How-toFor engineers

Set up SSO

The SSO setup process, which starts by contacting Awell, plus the details to gather from the identity provider.

Single sign-on (SSO) can't be set up from within the Awell applications. Awell configures it on request, so the first step is a support email rather than a settings page.

1. Contact Awell

Email support@awellhealth.com to request SSO, and include:

  • the organization's name
  • the name of the identity provider (IdP), for example Okta or Google

2. Gather the integration details

Setup means configuring the IdP and coordinating with Awell. Awell needs the IdP metadata, which typically includes the IdP URL and the certificate used for SSO, to establish the connection.

Awell sends back the values to enter on the IdP side, which differ by provider:

ProviderAwell provides
GoogleACS URL, Entity ID
OktaACS URL, Audience URI, Connection ID

3. Configure the identity provider

Follow the provider's guide:

Other SAML providers are supported on request

Google Workspace and Okta have step-by-step guides. Other providers that use Security Assertion Markup Language (SAML) are generally supported; ask when making the request.

Next steps

Next: the guide for Google or Okta.

On this page