If you'd like to bypass iCompleat’s registration process, you can log in with Microsoft Azure Active Directory using Single Sign-On.

With Single Sign-On set up, all your users need is click Sign in with Microsoft on the iCompleat login page.

To set up Microsoft Azure Active Directory, follow the steps below.

Most of the steps take place in your Azure platform, & involve creating an app registration, registering & retrieving a tenant ID to use with your account in iCompleat.

Configure Azure & get a Tenant ID

1. Log in to the Azure management portal.
2. Select Azure Active Directory.
3. Click App registrations on the left.
4. Click New registration.
5. Type an appropriate name for your registration.
6. Select who can use this registration.

   We recommend selecting Accounts in this organizational directory only.

   
7. For a smooth user experience, provide the redirect URL to direct users to the iCompleat login screen.

   Paste the URL of the login page. https://portal.compleat.online/login/

   
8. Click Register.
9. Click Authentication on the left.
10. Scroll down to locate the Front-channel logout URL

    Paste iCompleat’s logout URL into the box.

    To get the correct link for your account:

    In iCompleat, hover over your name in the top-right, right click Log off, & click Copy link address. 

     

    If you're on our EU server, you'll use the following link:

    https://eu1.compleat.online/Main/Authentication/LogOff

11. Further down the page, click to select the checkbox ID tokens.
12. Click Save.
13. Now to get the Tenant ID.

    On the left, click Overview.

14. Locate the Directory (tenant) ID & ‘Copy to clipboard’ or make a note of the ID.

Well done! You've completed the configuration required in Azure.

Make sure you've made a note of your Tenant ID as it’s required for the configuration steps in iCompleat.

Configuration in iCompleat

The final stage is to insert the Tenant ID into the authentication settings of your account in iCompleat.

Follow these steps.

1. Log in to iCompleat & click Configuration.
2. Click Manage users.
3. Click Set up Azure AD.
4. Click Azure Active Directory, & paste your Tenant ID from Azure into the field.
5. (Optional) Switch on the Create user toggle to create a new user for someone who doesn't already exist in iCompleat. This is based on their email address.
   
6. Click Save.

Job done! You've created an active directory registration & used its tenant ID to allow authentication on your account.

When a user logs in

When a user logs in for the first time by clicking Sign in with Microsoft on the login page, they should be prompted to allow some permissions.

Once they've accepted these permissions, they'll land inside iCompleat on the homepage.