📝 Please note:
This setup guide is for Scale accounts only. Build, and Train accounts do not have access to this integration.
You will still need to add people to your Trainual account in order for them to be active in your account and for the SSO login to be effective. Learn how to add new teammates here!
If you have an Azure Active Directory account, you're in luck! You can now add Trainual to your Microsoft Azure Active Directory to use SSO on the fly. After adding us to AD, follow the below steps to get the integration set up in Trainual.
This is a two-part setup guide. We'll walk through the entire process below!
First, you need to register Trainual in your Microsft Azure account.
Secondly, you will need to connect Azure to your Trainual account.
Let's first walk through how to register Trainual in your Microsoft Azure Active Directory:
Log in to Azure Active Directory admin Center with your personal account.
After logging in:
Select Azure Active Directory in the left-hand navigation.
Select App registrations under "message."
Once you are here, select New Registration.
On the Register an application page, you will then set the following values:
Set supported account types to Accounts in this organizational directory only (Default Directory only - Single tenant)
Under Redirect URL, set the first drop-down to web and set the value to https://app.trainual.com/users/auth/microsoft_graph_auth/callback
🚨If you are using a custom domain for your Trainual account, you will need to add the custom domain redirect URL in addition to the original Trainual redirect URL noted above.
➡ Custom Domain URL: https://app.name-of-custom-domain-here.com/users/auth/microsoft_graph_auth/callback
Next, you will select Register. On your Project page, copy the value of the Application (client) ID and save it. You will need it in the next step.
Select Certificates & secrets under Manage.
Select the New client secret button.
Enter a value in Description and select one of the options for Expires and select Add.
Copy the client-server value before you leave the page. You will need it in the next step.
The client secret is never shown again, so make sure you copy it now.
To complete the setup for this integration, log in to your Trainual and follow these steps:
Click your Profile Icon on the top right of your screen.
Click Microsoft Azure.
Click "Connect your Active Directory."
On the form that populates, add your client ID, client secret.
You're connected! 🎉
📝Note: To confirm the connection was successful, two buttons will appear on the Microsoft Azure integrations page within Trainual that say: View integrations and Deactivate integration.
To test the single sign-on with Microsoft AD, sign out of the account and head back to the login page. You should now see a sign-in with a Microsoft AD button.
If you don't see this button, try clearing your browser history to refresh your page.
Click the button to log in automatically.
Note: For first-time logins, it will prompt a sign-in with Microsoft AD. Once the first login occurs, the user will not be prompted to log in again using Microsoft AD, it will automatically sign on.
To Enable SSO Only:
The billing admin or admin will go to the "My Settings" page
At the bottom of the page, toggle on the "Require login via SSO" option
The update will refresh the page and automatically save
If you have any additional questions, please feel free to email email@example.com!