Gestión y búsqueda de cuentas de usuario

Una vez que haya creado el grupo de usuarios, puede ver y administrar los usuarios con la AWS Management Console, la AWS Command Line Interface o la API de Amazon Cognito. En este tema se describe cómo puede ver y buscar usuarios con la AWS Management Console.

Visualización de atributos de los usuarios

Utilice el siguiente procedimiento para ver los atributos de los usuarios en la consola de Amazon Cognito.

Para ver los atributos de los usuarios

1. Vaya a la consola de Amazon Cognito. Si se le solicita, escriba sus credenciales de AWS.

2. ElegirUser Pools (Grupos de usuarios).

3. Elija en la lista un grupo de usuarios existente.

4. Elija la pestaña Users (Usuarios) y, a continuación, seleccione un usuario de la lista.

5. En la página de detalles de los usuarios, en User attributes (Atributos de usuario), puede ver qué atributos están asociados al usuario.

Restablecimiento de la contraseña de un usuario

Utilice el siguiente procedimiento para restablecer la contraseña de un usuario en la consola de Amazon Cognito.

Para restablecer la contraseña de un usuario

1. Vaya a la consola de Amazon Cognito. Si se le solicita, escriba sus credenciales de AWS.

2. ElegirUser Pools (Grupos de usuarios).

3. Elija en la lista un grupo de usuarios existente.

4. Elija la pestaña Users (Usuarios) y, a continuación, seleccione un usuario de la lista.

5. En la página de detalles de los usuarios, elija Actions (Acciones), Reset password (Restablecer contraseña).

6. En el cuadro de diálogo Reset password (Restablecer contraseña), compruebe la información y, cuando esté listo, elija Reset (Restablecer).

   Esta acción produce el envío inmediato de un código de confirmación al usuario y deshabilita la contraseña actual de este cambiando el estado del usuario a RESET_REQUIRED. El código de Reset password (Restablecer contraseña) es válido durante una hora.

Búsqueda de atributos de usuario

Si ya ha creado un grupo de usuarios, puede realizar búsquedas desde el panel Users (Usuarios) de la AWS Management Console. También puede utilizar la API ListUsers de Amazon Cognito, que acepta un parámetro Filter (Filtro).

Puede buscar cualquiera de los siguientes atributos estándar. No se pueden buscar los atributos personalizados.

• username (distingue entre mayúsculas y minúsculas)

• email

• phone_number

• nombre

• given_name

• family_name

• preferred_username

• cognito:user_status (denominado Status (Estado) en la consola) (no distingue entre mayúsculas y minúsculas)

• status (denominado Enabled (Habilitado) en la consola) (distingue entre mayúsculas y minúsculas)

• sub

nota

También puede listar usuarios con un filtro del lado del cliente. El filtro del lado del servidor no coincide con más de 1 atributo. Para la búsqueda avanzada, utilice un filtro del lado del cliente con el parámetro --query de la acción list-users en el AWS Command Line Interface. Cuando se utiliza un filtro del lado del cliente, ListUsers devuelve una lista paginada de cero o más usuarios. Puede recibir varias páginas seguidas sin resultados. Repita la consulta con cada token de paginación devuelto hasta recibir un valor de token de paginación nulo y, a continuación, revise el resultado combinado.

Para obtener más información acerca del filtrado del lado del servidor y del lado del cliente, consulte Filtrado de salida de la AWS CLI en la Guía del usuario de AWS Command Line Interface.

Búsqueda de usuarios mediante la AWS Management Console

Si ya ha creado un grupo de usuarios, puede realizar búsquedas desde el panel Users (Usuarios) de la AWS Management Console.

Las búsquedas de la AWS Management Console son siempre búsquedas de prefijo ("comienza con").

Para buscar un usuario en la consola de Amazon Cognito

1. Diríjase a la consola de Amazon Cognito. Es posible que se le soliciten sus credenciales de AWS.

2. Elija User Pools (Grupos de usuarios).

3. Elija en la lista un grupo de usuarios existente.

4. Elija la pestaña Users (Usuarios) y, a continuación, ingrese el nombre de usuario del usuario en el campo de búsqueda. Tenga en cuenta que algunos valores de atributo distinguen entre mayúsculas y minúsculas, por ejemplo Username (Nombre de usuario).

   También puede encontrar usuarios ajustando el filtro de búsqueda para restringir el ámbito a otras propiedades de usuario, como Email (Correo electrónico), Phone number (Número de teléfono) o Last name (Apellido).

Búsqueda de usuarios mediante la API ListUsers

Para buscar usuarios de su aplicación, utilice la API ListUsers de Amazon Cognito. Esta API utiliza los parámetros siguientes:

• AttributesToGet: serie de cadenas, donde cada cadena es el nombre de un atributo de usuario que debe devolverse por cada usuario en los resultados de búsquedas. Para recuperar todos los atributos, no incluya un parámetro AttributesToGet ni solicitud AttributesToGet con un valor de la cadena literal null.

• Filter: una cadena de filtro con la forma "AttributeName Filter-Type "AttributeValue"". Las comillas dentro de la cadena de filtro deben ir precedidas por una barra oblicua inversa (\). Por ejemplo, "family_name = \"Reddy\"". Si la cadena de filtro está vacía, ListUsers devuelve todos los usuarios del grupo de usuarios.

  • AttributeName: el nombre del atributo que debe buscarse. Solo puede buscar los atributos de uno en uno.

    nota

    Solo puede buscar atributos estándar. No se pueden buscar los atributos personalizados. Esto se debe a que solo se pueden buscar atributos indizados y los atributos personalizados no se pueden indexar.

  • Filter-Type: para una coincidencia exacta, utilice =; por ejemplo, given_name = "Jon". Para una coincidencia de prefijo ("comienza con"), utilice ^=; por ejemplo, given_name ^= "Jon".

  • AttributeValue: el valor del atributo que debe asociarse para cada usuario.

• Limit: número máximo de usuarios que debe devolverse.

• PaginationToken: un token para obtener más resultados de una búsqueda anterior. Amazon Cognito hace que venza el token de paginación después de una hora.

• UserPoolId: el ID del grupo de usuarios en el que debe realizarse la búsqueda.

Todas las búsquedas no distinguen entre mayúsculas y minúsculas. Los resultados de la búsqueda se ordenan según el atributo designado por la cadena AttributeName, en orden ascendente.

Ejemplos de uso de la API ListUsers

En el ejemplo siguiente se devuelven todos los usuarios y se incluyen todos los atributos.

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

En el ejemplo siguiente se devuelven todos los usuarios cuyos números de teléfono empiezan por "+1312" y se incluyen todos los atributos.

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

En el ejemplo siguiente se devuelven los 10 primeros usuarios cuyo apellido es "Reddy". Para cada usuario, los resultados de la búsqueda incluyen el nombre del usuario, su número de teléfono y su dirección de correo electrónico. Si hay más de 10 usuarios que coincidan con la búsqueda en el grupo de usuarios, la respuesta incluirá un token de paginación.

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

Mientras que en el ejemplo anterior se devuelve un token de paginación, en el ejemplo siguiente se devuelven los 10 usuarios siguientes que coincidan con la misma cadena 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"
}