FlytBaseFlytBase Documentation

Single Sign-On aziendale (SSO)

Getting started with your FlytBase Account

FlytBase supporta Enterprise Single Sign-On (SSO), consentendo alle organizzazioni di integrare il proprio provider di identità (IdP) esistente, come Azure Active Directory, Okta o Ping Identity, per autenticare gli utenti.

Questa funzionalità è progettata per le aziende che utilizzano sistemi drone-in-a-box su larga scala, dove la sicurezza e la conformità sono fondamentali. Collegando il tuo IdP, puoi centralizzare l'autenticazione, applicare le policy di sicurezza aziendali esistenti e semplificare l'onboarding degli utenti senza creare credenziali FlytBase separate.

Come funziona

FlytBase implementa OAuth 2.0 con OpenID Connect (OIDC) come standard di autenticazione. Quando un utente tenta di accedere:

  1. FlytBase reindirizza la richiesta di accesso al tuo IdP.
  2. L'IdP convalida l'identità dell'utente (inclusi MFA, policy password o regole di accesso condizionato).
  3. Una volta completata l'autenticazione, l'IdP restituisce i token a FlytBase.
  4. FlytBase convalida questi token utilizzando il JWKS (JSON Web Key Set) dell'IdP e concede l'accesso.

Questo flusso garantisce che FlytBase non gestisca mai direttamente le password dei tuoi utenti.

Standard supportati

  • Protocollo: OAuth 2.0 + OIDC
  • Flows: flusso del codice di autorizzazione (con supporto PKCE)
  • Ambiti: openid, profilo, email
  • Crittografia: TLS 1.2+ applicato su tutte le connessioni

Passaggi di configurazione

Passaggio 1: registra FlytBase nel tuo IdP

  • Nella console IdP (Azure AD, Okta e così via), crea una nuova applicazione/client.
  • Selezionare OIDC/OAuth 2.0 come protocollo di autenticazione.
  • Aggiungi l'URI di reindirizzamento fornito da FlytBase (esempio: https://<org>.flytbase.com/auth/callback).
  • Concedi i seguenti ambiti: openid, profile, email.

Passaggio 2: condividi i dettagli dell'IdP con FlytBase

Il tuo team IT deve fornire quanto segue al responsabile tecnico FlytBase:

  • URL dell'endpoint di autorizzazione
  • URL dell'endpoint del token
  • URL dell'endpoint JWKS
  • ID cliente e segreto cliente

Passaggio 3: configurazione FlytBase

Il team FlytBase configurerà la tua organizzazione con i metadati IdP forniti.

Passaggio 4: convalida dell'integrazione

  • Testare il flusso di accesso in fase di staging.
  • Conferma lo scambio di token e la mappatura dell'identità dell'utente.
  • Una volta completata l'operazione, distribuiscilo in produzione.

Mappatura e ruoli degli utenti

  • Se l'e-mail di un account FlytBase esistente corrisponde all'e-mail dell'IdP, l'utente viene automaticamente collegato, senza perdita di dati.
  • I nuovi utenti vengono creati al primo accesso (provisioning Just-In-Time).
  • I ruoli (amministratore, operatore, visualizzatore) continuano a essere gestiti in FlytBase utilizzando il controllo degli accessi basato sui ruoli (RBAC).

Considerazioni sulla distribuzione

  • Cloud: funziona immediatamente.
  • In sede: richiede la connettività tra il server FlytBase e gli endpoint IdP.
  • Air-Gapped: supportato con metadati IdP pre-condivisi e convalida offline; consultare il supporto FlytBase.

Risoluzione dei problemi

  • Reindirizzamento mancata corrispondenza dell'URI → Assicurati che gli URI corrispondano esattamente in IdP e FlytBase.
  • Errore di ambito non valido → Conferma che openid, profilo ed e-mail sono concessi.
  • Errore di convalida del token → Verificare che l'endpoint JWKS sia raggiungibile.
  • Utente non trovato → Controlla se l'e-mail dell'utente nell'IdP corrisponde al suo profilo FlytBase.

I registri di sistema per i tentativi di autenticazione possono essere esaminati in Admin Console → Registri di sistema → Eventi di autenticazione.

Was this helpful?