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.yml fornito dall’immagine, modificalo e montalo in docker-compose.override.yml (passo 5); docker compose up -d lo applica.
  • Servizio Linux (.deb): /etc/gebo-ai/application.properties, poi sudo systemctl restart gebo-ai.
  • Windows (.msi): config\application.properties nella 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_INVITATION riporta 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_IDENTITY le persone dietro i token diventano utenti alla loro prima chiamata; altrimenti creale come nella pagina 29.