--- title: "Richte SAML SSO mit Okta ein" slug: "saml-sso-with-okta" updated: 2026-10-12T08:20:30Z published: 2026-10-12T08:20:30Z canonical: "docs.document360.com/saml-sso-with-okta" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Richte SAML SSO mit Okta ein Verbinden Sie Okta mit Document360 über SAML, sodass Ihre Benutzer und Leser sich mit ihren Okta-Zugangsdaten und nicht mit einem separaten Passwort bei Document360 anmelden können. Die Einrichtung beinhaltet optionale SCIM-Bereitstellung, um Benutzer und Leser automatisch synchron zu halten. Mit Okta und SAML können Sie: - Lassen Sie die Nutzer sich im Knowledge Base-Portal anmelden und die Leser auf der Knowledge Base-Website. - Lassen Sie die Leute sich direkt über das Okta-Dashboard anmelden. - Benutzer und Leser in Okta hinzufügen, aktualisieren und deaktivieren sowie Okta-Gruppen mit SCIM synchronisieren. - Verwenden Sie SCIM-Einstellungen aus einer SSO-Konfiguration in einem Elternprojekt. --- ## Bevor du anfängst - Du brauchst ein Okta-Konto mit Administratorzugriff. Wenn du keines hast, [melde dich bei Okta an](https://developer.okta.com/signup/). - Du brauchst die Rolle Eigentümer oder Administrator in deinem Document360-Projekt. - Öffne Document360 und Okta in zwei Browser-Tabs. Du wechselst während der Einrichtung zwischen ihnen. - Wenn Sie SCIM einrichten möchten, halten Sie einen sicheren Ort bereit, wie zum Beispiel einen Passwortmanager, um zwei geheime Token zu speichern. WARNUNG Zwei Optionen in diesem Setup lassen sich nicht rückgängig machen: - **Identitätsanbieter**: Sie können den IdP nach der Erstellung der Konfiguration nicht mehr ändern. - **Bestehende Konten in SSO umwandeln**: Konvertierte Nutzer und Leser verlieren sofort die Passwortanmeldung und müssen sich über Okta anmelden. Jeder von ihnen erhält eine E-Mail über die Änderung. --- ## Schritt 1: Starten Sie die SSO-Konfiguration in Document360 1. Gehe zu **Einstellungen** () > **Benutzer & Berechtigungen** > **Enterprise SSO**. 2. Wählen Sie **Create SSO** und dann **SAML.** 3. Wählen Sie im **Schritt "IDP wählen** " **Okta** aus. ![The Choose IDP step showing the identity provider options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SAML-create-sso-step-1.png) Der Schritt **'SP konfigurieren'** zeigt die Parameter an, die du in Okta eingeben wirst. Lass diesen Tab offen. ![The Configure SP step showing the callback path, service provider entity ID, and signed out callback path](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SP-Okta.png) --- ## Schritt 2: Erstellen Sie die SAML-App in Okta ### Erstelle die App-Integration 1. Melde dich bei Okta an und wähle dann oben rechts **Admin** aus, um die Admin-Konsole zu öffnen. 2. Im linken Navigationsfeld erweitern Sie **Anwendungen und Ressourcen** und wählen Sie dann **Anwendungen** aus. ![The Applications page in the Okta Admin Console](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-applications.png) 3. Wählen **Sie App-Integration erstellen**. 4. Wähle **SAML 2.0** und dann **Next** aus. ![The Create app integration dialog with SAML 2.0 selected](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-create-app-integration.png) ### Hier kommt die allgemeinen Einstellungen ins Spiel 1. Im Reiter **Allgemeine Einstellungen** geben Sie einen **App-Namen** ein, zum Beispiel *Document360 SSO*. 2. (Optional) Laden Sie ein Logo hoch und stellen Sie die Sichtbarkeit der App ein. 3. Wählen **Sie Nächstes** aus. Der **Reiter "SAML konfigurieren** " öffnet sich. ![The General Settings tab for the SAML app in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-saml-general-setting.png) ### Geben Sie die Document360-Parameter ein 1. Auf dem **Reiter "SAML konfigurieren** " kopieren Sie diese Werte aus dem Schritt **Document360 SP konfigurieren** : | Kopie von Document360 | In Okta einfügen | | --- | --- | | **Rückrufpfad** | **Single-Sign-on-URL** | | **Dienstanbieter-Entitäts-ID** | **Zielgruppen-URI (SP-Entitäts-ID)** | 2. Setze **das Format der Name-ID** auf **EmailAddress**. 3. Setze den **Anwendungsbenutzernamen** auf **E-Mail**. 4. Wählen Sie **Erweiterte Einstellungen anzeigen**, aktivieren **Sie Enable Single Logout** und fügen Sie den **Signed Out-Callback-Pfad** aus Document360 in **die Single Logout URL** ein. 5. Wählen **Sie Nächstes** aus. ![The Configure SAML tab in Okta with the single sign-on URL and audience URI filled in](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-okta-saml-settings.png) ### Füllen Sie die Feedback-Seite aus 1. Wählen **Sie Dies ist eine interne App, die wir erstellt haben**. 2. Wählen **Sie Beenden**. ![The Feedback page in Okta with the internal app option selected](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-feedback.png) Okta erstellt die App. ### Attribute hinzufügen Attributanweisungen sagen Okta, welche Benutzerdetails an Document360 gesendet werden sollen. HINWEIS Attributnamen sind groß- und kleinschreibungssensitiv. Geben Sie sie genau wie angezeigt ein. 1. In der App wählen Sie den **Reiter "Anmelden an"** und scrollen Sie zu **Attributanweisungen**. ![The Sign On tab of the Okta app, showing the Attribute statements section](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-sign-on.png) 2. Erweitern Sie **"Legacy-Konfiguration anzeigen**" und wählen Sie dann neben **Profilattribut-Anweisungen** **Bearbeiten**. ![The Edit option for profile attribute statements under Show legacy configuration](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-attribute-statements.png) 3. Fügen Sie diese drei Attributanweisungen hinzu. Wählen Sie Add **Another** aus, um die zweite und dritte Zeile hinzuzufügen. | Name | Namensformat | Wert | | --- | --- | --- | | `urn:oasis:names:tc:SAML:2.0:nameid` | URI-Referenz | `user.email` | | `name` | Unspezifiziert | `user.email` | | `email` | Unspezifiziert | `user.email` | 4. Wählen **Sie Speichern**. ### Weise Personen der App zu. Nur Personen, die der App in Okta zugeordnet sind, können sich mit Okta bei Document360 anmelden. 1. Wähle in der App den **Reiter Zuweisungen** aus. 2. Wählen **Sie Zuweisen** und dann **Personen zuweisen** oder **Gruppen zuweisen**. 3. Wählen Sie neben jeder Person oder Gruppe, die sich bei Document360 anmelden soll, "**Zuweisen**", wählen Sie **"Speichern und zurück"** und dann **"Fertig".** --- ## Schritt 3: Geben Sie die Okta-Daten in Document360 ein ### Hol dir die Setup-Werte von Okta Auf dem **Reiter "Anmelden** an" der App wählen Sie " **Einrichten von SAML anzeigen**". Die benötigten Werte öffnen sich auf einer neuen Seite. ![Opening View SAML setup instructions from the Sign On tab in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/6_GIF-Okta_app_signon_setup_instructions.gif) ![The Okta SAML setup instructions page showing the sign-on URL, issuer, and X.509 certificate](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta_setup_instructions_page.png) ### Schließen Sie den Schritt IdP konfigurieren 1. Wechsle zum Reiter Document360 und wähle dann **Nächster** aus, um zum Schritt **IdP konfigurieren** zu gelangen. 2. (Optional) Um SCIM-Einstellungen aus einem Elternprojekt wiederzuverwenden, wählen Sie eine SSO-Konfiguration mit aktiviertem SCIM in **Configure a existing connection**. Diese Konfiguration wird zur Kindkonfiguration und erbt die SCIM-Einstellungen des Elternteils, und der **SCIM-Schritt** wird gesperrt. Um mehr zu erfahren, lesen [Sie Inherit from Another Application](/help/docs/de/scim-with-okta#inherit-from-another-application) vor. 3. Kopiere diese Werte aus den Okta-Einrichtungsanweisungen: | Kopie von Okta | In Document360 einfügen | | --- | --- | | **Identity Provider Single Sign-On URL** | **Anmelde-URL** | | **Identitätsanbieter-Aussteller** | **Entitäts-ID** | 4. Lass **den Bindungstyp** auf **Httppost** gesetzt, was dem Standardwert von Okta entspricht. 5. Laden Sie das **X.509-Zertifikat** von Okta herunter und laden Sie es dann im **SAML-Zertifikat** hoch. Sie können eine PEM-, CRT- oder CER-Datei von bis zu 10 MB hochladen. 6. Damit sich Personen vom Okta-Dashboard aus anmelden können, aktivieren Sie **IdP-initiierte Anmeldung erlauben**. Um mehr zu erfahren, lesen Sie " [Lassen Sie Personen von Ihrem IDP-Dashboard aus anmelden](/help/docs/de/saml#let-people-sign-in-from-your-idp-dashboard)". ![The Configure IdP step in Document360 with the Okta sign-on URL, entity ID, and certificate entered](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-IdP-Okta.png) 7. Wählen **Sie Nächstes** aus. Der **SCIM-Schritt** öffnet sich. --- ## Schritt 4: (Optional) Einrichtung der SCIM-Bereitstellung SCIM hält Document360 synchron mit Okta: Wenn Sie Benutzer und Reader in Okta hinzufügen, aktualisieren oder deaktivieren, aktualisiert sich Document360 automatisch. Sie richten SCIM jetzt in beiden Tabs ein und testen es in Schritt 6, nachdem Sie die Konfiguration erstellt haben. Wenn du kein SCIM brauchst, lass **die Bereitstellung von SCIM aktivieren** deaktiviert und gehe zu [Schritt 5](/docs/de/saml-sso-with-okta#step-5-name-the-configuration-and-create-it). WARNUNG Document360 zeigt die primären und sekundären geheimen Token nur einmal an. Kopiere beide und speichere sie sicher, bevor du die Konfiguration erstellst. Danach sind sie maskiert und können nicht mehr abgerufen werden. Wenn du ein Token neu generierst, funktioniert das alte nicht mehr, und du musst es in Okta aktualisieren, um die Synchronisation fortzusetzen. ### Aktivieren Sie SCIM in Document360 1. Im **SCIM-Schritt** aktivieren Sie **die Bereitstellung von SCIM** aktivieren. ![The Enable SCIM provisioning toggle on the SCIM step in Document360](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SCIM-Okta.png) 2. Im Bestätigungsdialog überprüfen Sie die Bedingungen, aktivieren Sie das Kontrollkästchen und wählen **Sie dann Zustimmen**. Die **SCIM-Basis-URL** sowie die primären und sekundären Geheimtokens erscheinen. ![The SCIM base URL and secret tokens shown after SCIM provisioning is turned on](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Enable%20SCIM%20provisioning.png) 3. Kopiere beide geheimen Token und bewahre sie sicher auf. ### Aktiviere SCIM in der Okta-App 1. In der Okta Admin Console erweitern Sie **Anwendungen und Ressourcen**, wählen **Sie Anwendungen** aus und öffnen Sie dann Ihre Document360-App. 2. Im **Reiter General** wähle neben **App-Einstellungen** **Bearbeiten** aus. 3. Wählen Sie unter **Provisioning** **SCIM** und dann **Speichern**. ![The SCIM option selected under Provisioning in the Okta app settings](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/enable_scim_provisioning.png) ### Verbinden Sie Okta mit Document360 1. Im **Reiter Bereitstellung** wählen Sie neben **SCIM-Verbindung** **Bearbeiten**. ![The Edit option for the SCIM connection on the Provisioning tab in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/edit-provisioning.png) 2. In der **SCIM Connector-Basis-URL** fügen Sie die **SCIM-Basis-URL** aus Document360 ein. 3. Im **Feld eindeutige Kennung für Benutzer** geben `userName`Sie . 4. Unter **Unterstützte Bereitstellungsaktionen** wählen Sie nur **Push-Neue Benutzer,** **Push-Profil-Updates** und **Push-Gruppen** aus. 5. Im **Authentifizierungsmodus** wählen Sie **HTTP-Header**. 6. Fügen Sie unter **HTTP Header** das primäre geheime Token von Document360 in **die Autorisierung** ein. ![The SCIM connection settings in Okta with the base URL, unique identifier, provisioning actions, and authorization header](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/scim-connection.png) 7. Wählen **Sie Speichern**. HINWEIS Wähle noch nicht **Test-Connector-Konfiguration** aus. Der Test schlägt fehl, bis du die Konfiguration in Document360 in Schritt 5 erstellst. ### Setze die Standardrolle und Gruppen in Document360 1. Wechsle zum Document360-Reiter. Um Benutzer und Leser basierend auf ihren Okta-Gruppen zuzuweisen, aktivieren **Sie Gruppensynchronisation aktivieren**. 2. In **der Standardrolle** behalten Sie **den Beitragspartner** oder wählen Sie eine andere Rolle. Diese Rolle gilt nur für Nutzer. Leser erhalten keine Rolle. 3. In **Benutzergruppen** und **Lesergruppen** wählen Sie die Gruppen aus, zu denen neue Benutzer und Reader hinzugefügt werden sollen. Diese Gruppen gelten, egal ob die Gruppensynchronisation aktiviert ist oder nicht. ![The group sync toggle, default role, and user and reader group fields on the SCIM step](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SCIM-Okta-Group-Sync.png) 4. Wählen **Sie Nächstes** aus. Um mehr über Attributmapping, Provisioning und Deprovisioning zu erfahren, lesen [Sie Managing users and readers with SCIM in Okta](/help/docs/de/scim-with-okta). --- ## Schritt 5: Nenne die Konfiguration und erstelle sie 1. Im **SSO-Namen** geben Sie einen Namen für diese Konfiguration ein. 2. Geben Sie im **Text der Login-Schaltfläche** den Text für den Anmeldebutton ein. 3. (Optional) Um Benutzer nach einer Phase der Inaktivität abzumelden, aktivieren Sie **den SSO-Timeout für Idle-Sitzungen** und setzen Sie die **Timeout-Dauer (HH:MM).** 4. Unter **Bestehende Team- und Leserkonten in SSO konvertieren**, wähle in **Einladung senden Alle** **Benutzer** oder **Ausgewählte Benutzer** aus. Sieh dir die Warnung in [Bevor du anfängst](/docs/de/saml-sso-with-okta#before-you-begin). ![The final setup step with SSO name, login button text, idle timeout, and account conversion options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-Okta-more-settings.png) 5. Wählen **Sie Erstellen**. Die Konfiguration erscheint in der **Enterprise-SSO-Liste** . Um zu bestätigen, dass sie funktioniert, melde dich mit einem Okta-Konto an, das du der App zugewiesen hast. Wenn du SCIM eingerichtet hast, mache Schritt 6. --- ## Schritt 6: Test die SCIM-Verbindung in Okta Überspringe diesen Schritt, wenn du SCIM nicht eingerichtet hast. 1. Öffne in der Okta Admin Console deine Document360-App und gehe zum **Reiter Provisioning** . 2. Wählen Sie neben **SCIM-Verbindung** **"Bearbeiten**" und wählen Sie dann **"Test Connector Configuration**". Ein Bestätigungsdialog zeigt, dass der Test erfolgreich war. ![The Okta confirmation dialog showing a successful connector test and the detected provisioning features](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/test%20confirmation.png) 3. Wählen Sie **Schließen** und dann **Speichern**. Okta überträgt keine Änderungen an Document360, bis Sie **Benutzer erstellen**, **Benutzerattribute aktualisieren** und **Benutzer unter** **Bereitstellung** > **zur App** deaktivieren aktivieren. Dazu lesen [Sie Bereitstellung Okta in Document360](/help/docs/de/scim-with-okta#provision-okta-to-document360). Um Benutzer, Leser und Gruppen zuzuweisen, lesen [Sie Benutzerverwaltung und Leser mit SCIM in Okta](/help/docs/de/scim-with-okta). --- ## Best Practices - **Teste zuerst mit einer kleinen Gruppe.** Bevor du SSO für alle ausrollst, melde dich mit einigen Testkonten an, um Attributzuordnungen oder Zugriffsprobleme zu erkennen. - **Speichere beide geheimen Token wie Passwörter. Bewahre** sie in einem Passwortmanager oder Geheimnis-Tresor auf, niemals in einfachen Textdateien oder Code-Repositories. - **Passen Sie das Leerlauf-Timeout an Ihre Sicherheitsrichtlinie an.** Legen Sie die Timeout-Dauer nach den Sitzungsregeln Ihrer Organisation fest. --- ## FAQ **Warum gibt es zwei SCIM-Geheimtoken?** Zwei Token erlauben es, einen Token zu ersetzen, ohne die Synchronisation zu unterbrechen. Wenn der primäre Token offengelegt ist, wechsle zuerst Okta auf den sekundären Token und regeneriere dann den primären Token. Die Provisionierung läuft weiter, während du ihn ersetzt. **Kann ich dieselbe Okta-App für die Bereitstellung von SAML, SSO und SCIM verwenden?** Ja. Mit SAML aktiviert man SCIM in derselben Okta-App. Mit OpenID Connect benötigt SCIM eine separate OAuth Bearer Token App aus dem Okta-Katalog. **Was passiert mit bestehenden Document360-Nutzern und -Lesern, wenn ich SSO einrichte?** Nichts, es sei denn, du entscheidest dich, ihre Konten in Schritt 5 zu konvertieren. Konvertierte Nutzer und Leser behalten ihre Rollen und Berechtigungen. Wie sich ihre Anmeldung ändert, siehe die Warnung in [Before You Beginning](/docs/de/saml-sso-with-okta#before-you-begin).