Step 1 – Allow Urmobo in Entra ID (Azure)
The first step to configure authentication is to allow Urmobo in your Entra ID environment through your company’s Azure portal.
- Access the Azure Portal
- In the main menu, select Microsoft Entra ID.
💡 If this option is not visible on the main screen, use the search bar to find it by typing “Entra ID”.
Step 2 – Access Application Registrations
After accessing Microsoft Entra ID, in the left-hand menu, select “App registrations” (as shown in the image below).
Step 3 – Create a New Application Registration
On the App registrations screen, click “New registration” to start creating a new application integration in your Entra ID environment (as shown in the image below).
- Set a name for the application.
We suggest using "Urmobo MDM" for easy identification. - For Supported account types, keep the default option (according to your environment’s needs).
- For Redirect URI, select the type "Web".
- In the URI field, enter exactly the following address:
https://mdm.urmobo.com.br/home/MSAuthCallback
- ⚠️ Attention: Make sure to copy the URL exactly as shown above. Any mistake in this field may prevent proper authentication from working.
Step 5 – Store Credentials and Access Certificates
After completing the registration of the new application, Azure will display the details of the created application.
Write down and store the following information:
1. Application ID (App ID)
- Directory ID (Tenant ID)
- These details will be used later to configure SSO in the Urmobo portal.
2. Next, in the application’s side menu, click on “Certificates & secrets” (as shown in the image below).
Step 6 – Generate a New Client Secret
On the Certificates & secrets screen, click “New client secret” to create a new key that will be used for authentication with Urmobo (as shown in the image below).
Step 7 – Configure the Client Secret
In the window that appears after clicking “New client secret”:
- Provide a description (name) for the secret, for example: Urmobo Secret.
- Choose the desired expiration period (e.g., 6 months, 12 months, 24 months).
⚠️ Attention: After the expiration date, authentication will stop working.
You will need to generate a new secret and update the settings in the Urmobo portal to restore SSO access.
Click “Add” to finish.
Step 8 – Copy the Secret Code
After creating the secret, immediately copy the generated secret code by clicking the indicated button (as shown in the image below).
⚠️ Important: This code will only be displayed once. Make sure to copy and store it securely.
This code, along with the Application ID (App ID) and Directory ID (Tenant ID), will be used to configure SSO authentication in the Urmobo console.
Step 9 – Access the Environment in the Urmobo Portal
Using the data obtained from Azure (App ID, Tenant ID, and secret), log in to the Urmobo portal with an administrator account.
In the side menu, click “Environments” (as shown in the image below).
Locate the environment you want to configure.
Step 10 – Access Environment Settings
On the environments list screen, find the desired environment and click “Settings” to open the editing details (as shown in the image below).
Step 11 – Configure Entra ID Authentication in the Urmobo Portal
In the “Entra ID” tab within the environment settings, fill in the fields with the information obtained from the Azure portal:
- Application ID (App ID)
- Directory ID (Tenant ID)
- Client Secret
After filling in the fields, click “Save” (as shown in the image below).
Optional: Enforce Login Only via SSO
If you want users to access the portal exclusively through SSO, check the “SSO Only Login” option in the Settings tab.
Done! From this moment, your users can authenticate using Microsoft SSO.
⚠️ Important:
Make sure the email address registered in the Urmobo portal matches the one in Entra ID to ensure proper authentication.