Anleitung zur benutzerdefinierten SAML-SCIM-Konfiguration über Entra ID

Benutzerdefinierte SAML-Anwendungen, die in Microsoft Entra ID erstellt wurden, bieten eine eingeschränkte automatische Bereitstellung, einschließlich der Erstellung und Entfernung von Benutzern.

Microsoft Entra ID hieß früher Azure.

Was du brauchst

  • Bevor du die Bereitstellung einrichten kannst, muss benutzerdefiniertes SAML für deinen Workspace aktiviert sein.
  • Nur Entra ID-Admins können Entra ID SCIM konfigurieren.
  • Für die Bereitstellung ist eine benutzerdefinierte Nicht-Galerie-Anwendung in Microsoft Entra ID erforderlich. Die Galerie-Anwendung ClickUp Productivity Platform unterstützt kein SCIM und kann keine Gruppen bereitstellen.

Benutzerdefinierte SAML-Anwendung in Microsoft Entra ID einrichten

So richtest du die benutzerdefinierte SAML-Anwendung ein:

  1. Erstelle eine neue benutzerdefinierte SAML-Anwendung in Microsoft Entra ID. Dies ist nicht die offizielle ClickUp Microsoft Entra ID-Galerie-Anwendung ClickUp Productivity Platform.

Screenshot einer Person, die eine neue benutzerdefinierte SAML-App in Microsoft Entra ID einrichtet.

  1. Klicke in ClickUp oben links auf deinen Workspace-Avatar.
  2. Wähle Einstellungen aus.
  3. Klicke in der Seitenleiste „Alle Einstellungen" auf Sicherheit & Berechtigungen.
  4. Wähle im Abschnitt Single Sign-on (SSO) die Option SAML aus.

    Screenshot der SAML-Option in den Sicherheits- und Berechtigungseinstellungen von ClickUp.

  5. Kopiere für eine neue Microsoft Entra ID-App die SP-Entitäts-ID aus ClickUp.

    Screenshot der SP-Entitäts-ID aus ClickUp.

  6. Füge die SP-Entitäts-ID aus ClickUp in das Feld Bezeichner (Entitäts-ID) in Microsoft Entra ID ein.

    Screenshot einer Person, die die SP-Entitäts-ID in das Bezeichner-Feld einfügt.

  7. Kopiere die Single Sign-on-URL (ACS-URL) aus ClickUp und füge sie in das Feld Antwort-URL (Assertion Consumer Service-URL) in Microsoft Entra ID ein.
  8. Klicke in Microsoft Entra ID auf Speichern.

Screenshot der Schaltfläche „Speichern

SSO in ClickUp verknüpfen

Jetzt, wo die Anwendung eingerichtet ist, kannst du die SSO-Verbindung in ClickUp abschließen:

  1. Stelle sicher, dass die Person, die die SSO-Integration einrichtet, in der Microsoft Entra ID-App zugewiesen ist. Weitere Personen können später hinzugefügt werden.
  2. Kopiere die Anmelde-URL und das Öffentliche IDP-Zertifikat aus Microsoft Entra ID.

Screenshot der Anmelde-URL und des öffentlichen IDP-Zertifikats in Microsoft Entra ID

  1. Füge diese Werte als Klartext in die entsprechenden leeren ClickUp-Felder ein, wenn du den SAML-Connector auswählst.

    Screenshot eines Zertifikats.

    • Um das Zertifikat als Klartext zu erhalten, lade die Datei herunter und öffne sie per Rechtsklick in einem Texteditor deiner Wahl. Der Text beginnt mit -----BEGIN CERTIFICATE-----. Füge den gesamten Textwert ohne Änderungen in das Feld Öffentliches IDP-Zertifikat ein.
  2. Wähle Metadaten speichern.

    Screenshot der Schaltfläche „Metadaten speichern

  3. Du wirst aufgefordert, die Verknüpfung abzuschließen, indem du dich per SSO anmeldest. War das erfolgreich, wirst du zu ClickUp weitergeleitet.
  4. Auf der Seite Sicherheit & Berechtigungen in ClickUp siehst du drei neue Optionen:
    • SCIM-Basis-URL: Diese Information gibst du im nächsten Schritt ein.
    • SCIM-API-Token: Diese Information gibst du im nächsten Schritt ein.
    • Anmelderichtlinie: Wähle eine dieser vier Optionen:
    • Alle Benutzer müssen SAML-Authentifizierung verwenden: Alle Benutzer vom Typ Mitglied und vom Typ Gast müssen SAML-Authentifizierung verwenden.
    • Alle Benutzer außer Gästen müssen SAML-Authentifizierung verwenden: Benutzer vom Typ Gast müssen keine SAML-Authentifizierung verwenden.
    • Alle Benutzer außer eingeschränkten Mitgliedern und Gästen müssen SAML-Authentifizierung verwenden: Eingeschränkte Mitglieder, eingeschränkte Mitglieder mit Lesezugriff und alle Benutzer vom Typ Gast müssen keine SAML-Authentifizierung verwenden.
    • SAML-Authentifizierung ist optional: Die Verwendung von SAML-Authentifizierung ist für alle Benutzer optional.
  5. Gehe zum nächsten Schritt, um die anderen Personen in deinem Workspace bereitzustellen.

Vor der Bereitstellung von Gruppen

Überprüfe diese Einschränkungen, bevor du Microsoft Entra ID-Gruppen in ClickUp überträgst:

  • Die Bereitstellung erstellt neue Teams. Es ist nicht möglich, eine Gruppe mit einem Team zu verknüpfen, das bereits in deinem Workspace vorhanden ist.
  • Verschachtelte Gruppen werden nicht unterstützt.
  • Jeder Nutzer kann nur eine App-Rolle haben. Die Bereitstellung schlägt fehl, wenn ein Nutzer eine Rolle direkt und eine andere über eine Gruppe erhält oder unterschiedliche Rollen über zwei Gruppen zugewiesen bekommt.
  • Wenn du benutzerdefinierte App-Rollen verwendest, muss jeder zugewiesenen Gruppe eine Rolle zugewiesen sein. Gruppen ohne Rolle werden nicht unterstützt.
  • Gäste mit reinem Lesezugriff, die einem Team hinzugefügt wurden, werden in Gäste umgewandelt, die einen kostenpflichtigen Platz belegen können. Überprüfe die Gastmitgliedschaft in deinen Gruppen, bevor du sie bereitstellst.
  • Durch die Bereitstellung erhält ein Team keinen Zugriff auf Spaces, Ordner, Unterordner oder Listen.

Automatische Bereitstellung mit ClickUp einrichten

Wir unterstützen die Bereitstellung einzelner Benutzer und Gruppen mit SCIM. Wenn du Gruppen für ClickUp bereitstellst, werden neue Benutzer als Einzelpersonen bereitgestellt, und sowohl neue als auch bestehende Benutzer werden einem ClickUp Team hinzugefügt. Wenn du nicht möchtest, dass diese Benutzer einem Team hinzugefügt werden, lösche das Team nach der Bereitstellung.

Wenn du ein Benutzerprofil zur benutzerdefinierten SAML-App hinzufügst, ist die betreffende Person erst dann ein ClickUp-Benutzer, wenn du sie über SCIM bereitstellst.

Die automatische Bereitstellung kann bei Bedarf oder in Zyklen erfolgen, die standardmäßig alle 30 Minuten laufen. Benutzer, die der Anwendung zugewiesen sind, werden erst beim nächsten automatischen Bereitstellungszyklus hinzugefügt. Erfahre mehr darüber, wie die Anwendungsbereitstellung in Microsoft Entra ID funktioniert.

Screenshot der Schaltfläche „Bei Bedarf bereitstellen

So richtest du die automatische Bereitstellung ein:

  1. Öffne in Microsoft Entra ID die Registerkarte Bereitstellung und ändere das Dropdown-Menü von Manuell auf Automatisch. Dadurch erscheint das Fenster Administratoranmeldeinformationen auf der Registerkarte Bereitstellung.
    • Wenn du manuell bis zu fünf Benutzer gleichzeitig bereitstellen möchtest, wähle auf der Registerkarte „Bereitstellung" Bei Bedarf bereitstellen aus.

      Screenshot des Fensters für Administratoranmeldeinformationen auf der Registerkarte „Bereitstellung

  2. Gib die SCIM-Basis-URL von deiner ClickUp-Seite für Sicherheit & Berechtigungen in das Feld Mandanten-URL ein.
  3. Gib das SCIM-API-Token von deiner ClickUp-Seite für Sicherheit & Berechtigungen in das Feld Geheimes Token ein.
  4. Klicke auf Verbindung testen.

    Screenshot der Schaltfläche „Verbindung testen

  5. Klicke nach erfolgreichem Test auf Speichern.
  6. Klicke auf der Bereitstellungsseite auf Zuordnungen. Stelle sicher, dass sowohl Microsoft Entra ID-Benutzer bereitstellen als auch Microsoft Entra ID-Gruppen bereitstellen aktiviert sind. Wenn die Gruppenzuordnung deaktiviert ist, werden keine Teams erstellt.
  7. Nach dem Speichern ist SCIM in deinem Workspace eingerichtet. Benutzer können sich mit Microsoft Entra ID bei ClickUp anmelden.

Wähle die ClickUp-Benutzerrollen aus, die du bereitstellen möchtest

Die Benutzerrolle ist standardmäßig auf Mitglied gesetzt, es sei denn, du wählst die ClickUp-Benutzerrollen aus, die du bereitstellen möchtest.

So ordnest du Microsoft Entra ID den ClickUp-Benutzerrollen zu:

  1. Melde dich als Administrator beim Microsoft Entra Admin Center an.
  2. Wähle Identität, Anwendungen und dann Unternehmensanwendungen.
  3. Wähle auf der Seite „Unternehmensanwendungen" deine SAML-App aus.
  4. Wähle auf der Übersichtsseite in der linken Seitenleiste Bereitstellung aus.
  5. Klicke auf der Bereitstellungsseite auf Zuordnungen.
  6. Wähle Microsoft Entra ID-Benutzer bereitstellen aus, um eine Liste der Attribute anzuzeigen.
  7. Scrolle ans Ende der Seite und aktiviere das Kontrollkästchen Erweiterte Optionen anzeigen.
  8. Klicke auf Attributliste bearbeiten.

Screenshot einer Person, die „Erweiterte Optionen anzeigen

  1. Scrolle zur letzten Zeile der Spalte Name und gib dieses URN-Attribut für Benutzerrollen ein: urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
  2. Stelle im Dropdown-Menü der Spalte „Typ" sicher, dass Zeichenfolge ausgewählt ist.
  3. Klicke oben links auf Speichern.
    • Wenn der Name nicht gespeichert wird, wähle Verwerfen und versuche es erneut. Falls der Name weiterhin nicht gespeichert werden kann, setze deine Zuordnungen auf die Standardwerte zurück.
  4. Du wirst zur Seite Attributzuordnung weitergeleitet.
  5. Wähle Neue Zuordnung hinzufügen aus.
  6. Wähle auf der Seite Attribut bearbeiten unter „Zuordnungstyp" die Option Konstante aus.
    • Informationen zur dynamischen Zuordnung findest du weiter unten im Abschnitt Benutzerrollen dynamisch bereitstellen.
  7. Gib unter „Konstantenwert" einen der folgenden Werte ein:
    • 2 für Administratoren.
    • 3 für Mitglieder.
    • 4 für Gäste.
    • 100 für eingeschränkte Mitglieder.
    • {custom_role_id} für benutzerdefinierte Rollen.
  8. Gib unter „Zielattribut" Folgendes ein: urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
  9. Klicke auf OK und dann auf Speichern.
  10. Jeder Benutzer, den du bereitstellst, erhält diese ClickUp-Benutzerrolle.
    • Um eine weitere Benutzerrolle zuzuordnen, beginne bei Schritt 5 und wähle einen anderen Konstantenwert. Informationen zur dynamischen Zuordnung findest du weiter unten im Abschnitt Benutzerrollen dynamisch bereitstellen.

Die folgenden Attribute können ebenfalls zugeordnet werden:

Modell Benutzerrollen-Attribute
Basis id: user.id
userName: user.userName
name: user.givenName+""+familyName
active: user.active
emails: Array von E-Mail-Adressen mit der Eigenschaft „value" und der Eigenschaft „primary" (Boolean).
title: user.title
manager: user.role
Erweiterung role: user.role
customRoleId: Gib die ClickUp-ID der benutzerdefinierten Rolle ein.
Um die ID der benutzerdefinierten Rolle zu finden, sende die Anfrage Benutzer abrufen über die ClickUp API. Dieser Endpunkt ist nur für Enterprise-Pläne verfügbar.
customRoleName: Gib den Namen der benutzerdefinierten ClickUp-Rolle ein.
Enterprise
Diese Attribute werden schrittweise für alle Enterprise-Workspaces veröffentlicht.
Wenn diese Attribute festgelegt sind, werden sie auch auf der Personenübersichtsseite im Teams Hub angezeigt.
Managementkette
department: user.department
region: user.region

Benutzerrollen dynamisch bereitstellen

Verwalte Benutzerrollen in ClickUp dynamisch auf Basis zuweisbarer Benutzerrollen in Entra. Dazu werden Rollenwerte dynamisch mit dem Zielattribut geteilt. So kannst du Rollen in Entra zuweisen, die ClickUp-Rollen zugeordnet sind – das macht die Bereitstellung einfacher.

So änderst du die Zielattributzuordnung von einem konstanten Wert zu einem Ausdruck, um Benutzerrollen dynamisch bereitzustellen:

  1. Wähle auf der Übersichtsseite in der linken Seitenleiste Bereitstellung aus.
  2. Klicke auf der Bereitstellungsseite auf Zuordnungen und dann auf Microsoft Entra ID-Benutzer bereitstellen.
    • Falls noch nicht geschehen, scrolle zur letzten Zeile der Spalte Name und gib dieses URN-Attribut für Benutzerrollen ein: urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
  3. Wähle rechts neben dem URN-Attribut Bearbeiten aus.
  4. Wähle den Ausdruckszuordnungstyp aus und füge diesen Ausdruck hinzu: Switch(SingleAppRoleAssignment([appRoleAssignments]), "3", "ClickUpAdmin", "2", "ClickUpGuest", "4", "ClickUpLimitedMember", "100").
    • In diesem Ausdruck ist 3 der Standardwert, gefolgt von den entsprechenden Schlüssel-Wert-Paaren für die Entra-Rolle / ClickUp-Rolle. Mehr dazu erfährst du unter Ausdrücke für Attributzuordnungen in Microsoft Entra ID schreiben.
    • Du kannst diese Entra-Rollen beim Erstellen im Abschnitt „App-Registrierung" beliebig benennen. Wichtig ist nur, dass das jeweilige Argument dem richtigen ClickUp-Benutzerrollenwert zugeordnet ist und du diese Entra-Rollen beim Zuweisen von Benutzern zu ClickUp auswählst – dann werden sie korrekt bereitgestellt.
    • Du kannst auch andere logische Ausdrücke verwenden, solange dem ClickUp-URN-Attribut eine gültige Zahl zugewiesen wird, die einer Benutzerrolle entspricht.
  5. Klicke auf Speichern.
  6. Wenn du nun unter Benutzer und Gruppen Benutzer oder Gruppen zuweist, wähle die Rolle aus, die der jeweilige Benutzer in ClickUp erhalten soll.
  7. Bei der Bereitstellung erhält der Benutzer dann die richtige Rolle. Falls ein Benutzer sowohl einzeln als auch über eine Gruppe bereitgestellt wird, achte darauf, dass er nicht zwei verschiedenen App-Rollen zugewiesen ist – das führt sonst zu Fehlern.

Gruppen als Teams bereitstellen

Jede Microsoft Entra ID-Gruppe, die du der App zuweist, wird zu einem neuen ClickUp-Team mit demselben Namen. Neue Benutzer werden erstellt, und bestehende Benutzer werden dem Team hinzugefügt.

So stellst du Gruppen bereit:

  1. Klicke in deiner Microsoft Entra ID-App in der linken Seitenleiste auf Benutzer und Gruppen.
  2. Klicke oben links auf Benutzer/Gruppe hinzufügen und weise dann die Gruppen zu, die du als Teams verwenden möchtest. Das Zuweisen einzelner Benutzer erstellt kein Team.
  3. Wähle zum Testen auf der Registerkarte „Bereitstellung" Bedarfsgesteuerte Bereitstellung aus und wähle einen einzelnen Benutzer. Die bedarfsgesteuerte Bereitstellung sendet bis zu fünf Mitglieder einer Gruppe auf einmal, sodass ein Team beim Testen unvollständig aussehen kann.
  4. Starte die Bereitstellung in Microsoft Entra ID. Teams und ihre Mitglieder werden beim nächsten Bereitstellungszyklus hinzugefügt.
  5. Teile in ClickUp die Spaces, Ordner, Unterordner oder Listen, die das Team benötigt.

Neue und bestehende Benutzer bereitstellen

Für neue Benutzer folge den obigen Schritten. Teste die Bereitstellung zunächst mit einem neuen Benutzer, bevor du weitere Personen hinzufügst.

Für bestehende ClickUp-Benutzer prüfe, ob die E-Mail-Adresse, die deine Entra-Attributzuordnung sendet, mit der ClickUp-E-Mail-Adresse übereinstimmt. Überprüfe das Bereitstellungsergebnis. Falls die Bereitstellung keinem bestehenden Konto zugeordnet werden kann, wende dich an den Support, bevor du diese Person entfernst oder erneut einlädst.

Benutzer über Entra ID entfernen

Wenn die automatische Bereitstellung aktiviert ist, entferne die Zuweisung des Benutzers zur benutzerdefinierten SAML-App in Entra ID.

Überprüfe das Bereitstellungsergebnis und bestätige anschließend, dass die Person keinen Zugriff mehr auf deinen ClickUp-Workspace hat. Falls die Bereitstellung fehlschlägt oder der Zugriff bestehen bleibt, wende dich an den Support.

Namen oder E-Mail-Adresse eines Benutzers aktualisieren

Nachdem du den Namen oder die E-Mail-Adresse eines Benutzers in Entra ID geändert hast, überprüfe die Attributzuordnungen und das Bereitstellungsergebnis. Prüfe den in ClickUp angezeigten Namen bzw. die angezeigte E-Mail-Adresse. Stimmt dieser nicht mit dem zugeordneten Wert überein, wende dich an den Support.

Wenn du eine E-Mail-Adresse als SAML-NameID verwendest, muss die Person nach einer E-Mail-Änderung ihr ClickUp-Konto neu verknüpfen. Führe dazu die Schritte zur Kontoverknüpfung in Benutzerdefiniertes SAML Single Sign-on konfigurieren durch.