|
| 1 | +--- |
| 2 | +title: Azure Active Directory SSO integration with Locus |
| 3 | +description: Learn how to configure single sign-on between Azure Active Directory and Locus. |
| 4 | +services: active-directory |
| 5 | +author: jeevansd |
| 6 | +manager: CelesteDG |
| 7 | +ms.reviewer: CelesteDG |
| 8 | +ms.service: active-directory |
| 9 | +ms.subservice: saas-app-tutorial |
| 10 | +ms.workload: identity |
| 11 | +ms.topic: how-to |
| 12 | +ms.date: 04/26/2023 |
| 13 | +ms.author: jeedes |
| 14 | + |
| 15 | +--- |
| 16 | + |
| 17 | +# Azure Active Directory SSO integration with Locus |
| 18 | + |
| 19 | +In this article, you learn how to integrate Locus with Azure Active Directory (Azure AD). Locus is a real-world ready dispatch management platform for last-mile excellence. When you integrate Locus with Azure AD, you can: |
| 20 | + |
| 21 | +* Control in Azure AD who has access to Locus. |
| 22 | +* Enable your users to be automatically signed-in to Locus with their Azure AD accounts. |
| 23 | +* Manage your accounts in one central location - the Azure portal. |
| 24 | + |
| 25 | +You configure and test Azure AD single sign-on for Locus in a test environment. Locus supports **SP** initiated single sign-on. |
| 26 | + |
| 27 | +## Prerequisites |
| 28 | + |
| 29 | +To integrate Azure Active Directory with Locus, you need: |
| 30 | + |
| 31 | +* An Azure AD user account. If you don't already have one, you can [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). |
| 32 | +* One of the following roles: Global Administrator, Cloud Application Administrator, Application Administrator, or owner of the service principal. |
| 33 | +* An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/). |
| 34 | +* Locus single sign-on (SSO) enabled subscription. |
| 35 | + |
| 36 | +## Add application and assign a test user |
| 37 | + |
| 38 | +Before you begin the process of configuring single sign-on, you need to add the Locus application from the Azure AD gallery. You need a test user account to assign to the application and test the single sign-on configuration. |
| 39 | + |
| 40 | +### Add Locus from the Azure AD gallery |
| 41 | + |
| 42 | +Add Locus from the Azure AD 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](../manage-apps/add-application-portal.md). |
| 43 | + |
| 44 | +### Create and assign Azure AD test user |
| 45 | + |
| 46 | +Follow the guidelines in the [create and assign a user account](../manage-apps/add-application-portal-assign-users.md) article to create a test user account in the Azure portal called B.Simon. |
| 47 | + |
| 48 | +Alternatively, you can also use the [Enterprise App Configuration Wizard](https://portal.office.com/AdminPortal/home?Q=Docs#/azureadappintegration). In this wizard, you can add an application to your tenant, add users/groups to the app, and assign roles. The wizard also provides a link to the single sign-on configuration pane in the Azure portal. [Learn more about Microsoft 365 wizards.](/microsoft-365/admin/misc/azure-ad-setup-guides). |
| 49 | + |
| 50 | +## Configure Azure AD SSO |
| 51 | + |
| 52 | +Complete the following steps to enable Azure AD single sign-on in the Azure portal. |
| 53 | + |
| 54 | +1. In the Azure portal, on the **Locus** application integration page, find the **Manage** section and select **single sign-on**. |
| 55 | +1. On the **Select a single sign-on method** page, select **SAML**. |
| 56 | +1. On the **Set up single sign-on with SAML** page, select the pencil icon for **Basic SAML Configuration** to edit the settings. |
| 57 | + |
| 58 | +  |
| 59 | + |
| 60 | +1. On the **Basic SAML Configuration** section, perform the following steps: |
| 61 | + |
| 62 | + a. In the **Identifier** textbox, type a value using the following pattern: |
| 63 | + `urn:auth0:locus-aws-us-east-1:<ConnectionName>` |
| 64 | + |
| 65 | + b. In the **Reply URL** textbox, type a URL using the following pattern: |
| 66 | + `https://accounts.locus-dashboard.com/login/callback?connection=<ConnectionName>` |
| 67 | + |
| 68 | + c. In the **Sign on URL** textbox, type a URL using the following pattern: |
| 69 | + `https://<ClientId>.locus-dashboard.com/#/login/sso?clientId=<ClientId>&connection=<ConnectionName>` |
| 70 | + |
| 71 | + > [!NOTE] |
| 72 | + > These values are not real. Update these values with the actual Identifier, Reply URL and Sign on URL. Contact [Locus Client support team](mailto:[email protected]) to get these values. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal. |
| 73 | +
|
| 74 | +1. 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. |
| 75 | + |
| 76 | +  |
| 77 | + |
| 78 | +## Configure Locus SSO |
| 79 | + |
| 80 | +To configure single sign-on on **Locus ** side, you need to send the **App Federation Metadata Url ** to [Locus support team ](mailto:[email protected]). They set this setting to have the SAML SSO connection set properly on both sides. |
| 81 | + |
| 82 | +### Create Locus test user |
| 83 | + |
| 84 | +In this section, you create a user called Britta Simon at Locus. Work with [Locus support team ](mailto:[email protected]) to add the users in the Locus platform. Users must be created and activated before you use single sign-on. |
| 85 | + |
| 86 | +## Test SSO |
| 87 | + |
| 88 | +In this section, you test your Azure AD single sign-on configuration with following options. |
| 89 | + |
| 90 | +* Click on **Test this application** in Azure portal. This will redirect to Locus Sign-on URL where you can initiate the login flow. |
| 91 | + |
| 92 | +* Go to Locus Sign-on URL directly and initiate the login flow from there. |
| 93 | + |
| 94 | +* 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 about the My Apps, see [Introduction to the My Apps](../user-help/my-apps-portal-end-user-access.md). |
| 95 | + |
| 96 | +## Additional resources |
| 97 | + |
| 98 | +* [What is single sign-on with Azure Active Directory?](../manage-apps/what-is-single-sign-on.md) |
| 99 | +* [Plan a single sign-on deployment](../manage-apps/plan-sso-deployment.md). |
| 100 | + |
| 101 | +## Next steps |
| 102 | + |
| 103 | +Once you configure Locus you can enforce session control, which protects exfiltration and infiltration of your organization’s sensitive data in real time. Session control extends from Conditional Access. [Learn how to enforce session control with Microsoft Cloud App Security](/cloud-app-security/proxy-deployment-aad). |
0 commit comments