Como gerenciar e pesquisar contas de usuários - Amazon Cognito
Como visualizar atributos do usuárioComo redefinir uma senha do usuárioComo pesquisar atributos de usuáriosPesquisando usuários com o AWS Management ConsolePesquisando usuários com o ListUsers APIExemplos de uso do ListUsers API

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como gerenciar e pesquisar contas de usuários

Os grupos de usuários podem conter milhões de usuários. Trabalhar com um conjunto de dados desse tamanho é um desafio para os administradores. O Amazon Cognito tem ferramentas para encontrar e modificar perfis de usuário. Os principais métodos para encontrar usuários são a guia Usuários do console do Amazon Cognito e com. ListUsers Dos métodos que recuperam informações sobre usuários, essas são as opções que não têm um impacto nos custos, ao contrário de, por exemplo, AdminGetUser.

Esta seção do guia tem informações sobre como encontrar e atualizar perfis de usuário em um grupo de usuários.

Como visualizar atributos do usuário

Siga o procedimento abaixo para visualizar atributos do usuário no console do Amazon Cognito.

Para visualizar atributos do usuário

  1. Acesse o console do Amazon Cognito. Se solicitado, insira suas AWS credenciais.

  2. Escolha User Pools (Grupos de usuários).

  3. Escolha um grupo de usuários existente da lista.

  4. Selecione a guia Users (Usuários) e, em seguida, escolha um usuário na lista.

  5. Na página de detalhes do usuário, em User attributes (Atributos do usuário), você pode ver quais atributos estão associados ao usuário.

Como redefinir uma senha do usuário

Siga o procedimento abaixo para redefinir uma senha do usuário no console do Amazon Cognito.

Para redefinir uma senha do usuário

  1. Acesse o console do Amazon Cognito. Se solicitado, insira suas AWS credenciais.

  2. Escolha User Pools (Grupos de usuários).

  3. Escolha um grupo de usuários existente da lista.

  4. Selecione a guia Users (Usuários) e, em seguida, escolha um usuário na lista.

  5. Na página de detalhes do usuário, escolha Actions (Ações), Reset password (Redefinir senha).

  6. Na caixa de diálogo Reset password (Redefinir senha), leia as informações e, quando estiver pronto, escolha Reset (Redefinir).

    Essa ação resulta imediatamente no envio de um código de confirmação para o usuário e desabilita a senha atual do usuário, ao alterar o estado do usuário para RESET_REQUIRED. O código Reset password (Redefinir senha) é válido por 1 hora.

Como pesquisar atributos de usuários

Se você já tiver criado um grupo de usuários, poderá pesquisar no painel Users (Usuários) no AWS Management Console. Você também pode usar o Amazon Cognito ListUsers API, que aceita um parâmetro Filter.

Você pode pesquisar qualquer um dos seguintes atributos padrão. Atributos personalizados não podem ser pesquisados.

  • username (diferencia maiúsculas de minúsculas)

  • e-mail

  • phone_number

  • name

  • given_name

  • family_name

  • preferred_username

  • cognito: user_status (chamado Status no console) (diferencia maiúsculas de minúsculas)

  • status (chamado Enabled (Habilitado) no console) (diferencia maiúsculas de minúsculas)

  • sub

nota

Você também pode listar usuários usando um filtro no lado do cliente. O filtro no lado do servidor não encontra correspondência com mais de um atributo. Para pesquisa avançada, use um filtro no lado do cliente com o parâmetro --query da ação list-users na AWS Command Line Interface. Quando você usa um filtro do lado do cliente, ListUsers retorna uma lista paginada de zero ou mais usuários. Você pode receber várias páginas consecutivas com zero resultados. Repita a consulta com cada token de paginação retornado até que você receba um valor de token de paginação nulo, em seguida, revise o resultado combinado.

Para obter mais informações sobre filtragem do lado do servidor e do lado do cliente, consulte AWS CLI Filtragem de saída no Guia do usuário. AWS Command Line Interface

Pesquisando usuários com o AWS Management Console

Se você já tiver criado um grupo de usuários, poderá pesquisar no painel Users (Usuários) no AWS Management Console.

AWS Management Console as pesquisas são sempre pesquisas com prefixo (“começa com”).

Para pesquisar um usuário no console do Amazon Cognito

  1. Acesse o console do Amazon Cognito. Você pode ser solicitado a fornecer suas AWS credenciais.

  2. Escolha User Pools (Grupos de usuários).

  3. Escolha um grupo de usuários existente da lista.

  4. Escolha a guia Users (Usuários) e insira o nome de usuário do usuário no campo de pesquisa. Observe que alguns valores de atributo diferenciam maiúsculas de minúsculas (por exemplo, Username).

    Você também pode encontrar usuários ajustando o filtro de pesquisa para restringir o escopo para outras propriedades do usuário, como Email (E-mail), Phone number (Número de telefone) ou Last name (Sobrenome).

Pesquisando usuários com o ListUsers API

Para pesquisar usuários do seu aplicativo, use o Amazon Cognito ListUsers API. Isso API usa os seguintes parâmetros:

  • AttributesToGet: uma matriz de strings, onde cada string é o nome de um atributo de usuário a ser retornados para cada usuário nos resultados da pesquisa. Para recuperar todos os atributos, não inclua o parâmetro AttributesToGet nem a solicitação AttributesToGet com um valor da string literal null.

  • Filter: uma string de filtro do formulário "AttributeName Filter-Type "AttributeValue"". Aspas dentro da string de filtro devem ser evitadas usando o caractere de barra invertida (\). Por exemplo, "family_name = \"Reddy\"". Se a string de filtro estiver vazia, ListUsers retorna todos os usuários no grupo de usuários.

    • AttributeName: o nome do atributo a ser pesquisado. Você só pode pesquisar um atributo por vez.

      nota

      Você só pode pesquisar atributos padrão. Atributos personalizados não podem ser pesquisados. Isso é porque somente atributos indexados são pesquisáveis, e atributos personalizados não podem ser indexados.

    • Filter-Type: para obter uma correspondência exata, use =, por exemplo, given_name = "Jon". Para uma correspondência de prefixo ("começa com"), use ^=, por exemplo, given_name ^= "Jon".

    • AttributeValue: o valor de atributo que deve ser correspondido por cada usuário.

  • Limit: o número máximo de usuários a serem retornados.

  • PaginationToken: um token para obter mais resultados de uma pesquisa anterior. O Amazon Cognito encerra a validade do token de paginação após uma hora.

  • UserPoolId: a ID de grupo de usuários para o grupo de usuários na qual a pesquisa deve ser realizada.

Todas as pesquisas diferenciam maiúsculas de minúsculas. Os resultados da pesquisa são classificados pelo atributo nomeado pela string AttributeName, em ordem ascendente.

Exemplos de uso do ListUsers API

O exemplo a seguir retorna todos os usuários e inclui todos os atributos.


{
    "AttributesToGet": null,
    "Filter": "",
    "Limit": 10,
    "UserPoolId": "us-east-1_samplepool"
}

O exemplo a seguir retorna todos os usuários cujos números de telefone começam com "+1312" e inclui todos os atributos.


{
    "AttributesToGet": null,
    "Filter": "phone_number ^= \"+1312\"",
    "Limit": 10,
    "UserPoolId": "us-east-1_samplepool"
}

O exemplo a seguir retorna os primeiros 10 usuários que têm "Reddy" como sobrenome. Para cada usuário, os resultados da pesquisa incluem nome do usuário, número de telefone e endereço de e-mail. Se houver mais de 10 usuários correspondentes no grupo de usuários, a resposta incluirá um token de paginação.

{
    "AttributesToGet": [
        "given_name", 
        "phone_number", 
        "email"
    ],
    "Filter": "family_name = \"Reddy\"",
    "Limit": 10,
    "UserPoolId": "us-east-1_samplepool"
}

Se o exemplo anterior retornar um token de paginação, o exemplo a seguir retornará os próximos 10 usuários que correspondam à mesma string de filtro.

{
    "AttributesToGet": [
        "given_name", 
        "phone_number", 
        "email"
    ],
    "Filter": "family_name = \"Reddy\"",
    "Limit": 10,
    "PaginationToken": "pagination_token_from_previous_search",
    "UserPoolId": "us-east-1_samplepool"
}