CognitoIdentityProvider client

This page contains examples with the CognitoIdentityProvider client. See the client introduction for a more detailed description how to use a client. You may also want to consider the authentication documentation to understand the many ways you can authenticate with AWS.

The CognitoIdentityProvider package could be installed with Composer.

composer require async-aws/cognito-identity-provider

A new client object may be instantiated by:

use AsyncAws\CognitoIdentityProvider\CognitoIdentityProviderClient;

$cognitoIdentityProvider = new CognitoIdentityProviderClient();

The authentication parameters is read from the environment by default. You can also specify a AWS access id and secret:

use AsyncAws\CognitoIdentityProvider\CognitoIdentityProviderClient;

$cognitoIdentityProvider = new CognitoIdentityProviderClient([
    'accessKeyId' => 'my_access_key',
    'accessKeySecret' => 'my_access_secret',
    'region' => 'eu-central-1',
]);

For all available options, see the configuration reference.

Usage¶

Create a user as an admin¶

use AsyncAws\CognitoIdentityProvider\CognitoIdentityProviderClient;
use AsyncAws\CognitoIdentityProvider\ValueObject\AttributeType;

$cognitoIdp = new CognitoIdentityProviderClient();

$cognitoIdp->adminCreateUser([
    'UserPoolId' => 'us-east-1_1337oL33t',
    'Username' => '1c202820-8eb5-11ea-bc55-0242ac130003',
    'UserAttributes' => [
        new AttributeType(['Name' => 'phone_number', 'Value' => '+33600000000'])
    ],
]);

Get a user as an admin¶

use AsyncAws\CognitoIdentityProvider\CognitoIdentityProviderClient;
use AsyncAws\CognitoIdentityProvider\ValueObject\AttributeType;

$cognitoIdp = new CognitoIdentityProviderClient();

$result = $cognitoIdp->adminGetUser([
    'UserPoolId' => 'us-east-1_1337oL33t',
    'Username' => '1c202820-8eb5-11ea-bc55-0242ac130003',
    'UserAttributes' => [
        new AttributeType(['Name' => 'phone_number', 'Value' => '+33600000000'])
    ],
]);

echo 'User status is: ' . $result->getUserStatus() . PHP_EOL;
$givenNameAttribute = current(array_filter(
    $result->getUserAttributes(),
    function ($attr) { return $attr->getName() === 'given_name'; }
));
echo 'User given name is: ' . $givenNameAttribute->getValue() . PHP_EOL;

The source code to this page is found on GitHub.