AWS Cognito管理员创建用户的临时密码验证与重置技术问询

嘿，我前阵子刚处理过Cognito管理员创建用户的密码重置问题，刚好能给你清晰的解决方案！不管你是用纯AWS SDK还是Amplify，都能轻松搞定，下面给你两种常用的实现方式：

首先得安装对应的SDK依赖：

npm install @aws-sdk/client-cognito-identity-provider

然后按照以下流程实现——核心是先发起认证触发NEW_PASSWORD_REQUIRED挑战，再提交新密码完成重置：

import { CognitoIdentityProviderClient, InitiateAuthCommand, RespondToAuthChallengeCommand } from "@aws-sdk/client-cognito-identity-provider";

// 初始化Cognito客户端
const cognitoClient = new CognitoIdentityProviderClient({ region: "你的AWS区域，比如us-east-1" });

async function resetTempPassword(username, tempPassword, newPassword) {
  try {
    // 第一步：用临时密码发起认证，获取挑战会话
    const initiateAuthParams = {
      AuthFlow: "USER_PASSWORD_AUTH",
      ClientId: "你的Cognito App Client ID",
      AuthParameters: {
        USERNAME: username,
        PASSWORD: tempPassword
      }
    };
    const authInitResponse = await cognitoClient.send(new InitiateAuthCommand(initiateAuthParams));

    // 第二步：响应NEW_PASSWORD_REQUIRED挑战，设置新密码
    if (authInitResponse.ChallengeName === "NEW_PASSWORD_REQUIRED") {
      const challengeParams = {
        ClientId: "你的Cognito App Client ID",
        ChallengeName: "NEW_PASSWORD_REQUIRED",
        Session: authInitResponse.Session, // 必须用上一步返回的会话值
        ChallengeResponses: {
          USERNAME: username,
          NEW_PASSWORD: newPassword
          // 如果你的用户池有必填的用户属性（比如邮箱、姓名），这里要补充，比如：
          // email: "user@example.com",
          // name: "张三"
        }
      };
      const finalResponse = await cognitoClient.send(new RespondToAuthChallengeCommand(challengeParams));
      console.log("密码重置成功！", finalResponse);
      // 这里可以拿到用户的ID Token、Access Token等凭证
    }
  } catch (error) {
    console.error("重置密码出错：", error);
  }
}

// 调用函数
resetTempPassword("admin创建的用户名", "平台生成的临时密码", "用户设置的新密码");

⚠️ 注意事项：

• 确保你的Cognito App Client已经开启了USER_PASSWORD_AUTH认证流程（在控制台的App Client设置里，找到“认证流程”选项勾选即可）
• 临时密码只能使用一次，成功设置新密码后就会失效
• 如果用户池配置了必填的自定义属性，一定要在ChallengeResponses里补充，否则会报错

如果是前端项目，用Amplify会更省心，它会自动处理会话、凭证存储等细节：

首先安装Amplify依赖：

npm install aws-amplify

先配置Amplify（如果还没配置的话）：

import { Amplify } from 'aws-amplify';
import { Auth } from 'aws-amplify';

Amplify.configure({
  Auth: {
    region: "你的AWS区域",
    userPoolId: "你的Cognito User Pool ID",
    userPoolWebClientId: "你的Cognito App Client ID"
  }
});

然后实现密码重置逻辑：

async function completeNewPasswordSetup(username, tempPassword, newPassword) {
  try {
    // 用临时密码登录，触发NEW_PASSWORD_REQUIRED挑战
    const user = await Auth.signIn(username, tempPassword);

    // 完成新密码设置
    if (user.challengeName === 'NEW_PASSWORD_REQUIRED') {
      const loggedInUser = await Auth.completeNewPassword(
        user,
        newPassword,
        // 如果有必填用户属性，这里传入，比如：{ email: 'user@example.com' }
        {}
      );
      console.log("密码设置成功，用户已自动登录：", loggedInUser);
    }
  } catch (error) {
    console.error("设置密码失败：", error);
  }
}

// 调用函数
completeNewPasswordSetup("admin创建的用户名", "平台生成的临时密码", "用户设置的新密码");

⚠️ 注意事项：

• 如果你的用户池有必填属性，completeNewPassword的第三个参数要传入对应的键值对
• Amplify会自动把用户凭证存在浏览器的本地存储里，方便后续请求使用

内容的提问来源于stack exchange，提问作者Harsh