Gestione e ricerca degli account utente - Amazon Cognito
Visualizzazione degli attributi utenteReimpostare una password utenteRicerca degli attributi utenteRicerca di utenti con AWS Management ConsoleRicerca di utenti con ListUsers APIEsempi di utilizzo di ListUsers API

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione e ricerca degli account utente

I pool di utenti possono contenere milioni di utenti. Lavorare con un set di dati di queste dimensioni è una sfida per gli amministratori. Amazon Cognito dispone di strumenti per trovare e modificare i profili utente. I metodi principali per trovare gli utenti sono la scheda Utenti della console Amazon Cognito e con. ListUsers Tra i metodi che recuperano informazioni sugli utenti, queste sono le opzioni che non hanno un impatto sui costi, a differenza, ad esempio, di. AdminGetUser

Questa sezione della guida contiene informazioni sulla ricerca e l'aggiornamento dei profili utente in un pool di utenti.

Visualizzazione degli attributi utente

Utilizza la procedura seguente per visualizzare gli attributi utente nella console Amazon Cognito.

Per visualizzare gli attributi utente

  1. Passa alla console Amazon Cognito. Se richiesto, inserisci le tue AWS credenziali.

  2. Scegli User Pools (bacini d'utenza).

  3. Scegli un bacino d'utenza esistente dall'elenco.

  4. Scegli la scheda Users (utenti), quindi seleziona un utente nell'elenco.

  5. Nella pagina dei dettagli dell'utente, alla voce User attributes (attributi utente), è possibile visualizzare quali attributi siano associati all'utente.

Reimpostare una password utente

Utilizza la procedura seguente per reimpostare la password utente nella console Amazon Cognito.

Per reimpostare una password utente

  1. Passa alla console Amazon Cognito. Se richiesto, inserisci le tue credenziali. AWS

  2. Scegli User Pools (bacini d'utenza).

  3. Scegli un bacino d'utenza esistente dall'elenco.

  4. Scegli la scheda Users (utenti), quindi scegli un utente nell'elenco.

  5. Nella pagina dei dettagli dell'utente, scegli Actions (Operazioni),Reset password (reimposta password).

  6. Nella finestra di dialogo Reset password (reimposta password), controlla le informazioni e, quando sei pronto, scegli Reimposta.

    L'operazione genera un codice di conferma che viene inviato all'utente e ne disabilita la password corrente cambiando lo stato dell'utente in RESET_REQUIRED. Il codice Reset password (Reimposta password) è valido per 1 ora.

Ricerca degli attributi utente

Se hai già creato un bacino d'utenza, puoi effettuare la ricerca dal pannello Users (Utenti) nella AWS Management Console. Puoi anche utilizzare Amazon Cognito ListUsers API, che accetta un parametro Filter.

Puoi cercare i seguenti attributi standard. Gli attributi personalizzati non possono essere cercati.

  • username (distinzione tra maiuscole e minuscole)

  • email

  • phone_number

  • name

  • given_name

  • family_name

  • preferred_username

  • cognito: user_status (denominato Status (Stato) nella console) (senza distinzione tra maiuscole e minuscole)

  • status (denominato Enabled (Abilitato) nella console) (distinzione tra maiuscole e minuscole)

  • sub

Nota

È inoltre possibile fare un elenco degli utenti con un filtro lato client. Il filtro lato server non corrisponde a più di 1 attributo. Per la ricerca avanzata, utilizza un filtro lato client con il parametro --query dell'operazione list-users nella AWS Command Line Interface. Quando utilizzi un filtro lato client, ListUsers restituisce un elenco impaginato di zero o più utenti. È possibile ricevere più pagine di fila senza risultati. Ripetere la query con ogni token di impaginazione restituito fino a quando non si riceve un valore del token di impaginazione nullo, quindi rivedere il risultato combinato.

Per ulteriori informazioni sul filtraggio lato server e lato client, consulta Filtraggio dell'output nella Guida per l'utente. AWS CLI AWS Command Line Interface

Ricerca di utenti con AWS Management Console

Se hai già creato un bacino d'utenza, puoi effettuare la ricerca dal pannello Users (Utenti) nella AWS Management Console.

AWS Management Console le ricerche sono sempre ricerche con prefisso («inizia con»).

Per cercare un utente nella console Amazon Cognito

  1. Passa alla console Amazon Cognito. È possibile che ti vengano richieste le credenziali. AWS

  2. Scegli User Pools (bacini d'utenza).

  3. Scegli un bacino d'utenza esistente dall'elenco.

  4. Scegli la scheda Users (Utenti), quindi inserisci il nome utente nel campo di ricerca. Attenzione: alcuni valori di attributo tengono conto di maiuscole/minuscole (ad esempio lo User name (Nome utente).

    È inoltre possibile trovare utenti modificando il filtro di ricerca per restringere l'ambito alle altre proprietà dell'utente, ad esempio E-mail,numero di telefono, oppure cognome.

Ricerca di utenti con ListUsers API

Per cercare utenti dalla tua app, usa Amazon Cognito ListUsers API. Questo API utilizza i seguenti parametri:

  • AttributesToGet: una matrice di stringhe, in cui ogni stringa è il nome di un attributo utente da restituire a ogni utente nei risultati di ricerca. Per recuperare tutti gli attributi, non includere un parametro AttributesToGet o richiesta AttributesToGet con un valore della stringa letterale null.

  • Filter: una stringa del filtro del modulo"AttributeName Filter-Type "AttributeValue"". Le virgolette all'interno della stringa del filtro devono essere sfuggite utilizzando la barra rovesciata (\). Ad esempio "family_name = \"Reddy\"". Se la stringa del filtro è vuota, ListUsers riporta tutti gli utenti al bacino d'utenza.

    • AttributeName: il nome dell'attributo da cercare. Puoi cercare solo un attributo per volta.

      Nota

      Puoi cercare solo gli attributi standard. Gli attributi personalizzati non possono essere cercati. Questo perché si può effettuare la ricerca solo per gli attributi indicizzati, e gli attributi personalizzati non possono essere indicizzati.

    • Filter-Type: per una corrispondenza esatta, utilizza =, ad esempio, given_name = "Jon". Per una corrispondenza del prefisso ("inizia con"), utilizza ^=, ad esempio, given_name ^= "Jon".

    • AttributeValue: il valore di attributo che deve essere abbinato a ogni utente.

  • Limit: numero massimo di utenti da restituire.

  • PaginationToken: un token per ottenere più risultati da una ricerca precedente. Il token di impaginazione di Amazon Cognito scade dopo un'ora.

  • UserPoolId: l'ID del bacino d'utenza per il bacino d'utenza sul quale eseguire la ricerca.

Tutte le ricerche non fanno la distinzione tra maiuscole e minuscole. I risultati di ricerca vengono ordinati in base all'attributo denominato dalla stringa AttributeName, in ordine crescente.

Esempi di utilizzo di ListUsers API

L'esempio seguente illustra la restituzione di tutti gli utenti e include tutti gli attributi.


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

L'esempio seguente illustra la restituzione di tutti gli utenti il cui numero di telefono inizia per "+1312" e include tutti gli attributi.


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

L'esempio seguente illustra la restituzione dei primi 10 utenti il cui cognome è "Reddy". Per ogni utente, i risultati di ricerca includono il nome specificato dall'utente, il numero di telefono e l'indirizzo e-mail. Se non ci sono più di 10 utenti che corrispondono all'interno del bacino d'utenza, la risposta include un token di paginazione.

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

Mentre nell'esempio precedente viene restituito un token di paginazione, in quello seguente vengono restituiti i 10 utenti successivi che corrispondono alla stessa stringa del filtro.

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