OneLogin mit SAML SSO

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-Anmeldedaten 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 > Enterprise SSO.
2. Klicken Sie auf SSO > SAML erstellen.

3. Wählen Sie OneLogin als Ihren Identitätsanbieter im Schritt "Choose 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 gehe du zum Schritt SP konfigurieren und kopiere die benötigten Parameter.

2. Gehe zu OneLogin und navigiere zum Konfigurationsreiter . Gib 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. In Document360 klicken Sie auf Nächsten, um zum Schritt IdP konfigurieren zu gelangen.
3. Im Feld "Eine bestehende Verbindung konfigurieren " können Sie von einer bereits erstellten SSO-Konfiguration erben, die SCIM in einem Elternprojekt aktiviert hat. Durch Auswahl und 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 Nächstes, um zum Schritt SCIM-Bereitstellung zu navigieren .

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 Reader automatisch mit Document360 synchronisiert.

Wenn Sie keine SCIM-Bereitstellung benötigen, klicken Sie auf Nächst und springen Sie weiter zu "SSO Name und Login-Optionen konfigurieren " unten.

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 Kontrollkä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. Kehren Sie zu Document360 zurück. Im Feld Standardrolle ist die Rolle standardmäßig auf Beitragsmitglied gesetzt. Sie können dies bei Bedarf im Dropdown-Menü ändern.
2. Wählen Sie in den Feldern Benutzergruppen und Lesergruppen 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 fortzufahren.

Konfigurieren Sie den SSO-Namen und die Anmeldeoptionen

1. Im SSO-Namensfeld geben Sie einen Namen für die SSO-Konfiguration ein.
2. Im Text der Login-Schaltfläche 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. Für neu erstellte SSO-Konfigurationen wird dieser Schalter nicht angezeigt, da SCIM Benutzer und Gruppen automatisch bereitstellt. Erfahren Sie mehr über die Lesergruppe "Automatisch zuweisen".
4. Aktiviere bei Bedarf den Timeout der Idle-Session SSO und setze die Timeout-Dauer (HH:MM).
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. Sie können jetzt Leser direkt von Ihrem 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 erben. Dies vereinfacht den Einrichtungsprozess, vermeidet Wiederholungen der Konfigurationsschritte und hilft Administratoren, Zeit zu sparen und gleichzeitig Konsistenz zwischen den Integrationen sicherzustellen.

Kindlich geerbte SSO-Konfiguration

Wählen Sie auf der Seite "IdP" konfigurieren 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. Wenn Sie diese Option auswählen, wird das aktuelle Projekt als Kindprojekt bezeichnet und alle relevanten Eigenschaften vom Elternprojekt übernommen.

Elternerbte SSO-Konfiguration

Die Elternanwendung 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-Badge neben ihrem Namen zeigt an, dass SCIM aktiviert ist.

Benutzer in Document360 verwalten

Wenn SCIM aktiviert ist, ist das Bearbeiten eines Benutzernamens oder das direkte Löschen eines Benutzers 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 > Readers & 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 sie aus. Die Verwendung einer anderen App funktioniert mit Document360 nicht.
• Verwalten Sie nur Leser über OneLogin SCIM. Benutzerattribute und Gruppenzuordnung werden nicht unterstützt. Planen Sie Ihren Benutzerverwaltungs-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 aus OneLogin. Beachten Sie, dass gelöschte Benutzer in OneLogin in Document360 inaktiv und nicht gelöscht werden.
• 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