Add to Hosted Login

You can enable your custom IDP in Hosted Login by adding/updating the following settings in the Identity Cloud Console:

  • authentication.providers.custom
  • authentication.providers

authentication.providers.custom

The steps below will enable your custom IDP for use in Hosted Login:

  1. Navigate to your application in the Identity Cloud Console

  2. Navigate to MANAGE PROPERTIES

  3. Click the Actions menu ( ) for your Login Client and select Edit. This will take you to the page for viewing and editing your property. View/Edit property in Console

  4. Click the EDIT SETTINGS button at the bottom of the Settings section

  5. Click the Add Setting icon (Add Setting button). This will add a new line to the bottom of the list.

  6. Type or paste in the new setting name: authentication.providers.custom

  7. Click on the Create authentication.providers.custom. popup Create custom provider setting in Console

  8. The value for this setting is a JSON object containing the following information:

    • Your Customer ID + Custom Provider ID
    • name: Your custom IDP Button Text
    • icon: Your custom IDP Button Icon URL
    • provider: The hostname of your Hosted Login domain
      • If you’re using the default Hosted Login domain (example: v1.api.us.janrain.com), then the hostname is: janrain
      • If you’re using a custom CNAME for the Hosted Login domain (example: accounts.mycompany.com), then the hostname is, for example: mycompany
    Complete setting value:
    {"CUSTOMER_ID.CUSTOM_PROVIDER_ID": {"name": "BUTTON_TEXT","icon": "BUTTON_ICON_URL","provider": "janrain"}}

    If you completed the Gather Your Details section, the setting value above has your information pre-populated for you. It also assumes you’re using the default Hosted Login domain ("provider": "janrain"). If you’re using a custom CNAME for your Hosted Login domain, make sure to replace janrain with the correct hostname in the next step.

  9. Paste in the value for this setting: Custom provider setting value in Console

  10. Click the Save icon (Save button)

authentication.providers

The steps below will add your custom IDP to the login/registration options in your Hosted Login pages:

  1. Navigate to your application in the Identity Cloud Console

  2. Navigate to MANAGE PROPERTIES

  3. Click the Actions menu ( ) for your Login Client and select Edit. This will take you to the page for viewing and editing your property. View/Edit property in Console

  4. Click the EDIT SETTINGS button at the bottom of the Settings section

  5. Locate the authentication.providers setting and add your custom IDP to the array of providers.

    • Your custom IDP is identified by a string consisting of your Customer ID + . + Custom Provider ID:
    "CUSTOMER_ID.CUSTOM_PROVIDER_ID"
    • In the example below, we’re adding a custom IDP to an array that originally contained one provider: ["google"] Add custom provider in Console

      If you don’t already have the authentication.providers setting, you’ll need to add it in a similar fashion to steps 5-7 for the previous setting. In such case, the setting value would be an array containing just your custom IDP, example: ["a12bc34d-567e-8f90-gh12-3i45jk678lm9.1abccd23-e456-7f8g-h9ij-012kl3m4n566"]

  6. Click the Save icon (Save button)

It may take a few minutes for your changes to be reflected in Hosted Login after you add or update a setting in Console.

The next time you view your Hosted Login pages, you will see your custom IDP as a login option. Custom IDP in Hosted Login