Skip to content

Commit 7348436

Browse files
authored
Merge pull request #104923 from v-albemi/iamip-patent-platform-tutorial
Edit pass: Iamip patent platform tutorial
2 parents 62814a2 + d25ca00 commit 7348436

File tree

1 file changed

+66
-64
lines changed

1 file changed

+66
-64
lines changed

articles/active-directory/saas-apps/iamip-patent-platform-tutorial.md

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

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

26-
* Control in Azure AD who has access to IamIP Patent Platform.
26+
* Use Azure AD to control who can access IamIP Patent Platform.
2727
* Enable your users to be automatically signed-in to IamIP Patent Platform with their Azure AD accounts.
28-
* Manage your accounts in one central location - the Azure portal.
28+
* Manage your accounts in one central location: the Azure portal.
2929

30-
To learn more about 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/manage-apps/what-is-single-sign-on).
30+
To learn more about SaaS app integration with Azure AD, see [Single sign-on to applications in Azure Active Directory](https://docs.microsoft.com/azure/active-directory/manage-apps/what-is-single-sign-on).
3131

3232
## Prerequisites
3333

3434
To get started, you need the following items:
3535

3636
* An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/).
37-
* IamIP Patent Platform single sign-on (SSO) enabled subscription.
37+
* An IamIP Patent Platform subscription with single sign-on (SSO) enabled.
3838

39-
## Scenario description
39+
## Tutorial description
4040

41-
In this tutorial, you configure and test Azure AD SSO in a test environment.
41+
In this tutorial, you'll configure and test Azure AD SSO in a test environment.
4242

43-
* IamIP Patent Platform supports **SP and IDP** initiated SSO
44-
* Once you configure the IamIP Patent Platform you can enforce session controls, which protect exfiltration and infiltration of your organization’s sensitive data in real-time. Session controls extend from Conditional Access. [Learn how to enforce session control with Microsoft Cloud App Security](https://docs.microsoft.com/cloud-app-security/proxy-deployment-any-app).
43+
IamIP Patent Platform supports SP-initiated and IDP-initiated SSO.
4544

45+
After you configure the IamIP Patent Platform, you can enforce session control, which protects exfiltration and infiltration of your organization’s sensitive data in real time. Session controls extend from Conditional Access. [Learn how to enforce session control with Microsoft Cloud App Security](https://docs.microsoft.com/cloud-app-security/proxy-deployment-any-app).
4646

47-
## Adding IamIP Patent Platform from the gallery
47+
48+
## Add IamIP Patent Platform from the gallery
4849

4950
To configure the integration of IamIP Patent Platform into Azure AD, you need to add IamIP Patent Platform from the gallery to your list of managed SaaS apps.
5051

51-
1. Sign in to the [Azure portal](https://portal.azure.com) using either a work or school account, or a personal Microsoft account.
52-
1. On the left navigation pane, select the **Azure Active Directory** service.
53-
1. Navigate to **Enterprise Applications** and then select **All Applications**.
52+
1. Sign in to the [Azure portal](https://portal.azure.com) with a work or school account or with a personal Microsoft account.
53+
1. In the left pane, select **Azure Active Directory**.
54+
1. Go to **Enterprise applications** and then select **All Applications**.
5455
1. To add new application, select **New application**.
5556
1. In the **Add from the gallery** section, type **IamIP Patent Platform** in the search box.
5657
1. Select **IamIP Patent Platform** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
5758

59+
## Configure and test Azure AD SSO for IamIP Patent Platform
60+
61+
You'll configure and test Azure AD SSO with IamIP Patent Platform by using a test user named B.Simon. For SSO to work, you need to establish a link relationship between an Azure AD user and the corresponding user in IamIP Patent Platform.
5862

59-
## Configure and test Azure AD single sign-on for IamIP Patent Platform
63+
To configure and test Azure AD SSO with IamIP Patent Platform, you'll take these high-level steps:
6064

61-
Configure and test Azure AD SSO with IamIP Patent Platform 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 IamIP Patent Platform.
65+
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** to enable your users to use the feature.
66+
* **[Create an Azure AD test user](#create-an-azure-ad-test-user)** to test Azure AD single sign-on.
67+
* **[Grant access to the test user](#grant-access-to-the-test-user)** to enable the user to use Azure AD single sign-on.
6268

63-
To configure and test Azure AD SSO with IamIP Patent Platform, complete the following building blocks:
69+
1. **[Configure IamIP Patent Platform SSO](#configure-iamip-patent-platform-sso)** on the application side.
70+
* **[Create an IamIP Patent Platform test user](#create-iamip-patent-platform-test-user)** as a counterpart to the Azure AD representation of the user.
6471

65-
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** - to enable your users to use this feature.
66-
* **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with B.Simon.
67-
* **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable B.Simon to use Azure AD single sign-on.
68-
1. **[Configure IamIP Patent Platform SSO](#configure-iamip-patent-platform-sso)** - to configure the single sign-on settings on application side.
69-
* **[Create IamIP Patent Platform test user](#create-iamip-patent-platform-test-user)** - to have a counterpart of B.Simon in IamIP Patent Platform that is linked to the Azure AD representation of user.
70-
1. **[Test SSO](#test-sso)** - to verify whether the configuration works.
72+
1. **[Test SSO](#test-sso)** to verify that the configuration works.
7173

7274
## Configure Azure AD SSO
7375

74-
Follow these steps to enable Azure AD SSO in the Azure portal.
76+
Follow these steps to enable Azure AD SSO in the Azure portal:
7577

76-
1. In the [Azure portal](https://portal.azure.com/), on the **IamIP Patent Platform** application integration page, find the **Manage** section and select **single sign-on**.
78+
1. In the [Azure portal](https://portal.azure.com/), on the **IamIP Patent Platform** application integration page, in the **Manage** section, select **single sign-on**.
7779
1. On the **Select a single sign-on method** page, select **SAML**.
78-
1. On the **Set up single sign-on with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
80+
1. On the **Set up Single Sign-On with SAML** page, select the pencil button for **Basic SAML Configuration** to edit the settings:
7981

80-
![Edit Basic SAML Configuration](common/edit-urls.png)
82+
![Pencil button for Basic SAML Configuration](common/edit-urls.png)
8183

82-
1. On the **Basic SAML Configuration** section, if you have **Service Provider metadata file** and wish to configure in **IDP** initiated mode, perform the following steps:
84+
1. In the **Basic SAML Configuration** section, if you have a Service Provider metadata file and want to configure SSO in IDP-initiated mode, take these steps:
8385

84-
a. Click **Upload metadata file**.
86+
a. Select **Upload metadata file**:
8587

8688
![Upload metadata file](common/upload-metadata.png)
8789

88-
b. Click on **folder logo** to select the metadata file and click **Upload**.
90+
b. Select the folder button, select the metadata file, and then select **Upload**:
8991

90-
![choose metadata file](common/browse-upload-metadata.png)
92+
![Folder and Upload buttons](common/browse-upload-metadata.png)
9193

92-
c. After the metadata file is successfully uploaded, the **Identifier** and **Reply URL** values get auto populated in Basic SAML Configuration section.
94+
c. After the metadata file uploads, the **Identifier** and **Reply URL** values automatically populate in the **Basic SAML Configuration** section:
9395

94-
![image](common/idp-intiated.png)
96+
![Identifier and Reply URL values](common/idp-intiated.png)
9597

9698
> [!Note]
97-
> If the **Identifier** and **Reply URL** values do not get auto polulated, then fill in the values manually according to your requirement.
99+
> If the **Identifier** and **Reply URL** values aren't automatically populated, supply the values manually according to your requirements.
98100

99-
1. Click **Set additional URLs** and perform the following step if you wish to configure the application in **SP** initiated mode:
101+
1. Select **Set additional URLs** and complete the following step if you want to configure the application in SP-initiated mode:
100102

101-
In the **Sign-on URL** text box, type the URL:
102-
`https://patents.iamip.com/login-user`
103+
In the **Sign-on URL** box, enter
104+
**https:\//patents.iamip.com/login-user**.
103105

104-
1. On the **Set up single sign-on with SAML** page, in the **SAML Signing Certificate** section, find **Certificate (Raw)** and select **Download** to download the certificate and save it on your computer.
106+
1. On the **Set up Single Sign-On with SAML** page, in the **SAML Signing Certificate** section, select the **Download** link for **Certificate (Raw)** to download the certificate and save it on your computer:
105107

106-
![The Certificate download link](common/certificateraw.png)
108+
![Certificate download link](common/certificateraw.png)
107109

108-
1. On the **Set up IamIP Patent Platform** section, copy the appropriate URL(s) based on your requirement.
110+
1. In the **Set up IamIP Patent Platform** section, copy the appropriate URL or URLs, based on your requirements:
109111

110-
![Copy configuration URLs](common/copy-configuration-urls.png)
112+
![Copy configuration URLs](common/idp-intiated.png))
111113

112114
### Create an Azure AD test user
113115

114-
In this section, you'll create a test user in the Azure portal called B.Simon.
116+
In this section, you'll create a test user named B.Simon in the Azure portal.
115117

116-
1. From the left pane in the Azure portal, select **Azure Active Directory**, select **Users**, and then select **All users**.
118+
1. In the left pane of the Azure portal, select **Azure Active Directory**. Select **Users**, and then select **All users**.
117119
1. Select **New user** at the top of the screen.
118-
1. In the **User** properties, follow these steps:
119-
1. In the **Name** field, enter `B.Simon`.
120-
1. In the **User name** field, enter the username@companydomain.extension. For example, `[email protected]`.
121-
1. Select the **Show password** check box, and then write down the value that's displayed in the **Password** box.
122-
1. Click **Create**.
120+
1. In the **User** properties, complete these steps:
121+
1. In the **Name** box, enter **B.Simon**.
122+
1. In the **User name** box, enter \<username>@\<companydomain>.\<extension>. For example, `[email protected]`.
123+
1. Select **Show password**, and then write down the value that's displayed in the **Password** box.
124+
1. Select **Create**.
123125

124-
### Assign the Azure AD test user
126+
### Grant access to the test user
125127

126-
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to IamIP Patent Platform.
128+
In this section, you'll enable B.Simon to use Azure single sign-on by granting that user access to IamIP Patent Platform.
127129

128-
1. In the Azure portal, select **Enterprise Applications**, and then select **All applications**.
130+
1. In the Azure portal, select **Enterprise applications**, and then select **All applications**.
129131
1. In the applications list, select **IamIP Patent Platform**.
130-
1. In the app's overview page, find the **Manage** section and select **Users and groups**.
132+
1. On the app's overview page, in the **Manage** section, select **Users and groups**:
131133

132-
![The "Users and groups" link](common/users-groups-blade.png)
134+
![Select Users and groups](common/users-groups-blade.png)
133135

134-
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
136+
1. Select **Add user**, and then select **Users and groups** in the **Add Assignment** dialog box:
135137

136-
![The Add User link](common/add-assign-user.png)
138+
![Select Add user](common/add-assign-user.png)
137139

138-
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.
139-
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 and then click the **Select** button at the bottom of the screen.
140-
1. In the **Add Assignment** dialog, click the **Assign** button.
140+
1. In the **Users and groups** dialog box, select **B.Simon** in the **Users** list, and then click the **Select** button at the bottom of the screen.
141+
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 and then click the **Select** button at the bottom of the screen.
142+
1. In the **Add Assignment** dialog box, select the **Assign** button.
141143

142144
## Configure IamIP Patent Platform SSO
143145

144-
To configure single sign-on on **IamIP Patent Platform** side, you need to send the downloaded **Certificate (Raw)** and appropriate copied URLs from Azure portal to [IamIP Patent Platform support team](mailto:[email protected]). They set this setting to have the SAML SSO connection set properly on both sides.
146+
To configure single sign-on on the IamIP Patent Platform side, you need to send the downloaded raw certificate and the appropriate URLs that you copied from Azure portal to the [IamIP Patent Platform support team](mailto:[email protected]). They configure the SAML SSO connection to be correct on both sides.
145147

146148
### Create IamIP Patent Platform test user
147149

148-
In this section, you create a user called B.Simon in IamIP Patent Platform. Work with [IamIP Patent Platform support team](mailto:[email protected]) to add the users in the IamIP Patent Platform platform. Users must be created and activated before you use single sign-on.
150+
Work with the [IamIP Patent Platform support team](mailto:[email protected]) to add a user named B.Simon in IamIP Patent Platform. Users must be created and activated before you use single sign-on.
149151

150-
## Test SSO
152+
## Test SSO
151153

152-
In this section, you test your Azure AD single sign-on configuration using the Access Panel.
154+
In this section, you'll test your Azure AD SSO configuration by using Access Panel.
153155

154-
When you click the IamIP Patent Platform tile in the Access Panel, you should be automatically signed in to the IamIP Patent Platform 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).
156+
When you select the IamIP Patent Platform tile in Access Panel, you should be automatically signed in to the IamIP Patent Platform instance for which you set up SSO. For more information about Access Panel, see [Introduction to Access Panel](https://docs.microsoft.com/azure/active-directory/active-directory-saas-access-panel-introduction).
155157

156158
## Additional resources
157159

158-
- [ 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)
160+
- [Tutorials on how to integrate SaaS apps with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
159161

160162
- [What is application access and single sign-on with Azure Active Directory? ](https://docs.microsoft.com/azure/active-directory/manage-apps/what-is-single-sign-on)
161163

162-
- [What is conditional access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
164+
- [What is Conditional Access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
163165

164166
- [Try IamIP Patent Platform with Azure AD](https://aad.portal.azure.com/)
165167

166-
- [What is session control in Microsoft Cloud App Security?](https://docs.microsoft.com/cloud-app-security/proxy-intro-aad)
168+
- [What is session control in Microsoft Cloud App Security?](https://docs.microsoft.com/cloud-app-security/proxy-intro-aad)

0 commit comments

Comments
 (0)