AWS Security ChangesHomeSearch

AWS singlesignon medium security documentation change

Service: singlesignon · 2025-05-10 · Security-related medium

File: singlesignon/latest/userguide/howtosignin.md

Summary

Expanded documentation for AWS access portal sign-in process, added prerequisites for IAM Identity Center, and emphasized using administrative credentials instead of root/IAM users

Security assessment

Added explicit recommendation to use IAM Identity Center administrative credentials instead of root/IAM user credentials for admin tasks, with a warning to safeguard root credentials. This addresses security best practices for credential management and privilege separation.

Diff

diff --git a/singlesignon/latest/userguide/howtosignin.md b/singlesignon/latest/userguide/howtosignin.md
index 2a28bdbc5..293d3dc71 100644
--- a//singlesignon/latest/userguide/howtosignin.md
+++ b//singlesignon/latest/userguide/howtosignin.md
@@ -5 +5 @@
-Trusted devicesSign in tips for the AWS access portalSigning out of the AWS access portal
+Sign in to the AWS access portalTrusted devicesSign in tips for the AWS access portalSigning out of the AWS access portal
@@ -9 +9,5 @@ Trusted devicesSign in tips for the AWS access portalSigning out of the AWS acce
-By this time, you should have been provided a specific sign-in URL to the AWS access portal by an administrator. Once you have this URL, you can proceed with signing in to the portal. For more information, see [Sign in to the AWS access portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html).
+The AWS access portal provides IAM Identity Center users with single sign-on access to all their assigned AWS accounts and applications through a web portal. The following outlines how you can sign in to the AWS access portal, tips for signing in, and how to sign out of the AWS access portal. To learn how to sign in the AWS access portal as an IAM Identity Center user, see [Sign in to the AWS access portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) in the _AWS Sign-in Guide_.
+
+###### Prerequisites
+
+IAM Identity Center needs to be enabled to use the AWS access portal. For more information, see [Enable IAM Identity Center](./enable-identity-center.html)
@@ -14,0 +19,43 @@ After you sign in, the default duration for your AWS access portal session is 8
+## Sign in to the AWS access portal
+
+The following steps are for IAM Identity Center administrator to confirm that the IAM Identity Center user can sign in to the AWS access portal and access the AWS account.
+
+###### Sign in to the AWS access portal
+
+  1. Do either of the following to sign in to the AWS Management Console.
+
+     * **New to AWS (root user)** – Sign in as the account owner by choosing **Root user** and entering your AWS account email address. On the next page, enter your password.
+
+     * **Already using AWS (IAM credentials)** – Sign in with your IAM credentials and select an admin role.
+
+  2. Open the [IAM Identity Center console](https://console.aws.amazon.com/singlesignon).
+
+  3. In the navigation pane, choose **Dashboard**.
+
+  4. On the **Dashboard** page, under **Settings summary** , choose the AWS access portal URL.
+
+  5. Sign in by using either of the following:
+
+     * If you're using Active Directory or an external identity provider (IdP) as your identity source, sign in by using the credentials of the Active Directory or IdP user.
+
+     * If you're using the default Identity Center directory as your identity source, sign in by using the username that you specified when you created the user and the new password that you specified for the user.
+
+  6. In the **Accounts** tab, locate your AWS account and expand it.
+
+  7. The roles available to you are displayed. For example, if you're assigned both the **AdministratorAccess** permission set and **Billing** permissions sets, those roles are displayed in the AWS access portal. Choose the IAM role name you want to use for the session.
+
+  8. If you're redirected to the AWS Management Console you successfully finished setting up access to the AWS account.
+
+###### Note
+
+If you don't see any **AWS accounts** listed, it's likely that the user hasn't yet been assigned to a permission set for that account. For instructions on assigning users to a permission set, see [Assign user or group access to AWS accounts](./assignusers.html).
+
+
+
+
+Now that you've confirmed that you can sign in using IAM Identity Center credentials, switch to the browser that you used to sign into the AWS Management Console and sign out from your root user or IAM user credentials. 
+
+###### Important
+
+We strongly recommend that you use the credentials of the IAM Identity Center administrative user when you sign in to the AWS access portal to perform administrative tasks instead of using IAM user or root user credentials. Safeguard your root user credentials and use them to perform the tasks that only the root user can perform. To enable other users to access your accounts and applications, and to administer IAM Identity Center, create and assign permission sets only through IAM Identity Center.
+