SAML SSO mit OneLogin

OneLogin ist ein Identitätsanbieter (Identity Provider, IdP), der das Benutzerzugriffsmanagement vereinfacht, indem er es den Nutzern ermöglicht, sich mit einem einzigen Anmeldedatensatz bei mehreren Anwendungen anzumelden. Mit SAML SSO zwischen OneLogin und Document360 können Ihre Teammitglieder und Leser mit ihren bestehenden OneLogin-Zugangsdaten auf Document360 zugreifen.

Was du mit OneLogin als deinem IdP machen kannst

Bevor du anfängst

• Du hast ein aktives OneLogin-Konto mit Administratorzugriff.
• Du hast Eigentümer - oder Administratorzugriff in deinem Document360-Projekt.
• Öffne Document360 und OneLogin in zwei separaten Browser-Tabs. Du musst während der Einrichtung mehrmals zwischen ihnen wechseln.

Schritt 1: Starten Sie die SSO-Konfiguration in Document360

Erstellen Sie SSO in Document360

1. In Document360 navigieren Sie zu Einstellungen () > Benutzer & Berechtigungen > SSO-Konfiguration.
2. Klicken Sie auf Create SSO.

3. Wählen Sie OneLogin als Ihren Identitätsanbieter auf der Seite "Wählen Sie Ihren Identitätsanbieter (IdP) aus.

Schritt 2: Erstellen Sie eine SAML-Anwendung in OneLogin

Fügen Sie den SCIM-Provisioner mit der SAML-App hinzu

1. Melden Sie sich in Ihrem OneLogin Admin Portal an.
2. Im obersten Menü wählen Sie Anwendungen.
3. Klicke auf App hinzufügen.

4. Geben Sie in der Suchleiste SCIM ein, wählen Sie SCIM Provisioner mit SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups) aus der Liste und klicken Sie auf Speichern.

Laden Sie das X.509-Zertifikat herunter

1. In Ihrer OneLogin-Anwendung navigieren Sie zum SSO-Reiter .
2. Klicken Sie auf Details anzeigen , um das X.509-Zertifikat herunterzuladen.

Schritt 3: Konfigurieren Sie den Service Provider in OneLogin

SP-Parameter aus Document360 kopieren und in OneLogin eingeben

1. In Document360 gehen Sie zur Seite "Service Provider konfigurieren" (SP) und kopieren Sie die benötigten Parameter.

2. Gehe zu OneLogin und navigiere zum Konfigurationsreit . Geben Sie die Document360-Parameter mit der untenstehenden Abbildung ein.

Schritt 4: Schließen Sie die SSO-Konfiguration in Document360 ab

Konfigurieren Sie den Identitätsanbieter in Document360

1. In OneLogin navigieren Sie zum SSO-Tab und kopieren Sie die dort angezeigten Parameter.

2. Klicken Sie in Document360 auf Nächsten, um zur Seite "Configure the Identity Provider (IdP)" zu gelangen.
3. Im Feld "Eine bestehende Verbindung konfigurieren " können Sie von einer bereits erstellten SSO-Konfiguration erben, die SCIM im Elternprojekt aktiviert hat. Durch die Auswahl und das Erben dieser Verbindung wird die aktuelle SSO-Konfiguration als kindlich geerbte SSO-Konfiguration gesetzt und erbt automatisch die SCIM-Konfiguration vom Elternteil.

4. Gib die Parameter von OneLogin mit der untenstehenden Karte in Document360 ein.

5. Fügen Sie das zuvor heruntergeladene X.509-Zertifikat im SAML-Zertifikatsfeld in Document360 an.
6. Schalten Sie den Umschalter "Erlaubt IdP-initiierte Anmeldung" je nach Projektanforderungen ein oder aus.

7. Klicken Sie auf Weiter, um zur SCIM-Bereitstellungsseite zu gelangen.

Schritt 5: Konfigurieren Sie die SCIM-Bereitstellung

Die SCIM-Bereitstellung automatisiert das Lebenszyklusmanagement der Leser zwischen OneLogin und Document360. Wenn aktiviert, werden in OneLogin hinzugefügte oder deaktivierte Leser automatisch mit Document360 synchronisiert.

Wenn Sie keine SCIM-Bereitstellung benötigen, klicken Sie auf Nächst und folgen Sie den Schritten aus Schritt 6: Weitere Einstellungen.

Aktivieren Sie SCIM in Document360

1. Schalte den Enable SCIM-Provisionierungs-Schalter ein.

2. Ein Bestätigungsdialog erscheint. Überprüfen Sie die Bedingungen, aktivieren Sie das Kästchen und klicken Sie auf Zustimmen.
3. Die Parameter, die zur Durchführung der SCIM-Konfiguration in OneLogin erforderlich sind, werden dann angezeigt.

SCIM in OneLogin konfigurieren

1. In OneLogin navigieren Sie zum Tab Konfiguration und scrollen Sie zum Abschnitt API-Verbindung .
2. Geben Sie die Document360-Parameter mit der untenstehenden Abbildung ein.

3. Klicken Sie auf Aktivieren, um die SCIM-Bereitstellung in OneLogin zu aktivieren.
4. Klicken Sie auf Speichern , um die SAML-Anwendung erfolgreich mit aktiviertem SCIM zu erstellen.

Aktivieren Sie die SCIM-Bereitstellung in OneLogin

1. In OneLogin gehen Sie zum Reiter Provisioning .
2. Wähle das Kästchen Bereitstellung aktivieren aus und klicke auf Speichern.

SCIM Provisioner mit SAML-Anwendung wurde erfolgreich erstellt.

Vergabe von Standardrollen und Gruppen in Document360

1. Navigiere zurück zu Document360. Im Feld Standardrolle ist die Rolle standardmäßig auf Beitragsmitglied gesetzt. Du kannst das bei Bedarf im Dropdown-Menü ändern.
2. In den Feldern Benutzergruppen und Lesergruppen wählen Sie die Gruppen aus, die Sie hinzufügen möchten. Mehrere Gruppen können hinzugefügt werden, und sie übernehmen die zuvor gewählte Standardrolle.

3. Klicken Sie auf Weiter, um zu weiteren Einstellungen zu gelangen.

Schritt 6: Mehr Einstellungen

Konfigurieren Sie den SSO-Namen und die Anmeldeoptionen

1. Im SSO-Namensfeld geben Sie einen Namen für die SSO-Konfiguration ein.
2. Im Login-Anpassen-Button geben Sie den Text für den Login-Button ein, der den Nutzern angezeigt wird.
3. Automatische Zuweisung der Lesergruppe – diese Option ist nur für bestehende SSO-Konfigurationen verfügbar. Bei neu erstellten SSO-Konfigurationen wird dieser Schalter nicht angezeigt, da SCIM Benutzer und Gruppen automatisch bereitstellt. Erfahren Sie mehr über die Auto-Assign-Lesergruppe.
4. Aktivieren Sie den Ausloggen-Idle SSO-Benutzer bei Bedarf und schalten Sie je nach Ihren Anforderungen um.
5. Wählen Sie mit den Funktasten aus, ob Sie alle Nutzer oder nur ausgewählte Nutzer zum SSO einladen.

6. Klicken Sie auf Erstellen , um die SSO-Konfiguration abzuschließen.

SAML SSO mit SCIM wurde erfolgreich eingerichtet. Du kannst jetzt Leser direkt von deinem OneLogin-IDP aus verwalten.

Von einer anderen Anwendung erben

Beim Erstellen einer neuen SSO-Konfiguration in Document360 können Sie SCIM-Einstellungen von einer bestehenden SSO-Verbindung übernehmen. Dies vereinfacht den Einrichtungsprozess, vermeidet wiederholte Konfigurationsschritte und hilft Administratoren, Zeit zu sparen und gleichzeitig Konsistenz über die Integrationen hinweg zu gewährleisten.

Kindlich geerbte SSO-Konfiguration

Auf der Seite "Identitätsanbieter konfigurieren" (IdP) wählen Sie das Feld "Eine bestehende Verbindung konfigurieren" aus und wählen Sie die übergeordnete SSO SCIM-fähige Anwendung aus, von der Sie erben möchten. Die Wahl dieser Option bestimmt das aktuelle Projekt als Kindprojekt und erbt alle relevanten Eigenschaften vom Elternteil.

Elternerbte SSO-Konfiguration

Die übergeordnete Anwendung zeigt eine Liste aller Projekte an, die ihre Konfiguration übernommen haben. Alle Änderungen an der Elternanwendung werden automatisch in der Kindanwendung angezeigt.

• Wenn SCIM im Elternprojekt aktiviert ist, nachdem Kindprojekte es bereits geerbt haben, werden Benutzer und Gruppen automatisch allen Unterprojekten im Hintergrund zugeordnet.
• Die Aktivierung der Vererbung erleichtert die Verwaltung mehrerer SSO-Konfigurationen mit aktiviertem SCIM, da alle Einstellungen von einer übergeordneten Anwendung gesteuert werden. Dies spart Zeit und reduziert den Aufwand, jede Konfiguration einzeln zu verwalten.

Verwaltung von Document360 mit OneLogin

Sobald Sie die SAML-Anwendung mit SCIM in Document360 mit OneLogin erfolgreich eingerichtet haben, können Sie die Leser direkt von OneLogin aus verwalten, wobei alle Änderungen automatisch in Document360 angezeigt werden.

Fügen Sie einen Leser hinzu

1. Im OneLogin-Hauptmenü erweitern Sie das Dropdown-Menü Benutzer und wählen Sie Benutzer.
2. Klicken Sie auf Neuer Benutzer, geben Sie die erforderlichen Benutzerdaten ein und klicken Sie auf Speichern.

Ein neuer Benutzer wird nun erfolgreich erstellt.

Weisen Sie die Anwendung dem Benutzer zu

1. Nachdem du den Benutzer erstellt hast, gehe im linken Menü zur Anwendung .
2. Klicken Sie auf das +- Symbol oben rechts, um eine Anwendung hinzuzufügen.
3. Wählen Sie die Anwendung mit aktiviertem SCIM-aktiviertem SAML aus und klicken Sie auf Continue.

4. Geben Sie die E-Mail-Adresse des Nutzers im Feld SCIM-Benutzername ein und klicken Sie auf Speichern.

Der Benutzer wird nun erfolgreich der Anwendung zugewiesen.

Benutzerstatus genehmigen

1. Im OneLogin-Hauptmenü klicken Sie auf Anwendungen und wählen Sie Anwendungen.
2. Wählen Sie die SCIM-bereitgestellte SAML-Anwendung und öffnen Sie den Reiter Benutzer.
3. Klicken Sie auf den Status des Benutzers, der als Aushängend angezeigt wird, und wählen Sie dann im Bestätigungsdialog "Genehmigt ".

Der Benutzer wurde nun genehmigt und erfolgreich zu Document360 hinzugefügt.

Überprüfen Sie in Document360

Um zu überprüfen, dass der Benutzer erfolgreich zu Document360 hinzugefügt wurde:

1. In Document360 navigieren Sie zu Einstellungen () > Benutzer & Berechtigungen > Leser & Gruppen.

Der Leser wird automatisch in Document360 hinzugefügt. Das SSO-SCIM-Abzeichen neben ihrem Namen zeigt an, dass SCIM aktiviert ist.

Benutzer in Document360 verwalten

Wenn SCIM aktiviert ist, ist das Bearbeiten eines Benutzernamens oder das Löschen eines Benutzers direkt in Document360 deaktiviert. Diese Aktionen müssen über Ihr IdP verwaltet werden, um beide Plattformen synchron zu halten.

Dennoch können Sie den Inhaltszugriff innerhalb von Document360 verwalten.

Inhaltszugang verwalten

1. In Document360 navigieren Sie zu Einstellungen () > Benutzer & Berechtigungen > Leser & Gruppen.
2. Wählen Sie den gewünschten Nutzer aus und klicken Sie auf Inhaltszugriff verwalten.
3. Weisen Sie die Inhaltszugriffsebene im Dropdown-Menü zu und klicken Sie auf Aktualisieren.

Inhaltszugriff wird nun erfolgreich dem Nutzer zugewiesen.

Löschen Sie einen Benutzer

1. Im OneLogin-Hauptmenü klicken Sie auf Users und wählen Sie den Benutzer aus, den Sie löschen möchten.
2. Erweitern Sie das Dropdown-Menü "Mehr Aktionen " und klicken Sie auf Löschen.

3. Im Bestätigungsdialog klicken Sie erneut auf Löschen .

Der Benutzer wurde erfolgreich gelöscht und erscheint in OneLogin nicht mehr.

Best Practices

• Verwenden Sie die richtige SCIM-App in OneLogin. Suchen Sie speziell nach SCIM Provisioner mit SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups) und wählen Sie ihn aus. Eine andere App zu verwenden funktioniert mit Document360 nicht.
• Verwalten Sie nur Leser über OneLogin SCIM. Benutzerattribute und Gruppenzuordnung werden nicht unterstützt. Planen Sie Ihren Benutzermanagement-Workflow entsprechend.
• Genehmigen Sie bereitgestellte Benutzer umgehend. Benutzer, die in OneLogin hinzugefügt wurden, erscheinen in Document360 mit dem Status 'Ausstehend'. Genehmigen Sie sie in OneLogin, um den Zugriff zu aktivieren.
• Löschen Sie keine Benutzer in Document360, wenn SCIM aktiviert ist. Das direkte Löschen eines Benutzers in Document360 ist deaktiviert, wenn SCIM aktiv ist. Verwalten Sie Löschungen von OneLogin. Beachten Sie, dass gelöschte Benutzer in OneLogin in Document360 inaktiv werden, nicht gelöscht.
• Nutze Vererbung für Multi-Projekt-Setups. Wenn du mehrere Document360-Projekte hast, die dieselbe SSO-Konfiguration teilen, nutze die Eltern-Kind-Vererbung, um alle Einstellungen an einem Ort zu verwalten.

FAQ