AWS res: Add optional Cognito user pool prerequisite
Summary
Adds an optional prerequisite for importing an existing Cognito user pool for user/client authentication, including required sign-up custom attributes (aws_region, cluster_name, password_last_set, password_max_age, uid).
Security assessment
Documents identity/authentication prerequisites (Cognito user pool and custom attributes such as password_last_set/password_max_age tied to password policy), which affect how users authenticate to RES.
Evidence
+You have the option to import an existing Cognito User Pool for user and client authentication when you install RES. Otherwise, RES will create a new Cognito User Pool automatically. The pre-existing User Pool needs to have the following sign-up custom attributes:
Diff
diff --git a/res/archive/release-minus-4/ug/prerequisites.md b/res/archive/release-minus-4/ug/prerequisites.md index eef5f3bb6..7973e97be 100644 --- a//res/archive/release-minus-4/ug/prerequisites.md +++ b//res/archive/release-minus-4/ug/prerequisites.md @@ -7 +7 @@ -Create an AWS account with an administrative userCreate an Amazon EC2 SSH key pairIncrease service quotasCreate a custom domain (optional)Create domain (GovCloud only)Provide external resourcesConfigure LDAPS in your environment (optional)Service Account for Microsoft Active DirectoryConfigure a private VPC (optional) +Create an AWS account with an administrative userCreate an Amazon EC2 SSH key pairIncrease service quotasCreate a Cognito user pool (Optional)Create a custom domain (optional)Create domain (GovCloud only)Provide external resourcesConfigure LDAPS in your environment (optional)Service Account for Microsoft Active DirectoryConfigure a private VPC (optional) @@ -18,0 +19,2 @@ Create an AWS account with an administrative userCreate an Amazon EC2 SSH key pa + * Create a Cognito user pool (Optional) + @@ -71,0 +74,12 @@ Your AWS account has default quotas, formerly referred to as limits, for each AW +## Create a Cognito user pool (Optional) + +You have the option to import an existing Cognito User Pool for user and client authentication when you install RES. Otherwise, RES will create a new Cognito User Pool automatically. The pre-existing User Pool needs to have the following sign-up custom attributes: + +Name | Type | Min value/length | Max value/length | Mutable +---|---|---|---|--- +custom:aws_region | String | | | TRUE +custom:cluster_name | String | | | TRUE +custom:password_last_set | Number | | | TRUE +custom:password_max_age | Number | | | TRUE +custom:uid | Number | 2000200001 | 4294967294 | TRUE + @@ -348 +362 @@ If you are setting up `http_proxy` and `https_proxy` environment variables, the - " > /etc/environment + " >> /etc/environment launch template