Technical

Setting up SSO with Microsoft Azure AD

sign in to Microsoft azure portal

Step 1: Sign in to Azure Portal

  • Navigate to the Azure Portal (Microsoft Azure ) and sign in with your Azure account.

Step 2: Create an Azure AD tenant (if needed)

  • If you don't have an Azure AD tenant, you'll need to create one. Go to the "Azure Active Directory" section in the Azure Portal and follow the instructions to create a new tenant.

Step 3: Register your application in Azure AD

  • In the Azure Portal, go to the "Azure Active Directory" section and select "App registrations".

  • Click on "New registration" to register your application.

  • Provide the name "RecordMy" for your application, select the appropriate supported account types, and enter the Redirect URI (where users will be redirected after successful authentication).

  • After registration, make note of the Application (client) ID, as you'll need it later.

Step 4: Configure SSO settings in RecordMy

  • Locate the SSO settings within the RecordMy application (top-right menu > Establishments).

  • Look for options related to SSO or Identity Providers (IdPs).

  • Enter the Azure AD-related information, such as the Azure AD tenant ID and the Application ID obtained in the previous steps.

  • Follow any additional instructions provided by on the Establishment Settings page to complete the SSO configuration.

Step 5: Configure user attributes and claims (optional)

  • If you want to customize the information passed from Azure AD to RecordMy during SSO, you can configure user attributes and claims.

  • In the Azure Portal, go to the "Azure Active Directory" section and select "Enterprise applications."

  • Find and select "RecordMy", then navigate to the "User attributes & claims" section.

  • Configure the claims based on RecordMy's requirements. For example, you can include attributes like user's email, name, roles, etc.

Step 6: Test the SSO integration

  • Once you've configured the SSO settings and claims, it's important to test the integration.

  • Access RecordMy and initiate the SSO process.

  • You should be redirected to the Azure AD login page.

  • Enter the credentials of a user who is part of the Azure AD tenant you configured.

  • After successful authentication, you should be redirected back to RecordMy and automatically logged in.

Step 7: Monitor and troubleshoot

  • Monitor the SSO integration to ensure its smooth functioning.

  • Use the Azure Portal to review logs, monitor sign-ins, and check for any errors or issues.

  • If you encounter any problems, consult the Azure documentation, forums, or contact Azure support for assistance.