Log in to iCompleat with the same credentials you use for everything else

With Microsoft Entra ID Single Sign-On your team can register with and log in to iCompleat using their Microsoft login details.

This not only gives you and your team one less password to remember but also ensures your experience in iCompleat is a secure and seamless extension of your day-to-day activities.

With Entra ID Single Sign-On set up, your user simply click Sign in with Microsoft on the iCompleat login page.

In this article we show you how to set up Microsoft Entra ID with iCompleat.

Microsoft Entra ID was formerly known as Microsoft Azure Active Directory.

1 - Configure Entra ID and get a Tenant ID

The first step is to configure Entra ID in the MIcrosoft Entra portal, and retrieve a Tenant ID. You must be a Cloud Application Administrator to be able to do this.

1. Log in to the Microsoft Entra admin portal.

   If you have access to multiple tenants, click the Settings icon in the top menu to switch to the correct tenant to register the application from the Directories + subscriptions menu.

2. Go to Identity > Applications > App registrations, and click New registration.
3. Type an appropriate name for your registration.
4. Select who can use this registration.

   We recommend selecting Accounts in this organizational directory only.

5. 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/

   
6. Click Register.
7. Click Authentication on the left.
8. 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, click the profile icon in the top-right, right click Log off, and click Copy link address.

    

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

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

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

    On the left, click Overview.

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

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

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

2 - 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 and click Configuration.
2. Click Users.
3. Click Configure authentication options.
4. Select Microsoft Entra ID.
5. Paste your Tenant ID from Azure into the Microsoft Entra ID field.
6. (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.
   
7. Click Save.

Job done! You've created an Entra ID directory registration and 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.

 Still got questions? Comment below and let us know how we can improve this article.