# OneLogin SAML Implementierung Dieser Artikel enthält **OneLogin-spezifische** Hilfe zur Konfiguration der Zugangsdaten mit SSO über SAML 2.0. Für Hilfe bei der Konfiguration der Zugangsdaten mit SSO für einen anderen IdP, verweisen Sie auf [SAML 2.0 Konfiguration](https://bitwarden.com/de-de/help/configure-sso-saml/). Die Konfiguration beinhaltet die gleichzeitige Arbeit innerhalb der Bitwarden-Web-App und des OneLogin-Portals. Während Sie fortfahren, empfehlen wir, beides griffbereit zu haben und die Schritte in der Reihenfolge durchzuführen, in der sie dokumentiert sind. > [!NOTE] > **Already an SSO expert?** Skip the instructions in this article and download screenshots of sample configurations to compare against your own. > > ⬇️ [Download Sample](https://bitwarden.com/assets/mQMTlMcvpyBPzgAkgqDvg/420fde23d3edf526d97f22bea8a5ed80/OneLogin.zip) ## Öffnen Sie SSO in der Web-App Melden Sie sich bei der Bitwarden-Web-App an und öffnen Sie die Administrator-Konsole mit dem Produktumschalter ([filter]): ![Produktwechsler](https://bitwarden.com/assets/2uxBDdQa6lu0IgIEfcwMPP/e3de3361749b6496155e25edcfdcf08b/2024-12-02_11-19-56.png) Öffnen Sie den **Einstellungen** → **Single sign-on** Bildschirm Ihrer Organisation: ![SAML 2.0 Konfiguration ](https://bitwarden.com/assets/20720mRAluo6crSdTiYJrn/1175889d7f6ab42fe7614f34cdd1dcdd/2024-12-04_09-41-15.png) Wenn Sie es noch nicht getan haben, erstellen Sie einen einzigartigen **SSO-Identifikator** für Ihre Organisation und wählen Sie **SAML** aus dem **Typ**-Dropdown aus. Lassen Sie diesen Bildschirm geöffnet für eine einfache Referenz. Sie können die Option **Einen eindeutigen SP-Entity-ID festlegen** in diesem Stadium ausschalten, wenn Sie möchten. Wenn Sie dies tun, wird Ihre Organisations-ID aus Ihrem SP-Entity-ID-Wert entfernt. In fast allen Fällen wird jedoch empfohlen, diese Option aktiviert zu lassen. > [!TIP] Self-hosting, use alternative Member Decryption Options. > Es gibt alternative **Mitglied Entschlüsselungsoptionen**. Erfahren Sie, wie Sie mit [SSO auf vertrauenswürdigen Geräten](https://bitwarden.com/de-de/help/about-trusted-devices/) oder mit [Key Connector](https://bitwarden.com/de-de/help/about-key-connector/) beginnen können. ## Erstellen Sie eine OneLogin-App Im OneLogin Portal navigieren Sie zum **Anwendungen** Bildschirm und wählen Sie die Schaltfläche **App hinzufügen**: ![Eine Anwendung hinzufügen ](https://bitwarden.com/assets/37OSt7e5j969j9ikvH8buI/b6caa5f68ed17b43cd2c7247ee00bacf/OneLogin1.png) Geben Sie in der Suchleiste `saml test connector` ein und wählen Sie die **SAML Test Connector (Advanced)** App aus: ![SAML Test Connector App ](https://bitwarden.com/assets/hTfoABj2iirzB1X7UT69x/520891ab503ad773178fef291d49e198/2026-03-02_09-22-12.png) Geben Sie Ihrer Anwendung einen Bitwarden-spezifischen **Anzeigenamen** und wählen Sie die **Speichern** Schaltfläche. ### Konfiguration Wählen Sie **Konfiguration** aus der linken Navigation aus und konfigurieren Sie die folgenden Informationen, einige davon müssen Sie vom Single Sign-On-Bildschirm abrufen: ![App-Konfiguration](https://bitwarden.com/assets/12yP5ohPGhqcCZZdpwVDQd/e31bd5ade4c3677b8f5426f5fef6fb3e/onelogin2.png) | **Anwendungseinstellungen** | **Beschreibung** | |------|------| | Publikum (EntityID) | Setzen Sie dieses Feld auf die vorab generierte **SP Entity ID**. Dieser automatisch generierte Wert kann aus der **Einstellungen** → **Single Sign-On** Bildschirm der Organisation kopiert werden und variiert je nach Ihrer Konfiguration. | | Empfänger | Setzen Sie dieses Feld auf die gleiche vorab generierte **SP Entity ID**, die für die **Audience (Entity ID)**Einstellung verwendet wurde. | | ACS (Verbraucher) URL-Validator | Obwohl es von OneLogin als **Erforderlich**markiert ist, müssen Sie tatsächlich keine Informationen in dieses Feld eingeben, um sich mit Bitwarden zu integrieren. Springen Sie zum nächsten Feld, **ACS (Verbraucher) URL**. | | ACS (Verbraucher) URL | Setzen Sie dieses Feld auf die vorab generierte **Assertion Consumer Service (ACS) URL**. Dieser automatisch generierte Wert kann aus der **Einstellungen** → **Single Sign-On** Bildschirm der Organisation kopiert werden und variiert je nach Ihrer Konfiguration. | | SAML-Initiator | Wählen Sie **Dienstleister** aus. Die Anmeldung mit SSO unterstützt derzeit keine von IdP initiierten SAML-Behauptungen. | | SAML NameID Format | Setzen Sie dieses Feld auf das [SAML NameID Format](https://docs.oracle.com/cd/E19316-01/820-3886/ggwbz/index.html), das Sie für SAML-Behauptungen verwenden möchten. | | SAML-Signaturelement | Standardmäßig wird OneLogin die SAML-Antwort signieren. Sie können dies auf **Behauptung** oder **Beide** einstellen. | Wählen Sie die Schaltfläche **Speichern**, um Ihre Konfigurationseinstellungen abzuschließen. ### Parameter Wählen Sie **Parameter** aus der linken Navigation aus und verwenden Sie das + **Hinzufügen** Symbol, um die folgenden benutzerdefinierten Parameter zu erstellen: | **Feldname** | **Wert** | |------|------| | E-Mail-Adresse | E-Mail | | Vorname | Vorname | | Nachname | Nachname | Wählen Sie die Schaltfläche **Speichern**, um Ihre benutzerdefinierten Parameter abzuschließen. ### SSO Wählen Sie **SSO** aus der linken Navigation aus und vervollständigen Sie Folgendes: 1. Wählen Sie den Link **Details anzeigen** unter Ihrem X.509-Zertifikat: ![Betrachten Sie Ihr Zertifikat ](https://bitwarden.com/assets/7emKbivWUWKO1ufVC9Rkgu/e023c4c3fb7195afd93d6515f86d8cbf/onelogin3.png) Auf dem Zertifikatsbildschirm, laden Sie Ihr X.509 PEM-Zertifikat herunter oder kopieren Sie es, da Sie es [später verwenden müssen](https://bitwarden.com/de-de/help/saml-onelogin/#identity-provider-configuration/). Einmal kopiert, kehren Sie zum Haupt-SSO-Bildschirm zurück. 2. Stellen Sie Ihren **SAML-Signaturalgorithmus** ein. 3. Notieren Sie sich Ihre **Aussteller-URL** und **SAML 2.0-Endpunkt (HTTP)**. Sie werden diese Werte bald [benötigen](https://bitwarden.com/de-de/help/saml-onelogin/#identity-provider-configuration/). ### Zugriff Wählen Sie **Zugang** aus der linken Navigation aus. Im Abschnitt **Rollen** weisen Sie allen Rollen, die Sie für die Nutzung von Bitwarden verwenden möchten, den Zugriff auf die Anwendung zu. Die meisten Implementierungen erstellen eine Bitwarden-spezifische Rolle und wählen stattdessen die Zuweisung basierend auf einer allgemeinen Lösung (zum Beispiel, **Standard**) oder basierend auf bereits bestehenden Rollen. ![Rollenzuweisung ](https://bitwarden.com/assets/6D4j0WofpBcvSCMB0rN4Db/5303beacbc3ce331dfddc6dc6b19d6ea/ol-roles.png) ## Zurück zur Web-App Bis zu diesem Zeitpunkt haben Sie alles, was Sie im Kontext des OneLogin Portals benötigen, konfiguriert. Kehren Sie zur Bitwarden-Webanwendung zurück, um die Konfiguration abzuschließen. Der Single-Sign-On-Bildschirm teilt die Konfiguration in zwei Abschnitte auf: - Die Konfiguration des **SAML-Dienstanbieters** bestimmt das Format der SAML-Anfragen. - **Durch die Konfiguration des SAML-Identitätsanbieters** wird das zu erwartende Format für SAML-Antworten bestimmt. ### Konfiguration des Dienstanbieters Konfigurieren Sie die folgenden Felder entsprechend den in dem OneLogin Portal [während der App-Erstellung](https://bitwarden.com/de-de/help/saml-onelogin/#create-a-onelogin-app/) getroffenen Auswahlmöglichkeiten: | **Feld** | **Beschreibung** | |------|------| | Namens-ID-Format | Setzen Sie dieses Feld auf das, was Sie für das OneLogin **SAML nameID Format**Feld [während der App-Konfiguration](https://bitwarden.com/de-de/help/saml-onelogin/#configuration/) ausgewählt haben. | | Ausgehendes Signatur-Algorithmus | Algorithmus, der zum Signieren von SAML-Anfragen verwendet wird, standardmäßig `sha-256`. | | Unterzeichnungsverhalten | Ob/wann SAML-Anfragen signiert werden. Standardmäßig erfordert OneLogin keine Signatur für Anfragen. | | Minimales Eingehendes Signatur-Algorithmus | Setzen Sie dieses Feld auf das, was Sie für den **SAML-Signaturalgorithmus** [während der App-Konfiguration](https://bitwarden.com/de-de/help/saml-onelogin/#configuration/) ausgewählt haben. | | Möchte Behauptungen unterschrieben haben | Markieren Sie dieses Kästchen, wenn Sie das **SAML-Signaturelement**in OneLogin auf **Behauptung**oder **Beides**[während der App-Konfiguration](https://bitwarden.com/de-de/help/saml-onelogin/#configuration/) eingestellt haben. | | Zertifikate validieren | Markieren Sie dieses Kästchen, wenn Sie vertrauenswürdige und gültige Zertifikate von Ihrem IdP über eine vertrauenswürdige CA verwenden. Selbstsignierte Zertifikate können fehlschlagen, es sei denn, die richtigen Vertrauensketten sind innerhalb der Bitwarden Zugangsdaten mit SSO Docker-Image konfiguriert. | Wenn Sie mit der Konfiguration des Dienstanbieters fertig sind, **speichern** Sie Ihre Arbeit. ### Konfiguration des Identitätsanbieters Die Konfiguration des Identitätsanbieters erfordert oft, dass Sie sich auf das OneLogin Portal beziehen, um Anwendungswerte abzurufen: | **Feld** | **Beschreibung** | |------|------| | Entitäts-ID | Geben Sie Ihre OneLogin **Issuer URL** ein, die Sie vom [OneLogin App SSO Bildschirm](https://bitwarden.com/de-de/help/saml-onelogin/#sso/) abrufen können. Dieses Feld ist Groß- und Kleinschreibungssensitiv. | | Bindungsart | Einstellen auf **HTTP Post**(wie im SAML 2.0 Endpoint (HTTP) angegeben). | | Einmaliges Anmelden Service URL | Geben Sie Ihren OneLogin **SAML 2.0 Endpunkt (HTTP)** ein, den Sie vom [OneLogin App SSO Bildschirm](https://bitwarden.com/de-de/help/saml-onelogin/#sso/) abrufen können. | | URL des Einzelabmeldedienstes | Die Anmeldung mit SSO unterstützt derzeit **nicht** SLO. Diese Option ist für zukünftige Entwicklungen geplant, jedoch können Sie sie vorab konfigurieren, wenn Sie möchten. | | X509 Öffentliches Zertifikat | Fügen Sie das [abgerufene X.509 Zertifikat](https://bitwarden.com/de-de/help/saml-onelogin/#sso/) ein, entfernen Sie `-----BEGIN ZERTIFIKAT-----` und  `-----ENDE ZERTIFIKAT-----` Der Zertifikatswert ist Groß- und Kleinschreibungssensitiv, zusätzliche Leerzeichen, Zeilenumbrüche und andere überflüssige Zeichen **werden dazu führen, dass die Zertifikatsvalidierung fehlschlägt**. | | Ausgehendes Signaturalgorithmus | Wählen Sie den SAML-Signaturalgorithmus aus, der im Abschnitt [OneLogin SSO](https://bitwarden.com/de-de/help/saml-onelogin/#sso/)-Konfiguration ausgewählt wurde. | | Deaktivieren Sie ausgehende Abmeldeanfragen | Die Anmeldung mit SSO unterstützt derzeit **nicht** SLO. Diese Option ist für zukünftige Entwicklungen geplant. | | Möchte Authentifizierungsanfragen signiert haben | Ob OneLogin erwartet, dass SAML-Anfragen signiert werden. | > [!NOTE] X509 cert expiration > Bei der Ausstellung des X509-Zertifikats, machen Sie eine Notiz vom Ablaufdatum. Zertifikate müssen erneuert werden, um jegliche Unterbrechungen im Dienst für SSO-Endbenutzer zu verhindern. Wenn ein Zertifikat abgelaufen ist, können sich Administrator- und Eigentümer-Konten immer mit E-Mail-Adresse und Master-Passwort anmelden. Wenn Sie mit der Konfiguration des Identitätsanbieters fertig sind, **speichern** Sie Ihre Arbeit. > [!TIP] Policies for SSO Guides > Sie können Benutzer dazu auffordern, sich mit SSO anzumelden, indem Sie die Richtlinie für die Authentifizierung mit Single Sign-On aktivieren. Bitte beachten Sie, dass dies auch die Aktivierung der Einzelorganisation-Richtlinie erfordern wird. [Erfahren Sie mehr](https://bitwarden.com/de-de/help/policies/). ## Testen Sie die Konfiguration Sobald Ihre Konfiguration abgeschlossen ist, testen Sie diese, indem Sie zu [https://vault.bitwarden.com](https://vault.bitwarden.com) navigieren, Ihre E-Mail-Adresse eingeben, **Weiter** auswählen und den **Enterprise Single-On** Button auswählen: ![Unternehmens Single Sign On und Master-Passwort ](https://bitwarden.com/assets/3BdlHeogd42LEoG06qROyQ/c68021df4bf45d72e9d37b1fbf5a6040/login.png) Geben Sie die [konfigurierte Organisationskennung](https://bitwarden.com/de-de/help/saml-onelogin/#/) ein und wählen Sie **Anmelden**. Wenn Ihre Implementierung erfolgreich konfiguriert ist, werden Sie zur OneLogin Zugangsdaten-Bildschirm weitergeleitet: ![OneLogin Zugangsdaten ](https://bitwarden.com/assets/58dRC3pPEm0bO8xtd2Tqzq/415b83d361b49c73550d0932ddca8576/ol-login.png) Nachdem Sie sich mit Ihren OneLogin-Anmeldeinformationen authentifiziert haben, geben Sie Ihr Bitwarden Master-Passwort ein, um Ihren Tresor zu entschlüsseln! > [!NOTE] SSO must be initiated from Bitwarden > Bitwarden unterstützt keine unaufgeforderten Antworten, daher führt das Initiieren von Zugangsdaten von Ihrem IdP zu einem Fehler. Der SSO-Zugangsdaten-Fluss muss von Bitwarden aus initiiert werden.