Configure SSO with Microsoft Azure

If you do not already have a Microsoft Azure account, create a free Azure Account, then use the following steps to configure Azure as your SSO provider for integrator.io. 

Create an Azure active directory tenant

Once you have created your Azure account, use the following steps to create an Azure active directory  tenant:

1. Log in to the Azure portal, and select Create a resource from the homepage.

2. In the left navigation menu, select Identity, and then search for and select Azure Active Directory. 

3. Click Create on the Azure Active Directory page.

4. Enter your Organization name, Initial domain name, and your Country or region, then click Create (at the bottom of the page).

5. After a few moments, the page displays a link to manage your tenant. Click the link to access the Overview page.

6. This page confirms your tenant was successfully created.

Register an application

1. Click App registrations in the left navigation menu under Manage.

2. Click + New registration.

3. Enter an application name and the callback URL in the Redirect URI field in the form and click Register.

4. Copy the Application client ID to use as the Client ID for your integrator.io iClient.

5. Click Add a certificate or secret.

6. Click + New client secret, enter the name, and click Add.

7. Save the value in the Value field of the created Client to enter into integrator.io as the Client Secret for your integrator.io iClient.

8. Select the Authentication tab, and in the Web section under Redirect URIs, click Add URI to add the redirect URL.

9. Click Save.
10. Select the Overview tab, and click Endpoints in the application to retrieve the Issuer URL.

11. Copy the OpenID Connect metadata document endpoint URL (including /v2.0) to enter as the Issuer URL in integrator.io. For example:http://login.microsoftonline.com/<yourTenantId>/v2.0

    Note: Only copy the URL to /v2.0. Do not copy the entire URL or any part of the URL beyond /v2.0.

12. Navigate to Home, and click Branding & properties in the left navigation menu.

13. Find the Home page URL field and enter: https://integrator.io/sso/<your-organization-ID>. This URL should be identical to the Application login URL in integrator.io. Use the following steps to find your Application login URL in integrator.io:
    1. Log in to integrator.io using account owner credentials.
    2. In the bottom right corner click Account > Security. 
    3. The Security tab opens.

14. Save your settings and sign in to your integrator.io environment using the Application login URL. You may be prompted to allow access on first log in depending on your configuration.

See Enable single sign-on (SSO) for instructions for configuring SSO for integrator.io.