README

使用JSON Web Tokens (JWT)通过Amazon Cognito启用Craft身份验证。

需求

此插件需要Craft CMS 3.3或更高版本。

要安装插件，请按照以下说明操作。

JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties.

此插件启用使用Amazon Cognito用户池登录Craft。使用Cognito JWT "隐式授权"（type=token）请求。

安装后，导航到插件的设置页面并输入所需设置以激活插件

设置	描述
`自动创建用户`	可选。激活后，当提供可验证的JWT时，将自动创建公共用户。
`禁用公共注册时自动创建用户`	可选。激活后，即使禁用公共注册，也会自动创建用户。
`默认用户组`	可选。设置要添加新创建用户的组。
`启用CP登录按钮`	可选。启用后，将在CP登录屏幕中添加一个按钮以使用Cognito登录。
`自定义登录按钮文本`	可选。用于覆盖登录Cognito按钮上的默认文本。
`自定义登录按钮URL`	可选。用于覆盖用于登录按钮的托管UI生成的URL。
`重定向URL`	可选。登录后用于重定向用户，默认为当前站点的基URL。
AWS设置
`用户池区域`	必需。用户池所在地的AWS区域。
`应用域`	可选。用于生成登录Cognito按钮的登录链接。
`应用客户端ID`	必需。用于生成登录链接，并验证JWT是否为正确的池创建。
`用户池ID`	必需。用于获取Cognito用于签署JWT的密钥。

Cognito用户池还需要配置以允许回调URL到您的站点。这是由插件生成的，并在插件设置页面的最后“设置”中显示。回调URL是“控制面板URL（通常是/admin）”/cognitologin。

配置用户池

插件将尝试验证控制面板 URL（通常是 /admin）的 /cognitologin 的传入请求中存在的 JWT。

插件将从 Cognito 获取 Json Web Token Set（JWKS），并使用它通过 PHP 的 lcobucci/jwt 包尝试验证令牌。该包遵循 IANA JWT 规范。

如果提供的令牌可以验证并且可以与具有与提供的 email 键匹配的电子邮件地址或与提供的 cognito:username 键匹配的用户名的用户账户匹配，则用户将被认证，请求将被允许继续。

如果令牌可验证，但不存在匹配的用户账户，但

在 Craft 设置中，将现场创建新的用户账户，然后新用户登录。

插件提供以下功能：

原始 JWT 认证由 Mike Pierce 编写，并由 Edenspiekermann 实现。由 Matthew Carter 转换为使用 Cognito JWTs 和验证流程。由 StructureIT 开发者维护。