Gestión y búsqueda de cuentas de usuario - Amazon Cognito
Visualización de atributos de los usuariosRestablecimiento de la contraseña de un usuarioBúsqueda de atributos de usuarioBúsqueda de usuarios con la AWS Management ConsoleBúsqueda de usuarios con ListUsers APIEjemplos de uso del ListUsers API

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Gestión y búsqueda de cuentas de usuario

Los grupos de usuarios pueden contener millones de usuarios. Trabajar con un conjunto de datos de este tamaño es un desafío para los administradores. Amazon Cognito cuenta con herramientas para buscar y modificar los perfiles de usuario. Los principales métodos para encontrar usuarios son la pestaña Usuarios de la consola Amazon Cognito y con. ListUsers De los métodos que recuperan información sobre los usuarios, estas son las opciones que no tienen un impacto en los costos, a diferencia de, por ejemplo, AdminGetUser.

Esta sección de la guía contiene información sobre cómo buscar y actualizar los perfiles de usuario en un grupo de usuarios.

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, introduzca sus AWS credenciales.

  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, 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, introduzca sus AWS credenciales.

  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, 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 usar Amazon Cognito ListUsers API, que acepta un parámetro de 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

  • name

  • 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 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 sobre el filtrado del lado del servidor y del lado del cliente, consulte Filtrar los resultados en la Guía del usuario. AWS CLI AWS Command Line Interface

Búsqueda de usuarios con 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.

AWS Management Console las búsquedas son siempre búsquedas con prefijos («comienza por»).

Para buscar un usuario en la consola de Amazon Cognito

  1. Vaya a la consola de Amazon Cognito. Es posible que se le pidan sus AWS credenciales.

  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 con ListUsers API

Para buscar usuarios desde su aplicación, utilice Amazon Cognito ListUsers API. APIUtiliza los siguientes parámetros:

  • 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 del ListUsers API

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