# SSO with Okta
URL: https://docs.awellhealth.com/docs/administer-and-secure/sso-with-okta

> For the complete documentation index, see [llms.txt](https://docs.awellhealth.com/llms.txt).



With Okta as the identity provider (IdP), people sign in to Awell with their Okta credentials. The
connection is a Security Assertion Markup Language (SAML) app integration in Okta.

## Before starting [#before-starting]

* **An active Okta account** with administrative access.
* **An Awell account with permission to configure single sign-on (SSO).** Awell provides an **ACS URL**,
  an **Audience URI** and a **Connection ID** on
  [request](/docs/administer-and-secure/set-up-sso).

Request SSO from Awell first; step 2 can't be completed without those three values.

## 1. Create and configure a new Okta application [#1-create-and-configure-a-new-okta-application]

Follow Okta's guide for adding a SAML application.

## 2. Create the SAML app integration [#2-create-the-saml-app-integration]

Complete the SAML integration using the ACS URL, Audience URI and Connection ID from Awell.

## 3. Gather the SAML configuration details from Okta [#3-gather-the-saml-configuration-details-from-okta]

Collect the details Okta generates, including its metadata.

## 4. Assign users in Okta [#4-assign-users-in-okta]

Assign the application to the users and groups who should have Awell access.

As with any IdP, assigning the application is the ongoing access process: with
[just-in-time provisioning](/docs/administer-and-secure/single-sign-on) an assigned user's Awell profile
is created the first time they log in.

## 5. Provide the Okta details to Awell [#5-provide-the-okta-details-to-awell]

Send the details to Awell, who complete the connection.

## Awell completes the connection [#awell-completes-the-connection]

Awell finishes the configuration and confirms when SSO is live. Test with one user before assigning
everyone.

## Next steps [#next-steps]

Once people can sign in, assign them the right
[roles](/docs/administer-and-secure/roles-and-permissions).
