Amazon Cognito 无密码认证项目教程

武允倩

于 2024-09-13 07:47:52 发布

阅读量903

点赞数 11

本文链接：https://blog.csdn.net/gitblog_00049/article/details/142193616

版权

Amazon Cognito 无密码认证项目教程

amazon-cognito-passwordless-auth Passwordless authentication with Amazon Cognito: FIDO2 (WebAuthn, support for Passkeys), Magic Link, SMS OTP Step Up 项目地址: https://gitcode.com/gh_mirrors/am/amazon-cognito-passwordless-auth

1. 项目介绍

1.1 项目概述

amazon-cognito-passwordless-auth 是一个开源项目，旨在通过 Amazon Cognito 实现无密码认证。该项目提供了多种无密码认证方式，包括 FIDO2（WebAuthn，支持 Passkeys）、Magic Link 和 SMS OTP Step Up。这些方法通过自定义认证流程来增强安全性，减少用户摩擦，并提供更好的用户体验。

1.2 主要功能

FIDO2: 支持 WebAuthn，允许用户使用面部识别、指纹、YubiKey 等方式进行认证。
Magic Link: 通过发送一次性使用的秘密链接进行认证。
SMS OTP Step Up: 允许已登录用户通过 SMS 一次性密码（OTP）再次验证身份。

1.3 适用场景

该项目适用于需要提高用户认证安全性和用户体验的客户面向应用程序。通过 Amazon Cognito 的自定义认证流程，开发者可以轻松扩展认证因素，满足不同应用场景的需求。

2. 项目快速启动

2.1 环境准备

安装 Node.js 和 npm。
安装 AWS CDK（Cloud Development Kit）。

2.2 安装项目

git clone https://github.com/aws-samples/amazon-cognito-passwordless-auth.git
cd amazon-cognito-passwordless-auth
npm install

2.3 配置和部署

import * as cdk from "aws-cdk-lib";
import { Construct } from "constructs";
import { Passwordless } from "amazon-cognito-passwordless-auth/cdk";

class SampleTestStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    const passwordless = new Passwordless(this, "Passwordless", {
      userPool: yourUserPool, // 可选，如果不提供将自动创建 Amazon Cognito User Pool
      allowedOrigins: ["http://localhost:5173"], // 指定所有暴露 Web 应用的 URL
      magicLink: {
        sesFromAddress: "no-reply@auth.example.com" // 必须是 Amazon SES 中验证过的域名或身份
      },
      fido2: {
        allowedRelyingPartyIds: ["localhost"] // 指定希望用作 Relying Party ID 的域名
      },
      smsOtpStepUp: [] // 如果不需要 SMS OTP Step Up 认证，可以省略此项
    });

    new cdk.CfnOutput(this, "ClientId", {
      value: passwordless.userPoolClients.at(0).userPoolClientId
    });

    new cdk.CfnOutput(this, "Fido2Url", {
      value: passwordless.fido2Api.url
    });
  }
}