Entra mit SAML SSO

Microsoft Entra ID ist Microsofts cloudbasierter Identitäts- und Zugriffsmanagementdienst, früher bekannt als Azure Active Directory. Mit SAML SSO zwischen Microsoft Entra und Document360 können sich Ihre Benutzer und Leser mit ihren bestehenden Microsoft-Zugangsdaten bei Document360 anmelden, ohne ein separates Passwort zu benötigen.

Was du mit Microsoft Entra als deinem IdP machen kannst

Bevor du anfängst

• Sie haben ein aktives Microsoft Azure-Konto mit Administratorzugriff. Melden Sie sich bei entra.microsoft.com an.
• Du hast Eigentümer - oder Administratorzugriff in deinem Document360-Projekt.
• Öffne Document360 und Microsoft Entra in zwei separaten Browser-Tabs. Du musst während der Einrichtung mehrmals zwischen ihnen wechseln.

Schritt 1: Erstellen Sie eine SAML-Anwendung in Microsoft Entra

Melden Sie sich bei Microsoft Entra an

1. Melden Sie sich unter entra.microsoft.com in Ihrem Microsoft Azure-Konto an.
2. Sie werden zur Seite des Microsoft Entra Admin-Centers navigiert.

Erstellen Sie die Anwendung

1. Im Microsoft Entra Verwaltungszentrum wählen Sie in der linken Navigationsleiste die Entra ID aus und klicken Sie auf Unternehmens-Apps.
2. Auf der Seite Unternehmensanwendungen klicken Sie auf Neue Anwendung > Erstellen Sie Ihre eigene Anwendung.
3. Geben Sie einen Namen für Ihre Anwendung im Feld Eingabename ein und klicken Sie auf Erstellen.

Schritt 2: SAML in Entra mit Document360-Parametern konfigurieren

Holen Sie sich die Parameter des Service Provider von Document360

1. Öffne Document360 in einem separaten Tab.
2. Navigieren Sie zu Einstellungen () > Benutzer & Berechtigungen > Enterprise SSO.
3. Klicken Sie auf SSO > SAML erstellen.

4. Wählen Sie die Entra-ID als Ihren Identitätsanbieter (IdP) aus, um automatisch zum Schritt SP konfigurieren zu navigieren.

5. Der Schritt SP konfigurieren zeigt die erforderlichen Parameter an, um Ihre SAML-Integration im Identity Provider zu konfigurieren.

Configure SAML in Entra

1. Gehe zu Microsoft Entra und öffne auf der Seite zur erstellten Anwendung den Reiter Single Sign-on und wähle die SAML-Methode aus.

2. Klicken Sie auf Bearbeiten im Abschnitt Basic SAML Configuration und geben Sie die unten gezeigten Parameter aus Document360 ein.

3. Klicken Sie auf Speichern.

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

Konfigurieren Sie den Identitätsanbieter in Document360

1. Kehren Sie zu Document360 zurück und klicken Sie auf Nächsten, um zum Schritt IdP konfigurieren zu navigieren.
2. Wenn Sie bereits eine bestehende SSO-Konfiguration haben, können Sie sie im Dropdown-Menü "Eine bestehende Verbindung konfigurieren" auswählen, um deren Einstellungen zu übernehmen. Das eliminiert eine redundante Einrichtung und spart Zeit.

3. Füllen Sie die erforderlichen Felder mit den Parametern aus, die im Abschnitt "Set up Document360 SCIM SSO " auf der Entra-Seite gefunden werden, wie unten gezeigt.

4. Laden Sie das Zertifikat (Base64) im Abschnitt SAML-Zertifikate herunter und fügen Sie es dem SAML-Zertifikatsfeld in Document360 an.

5. Schalten Sie die Option "IdP-initiierte Anmeldung erlauben" je nach Projektanforderungen ein- oder aus. Erfahren Sie mehr über die von IdP initiierte Anmeldung.
6. Klicken Sie auf Weiter, um zur SCIM-Bereitstellungsseite zu gelangen.

Schritt 4: Konfigurieren Sie die SCIM-Bereitstellung

Die SCIM-Bereitstellung automatisiert das Lebenszyklusmanagement von Benutzer und Lesern zwischen Microsoft Entra und Document360. Wenn aktiviert, werden in Entra hinzugefügte, aktualisierte oder deaktivierte Benutzer 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. Aktivieren Sie auf der SCIM-Bereitstellungsseite in Document360 den Aktivieren der SCIM-Bereitstellung.
2. Ein Bestätigungsdialog erscheint. Lesen Sie die Bedingungen und klicken Sie auf Zustimmen. Anschließend wird eine Reihe von Parametern angezeigt.

Konfigurieren Sie die SCIM-Bereitstellung in Entra

1. Gehe zu Entra, wähle im linken Menü den Reiter Provisioning aus und wähle dann im oberen Menü neue Konfiguration .

2. Die Seite zur neuen Bereitstellung wird angezeigt. Füllen Sie die Felder im Abschnitt Admin-Zugangsdaten mit den unten gezeigten Parametern aus Document360 aus.

Setze Standardrollen und -gruppen in Document360

1. Gehen Sie zurück zu Document360 und aktivieren Sie den Schalter "Gruppensynchronisation aktivieren ". Wenn aktiviert, werden Benutzer- und Lesergruppen automatisch basierend auf den IdP-Gruppenzuordnungen zugewiesen.
2. Im Feld Standardrolle ist die Rolle standardmäßig auf Beitragsleistender gesetzt. Sie können dies bei Bedarf im Dropdown-Menü ändern.

3. 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.
4. 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. Auto assign reader group – 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 Gruppe Auto assign reader.
4. Aktiviere bei Bedarf den Timeout der Idle-Session SSO und setze die Timeout-Dauer (HH:MM).
5. Entscheiden Sie, ob Sie bestehende Nutzer- und Leserkonten zum SSO einladen.

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

Die Enterprise SSO-Konfiguration in Document360 wurde erfolgreich erstellt.

Schritt 5: SCIM-Provisionierung in Entra abschließen

Testen und speichern Sie die SCIM-Verbindung

1. Gehen Sie zurück zu Entra, wo die Seite zur neuen Bereitstellung angezeigt wird.
2. Sobald alle erforderlichen Felder ausgefüllt sind, klicken Sie auf "Verbindung testen ", um die Konfiguration zu überprüfen.

3. Eine Bestätigungsmeldung erscheint, sobald die SCIM-Bereitstellungsverbindung zwischen Entra und Document360 erfolgreich ist.
4. Klicken Sie auf Erstellen , um die Konfiguration abzuschließen.

Die SCIM-Bereitstellung zwischen Entra und Document360 wurde erfolgreich geschaffen.

Best Practices

• Erstellen Sie eine Nicht-Galerie-Anwendung. Verwenden Sie beim Erstellen Ihrer Entra-Anwendung immer die Option "Integriere alle anderen Anwendungen, die Sie nicht finden ". Galerie-Apps unterstützen keine benutzerdefinierte SCIM-Bereitstellung.
• Speichern Sie beide geheimen Token sicher. Behandeln Sie die primären und sekundären SCIM-Token wie Passwörter. Speichern Sie sie in einem Secrets-Manager oder Passwort-Tresor, nicht in einfachen Textdateien oder Code-Repositories.
• Testen Sie die SCIM-Verbindung nicht, bevor Sie die Document360-Konfiguration gespeichert haben. Der Test wird in diesem Stadium fehlschlagen. Schließen Sie immer zuerst die Document360 SSO-Konfiguration durch und speichern Sie sie und kehren Sie dann zum Testen zu Entra zurück.
• Stellen Sie die Attributzuordnung auf Benutzerebene ein, nicht auf Gruppenebene. Bei der Konfiguration des oder-Attributs userType isTeamAccount sollten Sie es immer auf Benutzerebene festlegen, um Bereitstellungskonflikte für Nutzer zu vermeiden, die mehreren Gruppen angehören.
• Stimmen Sie die Leerlaufzeit mit Ihrer Sicherheitsrichtlinie ab. Aktivieren Sie den Ausloggen-Leerlauf-SSO-Benutzer und stellen Sie die Dauer so ein, dass sie den Anforderungen Ihrer Organisation an das Sitzungsmanagement entspricht.

FAQ