Topics included in this article:
- Common Questions
- Recovery Users
- Step-by-step instructions
- SCIM setup with Azure
- My Apps setup with Azure
Step by Step Instructions
Below are the steps necessary to setup single sign-on with Office 365/Microsoft Azure AD.
1) Access the Azure Active Directory Portal (https://aad.portal.azure.com/) and create a new application named "Rhombus Systems".
2) Assign users and groups to the application.
From the Azure home page, navigate to Azure Active Directory->App Registrations (tab on left side)->All applications->Select Rhombus Systems app->App roles (tab on the left side)
Once there, click the Create app role on the top (red box)
Next, make sure the Display name and Value fields match the role name defined in the Rhombus console (the role name within Rhombus CAN contain spaces. Rhombus will first check for a match using space, and then underscore):
Azure Create app role
Role in Rhombus Console
Once you have confirmed the name matches on both Azure and Rhombus console, hit blue Apply button at the bottom of the Create app role pop out.
NOTE: Please note that the role name within Azure cannot contain spaces, but the Rhombus role name can. The below screen shot demonstrates how you would enter the Super Admin Group role name within Azure.
3) Add the newly created app role to the correct users within the Rhombus Systems Enterprise Application.
Navigate to Enterprise Applications->Rhombus Systems app->Users and groups and check the select box for the user(s) that need the new role and click the Edit button at the top:
In the Edit Assignment popup, click None Selected under Select a role, then on the right side select the corresponding role for that user and hit the blue Select button. Once selected click the blue Assign button
You can confirm the assignment worked by viewing it in the Role assigned column (red box)
4) Edit the "Basic SAML Configuration" by copying and pasting the information from the SSO page on the Rhombus web console.
5) Edit the "User Attributes & Claims" so that the "Unique User Identifier" is set to "user.mail". Note: depending on the configuration of the user or group, this may need to be set to "user.userprinciplename".
Next, click the "Add new claim" at the top of the "User Attributes & Claims" edit page and add the following Role claim:
Namespace should be set to http://schemas.microsoft.com/ws/2008/06/identity/claims/role
Your "User Attributes & Claims" should look something like this:
6) Download the MetaData XML and paste it in the "IDP MetaData XML" field in the Rhombus Single Sign-On Settings page.
7) Edit The Metadata XML by adding the NameIDFormat Attribute as show below:
Add the following line in the XML within the IDPSSODescriptor as shown below
If you are using a SAML 2.0, you may need to add the appropriate "md" prefixes to the XML tags to match the format.
8) Click "Save" on the Rhombus web console SSO page.
9) Now when users try to login to Rhombus, they will be redirected to login through AD. If JIT is not enabled, each user will need to be created in Rhombus before logging in.
SCIM setup with Azure
If you also want to setup SCIM provisioning with Azure, we have you covered. Checkout our step by step for setting this up on our other article: How to configure SCIM 2.0 with Azure
My Apps setup with Azure
1) Download the SP Metadata file on the SSO settings page inside the Rhombus Console.
2) Log in to your Azure portal, click the Single sign-on tab and upload your SP Metadata file
3) Click explore button on the far right to open the Library folder, locate the file, and once selected hit add