Set up single sign-on (SSO) so people in your organisation can log in to Rubii with their Microsoft Entra ID (Azure AD) accounts. This guide is for organisations that already have a Rubii account. You'll need to be able to see the Data Sources page in Rubii, and have admin access to the Microsoft Entra admin center.
Note: Microsoft Entra SSO is only available on accounts where Rubii has switched it on. If you can't find Microsoft Entra on your Data Sources page, contact our support team.
I. Find Microsoft Entra in Rubii
- Log in to Rubii.
- Go to the Data Sources page, or click here.
- Find Microsoft Entra under Single Sign On. You can also type "Entra" in the search box at the top.
- Click the Microsoft Entra card to see the setup steps.
II. Register an app in Microsoft Entra ID
- Log in to the Microsoft Entra admin center.
- Find App Registrations.
- Click New Registration.
- Leave the other fields at their defaults (the default is Single Tenant Only), then click Register.
- Open the new application's details.
III. Create a client secret
- Open Certificates and Secrets.
- Click New Client Secret.
- Set the Expiry for the secret. How long depends on your organisation's policy.
- Click Add.
- Copy the secret value straight away and store it securely. Once you leave the page, the value is masked and you can't retrieve it again.
IV. Note your Entra credentials
- Click Overview in the app registration.
- Note down:
- Application (client) ID
- Directory (tenant) ID
- Client Secret (from section III)
V. Connect Microsoft Entra in Rubii
- Go back to the Microsoft Entra card on the Rubii Data Sources page.
- When you have all three values, click I am ready to start connecting.
- Set up your SSO domain: enter the SSO domain you want to use (for example, yourcompany.rubii.com).
- Enter your Entra credentials: enter the Tenant ID, Client ID and Client Secret.
- When the connection completes, Rubii gives you a Callback URL (sometimes called a Redirect URI). Copy it for the next section.
VI. Add the Callback URL in Microsoft Entra
- Go back to your app registration in Microsoft Entra.
- In the left navigation, click Authentication.
- Click Add a platform and select Web.
- In the Redirect URIs field, add the Callback URL Rubii gave you in section V.
VII. Control who can log in (optional, recommended)
This makes sure only the people you choose can log in to Rubii with SSO.
- Go to Enterprise Applications in Microsoft Entra.
- Find your Rubii application and click Properties.
- Set Assignment Required to Yes.
- Go to Users and Groups in the enterprise application and add the users or groups who should have access.
Note: Global Administrators in Microsoft Entra can bypass the Assignment Required restriction.
Tip: Create a role in Entra just for Rubii users, assign people to that role, then assign the role to the Rubii enterprise application.
VIII. Share the login link
Share the SSO login link provided by Rubii with your organisation so people can log in with Microsoft Entra.