使用JavaScript SDK v3操作Amazon Cognito身份验证服务

最新推荐文章于 2025-06-04 09:09:45 发布

原创最新推荐文章于 2025-06-04 09:09:45 发布 · 260 阅读

CC 4.0 BY-SA版权

使用JavaScript SDK v3操作Amazon Cognito身份验证服务

前言

Amazon Cognito是AWS提供的一项用户身份验证和访问控制服务，它可以帮助开发者轻松地为Web和移动应用程序添加用户注册、登录和访问控制功能。本文将介绍如何使用AWS SDK for JavaScript (v3)来操作Amazon Cognito Identity Provider服务。

重要注意事项

在使用这些代码示例前，请注意以下几点：

费用问题：运行这些代码可能会在您的AWS账户中产生费用。AWS提供免费套餐，但超出部分将按标准费率计费。
权限最小化：为安全起见，建议遵循最小权限原则，只授予代码执行任务所需的最低权限。
区域限制：某些AWS服务并非在所有区域都可用，请确认您使用的区域支持Cognito服务。

准备工作

在开始之前，您需要：

安装Node.js环境（建议使用最新LTS版本）
配置AWS凭证，可以通过环境变量或共享凭证文件
安装AWS SDK for JavaScript v3

基础示例

入门示例

hello.js文件提供了一个最简单的Cognito操作示例，它会列出您账户中的所有用户池：

// 示例代码片段
import { CognitoIdentityProviderClient, ListUserPoolsCommand } from "@aws-sdk/client-cognito-identity-provider";

const client = new CognitoIdentityProviderClient({ region: "us-east-1" });
const command = new ListUserPoolsCommand({ MaxResults: 10 });
const response = await client.send(command);
console.log(response.UserPools);

运行方式：

node hello.js

常用操作示例

用户管理

创建用户 (sign-up.js)

// 创建新用户
const params = {
  ClientId: "your-app-client-id",
  Username: "username",
  Password: "securePassword123!",
  UserAttributes: [
    { Name: "email", Value: "user@example.com" }
  ]
};
await client.send(new SignUpCommand(params));

确认用户注册 (confirm-sign-up.js)

// 确认用户注册
await client.send(new ConfirmSignUpCommand({
  ClientId: "your-app-client-id",
  Username: "username",
  ConfirmationCode: "123456" // 用户收到的验证码
}));

获取用户信息 (admin-get-user.js)

// 管理员获取用户信息
const user = await client.send(new AdminGetUserCommand({
  UserPoolId: "your-user-pool-id",
  Username: "username"
}));

认证流程

初始化认证 (initiate-auth.js)

// 用户登录
const auth = await client.send(new InitiateAuthCommand({
  AuthFlow: "USER_PASSWORD_AUTH",
  ClientId: "your-app-client-id",
  AuthParameters: {
    USERNAME: "username",
    PASSWORD: "password"
  }
}));

多因素认证(MFA)响应 (respond-to-auth-challenge.js)

// 响应MFA挑战
const result = await client.send(new RespondToAuthChallengeCommand({
  ChallengeName: "SOFTWARE_TOKEN_MFA",
  ClientId: "your-app-client-id",
  Session: auth.Session,
  ChallengeResponses: {
    USERNAME: "username",
    SOFTWARE_TOKEN_MFA_CODE: "123456" // 用户MFA应用生成的代码
  }
}));