Skip to main content

Microsoft Azure AD Sign-in Configuration

Microsoft Work sign-in is available on Enterprise editions.

microsoft sign-in

To enable users to sign in with Microsoft Work accounts, some configuration is required. Contact your Cotalker sales representative to obtain a Redirect URI before commencing the configuration.

Follow these simple steps:

  1. Sign in to the Azure portal.

  1. If you have access to multiple tenants, use the Directory + subscriptions filter in the top menu to select the tenant in which you want to register the application.
directory + subscriptions

  1. From the Home page, search for and select Azure Active Directory.
Azure Active Directory

  1. On the left-side panel, under Manage, select App registrations, then press New registration.
App registration

  1. From the Register an application page:
    1. Enter a Name for the application. "Cotalker" is a suitable name. Cotalker users might see this name, and if necessary, you can change it later.
    2. Choose "Accounts in this organizational directory only" as the Supported account type for the application.
    3. Do NOT enter a Redirect URI.
    4. Press Register to create the app registration.
register app


  1. From the left-side panel, under Manage, select Authentication, then press Add a platform.
add platform

  1. On the right-side panel, Configure platforms, under Web applications, select the Single-page application tile.
single-page app

  1. On the right-side panel, Configure single-page application:
    1. Under Redirect URIs, enter a redirect URI. This value is supplied by Cotalker.
    2. Press Configure to finish adding the redirect URI.
Configure single-page application
note

Do NOT enter a redirect URI that was not supplied by Cotalker.
Do NOT select any of the implicit or hybrid flow checkboxes.


  1. On the left-side panel, under Manage, select Token configuration, then press Add optional claim.
Token configuration

  1. On the right-side panel, Add optional claim:
    1. Under Token type, select ID.
    2. Then select the email, family_name and given_name checkboxes.
    3. Press Add to continue adding the optional claim.
Token type

  1. A pop-up window appears:
    1. Select the checkbox "Turn on the Microsoft Graph email, profile permission (required for claims to appear in token)".
    2. Press Add to finish adding the optional claim.
pop-up window

  1. Finally, Cotalker requires two values from the app just created. These values are found under the Overview option in the previously created app view (Azure Active Directory > App registrations > Cotalker):
    1. Application (client) ID
    2. Directory (tenant) ID
overview

Once you have these values, update your Cotalker platform's configuration through an API PATCH request to the companies endpoint. The request must contain the following body filled out with the corresponding values: 

{
    "branding": {
        "auth": {
            "azureAD": {
                "isActive": true,
                "clientId": "", //APPLICATION (CLIENT) ID
                "authority": "", // DIRECTORY (TENANT) ID
                "redirectUri": "" // OBTAIN REDIRECT URI FROM COTALKER STAFF.
            }
        }
    }
}

For more details about the request body, go to the COTCompany data model section.