Vai al contenuto principale
Didit Authentication consente alla tua applicazione B2B di raggruppare gli utenti in base all’azienda per cui lavorano. Ogni organizzazione ha i propri membri e i propri ruoli, può verificare i domini email in modo che i colleghi si uniscano automaticamente e può autenticare i propri utenti tramite il proprio provider di identità SAML o OIDC. La tua app legge le organizzazioni e i ruoli della persona dal suo token e dalla sua sessione, e decide cosa ciascun ruolo può fare.
Un’organizzazione, in questo contesto, è uno dei tuoi clienti all’interno della tua applicazione. Non coincide con la tua organizzazione Didit, che include il tuo team nella Business Console.

Attiva le organizzazioni

Le organizzazioni sono disattivate per una nuova applicazione. Apri Authentication > Organizations nella console e, nella scheda Settings:
  • Attiva Organizations.
  • Scegli il Default role for new members, cioè il ruolo che le persone ricevono quando si uniscono tramite un dominio verificato o single sign-on (member per impostazione predefinita).
  • Lascia attiva Require MFA for organization admins, la policy MFA predefinita (vedi sotto).
Poi gestisci le organizzazioni nella console: New organization crea un’organizzazione con il suo nome e uno slug, univoco nell’applicazione. Le organizzazioni vengono create dal tuo team; al momento le persone non possono creare le proprie organizzazioni dalla tua app. L’elenco mostra per ogni organizzazione i membri, i domini verificati, lo stato del single sign-on, la regola MFA e la data di creazione. Sopra l’elenco, le metriche principali contano organizzazioni, membri, connessioni SSO e domini verificati.
La pagina Organizations nella Didit Business Console, con le metriche principali e un elenco di organizzazioni con i rispettivi membri, domini verificati e stato del single sign-on

Authentication > Organizations.

Membri e ruoli

Una persona può appartenere a più organizzazioni della tua applicazione, con un ruolo in ciascuna. Sui piani Scale ed Enterprise, e in ogni applicazione Sandbox, puoi anche definire ruoli personalizzati, ciascuno con una chiave e i permessi che la tua app verifica, ad esempio payouts.approve. Un membro può avere un ruolo personalizzato in aggiunta al proprio ruolo. Apri un’organizzazione per vedere il suo single sign-on, i domini verificati, i membri, i ruoli e gli inviti.
Un'organizzazione aperta nella Didit Business Console, con l'accesso singolo SAML e un link di configurazione, un dominio verificato con adesione automatica, e i suoi membri e ruoli

Il single sign-on, i domini verificati, i membri e i ruoli di un'organizzazione.

Inviti

Scegli Invite member in un’organizzazione, inserisci fino a 20 indirizzi email e il ruolo che ciascuno riceverà (admin, member o billing), e Didit invia un’email con l’invito a ogni persona. Un invito dura 7 giorni e apre la pagina ospitata /invite all’origine usata per l’accesso, dove la persona accede o crea un account e si unisce all’organizzazione. L’elenco Invitations dell’organizzazione mostra la scadenza di ciascun invito, con Resend e Revoke.

Domini verificati e auto-join

Un’organizzazione può dimostrare di possedere un dominio email:
  1. Aggiungi il dominio all’organizzazione.
  2. Aggiungi presso il tuo provider DNS il record TXT che Didit mostra in _didit-auth.<domain>, contenente il token di verifica.
  3. Verifica il dominio. Viene mostrato come Verified una volta trovato il record.
Con Auto-join attivo per un dominio verificato, una persona che accede con un indirizzo email verificato di quel dominio entra automaticamente nell’organizzazione, con il tuo ruolo predefinito. Un dominio può consentire l’accesso automatico a una sola organizzazione della tua applicazione.

Single sign-on aziendale

Un’organizzazione può far accedere i propri utenti tramite il proprio provider di identità, con SAML o OIDC.
  • Link di configurazione. Scegli Copy setup link nella scheda Single sign-on dell’organizzazione e condividilo in modo sicuro con l’amministratore IT dell’organizzazione. Il link resta valido per sette giorni e guida l’amministratore nella configurazione della connessione. I link di configurazione richiedono il piano Scale o Enterprise; le applicazioni sandbox li hanno su qualsiasi piano.
  • SAML. I metadati del tuo provider di servizi sono pubblicati in {origin}/sso/saml/metadata/.
  • Individuazione della connessione. La pagina di accesso ospitata trova la connessione dell’organizzazione a partire dal dominio email verificato della persona, da Use single sign-on oppure da organization=<slug> nell’URL di accesso.
  • Stato. L’elenco delle organizzazioni indica se ogni connessione è attiva, non configurata o in attesa di un link di configurazione inviato.
Le persone che accedono tramite il provider di identità di un’organizzazione entrano a far parte dell’organizzazione con il tuo ruolo predefinito. I campi di configurazione di ciascun protocollo sono descritti in metodi di accesso.

MFA per gli amministratori dell’organizzazione

La policy MFA predefinita, organization_admins, richiede un secondo fattore a tutte le persone che hanno il ruolo admin in una qualsiasi organizzazione della tua applicazione. Chi diventa amministratore deve registrare un fattore, e GET /session/ smette di accettare la sua sessione finché questa non soddisfa di nuovo la policy. Puoi modificare la policy in Authentication > Security and sessions, oppure con mfa_policy nelle impostazioni dell’applicazione.

Leggere le organizzazioni nella tua app

Quando le organizzazioni sono attive, i token e la sessione della persona indicano alla tua app a quali organizzazioni appartiene:
Verifica il ruolo e le autorizzazioni nel tuo backend, a partire da un token verificato o da GET /session/, prima di ogni azione che ne dipende. Quando le organizzazioni sono disattivate, org è null e l’elenco è vuoto.

Importare organizzazioni esistenti

Quando importi gli utenti da un’altra piattaforma, puoi portare con loro anche le appartenenze alle organizzazioni. Consulta link social, autenticatori e organizzazioni.
Ultima modifica il 22 novembre 2026