Zum Hauptinhalt springen

Wie richte ich die SCIM-Verzeichnissynchronisierung für meinen Gamma-Arbeitsbereich ein?

Richten Sie die SCIM-Verzeichnissynchronisierung für Gamma ein. SCIM-Provisionierung, Deprovisionierung, Verzeichnissynchronisierung, Okta, Microsoft Entra ID, Azure AD, Identitätsanbieter, Benutzerprovisionierung, Offboarding, Sitzplatzverwaltung, Wor...

Einführung

SCIM-Verzeichnissynchronisierung ermöglicht es Ihnen, die Mitglieder Ihres Gamma-Arbeitsbereichs direkt über Ihren Identitätsanbieter wie Okta oder Microsoft Entra ID zu verwalten. Nach der Verbindung wird durch das Hinzufügen einer Person zu Gamma in Ihrem Verzeichnis automatisch ihr Konto erstellt, und das Entfernen deaktiviert ihr Konto und gibt den Sitzplatz frei, ohne dass eine manuelle Bereinigung in Gamma erforderlich ist.

🔷 Hinweis: SCIM ist im Enterprise-Plan von Gamma verfügbar und erfordert, dass Single Sign-On (SSO) zuerst aktiviert ist. Sie benötigen Administratorzugang für den Arbeitsbereich in Gamma sowie Administratorzugang zu Ihrem Identitätsanbieter.

Wie SCIM im Vergleich zur Just-in-time-Provisionierung funktioniert

Gamma unterstützt zwei Möglichkeiten, Benutzer über SSO bereitzustellen.

  • Just-in-time (JIT) Provisionierung. Das Gamma-Konto eines Benutzers wird automatisch beim ersten Anmelden mit SSO erstellt. Dies funktioniert sofort ohne weitere Einrichtung außer SSO. Bis sich Personen anmelden, kann der Arbeitsbereich leer erscheinen, was normal ist.

  • SCIM-Provisionierung. Gamma synchronisiert Benutzerkonten direkt aus dem Verzeichnis Ihres Identitätsanbieters. Konten werden ohne erste Anmeldung erstellt, und das Entfernen einer Person aus Ihrem Verzeichnis deprovisioniert sie automatisch in Gamma.

Die meisten Teams beginnen mit JIT und fügen SCIM hinzu, wenn sie das Offboarding über das Verzeichnis steuern möchten.

SCIM einrichten

Bevor Sie beginnen

SCIM hat zwei Voraussetzungen.

  1. SSO muss für Ihren Arbeitsbereich aktiv sein. Die Verzeichnissynchronisierung baut auf Ihrer SSO-Verbindung auf, daher erscheint die Option zur Einrichtung erst, wenn SSO abgeschlossen ist.

  2. Fügen Sie zuerst alle Personen, die Zugriff auf Gamma benötigen, zu Ihrer Verzeichnisgruppe hinzu. Sobald SCIM aktiviert ist, ist Ihr Verzeichnis der einzige Zugang zum Arbeitsbereich für Personen in Ihren verifizierten Domains. Personen, die nicht im Verzeichnis sind, können nicht beitreten, auch nicht über SSO.

Schritt 1: Stellen Sie sicher, dass SSO aktiv ist

SCIM kann erst nach Abschluss der SSO-Einrichtung konfiguriert werden. Wenn Ihr Arbeitsbereich noch kein SSO hat, beginnen Sie dort.
​

Schritt 2: Öffnen Sie die Einstellungen für die Verzeichnissynchronisierung

Gehen Sie in Ihrem Arbeitsbereich zu Workspace Einstellungen > Sicherheit & Authentifizierung. Sobald SSO aktiv ist, sehen Sie einen Abschnitt Verzeichnissynchronisierung mit einer SCIM-Zeile.

Klicken Sie auf Konfigurieren, um ein sicheres Setup-Portal in einem neuen Tab zu öffnen.

Schritt 3: Verbinden Sie das Verzeichnis Ihres Identitätsanbieters

Das Setup-Portal führt Sie durch die Verbindung Ihres Verzeichnisses mit anbieter-spezifischen Anweisungen.

Nach der Verbindung führt Gamma eine erste Synchronisierung mit Ihrem Verzeichnis durch. Bestehende Arbeitsbereichsmitglieder werden per E-Mail abgeglichen, sodass ihre Konten verknüpft und nicht dupliziert werden, und ihre Inhalte bleiben unverändert.

Nach Abschluss der Synchronisierung zeigt die Seite Sicherheit & Authentifizierung die Verzeichnissynchronisierung als Aktiviert mit dem Aktivierungsdatum an. Ab diesem Zeitpunkt wird die Arbeitsbereichsmitgliedschaft über Ihren Identitätsanbieter verwaltet.

Wie die Mitgliedschaft funktioniert, sobald SCIM aktiv ist

Personen hinzufügen

  • Weisen Sie jemandem in Ihrem Identitätsanbieter Gamma zu, wird dessen Gamma-Konto automatisch erstellt. Sie erhalten keine Einladungsemail von Gamma. Sie melden sich einfach mit SSO an, und ihr Konto sowie die Arbeitsbereichsmitgliedschaft sind bereits vorhanden.

  • Wenn jemand bereits ein Gamma-Konto mit passender E-Mail hatte, wird dieses auf dieselbe Weise mit Ihrem Arbeitsbereich verknüpft, ebenfalls ohne E-Mail.

  • Neue Mitglieder treten als Mitglieder bei. Ein bestehender Administrator kann sie in den Workspace Einstellungen zum Administrator befördern.

  • SCIM synchronisiert die E-Mail, den Vornamen und Nachnamen jedes Benutzers. Profilaktualisierungen in Ihrem Verzeichnis werden automatisch mit Gamma synchronisiert.

🔷 Hinweis: Während SCIM aktiv ist, werden Einladungen, die von der Mitglieder-Seite in Gamma an E-Mails Ihrer SSO-verwalteten Domain gesendet werden, übersprungen und keine Einladungsemail versendet. Fügen Sie diese Personen stattdessen über Ihr Verzeichnis hinzu. Einladungen an E-Mails außerhalb Ihrer verwalteten Domain, wie externe Gäste, funktionieren weiterhin normal.

Personen entfernen

  • Entfernen oder weisen Sie jemanden in Ihrem Identitätsanbieter ab, wird dessen Gamma-Konto deaktiviert, er wird aus dem Arbeitsbereich entfernt, alle aktiven Sitzungen werden beendet und sein Sitzplatz sofort freigegeben. Es sind keine weiteren Schritte in Gamma erforderlich.

  • Wenn Sie die Person später erneut zuweisen, werden ihr Konto und ihre Inhalte beim nächsten Anmelden wiederhergestellt.

  • Alles, was sie im Unternehmensarbeitsbereich erstellt haben, bleibt dort mit unveränderten Berechtigungen. Um Inhalte eines ausscheidenden Mitarbeiters auf ein anderes Konto zu übertragen, kontaktieren Sie unser Support-Team.

💎 Profi-Tipp: Halten Sie mindestens zwei Administratoren in Ihrem Arbeitsbereich. Der einzige Administrator (oder Abrechnungsadministrator) kann nicht über SCIM deprovisioniert werden, was Sie davor schützt, sich selbst auszusperren, aber das Offboarding blockieren kann, wenn nur ein Administrator vorhanden ist.

Sitzplätze

  • Benutzer, die über Ihr Verzeichnis hinzugefügt werden, werden bereitgestellt, auch wenn Sie Ihre gekaufte Sitzplatzanzahl überschreiten, und Ihr Abonnement passt sich nicht automatisch an.

  • Planen Sie Ihre Sitzplatzanzahl, bevor Sie Ihre Gruppe im Identitätsanbieter zuweisen, und verwenden Sie Mitglieder > Sitzplätze verwalten, um Mitglieder und gekaufte Sitzplätze in Einklang zu halten.

FAQs & Häufige Probleme

Ich habe jemanden von der Mitglieder-Seite eingeladen, aber er hat die E-Mail nie erhalten.

  • Wenn die E-Mail-Adresse in Ihrer SSO-verwalteten Domain liegt, wird die Einladung übersprungen, solange SCIM aktiv ist.

  • Fügen Sie die Person stattdessen in Ihrem Identitätsanbieter-Verzeichnis zu Gamma hinzu.

Jemand in meinem Team sieht eine Fehlermeldung, dass unsere Organisation Verzeichnissynchronisierung verwendet.

  • Die Person wurde noch nicht in Ihrem Identitätsanbieter zu Gamma hinzugefügt.

  • Bitten Sie Ihren IT-Administrator, die Person im Verzeichnis Gamma zuzuweisen, und lassen Sie sie sich dann erneut anmelden.

Erhalten bereitgestellte Benutzer eine Willkommens- oder Einladungsemail?

  • Nein. Gamma erstellt das Konto still im Hintergrund.

  • Wenn eine Benachrichtigung versendet wird, kommt sie von Ihrem Identitätsanbieter, nicht von Gamma.

Können wir die Arbeitsbereichsmitgliedschaft mit Identitätsanbieter-Gruppen steuern oder Gruppen Rollen zuordnen?

  • Noch nicht. Gruppensynchronisierung steht auf unserer Roadmap.

  • Jeder, der über SSO oder SCIM bereitgestellt wird, tritt als Mitglied bei, und Administratorrechte müssen manuell in Gamma vergeben werden.

Wir haben jemanden in unserem Identitätsanbieter entfernt, aber SCIM nicht eingerichtet. Ist die Person raus?

  • Ohne SCIM blockiert das Entfernen einer Person aus Ihrem IdP neue Anmeldungen, aber eine bestehende Sitzung bleibt bis zum Ablauf aktiv, und der Sitzplatz wird nicht automatisch freigegeben.

  • Entfernen Sie die Person aus Workspace Einstellungen > Mitglieder, um den Sitzplatz freizugeben. Dies ist genau der manuelle Schritt, den SCIM überflüssig macht.

Können wir SCIM später deaktivieren?

  • Wenden Sie sich an unser Support-Team, wir helfen Ihnen, die Verzeichnissynchronisierung zu deaktivieren oder neu zu konfigurieren.

Hat dies deine Frage beantwortet?