AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Container for the parameters to the AdminSetUserPassword operation.
Sets the specified user's password in a user pool. This operation administratively
sets a temporary or permanent password for a user. With this operation, you can bypass
self-service password changes and permit immediate sign-in with the password that
you set. To do this, set Permanent
to true
.
You can also set a new temporary password in this request, send it to a user, and
require them to choose a new password on their next sign-in. To do this, set Permanent
to false
.
If the password is temporary, the user's Status
becomes FORCE_CHANGE_PASSWORD
.
When the user next tries to sign in, the InitiateAuth
or AdminInitiateAuth
response includes the NEW_PASSWORD_REQUIRED
challenge. If the user doesn't
sign in before the temporary password expires, they can no longer sign in and you
must repeat this operation to set a temporary or permanent password for them.
After the user sets a new password, or if you set a permanent password, their status
becomes Confirmed
.
AdminSetUserPassword
can set a password for the user profile that Amazon Cognito
creates for third-party federated users. When you set a password, the federated user's
status changes from EXTERNAL_PROVIDER
to CONFIRMED
. A user in this state
can sign in as a federated user, and initiate authentication flows in the API like
a linked native user. They can also modify their password and attributes in token-authenticated
API requests like ChangePassword
and UpdateUserAttributes
. As a best
security practice and to keep users in sync with your external IdP, don't set passwords
on federated user profiles. To set up a federated user for native sign-in with a linked
native user, refer to Linking
federated users to an existing user profile.
Amazon Cognito evaluates Identity and Access Management (IAM) policies in requests for this API operation. For this operation, you must use IAM credentials to authorize requests, and you must grant yourself the corresponding IAM permission in a policy.
Learn more
Namespace: Amazon.CognitoIdentityProvider.Model
Assembly: AWSSDK.CognitoIdentityProvider.dll
Version: 3.x.y.z
public class AdminSetUserPasswordRequest : AmazonCognitoIdentityProviderRequest IAmazonWebServiceRequest
The AdminSetUserPasswordRequest type exposes the following members
Name | Description | |
---|---|---|
![]() |
AdminSetUserPasswordRequest() |
Name | Type | Description | |
---|---|---|---|
![]() |
Password | System.String |
Gets and sets the property Password. The new temporary or permanent password that you want to set for the user. You can't remove the password for a user who already has a password so that they can only sign in with passwordless methods. In this scenario, you must create a new user without a password. |
![]() |
Permanent | System.Boolean |
Gets and sets the property Permanent.
Set to |
![]() |
Username | System.String |
Gets and sets the property Username.
The name of the user that you want to query or modify. The value of this parameter
is typically your user's username, but it can be any of their alias attributes. If
|
![]() |
UserPoolId | System.String |
Gets and sets the property UserPoolId. The ID of the user pool where you want to set the user's password. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5