Como gerenciar e pesquisar contas de usuários

Depois de criar seu grupo de usuários, você pode visualizar e gerenciar usuários usando o AWS Management Console, bem como a AWS Command Line Interface ou a API do Amazon Cognito. Este tópico descreve como você pode visualizar e pesquisar usuários usando o AWS Management Console.

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 credenciais da AWS.

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 credenciais da AWS.

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 a API ListUsers do Amazon Cognito, que aceita um parâmetro Filter (Filtro).

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 no 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 mais informações sobre filtragem no lado do servidor e no lado do cliente, consulte Filtrar resultados da AWS CLI no Guia do usuário da AWS Command Line Interface.

Como pesquisar usuários usando 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.

Pesquisas do AWS Management Console são sempre pesquisas de prefixo ("começa com").

Para pesquisar um usuário no console do Amazon Cognito

1. Acesse o console do Amazon Cognito. Podem ser solicitadas suas credenciais da AWS.

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).

Pesquisar usuários usando o API ListUsers

Para pesquisar usuários da sua aplicação, use a API ListUsers do Amazon Cognito. Esta 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 da API ListUsers

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"
}