Skip to content

Commit 7601f1d

Browse files
authored
Merge pull request #205349 from v-hgampala/aws-sso-reverting-changes
Product Backlog Item 1990111: SaaS App Tutorial: AWS SSO Update
2 parents 367d1ec + de4156d commit 7601f1d

File tree

6 files changed

+50
-50
lines changed

6 files changed

+50
-50
lines changed
Lines changed: 49 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: 'Tutorial: Azure AD SSO integration with AWS IAM Identity Center (successor to AWS Single Sign-On)'
3-
description: Learn how to configure single sign-on between Azure Active Directory and AWS IAM Identity Center (successor to AWS Single Sign-On).
2+
title: 'Tutorial: Azure AD SSO integration with AWS Single Sign-On'
3+
description: Learn how to configure single sign-on between Azure Active Directory and AWS Single Sign-On.
44
services: active-directory
55
author: jeevansd
66
manager: CelesteDG
@@ -14,58 +14,58 @@ ms.author: jeedes
1414

1515
---
1616

17-
# Tutorial: Azure AD SSO integration with AWS IAM Identity Center
17+
# Tutorial: Azure AD SSO integration with AWS Single Sign-On
1818

19-
In this tutorial, you'll learn how to integrate AWS IAM Identity Center (successor to AWS Single Sign-On) with Azure Active Directory (Azure AD). When you integrate AWS IAM Identity Center with Azure AD, you can:
19+
In this tutorial, you'll learn how to integrate AWS Single Sign-On with Azure Active Directory (Azure AD). When you integrate AWS Single Sign-On with Azure AD, you can:
2020

21-
* Control in Azure AD who has access to AWS IAM Identity Center.
22-
* Enable your users to be automatically signed-in to AWS IAM Identity Center with their Azure AD accounts.
21+
* Control in Azure AD who has access to AWS Single Sign-On.
22+
* Enable your users to be automatically signed-in to AWS Single Sign-On 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-
* AWS IAM Identity Center enabled subscription.
30+
* AWS Single Sign-On enabled subscription.
3131

3232
## Scenario description
3333

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

36-
* AWS IAM Identity Center supports **SP and IDP** initiated SSO.
36+
* AWS Single Sign-On supports **SP and IDP** initiated SSO.
3737

38-
* AWS IAM Identity Center supports [**Automated user provisioning**](./aws-single-sign-on-provisioning-tutorial.md).
38+
* AWS Single Sign-On supports [**Automated user provisioning**](./aws-single-sign-on-provisioning-tutorial.md).
3939

40-
## Add AWS IAM Identity Center from the gallery
40+
## Add AWS Single Sign-On from the gallery
4141

42-
To configure the integration of AWS IAM Identity Center into Azure AD, you need to add AWS IAM Identity Center from the gallery to your list of managed SaaS apps.
42+
To configure the integration of AWS Single Sign-On into Azure AD, you need to add AWS Single Sign-On from the gallery to your list of managed SaaS apps.
4343

4444
1. Sign in to the Azure portal using either a work or school account, or a personal Microsoft account.
4545
1. On the left navigation pane, select the **Azure Active Directory** service.
4646
1. Navigate to **Enterprise Applications** and then select **All Applications**.
4747
1. To add new application, select **New application**.
48-
1. In the **Add from the gallery** section, type **AWS IAM Identity Center** in the search box.
49-
1. Select **AWS IAM Identity Center** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
48+
1. In the **Add from the gallery** section, type **AWS Single Sign-On** in the search box.
49+
1. Select **AWS Single Sign-On** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
5050

51-
## Configure and test Azure AD SSO for AWS IAM Identity Center
51+
## Configure and test Azure AD SSO for AWS Single Sign-On
5252

53-
Configure and test Azure AD SSO with AWS IAM Identity Center 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 AWS IAM Identity Center.
53+
Configure and test Azure AD SSO with AWS Single Sign-On 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 AWS Single Sign-On.
5454

55-
To configure and test Azure AD SSO with AWS IAM Identity Center, perform the following steps:
55+
To configure and test Azure AD SSO with AWS Single Sign-On, perform the following steps:
5656

5757
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** - to enable your users to use this feature.
5858
1. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with B.Simon.
5959
1. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable B.Simon to use Azure AD single sign-on.
60-
1. **[Configure AWS IAM Identity Center SSO](#configure-aws-iam-identity-center-sso)** - to configure the single sign-on settings on application side.
61-
1. **[Create AWS IAM Identity Center test user](#create-aws-iam-identity-center-test-user)** - to have a counterpart of B.Simon in AWS IAM Identity Center that is linked to the Azure AD representation of user.
60+
1. **[Configure AWS Single Sign-On SSO](#configure-aws-single-sign-on-sso)** - to configure the single sign-on settings on application side.
61+
1. **[Create AWS Single Sign-On test user](#create-aws-single-sign-on-test-user)** - to have a counterpart of B.Simon in AWS Single Sign-On that is linked to the Azure AD representation of user.
6262
1. **[Test SSO](#test-sso)** - to verify whether the configuration works.
6363

6464
## Configure Azure AD SSO
6565

6666
Follow these steps to enable Azure AD SSO in the Azure portal.
6767

68-
1. In the Azure portal, on the **AWS IAM Identity Center** application integration page, find the **Manage** section and select **single sign-on**.
68+
1. In the Azure portal, on the **AWS Single Sign-On** application integration page, find the **Manage** section and select **single sign-on**.
6969
1. On the **Select a single sign-on method** page, select **SAML**.
7070
1. On the **Set up single sign-on with SAML** page, click the pencil icon for **Basic SAML Configuration** to edit the settings.
7171

@@ -75,7 +75,7 @@ Follow these steps to enable Azure AD SSO in the Azure portal.
7575

7676
a. Click **Upload metadata file**.
7777

78-
b. Click on **folder logo** to select metadata file which is explained to download in **[Configure AWS IAM Identity Center SSO](#configure-aws-iam-identity-center-sso)** section and click **Add**.
78+
b. Click on **folder logo** to select metadata file, which is explained to download in **[Configure AWS Single Sign-On SSO](#configure-aws-single-sign-on-sso)** section and click **Add**.
7979

8080
![image2](common/browse-upload-metadata.png)
8181

@@ -101,20 +101,20 @@ Follow these steps to enable Azure AD SSO in the Azure portal.
101101
`https://portal.sso.<REGION>.amazonaws.com/saml/assertion/<ID>`
102102

103103
> [!NOTE]
104-
> These values are not real. Update these values with the actual Identifier, Reply URL and Sign-on URL. Contact [AWS IAM Identity Center 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.
104+
> These values are not real. Update these values with the actual Identifier, Reply URL and Sign-on URL. Contact [AWS Single Sign-On 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.
105105

106-
1. AWS IAM Identity Center 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.
106+
1. AWS Single Sign-On 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.
107107

108108
![image](common/edit-attribute.png)
109109

110110
> [!NOTE]
111-
> If ABAC is enabled in AWS IAM Identity Center, the additional attributes may be passed as session tags directly into AWS accounts.
111+
> If ABAC is enabled in AWS Single Sign-On, the additional attributes may be passed as session tags directly into AWS accounts.
112112

113113
1. 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.
114114

115115
![The Certificate download link](common/certificatebase64.png)
116116

117-
1. On the **Set up AWS IAM Identity Center** section, copy the appropriate URL(s) based on your requirement.
117+
1. On the **Set up AWS Single Sign-On** section, copy the appropriate URL(s) based on your requirement.
118118

119119
![Copy configuration URLs](common/copy-configuration-urls.png)
120120

@@ -132,35 +132,35 @@ In this section, you'll create a test user in the Azure portal called B.Simon.
132132

133133
### Assign the Azure AD test user
134134

135-
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to AWS IAM Identity Center.
135+
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to AWS Single Sign-On.
136136

137137
1. In the Azure portal, select **Enterprise Applications**, and then select **All applications**.
138-
1. In the applications list, select **AWS IAM Identity Center**.
138+
1. In the applications list, select **AWS Single Sign-On**.
139139
1. In the app's overview page, find the **Manage** section and select **Users and groups**.
140140
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
141141
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.
142142
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.
143143
1. In the **Add Assignment** dialog, click the **Assign** button.
144144

145-
## Configure AWS IAM Identity Center SSO
145+
## Configure AWS Single Sign-On SSO
146146

147-
1. To automate the configuration within AWS IAM Identity Center, you need to install **My Apps Secure Sign-in browser extension** by clicking **Install the extension**.
147+
1. To automate the configuration within AWS Single Sign-On, you need to install **My Apps Secure Sign-in browser extension** by clicking **Install the extension**.
148148

149149
![My apps extension](common/install-myappssecure-extension.png)
150150

151-
2. After adding extension to the browser, click on **Set up AWS IAM Identity Center** will direct you to the AWS IAM Identity Center application. From there, provide the admin credentials to sign into AWS IAM Identity Center. The browser extension will automatically configure the application for you and automate steps 3-10.
151+
2. After adding extension to the browser, click on **Set up AWS Single Sign-On** will direct you to the AWS Single Sign-On application. From there, provide the admin credentials to sign into AWS Single Sign-On. The browser extension will automatically configure the application for you and automate steps 3-10.
152152

153153
![Setup configuration](common/setup-sso.png)
154154

155-
3. If you want to setup AWS IAM Identity Center manually, in a different web browser window, sign in to your AWS IAM Identity Center company site as an administrator.
155+
3. If you want to setup AWS Single Sign-On manually, in a different web browser window, sign in to your AWS Single Sign-On company site as an administrator.
156156

157-
1. Go to the **Services -> Security, Identity, & Compliance -> AWS IAM Identity Center**.
157+
1. Go to the **Services -> Security, Identity, & Compliance -> AWS Single Sign-On**.
158158
2. In the left navigation pane, choose **Settings**.
159-
3. On the **Settings** page, find **Identity source**, click on **Actions** pull-down menu, and select Change **identity source**.
159+
3. On the **Settings** page, find **Identity source** and click on **Change**.
160160

161161
![Screenshot for Identity source change service](./media/aws-single-sign-on-tutorial/settings.png)
162162

163-
4. On the Change identity source page, choose **External identity provider**.
163+
4. On the Change identity source, choose **External identity provider**.
164164

165165

166166
![Screenshot for selecting external identity provider section](./media/aws-single-sign-on-tutorial/external-identity-provider.png)
@@ -170,11 +170,11 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
170170

171171
![Screenshot for download and upload metadata section](./media/aws-single-sign-on-tutorial/upload-metadata.png)
172172

173-
a. In the **Service provider metadata** section, find **AWS SSO SAML metadata**, select **Download metadata file** to download the metadata file and save it on your computer and use this metadata file to upload on Azure portal.
173+
a. In the **Service provider metadata** section, find **AWS SSO SAML metadata** and select **Download metadata file** to download the metadata file and save it on your computer and use this metadata file to upload on Azure portal.
174174

175-
b. Copy **AWS access portal sign-in URL** value, paste this value into the **Sign on URL** text box in the **Basic SAML Configuration section** in the Azure portal.
175+
b. Copy **AWS SSO Sign-in URL** value, paste this value into the **Sign on URL** text box in the **Basic SAML Configuration section** in the Azure portal.
176176

177-
c. In the **Identity provider metadata** section, select **Choose file** to upload the metadata file which you have downloaded from the Azure portal.
177+
c. In the **Identity provider metadata** section, choose **Browse** to upload the metadata file, which you have downloaded from the Azure portal.
178178

179179
d. Choose **Next: Review**.
180180

@@ -184,9 +184,9 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
184184

185185
9. Click **Change identity source**.
186186

187-
### Create AWS IAM Identity Center test user
187+
### Create AWS Single Sign-On test user
188188

189-
1. Open the **AWS IAM Identity Center console**.
189+
1. Open the **AWS SSO console**.
190190

191191
2. In the left navigation pane, choose **Users**.
192192

@@ -198,22 +198,22 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
198198

199199
b. In the **Email address** field, enter the `[email protected]`. For example, `[email protected]`.
200200

201-
c. In the **Confirm email address** field, re-enter the email address from the previous step.
201+
c. In the **Confirm email address** field, reenter the email address from the previous step.
202202

203203
d. In the First name field, enter `Jane`.
204204

205205
e. In the Last name field, enter `Doe`.
206206

207207
f. In the Display name field, enter `Jane Doe`.
208208

209-
g. Choose **Next**, and then **Next** again.
209+
g. Choose **Next: Groups**.
210210

211211
> [!NOTE]
212-
> Make sure the username entered in AWS IAM Identity Center matches the user’s Azure AD sign-in name. This will you help avoid any authentication problems.
212+
> Make sure the username entered in AWS SSO matches the user’s Azure AD sign-in name. This will you help avoid any authentication problems.
213213
214214
5. Choose **Add user**.
215215
6. Next, you will assign the user to your AWS account. To do so, in the left navigation pane of the
216-
AWS IAM Identity Center console, choose **AWS accounts**.
216+
AWS SSO console, choose **AWS accounts**.
217217
7. On the AWS Accounts page, select the AWS organization tab, check the box next to the AWS
218218
account you want to assign to the user. Then choose **Assign users**.
219219
8. On the Assign Users page, find and check the box next to the user B.Simon. Then choose **Next:
@@ -224,28 +224,28 @@ permission set**.
224224

225225
> [!NOTE]
226226
> Permission sets define the level of access that users and groups have to an AWS account. To learn more
227-
about permission sets, see the **AWS IAM Identity Center Multi Account Permissions** page.
227+
about permission sets, see the AWS SSO **Permission Sets** page.
228228
10. Choose **Finish**.
229229

230230
> [!NOTE]
231-
> AWS IAM Identity Center also supports automatic user provisioning, you can find more details [here](./aws-single-sign-on-provisioning-tutorial.md) on how to configure automatic user provisioning.
231+
> AWS Single Sign-On also supports automatic user provisioning, you can find more details [here](./aws-single-sign-on-provisioning-tutorial.md) on how to configure automatic user provisioning.
232232
233233
## Test SSO
234234

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

237237
#### SP initiated:
238238

239-
* Click on **Test this application** in Azure portal. This will redirect to AWS IAM Identity Center sign-in URL where you can initiate the login flow.
239+
* Click on **Test this application** in Azure portal. This will redirect to AWS Single Sign-On sign-in URL where you can initiate the login flow.
240240

241-
* Go to AWS IAM Identity Center sign-in URL directly and initiate the login flow from there.
241+
* Go to AWS Single Sign-On sign-in URL directly and initiate the login flow from there.
242242

243243
#### IDP initiated:
244244

245-
* Click on **Test this application** in Azure portal and you should be automatically signed in to the AWS IAM Identity Center for which you set up the SSO.
245+
* Click on **Test this application** in Azure portal and you should be automatically signed in to the AWS Single Sign-On for which you set up the SSO.
246246

247-
You can also use Microsoft My Apps to test the application in any mode. When you click the AWS IAM Identity Center 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 AWS IAM Identity Center 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).
247+
You can also use Microsoft My Apps to test the application in any mode. When you click the AWS Single Sign-On 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 AWS Single Sign-On 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).
248248

249249
## Next steps
250250

251-
Once you configure AWS IAM Identity Center 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 Defender for Cloud Apps](/cloud-app-security/proxy-deployment-any-app).
251+
Once you configure AWS Single Sign-On 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 Defender for Cloud Apps](/cloud-app-security/proxy-deployment-any-app).
1.58 KB
Loading
-28.7 KB
Loading
-5.17 KB
Loading
44 KB
Loading

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,7 @@
237237
href: awarego-tutorial.md
238238
- name: AWS ClientVPN
239239
href: aws-clientvpn-tutorial.md
240-
- name: AWS IAM Identity Center
240+
- name: AWS Single Sign-On
241241
href: aws-single-sign-on-tutorial.md
242242
- name: Axiad Cloud
243243
href: axiad-cloud-tutorial.md

0 commit comments

Comments
 (0)