SCIM-Bereitstellung für Benutzer und Gruppen

Benutzer erstellen und verwalten:

• Workspace-Mitglieder erstellen und entfernen

• Profilinformationen von Mitgliedern ändern

• Workspace-Mitglieder abrufen

  • Mitglieder anhand von E-Mail-Adresse und Namen suchen

Gruppen erstellen und verwalten:

• Workspace-Gruppen erstellen und entfernen

• Gruppenmitglieder hinzufügen und entfernen

• Workspace-Gruppe abrufen

  • Gruppen anhand von Namen suchen

Nicht unterstützt:

• Workspace-Gäste verwalten

Derzeit unterstützt Notion Okta-, Rippling- und spezifische SCIM-Anwendungen. Falls du einen anderen Identitätsanbieter nutzt, teile uns das bitte mit.

Enterprise Plan admins can generate and view their SCIM API token by going to Settings & Members → Security & identity → SCIM configuration.

Die Okta-Integration unterstützt die folgenden Bereitstellungsfunktionen:

• Benutzer erstellen

• Benutzerattribute ändern (sofern die jeweilige E-Mail-Domain deiner Organisation gehört)

• Benutzer deaktivieren (zum Löschen von Benutzern aus dem Notion-Workspace)

• Push-Gruppen

• Füge die Notion-App über das Integrationsverzeichnis von Okta hinzu.

• Unter „Bereitstellung“ aktivierst du nun die API-Integration.

• Gib das SCIM-API-Token von Notion aus deinem Workspace in das Feld „API-Token“ ein.

• Für das Benutzernamenformat der Anwendung wählst du in der Registerkarte „Sign-On-Anwendung“ „E-Mail“ aus. E-Mail-Adressen werden dabei immer in Kleinbuchstaben geschrieben.

• Nach der Einrichtung der API-Integration öffnest du die Registerkarte „Push-Gruppen“ und fügst über die gleichnamige Schaltfläche die Okta-Gruppen hinzu, die mit Notion synchronisiert werden sollen.

Bei Problemen mit der Bereitstellung über Okta kannst du uns jederzeit unter [email protected] erreichen.

• GET /ServiceProviderConfig

  • GET <https://api.notion.com/scim/v2/ServiceProviderConfig>

  • Ruft eine Beschreibung der verfügbaren SCIM-Funktionen ab

  • Die Definitionen finden sich in Abschnitt 5 der SCIM-Protokollspezifikation.

• GET /ResourceTypes

  • GET <https://api.notion.com/scim/v2/ResourceTypes>

  • Ruft eine Liste der verfügbaren SCIM-Ressourcen ab

  • Die Definitionen finden sich in Abschnitt 6 der SCIM-Protokollspezifikation.

In der Tabelle wird die Zuordnung von SCIM-Benutzerattributen zu Benutzerprofilfeldern in Notion dargestellt. Alle anderen Benutzerattribute werden ignoriert.

• GET /Users

  • GET <https://api.notion.com/scim/v2/Users>

  • Ruft eine paginierte Liste der Workspace-Mitglieder ab

  • Für die Paginierung eignen sich die Parameter startIndex und count. startIndex ist dabei 1-indiziert.

  • Die Ergebnisse können mit dem Parameter Filter gefiltert werden. Gültige Filterattribute sind email, given_name und family_name. Beispiel: GET <https://api.notion.com/scim/v2/Users?startIndex=1&count=50&filter=email> eq [email protected]

  • Bei given_name und family_name sollte man auf die korrekte Groß- und Kleinschreibung achten. E-Mail-Adressen werden in Kleinbuchstaben konvertiert.

• GET /Users/<id>

  • GET <https://api.notion.com/scim/v2/Users/><id>

  • Findet Workspace-Mitglieder anhand ihrer Benutzer-ID. Dabei handelt es sich um einen Universally Unique Identifier (UUID) mit 32 Zeichen im Format 00000000-0000-0000-0000-000000000000.

  • Achtung: meta.created und meta.lastModified geben keine aussagekräftigen Zeitstempelwerte wieder.

• POST /Users

  • POST <https://api.notion.com/scim/v2/Users>

  • Besitzt ein neu hinzugefügter Benutzer bereits ein Notion-Benutzerkonto mit derselben E-Mail-Adresse, wird er deinem Workspace hinzugefügt.

  • If the user does not exist, calling this will create a new Notion user and then add that user to your workspace. They will be mapped to the Notion user profile that is created.

• PATCH /Users/<id>

  • PATCH <https://api.notion.com/scim/v2/Users/><id>

  • Mehrstufige Aktualisierung und anschließende Erstellung des geänderten Benutzerdatensatzes

• PUT /Users/<id>

  • PUT <https://api.notion.com/scim/v2/Users/><id>

  • Aktualisierung und Ausgabe des geänderten Benutzerdatensatzes

• DELETE /Users/<id>

  • DELETE <https://api.notion.com/scim/v2/Users/><id>

  • Entfernt einen Benutzer aus dem Workspace. Der betroffene Benutzer wird dabei von allen laufenden Sitzungen abgemeldet.

  • Hinweis: Benutzerkonten können nicht über SCIM gelöscht werden. Konten müssen immer manuell gelöscht werden.

• GET /Groups

  • GET <https://api.notion.com/scim/v2/Groups>

  • Ruft eine paginierte Liste der Workspace-Gruppen ab

  • Für die Paginierung eignen sich die Parameter startIndex und count. startIndex ist dabei 1-indiziert. Beispiel: GET <https://api.notion.com/scim/v2/Groups?startIndex=1&count=5>

  • Die Ergebnisse können mit dem Parameter Filter gefiltert werden. Gruppen können anhand des displayName-Attributs gefiltert werden. Beispiel: GET <https://api.notion.com/scim/v2/Groups?filter=displayName> eq Designers

• GET /Groups/<id>

  • GET <https://api.notion.com/scim/v2/Groups/><id>

  • Findet Workspace-Mitglieder anhand ihrer Gruppen-ID. Dabei handelt es sich um einen Universally Unique Identifier (UUID) mit 32 Zeichen im Format 00000000-0000-0000-0000-000000000000.

• POST /Groups

  • POST <https://api.notion.com/scim/v2/Groups>

  • Erstellt eine neue Workspace-Gruppe

• PATCH /Groups/<id>

  • PATCH <https://api.notion.com/scim/v2/Groups/><id>

  • Mehrstufige Aktualisierung der Workspace-Gruppe

• PUT /Groups/<id>

  • PUT <https://api.notion.com/scim/v2/Groups/><id>

  • Aktualisiert die Workspace-Gruppe

• DELETE /Groups/<id>

  • DELETE <https://api.notion.com/scim/v2/Groups/><id>

  • Löscht die Workspace-Gruppe