如何使用 AWS Cognito 在 PHP 中实现安全验证

M66 2025-06-12

通过 AWS Cognito 实现 PHP 安全验证

AWS Cognito 是一个强大的身份验证和授权服务，能够帮助开发者轻松实现应用程序的用户管理和身份验证功能。在本文中，我们将展示如何使用 AWS Cognito 与 PHP 集成来实现安全验证功能，并通过代码示例详细讲解实现过程。

前提条件

在开始之前，确保您具备以下前提条件：

有一个有效的 AWS 账户并拥有 AWS CLI（命令行工具）访问权限；
已经配置并激活了 AWS Cognito 服务。

步骤1：创建用户池（User Pool）

首先，在 AWS Cognito 中创建一个用户池来存储和管理用户凭证。可以使用 AWS CLI 或 AWS 管理控制台来创建用户池。以下是使用 AWS CLI 创建用户池的示例命令：


aws cognito-idp create-user-pool --pool-name MyUserPool --auto-verified-attributes email --policies PasswordPolicies=RequiredLength=8,RequireUppercase=true,RequireLowercase=true,RequireNumbers=true,RequireSymbols=true --schema Name=email,AttributeDataType=Email:STRING,Required=true,Name=phone_number,AttributeDataType=Number:STRING,Required=false

此命令将创建名为 "MyUserPool" 的用户池，启用电子邮件验证，且密码需满足指定的规则。

步骤2：设置用户池客户端（User Pool Client）

接下来，为了让您的应用程序能够与 Cognito 用户池进行交互，您需要创建一个用户池客户端。这可以通过 AWS CLI 或管理控制台完成。以下是使用 AWS CLI 创建用户池客户端的示例命令：


aws cognito-idp create-user-pool-client --user-pool-id YOUR_USER_POOL_ID --client-name MyUserPoolClient --no-generate-secret --explicit-auth-flows ALLOW_REFRESH_TOKEN_AUTH --refresh-token-validity 30

此命令将创建名为 "MyUserPoolClient" 的用户池客户端，并允许通过刷新令牌进行身份验证，刷新令牌的有效期为30天。

步骤3：PHP 代码实现身份验证

现在，我们已经设置了用户池和客户端，接下来可以编写 PHP 代码来实现用户身份验证。首先，您需要引入 AWS SDK for PHP。可以通过 Composer 安装，或直接下载并引入 SDK 源代码。


require 'vendor/autoload.php'; // 引入 AWS SDK for PHP 的自动加载文件
use Aws\CognitoIdentityProvider\CognitoIdentityProviderClient;

接下来，配置 AWS Cognito 访问凭证。替换以下代码中的 `YOUR_USER_POOL_ID`、`YOUR_USER_POOL_CLIENT_ID` 和 `YOUR_AWS_REGION` 为您实际的值：


$poolId = 'YOUR_USER_POOL_ID';
$clientId = 'YOUR_USER_POOL_CLIENT_ID';
$region = 'YOUR_AWS_REGION';

然后，实例化 CognitoIdentityProviderClient 并配置凭证信息：


$client = new CognitoIdentityProviderClient([
    'version' => 'latest',
    'region' => $region
]);

$client->setCredentials([
    'key' => 'YOUR_AWS_ACCESS_KEY_ID',
    'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',
]);

进行身份验证

现在，您可以使用 Cognito 进行身份验证。以下代码片段展示了如何通过 AWS Cognito 进行身份验证：


$result = $client->adminInitiateAuth([
    'UserPoolId' => $poolId,
    'ClientId' => $clientId,
    'AuthFlow' => 'ADMIN_NO_SRP_AUTH',
    'AuthParameters' => [
        'USERNAME' => 'testuser@example.com',
        'PASSWORD' => 'P@ssw0rd'
    ]
]);

var_dump($result);

在上面的代码中，我们使用 `adminInitiateAuth` 方法进行身份验证。请替换 `'USERNAME'` 和 `'PASSWORD'` 为实际的用户名和密码。成功验证后，`$result` 将包含验证的结果。

结论

通过本文，我们了解了如何在 PHP 中集成 AWS Cognito 来实现安全的用户身份验证。通过创建用户池、设置客户端并使用 PHP 代码实现身份验证，我们能够为应用程序提供强大的用户管理功能。AWS Cognito 是一种简单而安全的解决方案，能够提升应用程序的安全性和可靠性。