Gestione e ricerca degli account utente

Una volta creato il bacino d'utenza, potrai visualizzare e gestire gli utenti tramite la AWS Management Console, la AWS Command Line Interface oppure l'API di Amazon Cognito. Questo argomento descrive in che modo puoi visualizzare e cercare gli utenti tramite la AWS Management Console.

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 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 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 utilizzare anche l'API ListUsers di Amazon Cognito, che accetta il 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 si utilizza 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 filtro lato server e lato client, consulta Filtro dell'output di AWS CLI nella Guida per l'utente di AWS Command Line Interface (lingua italiana non garantita).

Ricerca di utenti tramite la AWS Management Console

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

Le ricerche della AWS Management Console sono sempre ricerche con prefisso ("inizia con").

Per cercare un utente nella console Amazon Cognito

1. Passa alla console Amazon Cognito. Potrebbe comparire una richiesta di inserimento delle 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 tramite l'API ListUsers

Per cercare gli utenti dall'app, utilizza utilizza l'API ListUsers di Amazon Cognito. Quest'API utilizza i parametri seguenti:

• 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 dell'API ListUsers

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