Guida all’installazione di Gebo.ai · Sicurezza · Pagina 24b

Account Microsoft

Le persone entrano in Gebo.ai con un account Microsoft personale (Outlook.com, Hotmail, Live) o con l’account di lavoro delle organizzazioni che elenchi. Un’applicazione in Entra, una configurazione nelle impostazioni.

Tempo
15 minuti, più l’ID tenant di ogni organizzazione da ammettere.
Ti serve
Un tenant Microsoft Entra in cui puoi registrare applicazioni, e Gebo.ai aperto all’indirizzo che usano i tuoi utenti.

1Registra Gebo.ai in Entra

  1. Nell’interfaccia di amministrazione di Microsoft Entra apri Registrazioni app e clicca Nuova registrazione.
  2. Chiamala Gebo.ai e, in Tipi di account supportati, scegli l’opzione per gli account in qualsiasi directory organizzativa e account Microsoft personali. Clicca Registra. L’indirizzo di reindirizzamento arriva dopo.
  3. Nella Panoramica copia l’ID applicazione (client).
  4. In Certificati e segreti clicca Nuovo segreto client e copia subito il suo Valore: Entra lo mostra solo ora.
Solo la tua organizzazione?Se entrano solo le persone della tua organizzazione, la pagina 24 è la scelta più semplice: la sua applicazione ammette solo il tuo tenant.

2Apri le impostazioni di single sign-on

In Impostazioni apri Sicurezza (1) e clicca Single sign-on, autenticazione oauth2 (2), poi + Configurazione Oauth2.

La scheda Sicurezza delle impostazioni.
La scheda Sicurezza delle impostazioni.

3Inserisci l’applicazione

Una nuova configurazione per gli account Microsoft, che ammette gli account personali e un'organizzazione. Il segreto è ancora da inserire.
Una nuova configurazione per gli account Microsoft, che ammette gli account personali e un’organizzazione. Il segreto è ancora da inserire.
  1. Descrizione: il nome sul pulsante di accesso, per esempio Account Microsoft.
  2. Provider: Microsoft accounts auth provider (personal accounts and the organizations you list).
  3. Scopo della configurazione: Autenticazione.
  4. 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.
  5. ID client: l’identificativo che il provider ha assegnato a Gebo.ai.
  6. Chiave segreta: il segreto client che il provider ha assegnato a Gebo.ai.
  7. allowedTenants: chi può entrare, separati da virgole: consumers per gli account Microsoft personali, e l’ID tenant di ogni organizzazione da ammettere. Per esempio consumers, aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.
  8. Clicca Salva.

Ogni organizzazione trova il suo ID tenant nella Panoramica della sua interfaccia di amministrazione di Microsoft Entra. L’elenco vale dall’accesso successivo: per aggiungere o togliere un’organizzazione, Modifica la configurazione.

Ammetti solo organizzazioni di cui ti fidiGebo.ai riconosce le persone dall’indirizzo e-mail, e gli amministratori di un’organizzazione decidono gli indirizzi delle sue persone. Ammetti un’organizzazione solo se ti fidi dei suoi amministratori.

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

La configurazione salvata: il suo indirizzo di reindirizzamento (1) e il suo codice (2).
La configurazione salvata: il suo indirizzo di reindirizzamento (1) e il suo codice (2).

In Entra apri l’applicazione, Autenticazione → Aggiungi una piattaforma → Web, incolla l’indirizzo come URI di reindirizzamento e clicca Configura.

Prima apri Gebo.ai al suo indirizzo veroGli indirizzi sono costruiti dall’indirizzo a cui il browser ha aperto Gebo.ai. Apri Gebo.ai all’indirizzo che usano i tuoi utenti, per esempio 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.

Il pulsante Account Microsoft nella pagina di accesso.
Il pulsante Account Microsoft nella pagina di accesso.

Per impostazione predefinita Gebo.ai fa entrare le persone create da un amministratore: per ognuna crea un utente il cui Nome utente è l’indirizzo e-mail del suo account Microsoft 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.

6Se qualcuno non riesce a entrare

  • Una persona di un’organizzazione che manca da allowedTenants viene rifiutata, e così un account personale se manca consumers.
  • Gebo.ai riconosce le persone dall’indirizzo e-mail che Microsoft invia: assicurati che ogni account di lavoro ne abbia uno (la Posta elettronica dell’utente in Entra).
  • Se Microsoft chiede a una persona di un’organizzazione un consenso che non può dare, deve concederlo un amministratore di quell’organizzazione.