使用 Amazon Cognito 配置 SSO
OpenID Connect(OIDC) 为 OAuth 2.0 增加身份层,使应用可以验证最终用户身份,并从身份提供商(IdP)获取基本资料。在单点登录(SSO)部署中,用户通过 IdP 完成身份认证后即可访问关联应用,无需分别登录每个应用。
Amazon Cognito 是 AWS 提供的托管身份服务。Cognito 用户池提供用户目录、OIDC 授权服务器和托管登录页面。在本集成中,Apache APISIX 会先将浏览器身份认证委托给 Cognito,再把请求代理到上游服务。
本指南介绍如何创建 Cognito 用户池和 Web 应用客户端,然后为使用代码交换证明密钥(PKCE)的 OIDC 授权码流程配置 APISIX。当请求没有有效的 APISIX 会话时,APISIX 会将浏览器重定向到 Cognito。身份认证成功后,APISIX 会用授权码换取 Token、创建浏览器会话并继续处理原始请求。
前置条件
- 安装 Docker。
- 安装 cURL 和 OpenSSL。
- 按照入门指南使用 Docker 启动 APISIX。
- 拥有 AWS 账户,并具有管理 Amazon Cognito 用户池和应用客 户端的权限。
- 如果计划使用 ADC,请先安装并配置 ADC。
- 如果使用 Admin API 示例且启用了身份验证,请将管理员角色的密钥导出为
ADMIN_API_KEY。请在deployment.admin.admin_key下配置该密钥。Docker 快速入门为了便于本地评估而禁用了身份验证;生产环境中请保持启用。
配置 Amazon Cognito
为浏览器身份认证流程创建用户池、Web 应用客户端和测试用户。
创建用户池和 Web 应用客户端
登录 AWS 管理控制台,然后打开 Amazon Cognito → User pools。创建用户目录和应用:
- 选择 Create user pool。
- 选择 Traditional web application 作为应用类型。
- 输入
APISIX Authorization Code作为应用名称。 - 在 Options for sign-in identifiers 下选择 Email。
- 除非要允许用户自行创建账户,否则清除 Enable self-registration。
- 输入
http://localhost:9080/anything/user/callback作为返回 URL。 - 选择 Create user directory。
Cognito 会创建用户池、机密应用客户端、用户池 Domain 和托管登录页面。返回 URL 标识 Cognito 完成身份认证后将浏览器发送到的 APISIX 端点。生产环境应使用用户可访问的 HTTPS 端点,并在 Cognito 中注册完全相同的 URL。
在新应用客户端的 Login pages 标签页中,确认 Authorization code grant 是唯一的 OAuth Grant Type,并且允许的 Callback URL 与 APISIX 回调地址一致。

创建用户
创建一个可通过托管登录页面登录的用户:
- 在用户池中选择 User management → Users → Create user。
- 将 Invitation message 保持为不发送邀请的选项。
- 输入用户电子邮件地址,然后选择 Mark email address as verified。
- 设置符合用户池密码策略的临时密码。
- 选择 Create user。
用户首次登录时必须替换临时密码。
保存 OIDC 配置
在用户池 Overview 页面记录 User pool ID。在 Applications → App clients 下打开 APISIX Authorization Code,并记录其 Client ID 和 Client secret。