Zum Hauptinhalt springen
Members melden sich mit ihrem Microsoft-Geschäftskonto bei Collabase an, und Microsoft Entra ID legt ihre Collabase-Konten an, aktualisiert und deaktiviert sie. Dieser Leitfaden führt dich vom ersten Check bis zur ersten Test-Anmeldung. Geh die Phasen der Reihe nach durch. Jede Phase endet mit einem Kontrollpunkt und einem Link zur nächsten.
Die Bezeichnungen im Microsoft Entra Admin Center und in Collabase stehen in diesem Leitfaden auf Englisch, wie in den Oberflächen. Läuft dein Portal auf Deutsch, such die entsprechende Bezeichnung oder stell die Sprache des Portals auf Englisch.

Auf einen Blick

Zwei Wege führen durch diesen Leitfaden:
  • Nur Anmeldung: die Phasen 1, 2, 3 und die ersten zwei Schritte von Phase 5. SCIM ergänzt du später.
  • Anmeldung und SCIM: alle fünf Phasen. Das ist das vollständige Setup.

Voraussetzungen

Prüfe das, bevor du beginnst. Phase 2 führt dich durch die Vorbereitung.

In Collabase

  • Eine aktive Enterprise-Lizenz. Identity Provider und SCIM gehören zur Collabase Enterprise Edition, und SCIM stoppt, wenn die Lizenz abgelaufen ist.
  • Ein Konto mit Systemadministrator-Rechten.
  • Genug freie Lizenzplätze für die Personen, die du provisionierst. Wer nicht mehr hineinpasst, wird abgewiesen.
  • Ein zweiter Admin, der sich mit E-Mail und Passwort anmeldet, als Weg zurück. Siehe Emergency admin access.
  • Deine Collabase-Adresse über HTTPS, zum Beispiel https://collabase.example.com.

In Microsoft Entra ID

  • Die Rolle Application Administrator oder Cloud Application Administrator im Microsoft Entra Admin Center.
  • Eine Microsoft-Lizenz, die die automatische Bereitstellung abdeckt. Prüfe deinen Plan unter Microsoft Entra licensing.
  • Eine Pilotgruppe mit ein oder zwei Personen, die noch kein Collabase-Konto haben. Phase 2 legt sie an.

Netzwerk

  • Für die Anmeldung erreichen die Browser der Members Collabase und Microsoft. Bei OAuth erreicht auch dein Collabase-Server Microsoft über HTTPS.
  • Für SCIM ruft der Microsoft-Provisionierungsdienst Collabase auf. Deine Collabase-Adresse muss aus dem Internet erreichbar sein, oder du gibst die Microsoft Entra IP ranges frei (Service Tag AzureActiveDirectory). Läuft Collabase in einem privaten Netz, brauchst du den On-Premises-Provisionierungs-Agent von Microsoft.

Überblick

Die Zeiten sind typische Werte für ein erstes Setup. Der erste Provisionierungszyklus in Entra dauert länger als spätere. Wenn etwas scheitert, geh zur Fehlerbehebung.

Phase 1: Planen

Phase 1 von 5, etwa 10 Minuten. Weiter: Phase 2, Vorbereiten.

Eine Anmeldemethode wählen

Nimm für denselben Entra-Tenant entweder OAuth oder SAML, nicht beides. Zwei Buttons, die zum selben Verzeichnis führen, schaffen nur Einstellungen, die du pflegen musst. Spricht nichts für SAML, nimm OAuth. Nimm SAML, wenn deine Sicherheitsvorgaben es verlangen oder wenn du in Entra selbst bestimmen willst, welche Attribute Collabase erhält. SCIM funktioniert mit beiden. Die Details zu SAML stehen unter SAML single sign-on.

E-Mail-Adresse festlegen

Collabase verbindet Anmeldung und SCIM über die E-Mail-Adresse. Lies das einmal, denn es erklärt die meisten Fehler, auf die du stossen kannst.
  • SCIM legt das Konto mit der E-Mail-Adresse an, die Entra sendet. Sendet Entra keine, nimmt Collabase den User Principal Name.
  • Bei der ersten Anmeldung sucht Collabase genau ein aktives Konto mit der E-Mail-Adresse der Anmeldung und verknüpft es. Spätere Anmeldungen erkennt Collabase an der eigenen ID des Identity Providers.
  • Hat kein Konto diese Adresse, entscheidet Auto-create new users: eingeschaltet legt ein zweites Konto an, ausgeschaltet verweigert die Anmeldung.
Die Adresse, die Entra über SCIM sendet, und die Adresse bei der Anmeldung müssen also identisch sein. Nimm für beide mail oder für beide den User Principal Name. Schreib deine Wahl auf, du brauchst sie in den Phasen 3 und 4.
Gastkonten lassen sich nicht mit einem Identity Provider verknüpfen, und ein deaktiviertes Konto kann sich nicht anmelden. Die vollständigen Regeln stehen unter First sign-in and account matching.
Kontrollpunkt. Du weisst, welche Methode du nimmst, ob du SCIM ergänzt und welches Entra-Attribut die E-Mail-Adresse ist.
Weiter: Phase 2, Vorbereiten.

Phase 2: Vorbereiten

Phase 2 von 5, etwa 15 Minuten. Zurück: Phase 1. Weiter: Phase 3, Anmeldung.
1

Einen Weg zurück sichern

Stell sicher, dass sich mindestens ein Admin mit E-Mail und Passwort anmeldet. Ist Entra nicht erreichbar oder falsch konfiguriert, bringt dich dieses Konto wieder hinein. Die Passwort-Anmeldung bleibt unter /auth/login erreichbar. Hintergrund: Emergency admin access.
2

Lizenz und Lizenzplätze prüfen

Bestätige, dass die Enterprise-Lizenz aktiv ist und genug Lizenzplätze für deine Pilotgruppe frei sind. Collabase weist eine Person ab, wenn kein Lizenzplatz frei ist, siehe How existing accounts are handled.
3

Pilotgruppe in Entra anlegen

Lege im Microsoft Entra Admin Center eine Sicherheitsgruppe an, zum Beispiel «Collabase Pilot», und füge ein oder zwei Personen hinzu, die noch kein Collabase-Konto haben. Nimm deine eigenen Administratorkonten nicht auf: SCIM übernimmt kein bestehendes Konto über die E-Mail-Adresse, und Collabase zeigt eine solche Person als abgewiesen.
4

Collabase-Adresse notieren

Schreib deine Adresse mit Protokoll auf, zum Beispiel https://collabase.example.com. Jede URL in diesem Leitfaden beginnt damit und steht als https://your-collabase-domain.
Kontrollpunkt. Ein zweiter Admin kann sich mit Passwort anmelden, Lizenzplätze sind frei, die Pilotgruppe existiert.
Weiter: Phase 3, Anmeldung.

Phase 3: Anmeldung

Phase 3 von 5, etwa 20 Minuten mit OAuth oder 30 Minuten mit SAML. Zurück: Phase 2. Weiter: Phase 4, SCIM. Folge einer der beiden Optionen: Option A: OAuth oder Option B: SAML. Beide enden am selben Kontrollpunkt.

Option A: OAuth

1

Anwendung in Entra registrieren

Öffne im Microsoft Entra Admin Center App registrations und wähle New registration. Nenne sie «Collabase» und wähle Single Tenant, damit sich nur Konten deiner Organisation anmelden können.
2

Redirect URI hinzufügen

Füge unter Authentication die Plattform Web mit dieser Redirect URI hinzu:
Collabase zeigt dieselbe Adresse als Redirect URI in den Provider-Einstellungen.
3

Client Secret erstellen

Wähle unter Certificates & secrets die Option New client secret. Kopiere den Value sofort, denn Entra zeigt ihn nur einmal. Client Secrets laufen ab: Notiere das Datum und ersetze das Secret in Collabase, bevor es verstreicht.
4

IDs kopieren

Kopiere auf der Seite Overview die Application (client) ID und die Directory (tenant) ID.
5

Microsoft in Collabase konfigurieren

Öffne Admin → Identity Providers → Microsoft und trage Client ID, Client Secret und Tenant ID (Directory ID) ein. Gib den Tenant als GUID an, nicht als Domain. Ohne ihn speichert Collabase den Provider nicht.
6

Verhalten festlegen und aktivieren

Setze Default Role for new users auf User. Schalte Auto-create new users aus, wenn SCIM deine Konten provisioniert. Trage bei Allowed email domains deine Firmen-Domains ein, siehe Restricting sign-in by email domain. Schalte dann Enable provider ein.
Das Panel Configure Microsoft mit Redirect URI, Client ID, Client Secret, Tenant ID, Default Role, Allowed email domains und den zwei Schaltern

Das Panel Configure Microsoft mit seinen Standardwerten. Auto-create new users bleibt eingeschaltet, bis du es ausschaltest.

Weiter am Kontrollpunkt dieser Phase.

Option B: SAML

1

Enterprise application anlegen

Geh im Microsoft Entra Admin Center zu Entra ID → Enterprise apps und wähle New application → Create your own application. Nenne sie «Collabase» und wähle die Option, jede andere Anwendung zu integrieren, die du nicht in der Galerie findest.
2

SAML-Einstellungen in Collabase öffnen

Öffne Admin → Identity Providers, füge SAML 2.0 hinzu und lass das Panel Configure SAML 2.0 offen. Unter Enter these values at your identity provider stehen die Assertion consumer service (ACS) URL und die Service provider metadata URL.
3

Collabase-Werte in Entra eintragen

Öffne in der Anwendung Single sign-on, wähle SAML und bearbeite Basic SAML Configuration:Die Entity ID ist die Metadata-URL. Du kannst sie in Collabase nicht ändern. Nach dem Speichern zeigt die aufgeklappte SAML-Zeile sie als Service provider entity ID.
4

Die Claims senden, die Collabase liest

Wähle in Attributes & Claims die Option Edit und füge mit Add new claim zwei Claims hinzu. Lass Namespace leer:Collabase liest genau diese zwei Namen, siehe Attributes Collabase reads. Entra sendet seine eigenen Claims unter langen Namen, die mit http://schemas.xmlsoap.org/ beginnen, und Collabase liest diese nicht. Ohne Claim email greift Collabase auf die Name ID zurück, die Entra standardmässig mit dem User Principal Name füllt. Ohne displayName wird der Name des Members derselbe Wert.
5

Assertion signieren

Setze in SAML Certificates die Signing Option auf Sign SAML assertion oder Sign SAML response and assertion. Collabase weist eine Assertion ab, die nicht signiert ist.
6

Entra-Werte in Collabase übernehmen

Kopiere die App Federation Metadata Url aus dem Bereich SAML Certificates in Import from metadata URL in Collabase und klicke auf Import. Collabase füllt Identity provider entity ID, Single sign-on URL und Signing certificate aus. Gespeichert wird erst, wenn du auf Save klickst. Es funktionieren nur öffentliche HTTPS-Adressen.Willst du die Werte von Hand eintragen, nimm sie aus Set up Collabase in Entra: Die Login URL ist die Single sign-on URL, der Microsoft Entra Identifier ist die Identity provider entity ID, und das Certificate (Base64) gehört in Signing certificate.
7

Verhalten festlegen und aktivieren

Setze Default Role for new users auf User. Schalte Auto-create new users aus, wenn SCIM deine Konten provisioniert. Schalte Enable provider ein und klicke auf Save. Die Anmeldeseite zeigt jetzt Sign in with SSO (SAML). Jede Einstellung ist unter SAML single sign-on erklärt.
8

Personen in Entra zuweisen

Öffne in der Anwendung Users and groups und weise die Pilotgruppe zu.
Die Anmeldung muss bei Collabase beginnen. Collabase weist eine Antwort ab, die nicht auf eine von ihm gestartete Anmeldung antwortet. Eine Anmeldung aus dem Microsoft-Portal oder aus My Apps funktioniert deshalb nicht. Schick deine Members auf die Collabase-Anmeldeseite.
Das Signaturzertifikat in Entra läuft ab. Notiere sein Datum. Stellt Entra ein neues aus, füge beide Zertifikate in Signing certificate ein, bis das alte abgelaufen ist. So funktioniert die Anmeldung während des Wechsels weiter.

Kontrollpunkt: Anmeldung

Öffne die Collabase-Anmeldeseite in einem privaten Browserfenster und melde dich als dein eigener Administrator mit Microsoft an. Collabase verknüpft dein bestehendes Konto über die E-Mail-Adresse. Du landest in Collabase, und Admin → Users zeigt kein zweites Konto für dich.
Scheitert das, siehe Probleme bei der Anmeldung. Klappt es und du willst nur die Anmeldung, geh weiter zum Test in Phase 5. Weiter: Phase 4, SCIM.

Phase 4: SCIM

Phase 4 von 5, etwa 25 Minuten plus bis zu 40 Minuten für die erste Synchronisierung. Zurück: Phase 3. Weiter: Phase 5, Testen und Ausrollen. Mit SCIM legt Entra Konten an, aktualisiert und deaktiviert sie. SCIM meldet niemanden an, deshalb muss Phase 3 zuerst erledigt sein. Die unterstützten Operationen stehen unter User provisioning with SCIM.
1

SCIM in Collabase aktivieren

Öffne Admin → Identity Providers, scrolle zu SCIM Provisioning und schalte Enable SCIM provisioning ein. Anfragen werden abgewiesen, bis dieser Schalter an ist, auch mit gültigem Token.
2

Token erzeugen

Klicke auf Generate token und kopiere das Token, sobald SCIM token created erscheint. Collabase zeigt es nur einmal. Ein Token ist 365 Tage gültig. Setz dir eine Erinnerung, vorher ein neues zu erzeugen, denn das neue Token ersetzt das alte sofort.
Der Dialog SCIM token created mit verdecktem Token

Der Token-Dialog. Kopiere das Token, bevor du auf den Button klickst.

3

Provisionierung in Entra öffnen

Nimm die Enterprise application aus Phase 3, wenn du SAML gewählt hast. Bei OAuth legst du eine auf demselben Weg an: Entra ID → Enterprise apps → New application → Create your own application, mit der Option, jede andere Anwendung zu integrieren. Öffne Provisioning und wähle New configuration.
4

Verbindung eintragen

Trage diese Werte ein. Fragt das Portal nach einer Authentifizierungsmethode, wähle Bearer-Token-Authentifizierung.
5

Testen und erstellen

Wähle Test Connection. Klappt es, wähle Create. Scheitert es, siehe SCIM-Probleme.
6

Attributzuordnung prüfen

Öffne Attribute mapping und prüfe die Benutzerzuordnung. Collabase verwendet diese Attribute:Stell sicher, dass die Adresse in emails diejenige ist, die du in Phase 1 festgelegt hast. Collabase übernimmt nie eine Rolle aus dem Verzeichnis. Jedes Konto, das SCIM anlegt, startet als User.
7

Pilotgruppe zuweisen und starten

Öffne Users and groups und weise die Pilotgruppe zu. Entra provisioniert nur zugewiesene Personen, wenn der Scope Sync only assigned users and groups ist. Öffne die Seite Overview und wähle Start provisioning. Der erste Zyklus dauert länger, spätere laufen etwa alle 40 Minuten.
Die Karte SCIM Provisioning mit Schalter, Tokenliste und der Liste Recently turned away

Die Karte SCIM Provisioning in Collabase. Beobachte Recently turned away während der ersten Zyklen.

Was mit Konten passiert

Ein deaktiviertes Konto wird standardmässig nach 30 Tagen anonymisiert: Name und E-Mail-Adresse werden entfernt, Seiten, Work Items und Kommentare bleiben und zeigen den Namen mit dem Zusatz (deleted). Den Zeitraum änderst du unter Anonymize locked accounts after in den Security policies. Reaktivierst du das Konto vor dem Stichtag, wird die Anonymisierung abgebrochen. Gruppen, die SCIM schickt, werden zu Collabase-Gruppen. Ihre Mitglieder verwaltest du in Entra, nicht in Collabase, und du kannst ihnen weiterhin Zugriff auf Spaces geben. Eine Gruppe kann höchstens 1000 Mitglieder haben. Mehr: Supported group operations.

Bestehende Konten

SCIM übernimmt nie ein Konto über die E-Mail-Adresse. Sendet Entra eine Person, deren Adresse schon zu einem Collabase-Konto gehört, das SCIM nicht angelegt hat, weist Collabase die Person mit einem Konflikt ab. Der Grund erscheint unter Recently turned away auf der Karte SCIM Provisioning, zusammen mit den letzten zehn abgewiesenen Personen. Willst du ein bestehendes Member unter SCIM bringen, ändere die E-Mail-Adresse eines der beiden Konten und lass Entra es erneut versuchen. Mehr: How existing accounts are handled.

Kontrollpunkt: SCIM

Wähle in Entra für eine Person der Pilotgruppe Provision on demand. In Collabase zeigt Admin → Users jetzt das Konto, und die Spalte Identity zeigt, woher es kommt. Fehlt die Person, schau unter Recently turned away und in den SCIM-Problemen.
Weiter: Phase 5, Testen und Ausrollen.

Phase 5: Testen und Ausrollen

Phase 5 von 5, etwa 30 Minuten. Zurück: Phase 4. Weiter: Betrieb sichern.
1

Die eigene Anmeldung testen

Öffne die Collabase-Anmeldeseite und melde dich mit Microsoft an. Dein bestehendes Administratorkonto wird über die E-Mail-Adresse verknüpft. Prüfe, dass du in Collabase landest und dass unter Admin → Users kein zweites Konto für dich erscheint.
2

Als Pilot-Member anmelden

Lass eine Person der Pilotgruppe sich mit Microsoft anmelden. Prüfe Admin → Users: Die Person muss genau ein Konto haben. Hast du SCIM ergänzt, hat SCIM dieses Konto vor der ersten Anmeldung angelegt. Hier zeigt sich ein Unterschied bei den E-Mail-Adressen, siehe Phase 1.
3

Gruppenzugriff prüfen

Dieser Schritt braucht SCIM. Öffne die gepushte Gruppe unter Admin → Users und gib ihr Zugriff auf einen Space. Das Pilot-Member sieht den Space nach der nächsten Anmeldung.
4

Das Entfernen testen

Dieser Schritt braucht SCIM. Entferne das Pilot-Member in Entra aus der Pilotgruppe und provisioniere erneut mit «On demand». Das Konto wird deaktiviert. Eine Anmeldung wird mit der Meldung abgewiesen, dass das Konto deaktiviert wurde.
5

Die Zuweisung ausweiten

Weise die Gruppen zu, die Zugriff haben sollen. Beobachte während der ersten Zyklen Recently turned away und die Provisionierungsprotokolle in Entra. Werden viele Personen abgewiesen, prüfe zuerst die bestehenden Konten.
Kontrollpunkt. Ein Pilot-Member hat sich angemeldet, hat ein Konto und verliert den Zugriff, wenn es entfernt wird. Dein Setup ist fertig.
Weiter: Betrieb sichern.

Betrieb sichern

Drei Geheimnisse laufen ab. Trag die Daten jetzt in deinen Kalender ein. Wirf ausserdem ab und zu einen Blick auf Recently turned away, und behalte den zweiten Admin mit Passwort. Beides bleibt nach dem Rollout nützlich.

Fehlerbehebung

Probleme bei der Anmeldung

Weitere Ursachen und Antworten: SAML single sign-on.

SCIM-Probleme

Weitere Ursachen und Antworten: User provisioning with SCIM.

Weiterführende Seiten

SAML single sign-on

Jede SAML-Einstellung, die Kontozuordnung und die Fehlerbehebung (auf Englisch).

User provisioning with SCIM

Unterstützte Operationen für Konten und Gruppen (auf Englisch).

Identity providers

OAuth, LDAP und SCIM an einem Ort (auf Englisch).

Security policies

Anmeldelimits, SSO bypass und gesperrte Konten (auf Englisch).
Zuletzt geändert am 26. Oktober 2026