Identity Provider Discovery

This is an Early AccessEarly Access (EA) features are opt-in features that you can try out in your org by asking Okta Support to enable them. Additionally, the Features page in the Okta Admin Console (Settings > Features) allows Super Admins to enable and disable some EA features themselves. feature. To enable it, please contact Okta Support.

When configured, Identity Provider Discovery redirects usersIn Okta literature, we generally refer to "users" as the people who serve as Okta administrators. When we refer to "end users" we are generally referring to the people who the administrators serve. That is, those who use Okta chiclets to access their apps, but have no administrative control. to different identity providers based on specified criteria. These criteria include location, device, the appAn abbreviation of application. Essentially, it is a web-based site used to perform any number of specific tasks, and requires authentication from end users by signing in. or app instance being accessed, the user's domainA domain is an attribute of an Okta organization. Okta uses a fully-qualified domain name, meaning it always includes the top-level domain (.com, .eu, etc.), but does not include the protocol (https)., and specific user attributes. For organizations that have more than one Okta orgThe Okta container that represents a real-world organization., the separate orgs can use separate identity providers and keep groupsGroups allow you to organize your end users and the apps they can access. Assigning apps to large sets of end users is made easier with groups. of users separate.

Note: Identity Provider Discovery is designed to improve usability and to enhance the end-user experience. It does not provide additional security enhancements.

Limitation: Identity Provider Discovery on ChromeBooks only supports the Okta Identity Provider and third-party Identity Providers that have announced support for ChromeBook.

End-user experience

When Identity Provider Discovery is configured to select a provider based on the end user's domain or attributes, the end-user sees a modified sign-in screen that accepts the email, and short names, as shown below.

The sign in is evaluated against the set criteria and the user is redirected to the appropriate sign-in screen for the desired identity provider.


Identity Provider Discovery is useful in the following scenarios


Before using this feature, you must have an additional identity provider configured. For information on configuring an additional SAMLAn acronym for Security Assertion Markup Language, SAML is an XML-based standard for exchanging authentication and authorization data between an identity provider (IdP) and a service provider (SP). The SAML standard addresses issues unique to the single sign-on (SSO) solution, and defines three roles: the end user, the IDP, and the SP. identity provider, see Configure Inbound SAML. Identity Provider Discovery does not support Social Identity Providers.


To configure Identity Provider Routing Rules (IdPAn acronym for Identity Provider. It is a service that manages end user accounts analogous to user directories such as LDAP and Active Directory, and can send SAML responses to SPs to authenticate end users. Within this scenario, the IdP is Okta. Discovery), navigate to Security > Identity Providers, and then, click the Routing Rules tab. The default rule is shown that specifies Okta as the default identity provider. To add an additional provider, click Add Routing Rule. The screen shown below opens.

You must name the rule. In addition to the name there are four types of routing specifications. Note that all specified conditions must be met to trigger the rule. After defining the conditions, you specify the identity provider to use.

  • User's IP Address — choices are Anywhere, In zone, and Not in zone. To specify a zone here, at least one network zone must already be defined. For information on zones, see IP Zones.
  • User's Device Platform — choices are Any device, any of these mobile devices: iOS, Android, Other mobile (e.g. BlackBerry), and any these desktop devices: Windows, macOS, Other desktop (e.g. Linux). You can select any desired combination of devices.
  • User is accessing — choices are Any application or to specify applications. To add an application or app instance, start typing the application name. A list of all matching apps appears from which you can choose. You can specify multiple applications.
  • User matches — choices are Anything, Regex on login, Domain list on login, and User attribute.

    Anything specifies any user. This is the default.

    Regex on login allows you to enter any valid regular expression based on the user login to use for matching. This is useful when specifying the domain or a user attribute is not sufficient for matching.

    For example, if an organization has the domains,,,, etc. and you want to match all users with a login that ends with, such as and In this case, you can use the regular expression test\.example\.com$. The $ is the regular expression operator for "ends with." Note that the periods in the URL are escaped.

    Domain list on login specifies a list of the domains to match; for example, Do not add the @ sign to the domain name. You can add multiple domains. Note that it is not necessary to escape any characters which is required when using a regular expression.

    User attribute specifies an attribute name, a type of comparison, and a value to match. After selecting User attribute, the item shown below appears.

    Choose an attribute from the list and choose the type of comparison to use from the second list. The expanded drop down lists are similar to the following example, varying by the user attributes in your org.

    After choosing from the drop down lists, enter the value to use for comparison. If you choose Regex for the type of comparison, enter a valid regular expression for the value.

  • Use this identity provider — choose the identity provider from the drop down list to use when all the criteria are met.

When done, click Create Rule. After creating a rule, the following prompt appears to allow you to activate the rule.

  • If you activate the rule, it is immediately in effect.
  • If you do not activate the rule, it is listed on the Routing Rules screen as inactive.

Maintaining Routing Rules

The Routing Rules screen shows all rules, active and inactive.


To activate, edit, deactivate, or delete a rule, click the rule name, and then click an action button on the right. You cannot modify the default rule.