View a markdown version of this page

Utilizzo di provider di identità social con un pool di utenti - Amazon Cognito
Configura un'app per sviluppatoriConfigura il tuo pool di utentiProva l'accesso tramite social

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à.

Utilizzo di provider di identità social con un pool di utenti

Gli utenti di app Web e per dispositivi mobili possono accedere tramite provider di identità social (IdP) come Facebook, Google, Amazon e Apple. Con l'interfaccia utente Web ospitata integrata, Amazon Cognito fornisce la gestione dei token per gli utenti autenticati. In questo modo, i sistemi back-end possono standardizzare un set di token del bacino d'utenza. È necessario abilitare l'accesso gestito per l'integrazione con i provider di identità social supportati. Quando Amazon Cognito crea le tue pagine di accesso gestite, crea endpoint OAuth 2.0 che Amazon Cognito, il tuo OIDC e i social utilizzano per lo scambio di informazioni. IdPs Per ulteriori informazioni, consulta la Documentazione di riferimento delle API Auth dei bacini d'utenza di Amazon Cognito.

Puoi aggiungere un IdP social in oppure puoi utilizzare Console di gestione AWS la AWS CLI o l'API Amazon Cognito.

Nota

Sign-in tramite una terza parte (federazione) è disponibile nei pool di utenti di Amazon Cognito. Questa funzione è indipendente dalla federazione tramite pool di identità di Amazon Cognito (identità federate).

Configura un account e un'applicazione social IdP per sviluppatori

Prima di creare un IdP social con Amazon Cognito, è necessario registrare l'applicazione con l'IdP social in modo da ricevere un ID client e un segreto client.

Facebook

Per le informazioni più recenti sulla configurazione degli account e dell'autenticazione degli sviluppatori Meta, consulta Meta App Development.

Come registrare un'applicazione con Facebook/Meta

  1. Creazione di un account sviluppatore con Facebook.

  2. Accedi con le tue credenziali di Facebook.

  3. Nel menu My Apps (Le mie app), scegli Create New App (Crea nuova app).

  4. Inserisci un nome per l'app Facebook, quindi scegli Create App ID (Crea ID dell'app).

  5. Nella barra di navigazione a sinistra, scegli Settings (Impostazioni) e successivamente Basic (Di base).

  6. Prendi nota di ID app e Segreto app. Li utilizzerai nella sezione successiva.

  7. Nella parte inferiore della pagina, scegli +Add Platform (+Aggiungi piattaforma).

  8. Scegli Website (Sito Web).

  9. Alla voce Website (Sito Web), inserisci il percorso della pagina di accesso per l'app in URL del sito.

    
https://mydomain.auth.us-east-1.amazoncognito.com/login?response_type=code&client_id=1example23456789&redirect_uri=https://www.example.com

  10. Scegli Save changes (Salva modifiche).

  11. Inserisci il percorso della directory principale del dominio del bacino d'utenza in App Domains (Domini app).

    https://mydomain.auth.us-east-1.amazoncognito.com

  12. Scegli Save changes (Salva modifiche).

  13. Nella barra di navigazione, scegli Add Products (Aggiungi prodotti) e successivamente Set up (Imposta) per il prodotto Facebook Login (Accedi con Facebook).

  14. Nella barra di navigazione, scegli Facebook Login (Accedi con Facebook) e successivamente Settings (Impostazioni).

    Inserisci il percorso dell'endpoint /oauth2/idpresponse per il dominio del pool di utenti in Valid OAuth Redirect URIs (URI di reindirizzamento OAuth validi).

    
https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

  15. Scegli Save changes (Salva modifiche).

Login with Amazon

Per le informazioni più recenti sulla configurazione degli account sviluppatore e sull'autenticazione di Login with Amazon, consulta Login with Amazon Documentation.

Come registrare un'applicazione con Login with Amazon

  1. Creazione di un account sviluppatore con Amazon.

  2. Accedi con le tue credenziali di Amazon.

  3. È necessario creare un profilo di sicurezza Amazon per ricevere l'ID client di Amazon e il segreto client.

    Nella barra di navigazione disponibile nella parte superiore della pagina, scegli Apps and Services (App e servizi) e successivamente Login with Amazon (Accedi con Amazon).

  4. Scegli Create a Security Profile (Crea un profilo di sicurezza).

  5. Digita un Security Profile Name (nome profilo sicurezza), una Security Profile Description (descrizione profilo sicurezza) e un Consent Privacy Notice URL (URL consenso informativa privacy).

  6. Scegli Save (Salva).

  7. Scegli Client ID (ID client) e Client Secret (Segreto client) per mostrare i dati relativi. Li utilizzerai nella sezione successiva.

  8. Passa il mouse sull'icona a forma di ingranaggio e scegli Web Settings (Impostazioni Web), quindi Scegli Edit (Modifica).

  9. Inserisci il dominio del bacino d'utenza nel campo Allowed Origins (origini consentite).

    https://mydomain.auth.us-east-1.amazoncognito.com

  10. Digita il dominio del bacino d'utenza con l'endpoint /oauth2/idpresponse in Allowed Return URLs (URL restituiti consentiti).

    https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

  11. Scegli Save Salva.

Google

Per ulteriori informazioni su OAuth 2.0 nella piattaforma Google Cloud, consulta la sezione relativa all'autenticazione e autorizzazione nella documentazione disponibile nella pagina Google Workspace for Developers.

Come registrare un'applicazione con Google

  1. Creazione di un account sviluppatore con Google.

  2. Accedi alla console Piattaforma Google Cloud.

  3. Nella barra di navigazione in alto, scegli Select a project (Seleziona un progetto). Se hai già un progetto nella piattaforma Google, nel menu viene visualizzato il tuo progetto predefinito.

  4. Scegli Nuovo progetto.

  5. Immetti un nome per il progetto e scegli Crea.

  6. Nella barra di navigazione a sinistra, scegli APIs and Services (API e servizi), quindiOauth consent screen (Schermata consenso Oauth).

  7. Inserisci le informazioni sull'app, un App domain (Dominio dell'app), gli Authorized domains (Domini autorizzati) e le Developer contact information (Informazioni di contatto dello sviluppatore). Gli Authorized domains (Domini autorizzati) devono includere amazoncognito.com e la radice del dominio personalizzato, ad esempio example.com. Seleziona Salva e continua.

  8. 1. In Scopes (Ambiti), scegli Add or remove scopes (Aggiunta o rimozione di ambiti) e seleziona almeno i seguenti ambiti OAuth.

    1. .../auth/userinfo.email

    2. .../auth/userinfo.profile

    3. openid

  9. In Test users (Utenti di test), scegli Add users (Aggiungi utenti). Inserisci l'indirizzo e-mail e qualsiasi altro utente di test autorizzato, quindi scegli SAVE AND CONTINUE (Salva e continua).

  10. Espandi di nuovo la barra di navigazione a sinistra e seleziona APIs and Services (API e servizi), quindi Credentials (Credenziali).

  11. Scegli CREATE CREDENTIALS (Crea credenziali), quindi OAuth client ID (ID client OAuth).

  12. Scegli un Application type (Tipo di applicazione) e assegna un Name (Nome) al client.

  13. In JavaScript Origini autorizzate, scegli AGGIUNGI URI. Immetti il dominio del pool di utenti.

    https://mydomain.auth.us-east-1.amazoncognito.com

  14. In Authorized redirect URIs (URI di reindirizzamento autorizzati), scegli ADD URI (Aggiungi URI). Inserisci il percorso dell'endpoint /oauth2/idpresponse del dominio del pool di utenti.

    https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

  15. Scegli CREATE (Crea).

  16. Memorizza in modo sicuro i valori visualizzati da Google in Your client ID (Il tuo ID client) e Your client secret (Il tuo segreto del client). Fornisci questi valori ad Amazon Cognito quando aggiungi un gestore dell'identità digitale (IdP) Google.

Sign in with Apple

Per le informazioni più aggiornate sulla configurazione della funzionalità di accesso con Apple, consulta la sezione relativa alla configurazione dell'ambiente per la funzionalità di accesso con Apple nella documentazione per gli sviluppatori Apple.

Come registrare un'applicazione con Accedi con Apple (SIWA)

  1. Creazione di un account sviluppatore con Apple.

  2. Accedi con le tue credenziali Apple.

  3. Sulla barra di navigazione a sinistra, scegli Certificates, Identifiers & Profiles (Certificati, identificatori e profili).

  4. Nel riquadro di navigazione a sinistra, scegli Identifiers (Identificatori).

  5. Nella pagina Identifiers (Identificatori), scegli l'icona +.

  6. Nella pagina Register a New Identifier (Registra un nuovo identificatore), scegli App IDs (ID app), quindi scegli Continue (Continua).

  7. Nella pagina Select a type (Seleziona un tipo), scegli App, quindi Continue (Continua).

  8. Nella pagina Register an App ID (Registra un'ID app), procedi come indicato di seguito:

    1. In Description (Descrizione), inserisci una descrizione.

    2. In App ID Prefix (Prefisso ID app), inserisci un Bundle ID ID bundle. Prendi nota del valore alla voce Prefisso ID app. Ne avrai bisogno per configurare Apple come provider di identità in Configura il tuo pool di utenti con un IdP social.

    3. In Funzionalità, scegli Accedi con Apple, quindi scegli Modifica.

    4. Nella pagina Sign in with Apple: App ID Configuration (Accedi con Apple: configurazione ID app) scegli di configurare l'app come app primaria o raggruppata con altri ID app, quindi scegli Save (Salva).

    5. Scegli Continua.

  9. Nella pagina Confirm your App ID (Conferma l'ID app), scegli Register (Registra).

  10. Nella pagina Identifiers (Identificatori), scegli l'icona +.

  11. Nella pagina Register a New Identifier (Registra un nuovo identificatore), seleziona Services IDs (ID servizi), quindi scegli Continue (Continua).

  12. Nella pagina Register a Services ID (Registra un ID servizi), procedi nel modo seguente:

    1. In Description (Descrizione), digitare una descrizione.

    2. In Identifier (Identificatore), digitare un identificatore. Prendi nota dell'ID servizi poiché ne avrai bisogno per configurare Apple come provider di identità in Configura il tuo pool di utenti con un IdP social.

    3. Scegli Continue (Continua), quindi scegli Register (Registra).

  13. Scegli l'ID servizi appena creato dalla pagina Identificatori.

    1. Scegli Sign In with Apple (Accedi con Apple), quindi scegli Configure (Configura).

    2. Nella pagina Web Authentication Configuration (Configurazione autenticazione Web), seleziona l'ID dell'app creato in precedenza come Primary App ID (ID app principale).

    3. Scegli l'icona + accanto a Website URLs (URL siti Web).

    4. In Domains and subdomains (Domini e sottodomini), inserisci il dominio del pool di utenti senza prefisso https://.

      mydomain.auth.us-east-1.amazoncognito.com

    5. In Return URLs (URL restituiti), inserisci il percorso dell'endpoint /oauth2/idpresponse del dominio del pool di utenti.

      https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

    6. Scegli Next (Successivo), quindi Done (Fatto). Non è necessario verificare il dominio.

    7. Scegli Continua, quindi Salva.

  14. Nel riquadro di navigazione a sinistra, scegli Keys (Chiavi).

  15. Nella pagina Keys (Chiavi), scegli l'icona +.

  16. Nella pagina Register a New Key, (Registra una nuova chiave) procedi nel modo seguente:

    1. Alla voce Key Name (nome chiave), digita un nome della chiave.

    2. Scegli Accedi con Apple, quindi scegli Configura.

    3. Nella pagina Configure Key (Configura chiave) seleziona l'ID dell'app creato in precedenza come Primary App ID (ID app principale). Scegli Save (Salva).

    4. Scegli Continua, quindi scegli Registra.

  17. Nella pagina Download Your Key (download della chiave), scegli Download per scaricare la chiave privata, quindi prendi nota dell' ID chiave visualizzato, poi scegli Done (Fine). Avrai bisogno di questa chiave privata e del valore di Key ID (ID chiave) visualizzato in questa pagina dopo aver scelto Apple come provider di identità in Configura il tuo pool di utenti con un IdP social.

Configura il tuo pool di utenti con un IdP social

Per configurare un pool di utenti (social IdP) conConsole di gestione AWS

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

  2. Scegli User Pools (Pool di utenti).

  3. Scegli un pool di utenti esistente dall'elenco o crea un pool di utenti.

  4. Scegli il menu Social e provider esterni, quindi seleziona Aggiungi un provider di identità.

  5. Scegli un provider di identità social: Facebook, Google, Login with Amazon o Accedi con Apple.

  6. Scegli uno dei seguenti passaggi, in base al provider di identità social che hai selezionato:

    • Google e Login with Amazon: inserisci l'ID del client dell'app e il segreto client dell'app generato nella sezione precedente.

    • Facebook: inserisci l'ID del client dell'app e il segreto del client dell'app generato nella sezione precedente, quindi scegli una versione API (ad esempio, versione 2.12). Ti consigliamo di selezionare la versione più recente possibile in quanto ogni versione dell'API di Facebook ha un ciclo di vita e una data di deprecazione. Gli ambiti e gli attributi di Facebook possono variare a seconda delle versioni dell'API. Ti consigliamo di testare l'accesso alla tua identità social con Facebook per assicurarti che la federazione funzioni come previsto.

    • Accedi con Apple: inserisci l'ID servizio, l'ID team, l'ID chiave e la chiave privata generati nella sezione precedente.

  7. Inserisci i nomi degli ambiti autorizzati che intendi utilizzare. Gli ambiti definiscono a quali attributi utente (ad esempio name e email) intendi accedere con l'app. Per Facebook, devono essere separati da virgole. Per Google e Login with Amazon, devono essere separati da spazi. Per Sign in with Apple, seleziona le caselle di controllo per gli ambiti cui desideri accedere.

    Provider di identità social Ambiti di esempio
    Facebook public_profile, email
    Google profile email openid
    Login with Amazon profile postal_code
    Accedi con Apple email name

    All'utente dell'app viene richiesto il consenso a fornire questi attributi all'app. Per ulteriori informazioni sugli ambiti dei provider di social, consulta la documentazione di Google, Facebook, Login with Amazon e Accedi con Apple.

    Nel caso di Accedi con Apple, di seguito sono riportati scenari utente in cui gli ambiti potrebbero non essere restituiti:

    • Un utente finale rileva degli errori dopo aver chiuso la pagina di accesso di Apple (può derivare da errori interni di Amazon Cognito o da un errore di scrittura dello sviluppatore)

    • L'identificatore ID del servizio viene utilizzato tra pool di utenti e and/or altri servizi di autenticazione

    • Uno sviluppatore aggiunge ambiti dopo che l'utente finale ha effettuato l'accesso in precedenza (non viene recuperata nessuna nuova informazione)

    • Uno sviluppatore elimina l'utente e quindi l'utente effettua nuovamente l'accesso rimuovendo l'app dal profilo dell'ID Apple

  8. Mappa gli attributi dal provider di identità al bacino d'utenza. Per ulteriori informazioni, vedi Specificazione di mappature degli attributi del provider di identità per il pool di utenti.

  9. Scegli Create (Crea).

  10. Dal menu App client, seleziona un client di app dall'elenco. Per aggiungere il nuovo provider di identità social al client dell'app, vai alla scheda Pagine di accesso e seleziona Modifica nella configurazione delle pagine di accesso gestite.

  11. Scegli Save changes (Salva modifiche).

Test della configurazione dell'IdP social

Nella tua applicazione, devi richiamare un browser nel client dell'utente in modo che possa accedere con il suo provider di social network. Prova l'accesso con il tuo provider di social network dopo aver completato le procedure di configurazione nelle sezioni precedenti. L'URL di esempio seguente carica la pagina di accesso per il tuo pool di utenti con un dominio prefisso.


https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize?response_type=code&client_id=1example23456789&redirect_uri=https://www.example.com

Questo link è la pagina a cui Amazon Cognito ti indirizza quando accedi al menu App client, selezioni un client per l'app, accedi alla scheda Pagine di accesso e selezioni Visualizza pagina di accesso. Per ulteriori informazioni sui domini del pool di utenti, consulta. Configurazione di un dominio di bacino d'utenza Per ulteriori informazioni sui client delle app, inclusi gli ID client e gli URL di callback, consulta. Impostazioni specifiche dell'applicazione con client di app

Il seguente collegamento di esempio imposta il reindirizzamento silenzioso a un provider di social network dal parametro Endpoint Authorize with an identity_provider query. Questo URL ignora l'accesso interattivo al pool di utenti con accesso gestito e va direttamente alla pagina di accesso IdP.


https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize?identity_provider=Facebook|Google|LoginWithAmazon|SignInWithApple&response_type=code&client_id=1example23456789&redirect_uri=https://www.example.com