Guida all’installazione di Gebo.ai · Sicurezza · Pagina 28b
Single sign-on: impostazioni della piattaforma
Due impostazioni del file di configurazione della piattaforma danno forma al single sign-on: se le persone che il tuo provider riconosce diventano utenti da sole, e come le tue applicazioni chiamano Gebo.ai con i token del tuo provider.
- Tempo
- 10 minuti.
- Ti serve
- L’accesso al server e un provider configurato come nelle pagine 24-28.
1Il file di configurazione
Le impostazioni vanno nel blocco ai.gebo.security del file di configurazione dell’installazione, e si applicano al riavvio di Gebo.ai.
- Docker Compose: nella cartella di
docker-compose.yml, copia fuori l’application.ymlfornito dall’immagine, modificalo e montalo indocker-compose.override.yml(passo 5);docker compose up -dlo applica. - Servizio Linux (
.deb):/etc/gebo-ai/application.properties, poisudo systemctl restart gebo-ai. - Windows (
.msi):config\application.propertiesnella cartella instance dell’installazione, poi riavvia il servizio Gebo.ai Service.
Con Docker Compose, copia fuori il file:
docker compose cp gebo.ai:/opt/gebo.ai/config/application.yml ./application.yml
e monta la tua copia: aggiungi la sua riga ai volumes del servizio gebo.ai in docker-compose.override.yml, oppure crea il file con:
services:
gebo.ai:
volumes:
- "./application.yml:/opt/gebo.ai/config/application.yml:ro"Quando aggiorni Gebo.ai, copia di nuovo il file della nuova immagine e riaggiungi le tue righe.
2Fai entrare le persone che il provider riconosce
Per impostazione predefinita Gebo.ai fa entrare gli utenti creati da un amministratore (pagina 29). Per rendere utente di Gebo.ai ogni persona a cui il tuo provider dà accesso, aggiungi loginPolicy al blocco ai.gebo.security, rientrato come le righe che seguono:
ai.gebo.security:
loginPolicy: TRUST_EVERY_OAUTH_IDENTITY
auth:
...In un file application.properties la stessa impostazione è una riga:
ai.gebo.security.loginPolicy=TRUST_EVERY_OAUTH_IDENTITY
- La prima volta che una persona accede attraverso un provider configurato, Gebo.ai crea il suo utente, con il suo indirizzo e-mail come Nome utente e il ruolo USER; ogni accesso successivo lo aggiorna. Lo stesso avviene la prima volta che una tua applicazione chiama l’API con il token di quella persona.
- Assegna ai nuovi utenti i loro gruppi e ruoli come nella pagina 29; per tenere fuori qualcuno, spunta Utente disabilitato sul suo utente.
- Sceglila per i provider i cui account appartengono tutti alla tua organizzazione, perché ogni account che riconoscono diventa un utente.
REQUIRE_INVITATIONriporta l’impostazione predefinita.
3Applicazioni che chiamano Gebo.ai con token OAuth2
Le tue applicazioni, lato client o lato server, possono chiamare l’API di Gebo.ai con gli access token di un provider configurato, accanto ai token che Gebo.ai emette da sé: oauth2ResourceServerEnabled è true per impostazione predefinita.
ai.gebo.security:
oauth2ResourceServerEnabled: true
auth:
...- In ogni configurazione del provider, elenca gli ID client delle tue applicazioni tra le Audience accettate (pagine 24-28): Gebo.ai accetta allora i token emessi per loro.
- Con
loginPolicy: TRUST_EVERY_OAUTH_IDENTITYle persone dietro i token diventano utenti alla loro prima chiamata; altrimenti creale come nella pagina 29.