This process assumes you already have a Rubii account and are integrating it with a new Microsoft Entra application for SSO.
I. Rubii Setup
- Login to Rubii.
- Go to the Data Sources Page.
- Look for Microsoft Entra (or Azure AD).
- Click on the Logo. You will see the setup steps and likely a video guide.
II. Microsoft Entra ID (Azure AD) App Registration
- Login to Microsoft Entra admin center.
- Find App Registrations.
- Click New Registration.
- Leave other fields as default (Default is Single Tenant Only). Click Register.
- Open the newly registered application's details.
III. Generating the Client Secret
- Open Certificates and Secrets.
- Click New Client Secret.
- Set the desired Expiry for the secret (the duration depends on your organization's policy).
- Click Add.
- The secret value will be displayed immediately after creation. Copy the secret value and store it securely. Once you leave the page, the secret value will be masked and you will not be able to retrieve it again.
IV. Retrieving Entra Credentials
- Click Overview in the app registration.
- Note down the following essential details:
- Application (client) ID
- Directory (tenant) ID
- Client Secret (from the previous step)
V. Completing Rubii Connection
- Go back to Rubii.
- Once you have the three details above (Client ID, Tenant ID, Secret), click "I am ready" to start the connection process.
- Setup SSO Domain: Enter your preferred SSO domain (e.g., yourcompany.rubii.com).
- Enter Entra Credentials: Input the Tenant ID, Client ID, and Client Secret you retrieved.
- The Rubii process should complete, and you will be provided with the Callback URL (sometimes called Redirect URI).
VI. Adding the Callback URL to Entra
- Go back to your App Registration in Microsoft Entra.
- In the left navigation, click Authentication (or find Redirect URI).
- Click Add a platform and select Web.
- In the Redirect URIs field, Add the Callback URL provided by Rubii in step 21.
VII. Managing User Access (Optional but Recommended)
This step ensures that only authorized users can access Rubii via SSO.
- Go to Enterprise Applications in Microsoft Entra.
- Find your Rubii application and click Properties.
- Set Assignment Required to Yes.
- Note: If a user is a Global Administrator, they can bypass this restriction.
- Recommendation: Create a new role in Entra specifically for Rubii users. Assign users to this role and then assign the role to the Rubii Enterprise App.
- Go to Users and Groups in the Enterprise App and Add the users/groups who should have access.
VIII. User Login
- Use the link provided by Rubii (usually found in step 2 of the Rubii setup) to share with your organization for logging in via Entra SSO.