Okta OIDC Configuration Guide

How to set up Okta Single Sign-On integration with map4health™


  • Supported features
  • Requirements
  • Configuration steps
  • Notes

Supported features

  • Single Sign-On (OpenID Connect) initiated via Okta IdP


  1. Add the map4health application in your Okta instance
  2. In order to access map4health via Okta Single Sign-On, a user must have an existing account in map4health
  3. Make sure that the map4health coach's email exactly matches their Okta account email
  4. Complete the Configuration steps below to ensure access to map4health via Okta Single Sign-on

Configuration steps

After adding the application, you need to obtain some information that you will have to send to map4health.

Gather information from Okta

  1. In the Okta admin page, click on the map4health application and then navigate to the Sign On tab
  2. Copy the values of "Client ID" and "Client secret" (click the eye button to toggle the visibility)
  3. There should be a section that has a link titled OpenID Provider Metadata. Click this link. In the JSON document shown, look for a key titled "issuer" and copy the URL-value

Send the information to map4health

Once you have all the information (summarized below), email it to support@map4health.com.

  • Client ID
  • Client Secret
  • Issuer URL

The map4health support team will handle your request and get back to you once the integration is configured.


Okta is the only external Identity Provider (IdP) supported by map4health so far.

Service Provider (SP)-Initiated Authentication (SSO) Flow is not supported by map4health yet.