Setting up SSO

To-do list for setting up SSO

Setting up SSO includes creating the Azure AD and Keycloak Applications. This article describes Azure AD part, for the Keycloack - reach out to your Corti Customer Success.

Creating the Azure AD Application

  1. Log into Microsoft Azure.
  2. Go to Azure Active Directory
    azure services
  3. Select “Enterprise Applications” on the left sidebar:
    sso enterprise
  4. Click “New Application” on the top bar:
    new application
  5. Click “Create your own application” on the top bar:
    sso create your own
  6. Select “Register an application to integrate with Azure AD” and provide a name, and select “Create”:
    sso_create your application
  7. For “Supported account types” select “Accounts in this organization only” and provide the Redirect URI. The Redirect URI has the format:
    “https://keycloak.${ENVIRONMENT_NAME}.corti.live/realms/${ENVIRONMENT_NAME}/broker/oidc/endpoint”

    sso register an application
  8. If it does not take you to the newly created application, go back to the “Enterprise Applications” stage (step 3) and select the newly created application from the list.
  9. Once inside your application, select “Single sign-on” from the left sidebar:
    sso clear
  10. Click “Go to application” inside the “Configure application properties” box:
    sso configure application properties
  11. Then select “API permissions” from the left sidebar:
    sso api permissions
  12. Click “Add a permission”:
    sso configured permissions
  13. Select “Microsoft Graph” on the sidebar that pops out:
    sso request api permissions
  14. Select “Delegated permissions”
    sso delegated permissions
  15. Select “email”, “openid”, and “profile” from the “OpenId permissions” section, then click “Add Permissions”
    sso email openid
  16. Now let’s create a client secret to be able to securely connect Keycloak & Azure AD. Start by selecting “Certificates & secrets” from the left sidebar:
    sso certificates
  17. Click “New client secret”
    sso new client secret
  18. Enter a descriptive name and set an expiry period:
    sso expiration
  19. A secret will be created. Copy this and put it in a safe place (1password preferably). 

NOTE: YOU WILL NOT BE ABLE TO GET THIS VALUE FROM AZURE AD EVER AGAIN, SO MAKE SURE TO SAVE IT.

20.  Make sure to note down the following two values from the “Overview” page:

    1. Application (client) ID
    2. Directory (tenant) ID

Creating the Keycloak Application

Reach out to your Corti Customer Success to configure this step.