- 09 May 2023
- 2 Minutes to read
- Contributors
- DarkLight
- PDF
Single Sign-On with Microsoft Azure AD
- Updated on 09 May 2023
- 2 Minutes to read
- Contributors
- DarkLight
- PDF
Overview
This step-by-step guide explains how to set up Single Sign-On in Record Migrator with Microsoft Azure Active Directory (AD) as your SAML 2.0 Identity Provider (IdP).
When you integrate Record Migrator with Azure AD, you can:
- Control in Azure AD who has access to Record Migrator
- Enable users to be automatically signed in to Record Migrator with their Azure AD accounts
- Manage your accounts in one central location— the Azure portal.
Prerequisites
To get started, you need the following items:
- Microsoft Azure account with Azure AD Premium activated.
- Administrator-level access to Record Migrator and Azure AD to configure SSO.
- Add Record Migrator as a non-gallery application in Azure.
Instructions
Step 1: Configuring in Azure AD
Log into the Azure portal (https://portal.azure.com/). In the left-hand menu, click
Azure Active Directory > Enterprise applications
.
Select
All applications
under theManage
section.Click
+ New application
at the top of the screen.
On the next screen, click on the
+ Create your own application
button.
Enter the name of the app as
Record Migrator
and choose the third option,Integrate any other application you don't find in the gallery (Non-gallery)
. Click onCreate.
After the Record Migrator application is created, click on
Single Sign-On
under theManage
section.On the
Select a Single sign-on method
dialog, selectSAML
mode to enable Single Sign-On.
On the
Set up Single Sign-On with SAML
page, click theEdit (pencil)
icon forBasic SAML Configuration
to change the settings.
On the
Basic SAML Configuration
section, perform the following steps:In the
Identifier (Entity ID)
field, enter the URL asautorabit.com
.In the
Reply URL
field, enter theURL
in the below format:<instanceurl>/api/v1/saml/SSO
For example: If your instance URL ishttps://rbm.autorabit.com,
your Reply URL will behttps://rbm.autorabit.com/api/v1/saml/SSO
In the
Sign on URL
field, type the secure URL of your domain (i.e., starting with https://). For example:https://rbm.autorabit.com/.
Click
Save
and close the dialog box.
Click on
Single Sign-On
to navigate to theSet up Single Sign-On with SAML
page.In the
SAML Certificate
section, findFederation Metadata XML
and selectDownload
to save the certificate on your computer.
Step 2: Configuring in Record Migrator SAML Connection
Now that Azure SSO implementation is set up, follow these steps to configure SSO in your Record Migrator account.
Log into your Record Migrator account.
Click on the Settings icon at the top-right corner of the page.
Go to User Management > SSO > OKTA.
Browse for the Metadata XML file you downloaded in your local machine and upload it.
Step 3: Testing the Single Sign-On Configuration
Log out of the Record Migrator app, and then log back in using the
Single Sign On
option.
Enter your organization name in the text field available.
Click Continue.
You should successfully redirect to the Record Migrator app after authentication.