aws-cognito-idp
Manage user pools for authentication and user directories.
TLDR
Create a new user pool
SYNOPSIS
aws cognito-idp command [options]
DESCRIPTION
aws cognito-idp is the AWS CLI interface for Amazon Cognito User Pools, a user directory service for web and mobile app authentication. It handles user registration, authentication, account recovery, and integration with external identity providers like Google, Facebook, and SAML-based systems.
Cognito User Pools provides features including multi-factor authentication, password policies, email/SMS verification, and OAuth 2.0 token issuance. It can be used for both server-side administration and client-side user flows.
COMMANDS
create-user-pool
Create a new user pooladmin-create-user
Create a user as an administratoradmin-delete-user
Delete a user from the poollist-users
List users in a user pooladmin-initiate-auth
Start server-side authenticationadmin-respond-to-auth-challenge
Respond to authentication challenges (MFA, new password)admin-set-user-password
Set or reset a user's passwordcreate-group
Create a user groupadmin-add-user-to-group
Add a user to a groupcreate-user-pool-client
Create an app client for authentication
CAVEATS
User pool configuration cannot be changed after creation for some settings like username attributes. Tokens issued by Cognito have a maximum lifetime of 24 hours for access tokens. Custom authentication lambdas add latency to sign-in flows. SMS-based MFA incurs additional SNS charges.
HISTORY
Amazon Cognito User Pools launched in July 2016 as a managed user directory. It built upon Cognito Identity (federated identities) which launched in 2014. Advanced security features including adaptive authentication were added in 2017, and WebAuthn/passkey support was introduced in 2023.
SEE ALSO
aws(1), aws-cognito-identity(1), aws-iam(1)
