• Docs
  • Administration
  • Configure Enterprise Login

Configure Enterprise Login

Choreo's Enterprise Login feature allows your users residing in an external IdP (Identity Provider) to login into Choreo seamlessly without changing their credentials.

This guide takes you through the steps you need to follow to configure an enterprise login for your organization in Choreo.


Make sure you have a valid email domain.

Step 1: Create an organization in Choreo

To create an organization in Choreo, follow the steps below:

  1. Sign in to the Choreo Console at https://console.choreo.dev/ using a Google/ GitHub/ Microsoft account.

  2. Create an organization as follows:

    • If you are a new user: enter a unique organization name and create an organization. For example, "Stark Industries".

      Create an organization in Choreo

    • If you are a returning user: expand the drop-down for your profile and click Settings. Under Organizations, you can view the organization you created at sign-up.

Step 2: Configure enterprise login for your Choreo organization

To configure enterprise login for your Choreo organization, follow the steps below:

  1. Expand the drop-down for your profile and click Settings.
  2. Click Copy Handle to copy the organization handle to the clipboard.

    Copy organization name

  3. When you add a Choreo organization, Choreo reserves the organization name for your user account. Therefore, you need to create an organization of the same name on the Choreo IdP (i.e., Asgardeo).

    To create your organization on the Choreo IdP, follow these steps: c 1. Sign up to Asgardeo https://asgardeo.io/signup?utm_source=console with the same credentials you used to create your Choreo account.

    1. Paste the value copied in step 2 as the organization name in Asgardeo and click Create.

      Create an organization in Asgardeo

  4. To enable enterprise login for your organization, send us an email as follows:

    • If you already have a support account with us, send us the organization name/handle and the email domains specific to your organization through our support portal.

    • If you do not have a support account with us yet, send an email to [email protected] requesting to enable enterprise login to your organization.

      Mention the following information in the request:

      • Organization name or handle. For example, “Stark Industries” or “starkindustries”
      • Email domains specific to your organization. For example, “@stark.com”, “@starkindustries.com”, and “@stark.eu.

      Sample Email

      Subject : [Stark Industries] Configure enterprise login
          Hi CS team,
          Configure enterprise login to my organization and please find the relevant information below.
          Organization name/handle: “Stark Industries”/“starkindustries”
          Email domains specific to my organization: “@stark.com”, “@starkindustries.com”, and “@stark.eu”
          Thank you!

  5. To configure your enterprise login, our support team will send you an email with a verification code. Login to your domain host account and configure the DNS record for your email domain with the following values:

    Field Value
    Name/Host/Alias @ or leave blank
    Time to Live (TTL) Leave default value or use 86400
    Value/Answer/Destination wso2-domain-verification:<verification_code>

What's next?

Next, you can create a connection to the federated identity provider (For example, Auth0, ADFS, Keycloak, etc.), following the steps below:

Step 3: Bring your own identity

Bring your own identity to Choreo by configuring a federated enterprise IdP on Asgardeo to your organization. Now that you have created an organization in Asgardeo with the same name as your Choreo organization in Step 2, Choreo can authenticate users signing in to that organization. Follow the steps below to configure the federated IdP:

  1. Sign in to Asgardeo at https://asgardeo.io/signup?utm_source=console.

  2. To configure a federated enterprise identity provider to your Asgardeo organization, follow the steps in Asgardeo documentation - Add Standard-Based Login.

  3. Next, navigate to Develop and select Applications from the left navigation. You will see an application prefixed “WSO2_LOGIN”.

    Asgardeo applications

  4. Click on the application and select the Sign-in Method tab. You can observe the connection you configured in step 2 of this section.

    Asgardeo applications

You are all set! Your users in the enterprise IdP can now log into the Choreo Console using their user credentials.