In this article, you learn how to integrate Locus with Microsoft Entra ID. Locus is a real-world ready dispatch management platform for last-mile excellence. When you integrate Locus with Microsoft Entra ID, you can:
Control in Microsoft Entra ID who has access to Locus.
Enable your users to be automatically signed-in to Locus with their Microsoft Entra accounts.
Manage your accounts in one central location.
You configure and test Microsoft Entra single sign-on for Locus in a test environment. Locus supports SP initiated single sign-on.
Prerequisites
To integrate Microsoft Entra ID with Locus, you need:
A Microsoft Entra subscription. If you don't have a subscription, you can get a free account.
Locus single sign-on (SSO) enabled subscription.
Add application and assign a test user
Before you begin the process of configuring single sign-on, you need to add the Locus application from the Microsoft Entra gallery. You need a test user account to assign to the application and test the single sign-on configuration.
Add Locus from the Microsoft Entra gallery
Add Locus from the Microsoft Entra application gallery to configure single sign-on with Locus. For more information on how to add application from the gallery, see the Quickstart: Add application from the gallery.
Browse to Identity > Applications > Enterprise applications > Locus > Single sign-on.
On the Select a single sign-on method page, select SAML.
On the Set up single sign-on with SAML page, select the pencil icon for Basic SAML Configuration to edit the settings.
On the Basic SAML Configuration section, perform the following steps:
a. In the Identifier textbox, type a value using the following pattern:
urn:auth0:locus-aws-us-east-1:<ConnectionName>
b. In the Reply URL textbox, type a URL using the following pattern:
https://accounts.locus-dashboard.com/login/callback?connection=<ConnectionName>
c. In the Sign on URL textbox, type a URL using the following pattern:
https://<ClientId>.locus-dashboard.com/#/login/sso?clientId=<ClientId>&connection=<ConnectionName>
Note
These values are not real. Update these values with the actual Identifier, Reply URL and Sign on URL. Contact Locus Client support team to get these values. You can also refer to the patterns shown in the Basic SAML Configuration section.
On the Set up single sign-on with SAML page, in the SAML Signing Certificate section, click copy button to copy App Federation Metadata Url and save it on your computer.
Configure Locus SSO
To configure single sign-on on Locus side, you need to send the App Federation Metadata Url to Locus support team. They set this setting to have the SAML SSO connection set properly on both sides.
Create Locus test user
In this section, you create a user called Britta Simon at Locus. Work with Locus support team to add the users in the Locus platform. Users must be created and activated before you use single sign-on.
Test SSO
In this section, you test your Microsoft Entra single sign-on configuration with following options.
Click on Test this application, this will redirect to Locus Sign-on URL where you can initiate the login flow.
Go to Locus Sign-on URL directly and initiate the login flow from there.
You can use Microsoft My Apps. When you click the Locus tile in the My Apps, this will redirect to Locus Sign-on URL. For more information, see Microsoft Entra My Apps.
Discover how Microsoft Entra External ID can provide secure, seamless sign-in experiences for your consumers and business customers. Explore tenant creation, app registration, flow customization, and account security.