> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizzazioni per app B2B: membri, ruoli e SSO aziendale

> Modella i tuoi clienti business come organizzazioni in Didit Authentication, con membri, ruoli, inviti, domini verificati, auto-join e SSO dedicato.

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.

> [!NOTE]
>
> 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](#mfa-per-gli-amministratori-dell’organizzazione)).

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Membri e ruoli

Una persona può appartenere a più organizzazioni della tua applicazione, con un ruolo in ciascuna.

| Ruolo | Destinato a |
| - | - |
| `admin` | Persone che gestiscono l'organizzazione nella tua applicazione. |
| `member` | Tutti gli altri. Il ruolo predefinito. |
| `billing` | Persone che gestiscono la fatturazione dell'organizzazione nella tua applicazione. |

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

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](https://docs.didit.me/it/authentication/sign-in-methods.md#sso-dell’organizzazione).

## 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](https://docs.didit.me/it/authentication/overview.md#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:

| Dove | Cosa contiene |
| - | - |
| `org` nei token di accesso e nel token ID | `{"id", "role"}` dell'appartenenza più risalente della persona a un'organizzazione, oppure `null`. |
| `organizations` in `GET /session/` | Ogni appartenenza, con `organization_id`, `organization__name`, `role` e `custom_role` (`key` e `permissions`, oppure `null`). |
| `organizations` nella sessione SDK | Lo stesso elenco, per esempio `session.organizations` in JavaScript e `user.organizations` in React. |

```json theme={null}
{
  "organizations": [
    {
      "organization_id": "3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b",
      "organization__name": "Northwind",
      "role": "admin",
      "custom_role": {"key": "approver", "permissions": ["payouts.approve"]}
    }
  ]
}
```

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](https://docs.didit.me/it/authentication/migration.md) da un'altra piattaforma, puoi portare con loro anche le appartenenze alle organizzazioni.
Consulta [link social, autenticatori e organizzazioni](https://docs.didit.me/it/authentication/migration.md#link-social-app-di-autenticazione-e-organizzazioni).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.