Skip to content

Commit d5ea3c8

Browse files
authored
Merge pull request #173938 from bhavana-129/holmes-update
Product Backlog Item 1578092: SaaS App Tutorial: Holmes Update
2 parents 76d5690 + c49386e commit d5ea3c8

File tree

2 files changed

+40
-38
lines changed

2 files changed

+40
-38
lines changed
Lines changed: 38 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: 'Tutorial: Azure Active Directory single sign-on (SSO) integration with Holmes | Microsoft Docs'
3-
description: Learn how to configure single sign-on between Azure Active Directory and Holmes.
2+
title: 'Tutorial: Azure AD SSO integration with ContractS CLM'
3+
description: Learn how to configure single sign-on between Azure Active Directory and ContractS CLM.
44
services: active-directory
55
author: jeevansd
66
manager: CelesteDG
@@ -9,83 +9,86 @@ ms.service: active-directory
99
ms.subservice: saas-app-tutorial
1010
ms.workload: identity
1111
ms.topic: tutorial
12-
ms.date: 04/06/2021
12+
ms.date: 09/29/2021
1313
ms.author: jeedes
1414

1515
---
1616

17-
# Tutorial: Azure Active Directory single sign-on (SSO) integration with Holmes
17+
# Tutorial: Azure AD SSO integration with ContractS CLM
1818

19-
In this tutorial, you'll learn how to integrate Holmes with Azure Active Directory (Azure AD). When you integrate Holmes with Azure AD, you can:
19+
In this tutorial, you'll learn how to integrate ContractS CLM with Azure Active Directory (Azure AD). When you integrate ContractS CLM with Azure AD, you can:
2020

21-
* Control in Azure AD who has access to Holmes.
22-
* Enable your users to be automatically signed-in to Holmes with their Azure AD accounts.
21+
* Control in Azure AD who has access to ContractS CLM.
22+
* Enable your users to be automatically signed-in to ContractS CLM with their Azure AD accounts.
2323
* Manage your accounts in one central location - the Azure portal.
2424

2525
## Prerequisites
2626

2727
To get started, you need the following items:
2828

2929
* An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/).
30-
* Holmes single sign-on (SSO) enabled subscription.
30+
* ContractS CLM single sign-on (SSO) enabled subscription.
3131

3232
## Scenario description
3333

3434
In this tutorial, you configure and test Azure AD SSO in a test environment.
3535

36-
## Adding Holmes from the gallery
36+
## Add ContractS CLM from the gallery
3737

38-
To configure the integration of Holmes into Azure AD, you need to add Holmes from the gallery to your list of managed SaaS apps.
38+
To configure the integration of ContractS CLM into Azure AD, you need to add ContractS CLM from the gallery to your list of managed SaaS apps.
3939

4040
1. Sign in to the Azure portal using either a work or school account, or a personal Microsoft account.
4141
1. On the left navigation pane, select the **Azure Active Directory** service.
4242
1. Navigate to **Enterprise Applications** and then select **All Applications**.
4343
1. To add new application, select **New application**.
44-
1. In the **Add from the gallery** section, type **Holmes** in the search box.
45-
1. Select **Holmes** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
44+
1. In the **Add from the gallery** section, type **ContractS CLM** in the search box.
45+
1. Select **ContractS CLM** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
4646

47+
## Configure and test Azure AD SSO for ContractS CLM
4748

48-
## Configure and test Azure AD SSO for Holmes
49+
Configure and test Azure AD SSO with ContractS CLM using a test user called **B.Simon**. For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in ContractS CLM.
4950

50-
Configure and test Azure AD SSO with Holmes using a test user called **B.Simon**. For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in Holmes.
51-
52-
To configure and test Azure AD SSO with Holmes, perform the following steps:
51+
To configure and test Azure AD SSO with ContractS CLM, perform the following steps:
5352

5453
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** - to enable your users to use this feature.
5554
1. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with B.Simon.
5655
1. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable B.Simon to use Azure AD single sign-on.
57-
1. **[Configure Holmes SSO](#configure-holmes-sso)** - to configure the single sign-on settings on application side.
58-
1. **[Create Holmes test user](#create-holmes-test-user)** - to have a counterpart of B.Simon in Holmes that is linked to the Azure AD representation of user.
56+
1. **[Configure ContractS CLM SSO](#configure-contracts-clm-sso)** - to configure the single sign-on settings on application side.
57+
1. **[Create ContractS CLM test user](#create-contracts-clm-test-user)** - to have a counterpart of B.Simon in ContractS CLM that is linked to the Azure AD representation of user.
5958
1. **[Test SSO](#test-sso)** - to verify whether the configuration works.
6059

6160
## Configure Azure AD SSO
6261

6362
Follow these steps to enable Azure AD SSO in the Azure portal.
6463

65-
1. In the Azure portal, on the **Holmes** application integration page, find the **Manage** section and select **single sign-on**.
64+
1. In the Azure portal, on the **ContractS CLM** application integration page, find the **Manage** section and select **single sign-on**.
6665
1. On the **Select a single sign-on method** page, select **SAML**.
6766
1. On the **Set up single sign-on with SAML** page, click the pencil icon for **Basic SAML Configuration** to edit the settings.
6867

6968
![Edit Basic SAML Configuration](common/edit-urls.png)
7069

71-
2. On the **Basic SAML Configuration** section, enter the values for the following fields:
70+
1. On the **Basic SAML Configuration** section, perform the following steps:
7271

7372
1. In the **Identifier** text box, type a URL using the following pattern:
7473

7574
`https://<WorkspaceID>.holmescloud.com`
7675

77-
1. In the **Reply URL (Assertion Consumer Service URL)** text box, enter `https://holmescloud.com/sso/acs`.
76+
1. In the **Reply URL (Assertion Consumer Service URL)** text box, type the URL:
77+
78+
`https://holmescloud.com/sso/acs`.
7879

79-
1. In the **Logout Url** text box, enter `https://holmescloud.com/sso/logout`.
80+
1. In the **Logout Url** text box, type the URL:
81+
82+
`https://holmescloud.com/sso/logout`.
8083

8184
> [!NOTE]
82-
> Update the value with the actual Identifier, which refers to the Holmes Admin page. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
85+
> Update the value with the actual Identifier, which refers to the ContractS CLM Admin page. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
8386

8487
3. On the **Set up single sign-on with SAML** page, in the **SAML Signing Certificate** section, find **Certificate (Base64)** and select **Download** to download the certificate and save it on your computer.
8588

8689
![The Certificate download link](common/certificatebase64.png)
8790

88-
1. On the **Set up Holmes** section, copy the appropriate URL(s) based on your requirement.
91+
1. On the **Set up ContractS CLM** section, copy the appropriate URL(s) based on your requirement.
8992

9093
![Copy configuration URLs](common/copy-configuration-urls.png)
9194

@@ -103,41 +106,40 @@ In this section, you'll create a test user in the Azure portal called B.Simon.
103106

104107
### Assign the Azure AD test user
105108

106-
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to Holmes.
109+
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to ContractS CLM.
107110

108111
1. In the Azure portal, select **Enterprise Applications**, and then select **All applications**.
109-
1. In the applications list, select **Holmes**.
112+
1. In the applications list, select **ContractS CLM**.
110113
1. In the app's overview page, find the **Manage** section and select **Users and groups**.
111114
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
112115
1. In the **Users and groups** dialog, select **B.Simon** from the Users list, then click the **Select** button at the bottom of the screen.
113116
1. If you are expecting a role to be assigned to the users, you can select it from the **Select a role** dropdown. If no role has been set up for this app, you see "Default Access" role selected.
114117
1. In the **Add Assignment** dialog, select the **Assign** button.
115118

116-
## Configure Holmes SSO
119+
## Configure ContractS CLM SSO
117120

118-
To configure single sign-on on the **Holmes** side, you need to register the downloaded **Certificate (Base64)** and the appropriate copied URLs from the Azure portal on the Holmes Admin page.
121+
To configure single sign-on on the **ContractS CLM** side, you need to register the downloaded **Certificate (Base64)** and the appropriate copied URLs from the Azure portal on the ContractS CLM Admin page.
119122

120-
### Create Holmes test user
123+
### Create ContractS CLM test user
121124

122-
In this section, you create a user called B.Simon in Holmes. You can create/invite a user on the Holmes Member Management page. Users must be created and activated before you use single sign-on.
125+
In this section, you create a user called B.Simon in ContractS CLM. You can create/invite a user on the ContractS CLM Member Management page. Users must be created and activated before you use single sign-on.
123126

124127
## Test SSO
125128

126129
In this section, you test your Azure AD single sign-on configuration with following options.
127130

128131
#### SP initiated:
129132

130-
* Click on **Test this application** in Azure portal. This will redirect to Holmes Sign on URL where you can initiate the login flow.
133+
* Click on **Test this application** in Azure portal. This will redirect to ContractS CLM Sign on URL where you can initiate the login flow.
131134

132-
* Go to Holmes Sign-on URL directly and initiate the login flow from there.
135+
* Go to ContractS CLM Sign-on URL directly and initiate the login flow from there.
133136

134137
#### IDP initiated:
135138

136-
* Click on **Test this application** in Azure portal and you should be automatically signed in to the Holmes for which you set up the SSO
137-
138-
You can also use Microsoft My Apps to test the application in any mode. When you click the Holmes tile in the My Apps, if configured in SP mode you would be redirected to the application sign on page for initiating the login flow and if configured in IDP mode, you should be automatically signed in to the Holmes for which you set up the SSO. For more information about the My Apps, see [Introduction to the My Apps](https://support.microsoft.com/account-billing/sign-in-and-start-apps-from-the-my-apps-portal-2f3b1bae-0e5a-4a86-a33e-876fbd2a4510).
139+
* Click on **Test this application** in Azure portal and you should be automatically signed in to the ContractS CLM for which you set up the SSO.
139140

141+
You can also use Microsoft My Apps to test the application in any mode. When you click the ContractS CLM tile in the My Apps, if configured in SP mode you would be redirected to the application sign on page for initiating the login flow and if configured in IDP mode, you should be automatically signed in to the ContractS CLM for which you set up the SSO. For more information about the My Apps, see [Introduction to the My Apps](https://support.microsoft.com/account-billing/sign-in-and-start-apps-from-the-my-apps-portal-2f3b1bae-0e5a-4a86-a33e-876fbd2a4510).
140142

141143
## Next steps
142144

143-
Once you configure Holmes 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-any-app).
145+
Once you configure ContractS CLM 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-any-app).

articles/active-directory/saas-apps/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -489,6 +489,8 @@
489489
href: contentsquare-sso-tutorial.md
490490
- name: ContractSafe Saml2 SSO
491491
href: contractsafe-saml2-sso-tutorial.md
492+
- name: ContractS CLM
493+
href: holmes-tutorial.md
492494
- name: ContractWorks
493495
href: contractworks-tutorial.md
494496
- name: Contrast Security
@@ -898,8 +900,6 @@
898900
href: hirevue-tutorial.md
899901
- name: Hive
900902
href: hive-tutorial.md
901-
- name: Holmes
902-
href: holmes-tutorial.md
903903
- name: Honestly
904904
href: honestly-tutorial.md
905905
- name: Hootsuite

0 commit comments

Comments
 (0)