Guida all’installazione di Gebo.ai · Sicurezza · Pagina 26
AWS Cognito
Le tue persone entrano in Gebo.ai con gli account di un user pool di Amazon Cognito. Aggiungi Gebo.ai come app client del pool, poi inseriscilo nelle impostazioni.
- Tempo
- 15 minuti.
- Ti serve
- Un account AWS che possa gestire lo user pool, un dominio Cognito del pool, e Gebo.ai aperto all’indirizzo che usano i tuoi utenti.
1Aggiungi Gebo.ai allo user pool
- Nella console AWS apri Amazon Cognito → User pools e il pool. Copia il suo User pool ID, per esempio
eu-west-1_AbCdEf123: la parte prima del trattino basso è la regione. - In App clients clicca Create app client, scegli Traditional web application, chiamalo Gebo.ai e crealo. Copia il Client ID e il Client secret.
- In Domain controlla il dominio Cognito del pool,
https://<prefisso>.auth.<regione>.amazoncognito.com: a Gebo.ai serve solo il prefisso.
2Apri le impostazioni di single sign-on
In Impostazioni apri Sicurezza (1) e clicca Single sign-on, autenticazione oauth2 (2), poi + Configurazione Oauth2.

3Inserisci l’app client

- Descrizione: il nome sul pulsante di accesso, per esempio AWS Cognito.
- Provider: AWS Cognito Oauth2 provider.
- Scopo della configurazione: Autenticazione.
- Audience accettate: serve solo agli strumenti che chiamano l’API di Gebo.ai con token di questo provider (pagina 28b). Inserisci l’ID client del punto 5 per accettare solo i token destinati a Gebo.ai; vuoto, è accettato qualsiasi token firmato da questo provider. L’accesso con il pulsante non ne dipende.
- ID client: l’identificativo che il provider ha assegnato a Gebo.ai.
- Chiave segreta: il segreto client che il provider ha assegnato a Gebo.ai.
- cognitoDomain: solo il prefisso del dominio Cognito, per esempio
gebo-azienda. - userPoolId: lo User pool ID.
- region: la regione del pool, per esempio
eu-west-1. - Clicca Salva.
4Dai al provider l’indirizzo di reindirizzamento
Salva chiude la finestra. Clicca Modifica accanto alla nuova configurazione: Gebo.ai le ha assegnato un Codice (2) ed elenca gli indirizzi da abilitare sul provider. L’indirizzo di reindirizzamento da registrare è quello che finisce con /login/oauth2/code/ seguito dal codice (1).

In Cognito apri l’app client e modifica le sue Login pages: incolla l’indirizzo tra gli Allowed callback URLs, mantieni l’Authorization code grant e gli scope OpenID, Email e Profile, e salva.
https://gebo.azienda.it, prima di copiarlo: un indirizzo con localhost funziona solo sul server stesso.5Fai entrare le persone
La pagina di accesso mostra ora un pulsante con la Descrizione della configurazione.

Per impostazione predefinita Gebo.ai fa entrare le persone create da un amministratore: per ognuna crea un utente il cui Nome utente è il suo indirizzo e-mail nello user pool e il cui Provider di autenticazione è questo provider, come descritto nella pagina 29. Per rendere utente da sola ogni persona che il provider riconosce, vedi la pagina 28b.