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à. # Importazione di utenti nel bacino d'utenza da un file CSV Se disponi di un archivio di identità esterno e hai tempo a disposizione per preparare il pool di utenti per nuovi utenti locali, l'importazione in blocco di utenti da un file con valori separati da virgole (CSV) può essere un'opzione semplice ed economica per la migrazione a un pool di utenti di Amazon Cognito. L'importazione di un file CSV consiste nel scaricare e compilare un file modello, per poi consegnarlo al gruppo di utenti in un processo di importazione. Puoi utilizzare un'importazione CSV per creare rapidamente utenti di prova. Puoi anche compilare a livello di codice il file con richieste API di lettura al tuo archivio di identità esterno, quindi analizzarne i dettagli e gli attributi in operazioni di scrittura sul file. Il processo di importazione imposta i valori per tutti gli attributi utente eccetto la **password**. L'importazione della password non è supportata, poiché le best practice di sicurezza richiedono che le password non siano disponibili come testo normale e noi non supportiamo l'importazione di hash. Questo significa che i tuoi utenti devono cambiare le loro password dopo il primo accesso. Gli utenti sono in uno `RESET_REQUIRED` stato quando vengono importati con questo metodo. Il modo più semplice per importare utenti da un file CSV consiste nell'attivare l'accesso [senza password](amazon-cognito-user-pools-authentication-flow-methods.md#amazon-cognito-user-pools-authentication-flow-methods-passwordless) nel pool di utenti. Grazie agli attributi dell'indirizzo e-mail e del numero di telefono e alla corretta configurazione del pool di utenti, gli utenti possono accedere con password monouso per e-mail o SMS () subito dopo il completamento del processo di importazione. OTPs Per ulteriori informazioni, consulta [Necessità degli utenti importati di ripristinare le password](#cognito-user-pools-using-import-tool-password-reset). Puoi anche impostare le password degli utenti con una richiesta [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminSetUserPassword.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminSetUserPassword.html)API che imposta il parametro su. `Permanent` `true` L'importazione in formato CSV non contribuisce al numero di utenti attivi fatturati mensilmente (MAUs) nel tuo pool di utenti. Tuttavia, le operazioni di reimpostazione della password generano. MAUs Per gestire i costi quando importi un gran numero di utenti con password che potrebbero non essere immediatamente attivi, configura l'applicazione in modo che richieda agli utenti una nuova password quando accedono e ricevono la sfida. `RESET_REQUIRED` **Nota** La data di creazione per ogni utente si riferisce al momento in cui tale utente è stato importato nel bacino d'utenza. La data di creazione non è uno degli attributi importati. **Passaggi per creare un processo di importazione degli utenti** 1. Crea un ruolo Amazon CloudWatch Logs nella console AWS Identity and Access Management (IAM). 1. Crea il file .csv di importazione degli utenti; 1. Crea ed esegui Web; 1. Carica il file .csv di importazione degli utenti; 1. Avvia ed esegui Web; 1. Utilizzalo CloudWatch per controllare il registro degli eventi. 1. Richiedi agli utenti importati di ripristinare le loro password. **Altre risorse** + [Esportazione dei profili utente di Cognito: architettura di riferimento per l'](https://aws.amazon.com/solutions/implementations/cognito-user-profiles-export-reference-architecture/)esportazione degli account utente tra pool di utenti **Topics** + [Creazione del ruolo CloudWatch Logs IAM](#cognito-user-pools-using-import-tool-cli-cloudwatch-iam-role) + [Creazione di un file CSV di importazione degli utenti](#cognito-user-pools-using-import-tool-csv-header) + [Creazione ed esecuzione del processo di importazione del bacino d'utenza di Amazon Cognito](#cognito-user-pools-creating-import-job) + [Visualizzazione dei risultati di importazione del pool di utenti nella CloudWatch console](#cognito-user-pools-using-import-tool-cloudwatch) + [Necessità degli utenti importati di ripristinare le password](#cognito-user-pools-using-import-tool-password-reset) ## Creazione del ruolo CloudWatch Logs IAM Se utilizzi la CLI o l'API di Amazon Cognito, devi creare un ruolo IAM. CloudWatch La procedura seguente descrive come creare un ruolo IAM che Amazon Cognito può utilizzare per scrivere i risultati del processo di importazione in Logs. CloudWatch **Nota** Quando crei un processo di importazione nella console di Amazon Cognito, puoi creare il ruolo IAM contemporaneamente. Quando scegli l'operazione **Create a new IAM role** (Crea un nuovo ruolo IAM), Amazon Cognito applica automaticamente la policy di attendibilità e la policy IAM appropriate al ruolo. **Per creare il ruolo CloudWatch Logs IAM per l'importazione del pool di utenti (AWS CLI, API)** 1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Crea un nuovo ruolo IAM per un Servizio AWS. Per istruzioni dettagliate, consulta [Creazione di un ruolo per un servizio Servizio AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html#roles-creatingrole-service-console) nella *Guida per l'utente di AWS Identity and Access Management *. 1. Quando selezioni un **Use Case** (Caso d'uso) per **Trusted entity type** (Tipo di entità attendibile), scegli qualsiasi servizio. Amazon Cognito non è attualmente elencato nei casi d'uso dei servizi. 1. Nella schermata **Add permissions** (Aggiungi autorizzazioni), scegli **Create policy** (Crea policy) e inserisci la seguente istruzione della policy. Sostituiscilo {{REGION}} con il tuo pool Regione AWS di utenti, ad esempio`us-east-1`. Sostituiscilo {{ACCOUNT}} con il tuo Account AWS ID, ad esempio`111122223333`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": [ "arn:aws:logs:{{us-east-1}}:{{111122223333}}:log-group:/aws/cognito/*" ] } ] } ``` ------ 1. Poiché non hai scelto Amazon Cognito come entità attendibile quando hai creato il ruolo, ora devi modificare manualmente la relazione di trust del ruolo. Seleziona **Roles** (Ruoli) nel pannello di navigazione della console IAM, quindi scegli il nuovo ruolo creato. 1. Seleziona la scheda **Relazioni di attendibilità** 1. Seleziona **Modifica policy di attendibilità**. 1. Incolla la seguente istruzione della policy in **Edit trust policy** (Modifica policy di attendibilità), sostituendo qualsiasi testo esistente: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "cognito-idp.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Scegli **Update policy** (Aggiorna policy). 1. Nota l'ARN del ruolo . Quando si crea processo di importazione, è necessario fornire l'ARN. ## Creazione di un file CSV di importazione degli utenti Prima di poter importare gli utenti esistenti nel pool di utenti, è necessario creare un file CSV contenente gli utenti che si desidera importare e i relativi attributi. Dal pool di utenti, è possibile recuperare un file di importazione utente con intestazioni che riflettono lo schema di attributi del pool di utenti. È quindi possibile inserire le informazioni utente che soddisfano i requisiti di formattazione in [Formattazione del file CSV](#cognito-user-pools-using-import-tool-formatting-csv-file). ### Download dell'intestazione del file CSV (console) Utilizza la seguente procedura per scaricare il file di intestazione CSV. **Per eseguire il download dell'intestazione del file CSV** 1. Passa alla [console Amazon Cognito](https://console.aws.amazon.com/cognito/home). È possibile che ti vengano richieste le AWS credenziali. 1. Scegli **User Pools (bacini d'utenza)**. 1. Scegli un bacino d'utenza esistente dall'elenco. 1. Scegli il menu **Utenti**. 1. Nella sezione **Import users** (Importa utenti), scegli **Create an import job** (Crea un processo di importazione). 1. In **Upload CSV** (Carica CSV), seleziona il link *template.csv* e scarica il file CSV. ### Download dell'intestazione del file CSV (AWS CLI) Per ottenere un elenco delle intestazioni corrette, dal **menu Utenti** in **Importa utenti**, seleziona **Crea processo di importazione**. Nella finestra di dialogo che segue, seleziona il `template.csv` link per scaricare un file modello con gli attributi del tuo pool di utenti. Puoi anche eseguire il seguente comando CLI, {{USER\_POOL\_ID}} dov'è l'identificatore del pool di utenti per il pool di utenti in cui importerai gli utenti: ``` aws cognito-idp get-csv-header --user-pool-id "{{USER_POOL_ID}}" ``` Risposta di esempio: ``` { "CSVHeader": [ "name", "given_name", "family_name", "middle_name", "nickname", "preferred_username", "profile", "picture", "website", "email", "email_verified", "gender", "birthdate", "zoneinfo", "locale", "phone_number", "phone_number_verified", "address", "updated_at", "cognito:mfa_enabled", "cognito:username" ], "UserPoolId": "{{USER_POOL_ID}}" } ``` ### Formattazione del file CSV L'aspetto del file di intestazione CSV di importazione degli utenti scaricato è il seguente: Include anche eventuali attributi personalizzati aggiunti al pool di utenti. ``` cognito:username,name,given_name,family_name,middle_name,nickname,preferred_username,profile,picture,website,email,email_verified,gender,birthdate,zoneinfo,locale,phone_number,phone_number_verified,address,updated_at,cognito:mfa_enabled ``` Modificare il file CSV, in modo che includa questa intestazione e i valori di attributo per gli utenti. Il file viene formattato in base ai seguenti criteri: **Nota** Per ulteriori informazioni sui valori di attributo, ad esempio il formato corretto per i numeri di telefono, consulta [Utilizzo degli attributi utente](user-pool-settings-attributes.md). + La prima riga nel file è la riga di intestazione scaricata, che contiene i nomi di attributo degli utenti. + L'ordine delle colonne nel file CSV non è rilevante. + Ogni riga, dopo la prima, contiene i valori di attributo per un utente. + Tutte le colonne nell'intestazione devono essere presenti, ma non è necessario che tu fornisca valori in ogni colonna; + I seguenti attributi sono necessari: + **cognito:username** + **email\_verified** o **phone\_number\_verified** + Almeno uno degli attributi verificato automaticamente deve essere `true` per ogni utente. Un attributo verificato automaticamente è un indirizzo e-mail o un numero di telefono a cui Amazon Cognito invia automaticamente un codice quando un nuovo utente si unisce al pool di utenti. + Il pool di utenti deve avere almeno un attributo verificato automaticamente, **email\_verified** o **phone\_number\_verified**. Se il bacino d'utenza non ha attributi verificati automaticamente, il processo di importazione non verrà avviato. + Se il bacino d'utenza ha un attributo verificato automaticamente, tale attributo deve essere verificato per ogni utente. Ad esempio, se il bacino d'utenza ha solo **phone\_number** come attributo verificato automaticamente, il valore **phone\_number\_verified** deve essere `true` per ogni utente. **Nota** Affinché gli utenti reimpostino le password, devono avere una e-mail o un numero di telefono verificati. Amazon Cognito invia un messaggio contenente un codice di reimpostazione della password all'e-mail o al numero di telefono specificati nel file CSV. Se il messaggio viene inviato al numero di telefono, è inviato tramite SMS. Per ulteriori informazioni, consulta [Verifica delle informazioni di contatto al momento della registrazione](signing-up-users-in-your-app.md#allowing-users-to-sign-up-and-confirm-themselves). + **e-mail** (se **email\_verified** è `true`) + **phone\_number** (se **phone\_number\_verified** è `true`) + Tutti gli attributi che hai contrassegnato come richiesto quando hai creato il bacino d'utenza + I valori di attributo che sono stringhe dovrebbero *non* essere tra virgolette; + Se il valore di un attributo contiene una virgola, è necessario inserire una barra rovesciata (\\) prima della virgola. Questo perché i campi in un file CSV sono separati da virgole. + I contenuti del file CSV devono essere in formato UTF-8 senza contrassegno ordine di byte. + Il campo **cognito:username** è obbligatorio e deve essere univoco all'interno del tuo bacino d'utenza. Può essere qualsiasi stringa Unicode. Tuttavia, non può contenere spazi o schede; + I valori della **data di nascita**, se presenti, devono essere nel formato. *{{mm/dd/yyyy}}* Ciò significa, ad esempio, che una data di nascita corrispondente al 1 febbraio 1985 deve essere codificata come **02/01/1985**. + Il campo **cognito:mfa\_enabled** deve corrispondere ai requisiti MFA del tuo pool di utenti. Se hai impostato l'autenticazione a più fattori (MFA) come obbligatoria nel tuo pool di utenti, questo campo deve `true` essere o vuoto per tutti gli utenti. Se hai impostato la modalità MFA come disattivata, questo campo deve essere `false` o vuoto per tutti gli utenti. Un valore vuoto imposta lo stato di abilitazione MFA degli utenti importati sullo stato richiesto dal pool di utenti. È possibile importare utenti in un pool di utenti richiesto dall'MFA senza un fattore MFA valido, indipendentemente dal fatto che sia stato impostato un valore. `cognito:mfa_enabled` Gli utenti in questo stato hanno la MFA attiva ma non possono accedere finché non configurano un attributo e-mail, un attributo numero di telefono o un TOTP e tale configurazione non è un fattore MFA valido nel tuo pool di utenti. + La lunghezza massima è 16.000 caratteri. + Il file CSV può avere una dimensione massima di 100 MB. + Il numero massimo di righe (utenti) nel file è 500.000. In questo valore massimo non è inclusa la riga di intestazione. + Il valore del campo **updated\_at** dovrebbe essere un periodo di tempo espresso in secondi, per esempio: **1471453471**. + Qualsiasi spazio, iniziale o finale in un valore di attributo, verrà tagliato. L'elenco seguente è un esempio di file di importazione CSV per un pool di utenti senza attributi personalizzati. Lo schema del pool di utenti potrebbe differire da questo esempio. In tal caso, è necessario fornire valori di test nel modello CSV scaricato dal pool di utenti. ``` cognito:username,name,given_name,family_name,middle_name,nickname,preferred_username,profile,picture,website,email,email_verified,gender,birthdate,zoneinfo,locale,phone_number,phone_number_verified,address,updated_at,cognito:mfa_enabled John,,John,Doe,,,,,,,johndoe@example.com,TRUE,,02/01/1985,,,+12345550100,TRUE,123 Any Street,,FALSE Jane,,Jane,Roe,,,,,,,janeroe@example.com,TRUE,,01/01/1985,,,+12345550199,TRUE,100 Main Street,,FALSE ``` ## Creazione ed esecuzione del processo di importazione del bacino d'utenza di Amazon Cognito Questa sezione descrive come creare ed eseguire il processo di importazione del pool di utenti utilizzando la console Amazon Cognito e AWS Command Line Interface ()AWS CLI. **Topics** + [Importazione di utenti da un file CSV (console)](#cognito-user-pools-using-import-tool-console) + [Importazione di utenti (AWS CLI)](#cognito-user-pools-using-import-tool-cli) ### Importazione di utenti da un file CSV (console) Nella procedura seguente viene descritto come importare gli utenti dal file CSV. **Per importare gli utenti da un file CSV (console)** 1. Passa alla [console Amazon Cognito](https://console.aws.amazon.com/cognito/home). È possibile che ti vengano richieste le credenziali AWS . 1. Scegli **User Pools (bacini d'utenza)**. 1. Scegli un bacino d'utenza esistente dall'elenco. 1. Scegli il menu **Utenti**. 1. Nella sezione **Import users** (Importa utenti), scegli **Create an import job** (Crea un processo di importazione). 1. Nella pagina **Create import job** (Crea processo di importazione), inserisci un **Job name** (Nome processo). 1. Scegli l'operazione **Create a new IAM role** (Crea un nuovo ruolo IAM) o **Use an existing IAM role** (Utilizza un ruolo IAM esistente). 1. Se hai scelto **Create a new IAM role** (Crea un nuovo ruolo IAM), inserisci un nome per il nuovo ruolo. Amazon Cognito creerà automaticamente un ruolo con le autorizzazioni e le relazioni di affidabilità corrette. Il principale IAM che crea il processo di importazione deve disporre delle autorizzazioni per creare ruoli IAM. 1. Se hai scelto **Use an existing IAM role** (Utilizza un ruolo IAM esistente), scegli un ruolo dall'elenco in **IAM role selection** (Selezione del ruolo IAM). Questo ruolo deve disporre delle autorizzazioni e della policy di attendibilità descritte in [Creazione del ruolo CloudWatch Logs IAM](#cognito-user-pools-using-import-tool-cli-cloudwatch-iam-role). 1. In **Carica CSV**, scegli **Scegli file** e allega il file CSV che hai preparato. 1. Scegli **Create job** (Crea processo) per inviare il processo, ma avvialo in un secondo momento. Scegli **Create and start job** (Crea e avvia il processo) per inviare il processo e avviarlo immediatamente. 1. Se hai creato il processo ma non l'hai avviato, puoi avviarlo in un secondo momento. **Nel menu **Utenti**, sotto **Importa utenti**, scegli il processo di importazione, quindi seleziona Avvia.** Puoi anche inviare una richiesta [StartUserImportJob](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_StartUserImportJob.html)API da un AWS SDK. 1. Monitora lo stato di avanzamento del processo di importazione **degli utenti nel menu Utenti** sotto **Importa utenti**. Se il processo non va a buon fine, puoi selezionare il valore **Status** (Stato). Per ulteriori dettagli, seleziona **Visualizza CloudWatch i log per maggiori dettagli** ed esamina eventuali problemi nella console CloudWatch Logs. ### Importazione di utenti (AWS CLI) I seguenti comandi della CLI sono disponibili per importare gli utenti in un bacino d'utenza: + `create-user-import-job` + `get-csv-header` + `describe-user-import-job` + `list-user-import-jobs` + `start-user-import-job` + `stop-user-import-job` Per l'elenco delle opzioni della riga di comando per questi comandi, utilizza l'opzione `help` della riga di comando. Esempio: ``` aws cognito-idp get-csv-header help ``` #### Creazione di un processo di importazione degli utenti Dopo aver creato il file CSV, crea un processo di importazione utenti eseguendo il seguente comando CLI, {{JOB\_NAME}} dove è il nome che scegli per il processo{{USER\_POOL\_ID}}, l'ID del pool di utenti per il pool di utenti a cui verranno aggiunti i nuovi utenti {{ROLE\_ARN}} e il ruolo ARN in cui hai ricevuto: [Creazione del ruolo CloudWatch Logs IAM](#cognito-user-pools-using-import-tool-cli-cloudwatch-iam-role) ``` aws cognito-idp create-user-import-job --job-name "{{JOB_NAME}}" --user-pool-id "{{USER_POOL_ID}}" --cloud-watch-logs-role-arn "{{ROLE_ARN}}" ``` Il valore {{PRE\_SIGNED\_URL}} restituito nella risposta è valido per 15 minuti. Dopo questo lasso di tempo scadrà e, a quel punto, è necessario creare un processo di importazione degli utenti per ottenere un nuovo URL. **Example risposta:** ``` { "UserImportJob": { "Status": "Created", "SkippedUsers": 0, "UserPoolId": "{{USER_POOL_ID}}", "ImportedUsers": 0, "JobName": "{{JOB_NAME}}", "JobId": "{{JOB_ID}}", "PreSignedUrl": "{{PRE_SIGNED_URL}}", "CloudWatchLogsRoleArn": "{{ROLE_ARN}}", "FailedUsers": 0, "CreationDate": 1470957431.965 } } ``` #### Valori di stato per un processo di importazione degli utenti Nelle risposte ai comandi di importazione degli utenti, visualizzerai uno dei seguenti valori `Status`: + `Created`: Il processo è stato creato, ma non avviato. + `Pending`: Stato di transizione. Hai avviato il processo, ma questo non ha ancora iniziato a importare gli utenti; + `InProgress`: Il processo è stato avviato e gli utenti sono in fase di importazione. + `Stopping`: Hai interrotto il processo, ma questo non ha ancora cessato l'importazione degli utenti. + `Stopped`: Hai interrotto il processo e quest'ultimo ha cessato l'importazione degli utenti. + `Succeeded`: La fase ha avuto esito positivo. + `Failed`: Il processo è stato interrotto a causa di un errore. + `Expired`: Hai creato un processo, ma non lo hai avviato entro 24-48 ore. Tutti i dati associati al processo sono stati eliminati e il processo non può essere avviato. #### Caricamento del file CSV Utilizza il seguente comando `curl` per caricare il file CSV contenente i dati dell'utente nell'URL prefirmato che hai ottenuto dalla risposta del comando `create-user-import-job`. ``` curl -v -T "{{PATH_TO_CSV_FILE}}" -H "x-amz-server-side-encryption:aws:kms" "{{PRE_SIGNED_URL}}" ``` Nell'output di questo comando, cerca la frase `"We are completely uploaded and fine"`. Questa frase indica che il file è stato caricato correttamente. I tuoi pool di utenti non conservano le informazioni nei file di importazione dopo aver eseguito i processi di importazione. Una volta completati o scaduti, Amazon Cognito elimina il file CSV caricato. #### Descrizione di un processo di importazione degli utenti Per ottenere una descrizione del processo di importazione degli utenti, utilizza il seguente comando, dove si {{USER\_POOL\_ID}} trova l'ID del pool di utenti e {{JOB\_ID}} l'ID del lavoro restituito quando hai creato il processo di importazione degli utenti. ``` aws cognito-idp describe-user-import-job --user-pool-id "{{USER_POOL_ID}}" --job-id "{{JOB_ID}}" ``` **Example Risposta di esempio:** ``` { "UserImportJob": { "Status": "Created", "SkippedUsers": 0, "UserPoolId": "{{USER_POOL_ID}}", "ImportedUsers": 0, "JobName": "{{JOB_NAME}}", "JobId": "{{JOB_ID}}", "PreSignedUrl": "{{PRE_SIGNED_URL}}", "CloudWatchLogsRoleArn":"{{ROLE_ARN}}", "FailedUsers": 0, "CreationDate": 1470957431.965 } } ``` Nell'output di esempio precedente, {{PRE\_SIGNED\_URL}} è l'URL in cui hai caricato il file CSV. {{ROLE\_ARN}}È l'ARN del ruolo CloudWatch Logs che hai ricevuto quando hai creato il ruolo. #### Elenco dei tuoi processi di importazione degli utenti Per elencare i tuoi processi di importazione degli utenti, utilizza il comando seguente: ``` aws cognito-idp list-user-import-jobs --user-pool-id "{{USER_POOL_ID}}" --max-results 2 ``` **Example Risposta di esempio:** ``` { "UserImportJobs": [ { "Status": "Created", "SkippedUsers": 0, "UserPoolId": "{{USER_POOL_ID}}", "ImportedUsers": 0, "JobName": "{{JOB_NAME}}", "JobId": "{{JOB_ID}}", "PreSignedUrl":"{{PRE_SIGNED_URL}}", "CloudWatchLogsRoleArn":"{{ROLE_ARN}}", "FailedUsers": 0, "CreationDate": 1470957431.965 }, { "CompletionDate": 1470954227.701, "StartDate": 1470954226.086, "Status": "Failed", "UserPoolId": "{{USER_POOL_ID}}", "ImportedUsers": 0, "SkippedUsers": 0, "JobName": "{{JOB_NAME}}", "CompletionMessage": "Too many users have failed or been skipped during the import.", "JobId": "{{JOB_ID}}", "PreSignedUrl":"{{PRE_SIGNED_URL}}", "CloudWatchLogsRoleArn":"{{ROLE_ARN}}", "FailedUsers": 5, "CreationDate": 1470953929.313 } ], "PaginationToken": "{{PAGINATION_TOKEN}}" } ``` I processi sono elencati in ordine cronologico dall'ultimo creato al primo. La {{PAGINATION\_TOKEN}} stringa dopo il secondo processo indica che ci sono risultati aggiuntivi per questo comando list. Per elencare i risultati aggiuntivi, utilizza l' opzione `--pagination-token` come segue: ``` aws cognito-idp list-user-import-jobs --user-pool-id "{{USER_POOL_ID}}" --max-results 10 --pagination-token "{{PAGINATION_TOKEN}}" ``` #### Avvio di un processo di importazione degli utenti Per avviare un processo di importazione degli utenti, utilizza il comando seguente: ``` aws cognito-idp start-user-import-job --user-pool-id "{{USER_POOL_ID}}" --job-id "{{JOB_ID}}" ``` Può essere attivo soltanto un processo di importazione alla volta per account. **Example Risposta di esempio:** ``` { "UserImportJob": { "Status": "Pending", "StartDate": 1470957851.483, "UserPoolId": "{{USER_POOL_ID}}", "ImportedUsers": 0, "SkippedUsers": 0, "JobName": "{{JOB_NAME}}", "JobId": "{{JOB_ID}}", "PreSignedUrl":"{{PRE_SIGNED_URL}}", "CloudWatchLogsRoleArn": "{{ROLE_ARN}}", "FailedUsers": 0, "CreationDate": 1470957431.965 } } ``` #### Arresto di un processo di importazione degli utenti Per arrestare un processo di importazione degli utenti mentre è in corso, utilizza il comando seguente. Una volta che hai interrotto il processo, non puoi riavviarlo. ``` aws cognito-idp stop-user-import-job --user-pool-id "{{USER_POOL_ID}}" --job-id "{{JOB_ID}}" ``` **Example Risposta di esempio:** ``` { "UserImportJob": { "CompletionDate": 1470958050.571, "StartDate": 1470958047.797, "Status": "Stopped", "UserPoolId": "{{USER_POOL_ID}}", "ImportedUsers": 0, "SkippedUsers": 0, "JobName": "{{JOB_NAME}}", "CompletionMessage": "The Import Job was stopped by the developer.", "JobId": "{{JOB_ID}}", "PreSignedUrl":"{{PRE_SIGNED_URL}}", "CloudWatchLogsRoleArn": "{{ROLE_ARN}}", "FailedUsers": 0, "CreationDate": 1470957972.387 } } ``` ## Visualizzazione dei risultati di importazione del pool di utenti nella CloudWatch console Puoi visualizzare i risultati del tuo processo di importazione nella CloudWatch console Amazon. **Topics** + [Visualizzazione dei risultati](#cognito-user-pools-using-import-tool-viewing-the-results) + [Interpretazione dei risultati](#cognito-user-pools-using-import-tool-interpreting-the-results) ### Visualizzazione dei risultati I seguenti passaggi descrivono come visualizzare i risultati dell'importazione del bacino d'utenza. **Visualizzazione dei risultati dell'importazione del bacino d'utenza** 1. Accedi Console di gestione AWS e apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Scegliere **Logs (Log)**. 1. Scegli il gruppo di log per i tuoi processi di importazione del bacino d'utenza. Il nome del gruppo di log è del tipo `/aws/cognito/userpools/{{USER_POOL_ID}}/{{USER_POOL_NAME}}`. 1. Scegli il log per il processo di importazione degli utenti che hai appena eseguito. Il nome del registro è nel formato{{JOB\_ID}}/{{JOB\_NAME}}. I risultati nel log si riferiscono ai i tuoi utenti per numero di linea. Nessun dato degli utenti viene scritto nel log. Per ogni utente, viene visualizzata una linea simile a quella riportata di seguito: + `[SUCCEEDED] Line Number 5956 - The import succeeded.` + `[SKIPPED] Line Number 5956 - The user already exists.` + `[FAILED] Line Number 5956 - The User Record does not set any of the auto verified attributes to true. (Example: email_verified to true).` ### Interpretazione dei risultati Lo stato degli utenti importati con successo è impostato su "PasswordReset». Nei seguenti casi, l'utente non verrà importato, ma il processo di importazione proseguirà: + Nessun attributo verificato automaticamente è impostato su `true`. + I dati dell'utente non corrispondono allo schema; + Non è stato possibile importare l'utente a causa di un errore interno. Nei seguenti casi, il processo di importazione fallirà: + Il ruolo Amazon CloudWatch Logs non può essere assunto, non ha la politica di accesso corretta o è stato eliminato. + Il bacino d'utenza è stato eliminato. + Amazon Cognito non è in grado di analizzare il file .csv. ## Necessità degli utenti importati di ripristinare le password Se il tuo pool di utenti offre solo l'accesso basato su password, gli utenti devono reimpostare le password dopo l'importazione. *La prima volta che accedono, possono inserire qualsiasi password.* Amazon Cognito richiede loro di inserire una nuova password nella risposta API alla richiesta di accesso della tua applicazione. Se il tuo pool di utenti dispone di fattori di autenticazione senza password, Amazon Cognito utilizza per impostazione predefinita quelli per gli utenti importati. Non viene loro richiesta una nuova password e possono accedere immediatamente con un'e-mail o un SMS OTP senza password. Puoi anche richiedere agli utenti di impostare una password in modo che possano completare altri metodi di accesso come nome utente-password e passkey. Le seguenti condizioni si applicano all'accesso senza password dopo l'importazione dell'utente. 1. È necessario importare gli utenti con un attributo che corrisponda a un fattore di accesso senza password disponibile. Se gli utenti possono accedere con un indirizzo e-mail, è necessario importare un attributo. `email` Se si tratta di un numero di telefono, è necessario importare un `phone_number` attributo. Se entrambi, importa un valore per entrambi gli attributi. 1. Normalmente, gli utenti importano in uno `RESET_REQUIRED` stato in cui devono reimpostare la password. Se vengono importati con la possibilità di accedere con un fattore senza password, Amazon Cognito imposta il loro stato su. `CONFIRMED` Per ulteriori informazioni sull'autenticazione senza password, incluso come configurarla e come costruire il flusso di autenticazione nella tua applicazione, consulta. [Autenticazione con pool di utenti Amazon Cognito](authentication.md) La procedura seguente descrive l'esperienza utente in un meccanismo di accesso personalizzato con utenti locali `RESET_REQUIRED` dopo l'importazione di un file CSV. **Se i tuoi utenti accedono con accesso gestito, chiedi loro di selezionare la password dimenticata?** opzione, fornisci il codice contenuto nell'e-mail o nel messaggio di testo e imposta una password. **Necessità degli utenti importati di ripristinare le password** 1. Nell'app, tenta di accedere silenziosamente per l'utente corrente con `InitiateAuth` utilizzando una password casuale. 1. Amazon Cognito restituisce `NotAuthorizedException` quando `PreventUserExistenceErrors` è abilitato. In caso contrario, restituisce `PasswordResetRequiredException`. 1. L'app effettua una richiesta API `ForgotPassword` e reimposta la password dell'utente. 1. L'app invia il nome utente in una richiesta API `ForgotPassword`. 1. Amazon Cognito invia un codice all'indirizzo e-mail o al numero di telefono verificato. La destinazione dipende dai valori forniti per `email_verified` e `phone_number_verified` nel file CSV. La risposta alla richiesta `ForgotPassword` indica la destinazione del codice. **Nota** Il pool di utenti deve essere configurato per verificare le e-mail o i numeri di telefono. Per ulteriori informazioni, consulta [Registrazione e conferma degli account utente](signing-up-users-in-your-app.md). 1. L'app visualizza un messaggio all'utente per verificare la posizione di invio del codice e richiede all'utente di inserire il codice e una nuova password. 1. L'utente inserisce il codice e la nuova password nell'app; 1. L'app invia il codice e la nuova password in una richiesta API `ConfirmForgotPassword`. 1. L'app reindirizza l'utente per l'accesso.