Skip to content

Commit a7f35fc

Browse files
committed
additional copyedits
1 parent 102b927 commit a7f35fc

File tree

1 file changed

+23
-25
lines changed

1 file changed

+23
-25
lines changed

articles/active-directory/saas-apps/contractsafe-saml2-sso-tutorial.md

Lines changed: 23 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ ms.collection: M365-identity-device-management
2323

2424
In this tutorial, you'll learn how to integrate ContractSafe Saml2 SSO with Azure Active Directory (Azure AD). When you integrate ContractSafe Saml2 SSO with Azure AD, you can:
2525

26-
* Control who has access to ContractSafe Saml2 SSO in Azure AD
27-
* Enable your users to automatically sign in to ContractSafe Saml2 SSO with their Azure AD accounts
28-
* Manage your accounts in one central location: the Azure portal
26+
* Control who has access to ContractSafe Saml2 SSO in Azure AD.
27+
* Enable your users to automatically sign in to ContractSafe Saml2 SSO with their Azure AD accounts.
28+
* Manage your accounts in one central location: the Azure portal.
2929

3030
To learn more about software as a service (SaaS) app integration with Azure AD, see [What is application access and single sign-on with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis).
3131

@@ -62,35 +62,35 @@ To configure and test Azure AD SSO with ContractSafe Saml2 SSO, complete the fol
6262
* **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** to enable **B.Simon** to use Azure AD SSO.
6363

6464
1. **[Configure ContractSafe Saml2 SSO](#configure-contractsafe-saml2-sso)** to configure the SSO settings on application side.
65-
* **[Create ContractSafe Saml2 SSO test user](#create-contractsafe-saml2-sso-test-user)** to have a counterpart of **B.Simon** in ContractSafe Saml2 SSO that is linked to the Azure AD representation of user.
66-
2. **[Test SSO](#test-sso)** - to verify whether the configuration works.
65+
* **[Create a ContractSafe Saml2 SSO test user](#create-a-contractsafe-saml2-sso-test-user)** to have a counterpart of **B.Simon** in ContractSafe Saml2 SSO that is linked to the Azure AD representation of user.
66+
2. **[Test SSO](#test-sso)** to verify whether the configuration works.
6767

6868
## Configure Azure AD SSO
6969

7070
Follow these steps to enable Azure AD SSO in the Azure portal.
7171

7272
1. In the [Azure portal](https://portal.azure.com/), on the **ContractSafe Saml2 SSO** application integration page, find the **Manage** section and select **single sign-on**.
7373
1. On the **Select a single sign-on method** page, select **SAML**.
74-
1. On the **Set up single sign-on with SAML** page, select the edit/pen icon for **Basic SAML Configuration** to edit the settings.
74+
1. On the **Set up single sign-on with SAML** page, select the edit (pen) icon for **Basic SAML Configuration** to edit the settings.
7575

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

78-
1. On the **Set up single sign-on with SAML** page, enter the values for the following fields:
78+
1. On the **Set up single sign-on with SAML** page, enter the following values in the corresponding fields:
7979

80-
a. In the **Identifier** text box, type a URL by using the following pattern:
80+
a. In the **Identifier** text box, enter a URL by using the following format:
8181
`https://app.contractsafe.com/saml2_auth/<UNIQUEID>/acs/`
8282

83-
b. In the **Reply URL** text box, type a URL by using the following pattern:
83+
b. In the **Reply URL** text box, enter a URL by using the following format:
8484
`https://app.contractsafe.com/saml2_auth/<UNIQUEID>/acs/`
8585

8686
> [!NOTE]
87-
> These values aren't real. Update these values with the actual Identifier and Reply URL. Contact the [ContractSafe Saml2 SSO 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.
87+
> These values aren't real. Update these values with the actual identifier and reply URL. Contact the [ContractSafe Saml2 SSO Client support team](mailto:[email protected]) to get these values. You can also refer to the formats shown in the **Basic SAML Configuration** section in the Azure portal.
8888

89-
1. ContractSafe Saml2 SSO application expects the SAML assertions in a specific format, which requires you to add custom attribute mappings to your SAML token attributes configuration. The following screenshot shows the list of default attributes.
89+
1. ContractSafe Saml2 SSO expects the SAML assertions in a specific format, which requires you to add custom attribute mappings to your SAML token attributes configuration. The following screenshot shows the list of default attributes.
9090

9191
![Common default attributes](common/default-attributes.png)
9292

93-
1. In addition to the default attributes, ContractSafe Saml2 SSO application expects few more attributes to be passed back in SAML response. These attributes are pre-populated, but you can review them as per your requirements. The following list shows the additional attributes.
93+
1. In addition to the default attributes, ContractSafe Saml2 SSO application expects few more attributes to be passed back in SAML response. These attributes are pre-populated, but you can review them according to your requirements. The following list shows the additional attributes.
9494

9595
| Name | Source Attribute|
9696
| ---------------| --------------- |
@@ -101,11 +101,11 @@ Follow these steps to enable Azure AD SSO in the Azure portal.
101101

102102
![The Certificate download link](common/metadataxml.png)
103103

104-
1. On the **Set up ContractSafe Saml2 SSO** section, copy the appropriate URL(s) based on your requirement.
104+
1. In the **Set up ContractSafe Saml2 SSO** section, copy the appropriate URL(s) based on your requirement.
105105

106106
![Copy configuration URLs](common/copy-configuration-urls.png)
107107

108-
### Create an Azure AD test user
108+
## Create an Azure AD test user
109109

110110
In this section, you'll create a test user in the Azure portal called **B.Simon**.
111111

@@ -117,7 +117,7 @@ In this section, you'll create a test user in the Azure portal called **B.Simon*
117117
1. Select the **Show password** check box, and then write down the value that's displayed in the **Password** box.
118118
1. Select **Create**.
119119

120-
### Assign the Azure AD test user
120+
## Assign the Azure AD test user
121121

122122
In this section, you'll enable **B.Simon** to use Azure SSO by granting access to ContractSafe Saml2 SSO.
123123

@@ -127,33 +127,31 @@ In this section, you'll enable **B.Simon** to use Azure SSO by granting access t
127127

128128
![The "Users and groups" link](common/users-groups-blade.png)
129129

130-
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
130+
1. Select **Add user**, and then select **Users and groups** in the **Add Assignment** dialog box.
131131

132132
![The Add User link](common/add-assign-user.png)
133133

134-
1. In the **Users and groups** dialog, select **B.Simon** from the Users list. Then, select the **Select** button at the bottom of the screen.
135-
1. If you're expecting any role value in the SAML assertion, in the **Select Role** dialog, select the appropriate role for the user from the list. Then, select the **Select** button at the bottom of the screen.
136-
1. In the **Add Assignment** dialog, select the **Assign** button.
134+
1. In the **Users and groups** dialog box, select **B.Simon** from the Users list. Then, select the **Select** button at the bottom of the screen.
135+
1. If you're expecting any role value in the SAML assertion, in the **Select Role** dialog box, select the appropriate role for the user from the list. Then, select the **Select** button at the bottom of the screen.
136+
1. In the **Add Assignment** dialog box, select the **Assign** button.
137137

138138
## Configure ContractSafe Saml2 SSO
139139

140140
To configure SSO on the **ContractSafe Saml2 SSO** side, you need to send the downloaded **Federation Metadata XML** and appropriate copied URLs from the Azure portal to the [ContractSafe Saml2 SSO support team](mailto:[email protected]). The team is responsible for setting the SAML SSO connection properly on both sides.
141141

142-
### Create a ContractSafe Saml2 SSO test user
142+
## Create a ContractSafe Saml2 SSO test user
143143

144144
In this section, you create a user called B.Simon in ContractSafe Saml2 SSO. Work with the [ContractSafe Saml2 SSO support team](mailto:[email protected]) to add the users in the ContractSafe Saml2 SSO platform. Users must be created and activated before you use SSO.
145145

146146
## Test SSO
147147

148-
In this section, you test your Azure AD SSO configuration by using the Azure Active Directory Access Panel.
149-
150-
When you select the ContractSafe Saml2 SSO tile in the Access Panel, you should be automatically signed in to the ContractSafe Saml2 SSO for which you set up SSO. For more information about the Access Panel, see [Introduction to the Access Panel](https://docs.microsoft.com/azure/active-directory/active-directory-saas-access-panel-introduction).
148+
In this section, you test your Azure AD SSO configuration by using the Azure Active Directory Access Panel. When you select the ContractSafe Saml2 SSO tile in the Access Panel, you should be automatically signed in to the ContractSafe Saml2 SSO for which you set up SSO. For more information about the Access Panel, see [Introduction to the Access Panel](https://docs.microsoft.com/azure/active-directory/active-directory-saas-access-panel-introduction).
151149

152150
## Additional resources
153151

154-
- [ List of Tutorials on How to Integrate SaaS Apps with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
152+
- [ List of tutorials on how to integrate SaaS apps with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
155153

156-
- [What is application access and single sign-on with Azure Active Directory? ](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
154+
- [What is application access and single sign-on with Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
157155

158156
- [What is conditional access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
159157

0 commit comments

Comments
 (0)