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

# Organisationen für B2B-Apps: Mitglieder, Rollen und Unternehmens-SSO

> Bilden Sie Geschäftskunden als Organisationen in Didit Authentication ab: mit Mitgliedern, Rollen, verifizierten Domains und eigenem SSO.

Mit den Organisationen von Didit Authentication kann eine B2B-Anwendung ihre Benutzer nach dem Unternehmen gruppieren, für das sie arbeiten.
Jede Organisation hat eigene Mitglieder und Rollen, kann ihre E-Mail-Domains verifizieren, damit Kollegen automatisch beitreten, und kann ihre Benutzer über ihren eigenen SAML- oder OIDC-Identitätsanbieter anmelden lassen.
Ihre App liest die Organisationen und Rollen der Person aus deren Token und Sitzung und legt fest, was jede Rolle tun darf.

> [!NOTE]
>
> Eine Organisation ist hier einer **Ihrer** Kunden innerhalb Ihrer Anwendung.
> Sie ist getrennt von Ihrer Didit-Organisation, die Ihr eigenes Team in der Business Console enthält.

## Organisationen aktivieren

Für eine neue Anwendung sind Organisationen deaktiviert.
Öffnen Sie in der Konsole **Authentication > Organizations** und nehmen Sie die Einstellungen in der Karte **Settings** vor:

* Aktivieren Sie **Organizations**.
* Wählen Sie die **Default role for new members**, also die Rolle, die Personen erhalten, wenn sie einer verifizierten Domain beitreten oder sich per Single Sign-on anmelden (standardmäßig `member`).
* Lassen Sie **Require MFA for organization admins** aktiviert, die Standard-MFA-Richtlinie (siehe [unten](#mfa-für-organisationsadministratoren)).

Anschließend verwalten Sie Organisationen in der Konsole: Mit **New organization** erstellen Sie eine Organisation mit ihrem Namen und einem innerhalb der Anwendung eindeutigen Slug.
Ihre Organisationen werden von Ihrem Team angelegt. Personen können über Ihre App noch keine eigenen Organisationen erstellen.
Die Liste zeigt für jede Organisation die Mitglieder, verifizierten Domains, den Status von Single Sign-on, die MFA-Regel und das Erstellungsdatum. Die darüber angezeigten wichtigsten Kennzahlen geben die Anzahl der Organisationen, Mitglieder, SSO-Verbindungen und verifizierten Domains an.

![Die Seite Organizations in der Didit Business Console mit den wichtigsten Kennzahlen und einer Liste der Organisationen mit ihren Mitgliedern, verifizierten Domains und dem Status von 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.

## Mitglieder und Rollen

Eine Person kann mehreren Organisationen Ihrer Anwendung angehören, mit jeweils einer Rolle in jeder davon.

| Rolle | Vorgesehen für |
| - | - |
| `admin` | Personen, die die Organisation in Ihrer Anwendung verwalten. |
| `member` | Alle anderen. Die Standardrolle. |
| `billing` | Personen, die die Abrechnung der Organisation in Ihrer Anwendung betreuen. |

Auf den Tarifen Scale und Enterprise sowie in jeder Sandbox-Anwendung können Sie außerdem **benutzerdefinierte Rollen** definieren, jeweils mit einem Schlüssel und den Berechtigungen, die Ihre Anwendung prüft, zum Beispiel `payouts.approve`.
Ein Mitglied kann zusätzlich zu seiner Rolle eine benutzerdefinierte Rolle haben.

Öffnen Sie eine Organisation, um ihren Single Sign-on, ihre verifizierten Domains, Mitglieder, Rollen und Einladungen zu sehen.

![Eine Organisation, geöffnet in der Didit Business Console, mit ihrem SAML-Single-Sign-on und einem Setup-Link, einer verifizierten Domain mit Auto-Join sowie ihren Mitgliedern und Rollen](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

Single Sign-on, verifizierte Domains, Mitglieder und Rollen einer Organisation.

## Einladungen

Wählen Sie bei einer Organisation **Invite member** aus, geben Sie bis zu 20 E-Mail-Adressen und die Rolle ein, die sie erhalten (`admin`, `member` oder `billing`), und Didit schickt jeder Person eine Einladung per E-Mail.
Eine Einladung gilt 7 Tage und öffnet die gehostete Seite `/invite` unter dem Origin Ihrer Anmeldung. Dort meldet sich die Person an oder erstellt ein Konto und tritt der Organisation bei.
In der Liste **Invitations** der Organisation sehen Sie, wann jede Einladung abläuft, und können sie mit **Resend** erneut senden oder mit **Revoke** widerrufen.

## Verifizierte Domains und Auto-Join

Eine Organisation kann nachweisen, dass sie eine E-Mail-Domain besitzt:

1. Fügen Sie die Domain zur Organisation hinzu.
2. Fügen Sie bei Ihrem DNS-Anbieter den TXT-Eintrag, den Didit anzeigt, unter `_didit-auth.<domain>` hinzu. Der Eintrag enthält den Verifizierungs-Token.
3. Prüfen Sie die Domain. Sie wird als **Verified** angezeigt, sobald der Eintrag gefunden wurde.

Wenn **Auto-join** für eine verifizierte Domain aktiviert ist, tritt eine Person, die sich mit einer verifizierten E-Mail-Adresse dieser Domain anmeldet, der Organisation automatisch bei und erhält dabei die Standardrolle.
Eine Domain kann das automatische Beitreten nur für eine Organisation Ihrer Anwendung aktivieren.

## Single Sign-on für Unternehmen

Eine Organisation kann ihre Benutzer über ihren eigenen Identity Provider anmelden lassen, mit SAML oder OIDC.

* **Setup-Link.** Wählen Sie **Copy setup link** in der Karte **Single sign-on** der Organisation und teilen Sie den Link sicher mit dem IT-Administrator der Organisation. Er ist sieben Tage lang gültig und führt den Administrator durch die Einrichtung der Verbindung. Setup-Links erfordern den Tarif Scale oder Enterprise; Sandbox-Anwendungen haben sie in jedem Tarif.
* **SAML.** Ihre Service-Provider-Metadaten sind unter `{origin}/sso/saml/metadata/` veröffentlicht.
* **Verbindung finden.** Die gehostete Anmeldeseite ermittelt die Verbindung der Organisation anhand der verifizierten E-Mail-Domain des Benutzers, über **Use single sign-on** oder über `organization=<slug>` in der Anmelde-URL.
* **Status.** Die Organisationsliste zeigt an, ob jede Verbindung aktiv ist, nicht eingerichtet ist oder auf einen gesendeten Setup-Link wartet.

Benutzer, die sich über den Identity Provider einer Organisation anmelden, werden mit Ihrer Standardrolle Mitglied dieser Organisation.
Die Konfigurationsfelder jedes Protokolls finden Sie unter [Anmeldemethoden](https://docs.didit.me/de/authentication/sign-in-methods.md#organisations-sso).

## MFA für Organisationsadministratoren

Die Standardrichtlinie für MFA, `organization_admins`, verlangt einen zweiten Faktor von jeder Person, die in einer Organisation Ihrer Anwendung die Rolle `admin` innehat.
Eine Person, die Administrator wird, muss einen Faktor hinterlegen, und `GET /session/` akzeptiert ihre Sitzung erst wieder, wenn die Sitzung die Richtlinie wieder erfüllt.
Ändern Sie die Richtlinie unter **Authentication > Security and sessions** oder mit `mfa_policy` in den [Anwendungseinstellungen](https://docs.didit.me/de/authentication/overview.md#anwendungseinstellungen).

## Organisationen in Ihrer App auslesen

Solange Organisationen aktiviert sind, zeigen die Tokens und die Sitzung der Person Ihrer App an, welcher Organisation sie angehört:

| Ort | Inhalt |
| - | - |
| `org`-Claim im Access- und ID-Token | `{"id", "role"}` der ältesten Organisationsmitgliedschaft der Person oder `null`. |
| `organizations` in `GET /session/` | Jede Mitgliedschaft mit `organization_id`, `organization__name`, `role` und `custom_role` (`key` und `permissions` oder `null`). |
| `organizations` in der SDK-Sitzung | Dieselbe Liste, zum Beispiel `session.organizations` in JavaScript und `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"]}
    }
  ]
}
```

Prüfen Sie Rolle und Berechtigungen in Ihrem Backend, entweder anhand eines verifizierten Tokens oder über `GET /session/`, bevor Sie eine Aktion ausführen, die davon abhängt.
Wenn Organisationen deaktiviert sind, ist `org` gleich `null` und die Liste ist leer.

## Bestehende Organisationen importieren

Wenn Sie [Benutzer](https://docs.didit.me/de/authentication/migration.md) von einer anderen Plattform importieren, können Sie deren Organisationsmitgliedschaften gleich mitübernehmen.
Siehe [Social-Links, Authentifikatoren und Organisationen](https://docs.didit.me/de/authentication/migration.md#social-links-authenticator-apps-und-organisationen).


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