> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/okta.md).

# Okta

Verwenden Sie Okta als Ihren Identitätsanbieter, damit sich Benutzer mit ihren Okta-Anmeldedaten über OAuth (OIDC) oder SAML bei Dispel anmelden.

## Übersicht

Verbinden Sie Okta — die Enterprise-Identitätsplattform von Okta — als Identitätsanbieter Ihrer Organisation. Nach der Verbindung melden sich Ihre Benutzer mit ihren Okta-Anmeldedaten per Single Sign-On bei Dispel an. Sie können Okta über **OAuth (OIDC)** oder **SAML**.

Diese Seite behandelt die Okta-spezifische Einrichtung. Für das gemeinsame Verhalten, das für jeden Anbieter gilt — wie sich Benutzer anmelden, Gruppenmapping, MFA und das Trennen der Verbindung — siehe [Identitätsanbieter](/documentation/documentation-de/absichern-and-steuern/identity-providers.md).

{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen** (oder die dedizierte **Einstellungen → Authentifizierung** Seite). Okta erscheint in der **Identität & Authentifizierung (IdP / SSO)** Abschnitt. Klicken Sie auf **Verbinden** auf die Kachel, um zu beginnen.
{% endhint %}

## Bevor Sie beginnen

* Sie konfigurieren die IdP-Seite im **Okta Admin Console**, daher benötigen Sie dort Administratorzugriff.
* Legen Sie ein Protokoll fest — **OAuth (OIDC)** oder **SAML**. Siehe [Protokoll auswählen](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#choosing-a-protocol).
* Stellen Sie sicher, dass die Benutzer, die sich über Okta anmelden werden, bereits **zu Ihrer Organisation eingeladen sind** in Dispel. SSO authentifiziert Benutzer, erstellt aber keinen Zugriff von sich aus.

{% hint style="warning" %}
**Immer nur ein Anbieter gleichzeitig.** Wenn Ihre Organisation bereits mit einem anderen Identitätsanbieter verbunden ist, trennen Sie diese Verbindung, bevor Sie Okta verbinden.
{% endhint %}

## Mit OAuth (OIDC) verbinden

#### In Okta

1. Gehen Sie in der Okta Admin Console zu **Anwendungen → App-Integration erstellen** und wählen Sie **OIDC — OpenID Connect**.
2. Legen Sie die **Anmelde-Weiterleitungs-URI** auf Ihre Dispel-Adresse gefolgt von `/oauth/login-callback` — zum Beispiel `https://app.dispel.com/oauth/login-callback`. Bestätigen Sie die genaue Adresse für Ihre Umgebung bei Ihrem Dispel-Ansprechpartner, wenn Sie unsicher sind.
3. Weisen Sie die App den Benutzern oder Gruppen zu, die Zugriff haben sollen.
4. Auf der App- **Allgemein** Registerkarte kopieren Sie das **Client-ID** und **Client Secret**und notieren Sie Ihre Okta-Domäne / Ihren Issuer.

#### In Dispel

1. Klicken Sie auf **Verbinden** auf der Okta-Karte und **Wählen Sie Authentifizierungsprotokoll → OAuth**.
2. Füllen Sie die Felder aus:

| Feld                     | Wert aus Okta                                                                              |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| **Client-URL**           | Ihr Okta-OAuth/OIDC-Endpunkt (Issuer), z. B. `https://your-org.okta.com`.                  |
| **Client-ID**            | Das **Client-ID**.                                                                         |
| **Client-Secret**        | Das **Client Secret**.                                                                     |
| **Organisationskennung** | Eine eindeutige Kennung, die Sie wählen; Benutzer geben sie auf dem Anmeldebildschirm ein. |

3. Klicken Sie auf **Einstellungen speichern**.

## Mit SAML verbinden

#### In Okta

1. Gehen Sie in der Okta Admin Console zu **Anwendungen → App-Integration erstellen** und wählen Sie **SAML 2.0**.
2. Fügen Sie in den SAML-Einstellungen die Werte ein, die Dispel oben in seinem SAML-Formular anzeigt:
   * **Single Sign-On-URL / Empfänger / Ziel** ← Dispels **Assertion Consumer Service URL**.
   * **Audience-URI (SP Entity ID)** ← Dispels **Service Provider (SP) Entity ID**.
3. Schließen Sie das Erstellen der App ab und öffnen Sie dann die **Anmeldung** Registerkarte und erfassen Sie:
   * **Single Sign-On-URL des Identitätsanbieters** → Dispels **SSO-URL**.
   * **Issuer des Identitätsanbieters** → Dispels **Entity ID des Identitätsanbieters**.
   * Die **X.509-/Signaturzertifikat** → Dispels **Base64-Signaturzertifikat**.
4. Weisen Sie die App den Benutzern oder Gruppen zu, die Zugriff haben sollen.

#### In Dispel

1. Klicken Sie auf **Verbinden** auf der Okta-Karte und **Wählen Sie Authentifizierungsprotokoll → SAML**.
2. Kopieren Sie die **Service Provider (SP) Entity ID** und **Assertion Consumer Service URL** oben im Formular angezeigt werden (verwenden Sie **ID kopieren** / **URL kopieren**) in Okta ein, wie oben.
3. Füllen Sie die Felder aus:

| Feld                                  | Wert aus Okta                                                                                  |
| ------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **SSO-URL**                           | Die **Single Sign-On-URL des Identitätsanbieters**.                                            |
| **Entity ID des Identitätsanbieters** | Die **Issuer des Identitätsanbieters**.                                                        |
| **Base64-Signaturzertifikat**         | Das Signaturzertifikat von Okta. Fügen Sie es ein oder verwenden Sie **Zertifikat hochladen**. |
| **Organisationskennung**              | Eine eindeutige Kennung, die Sie wählen; Benutzer geben sie auf dem Anmeldebildschirm ein.     |

4. Klicken Sie auf **Einstellungen speichern**.
5. Klicken Sie auf **Verbindung testen**. Dispel leitet Sie zur Anmeldung an Okta weiter und zeigt dann die E-Mail und den Namen an, die es erhalten hat. Wenn der Test fehlschlägt, bestätigen Sie, dass die Werte mit Ihrer Okta-App übereinstimmen und dass der Testbenutzer zu Ihrer Organisation eingeladen wurde.

## Nach der Verbindung

* **Benutzer melden sich an** indem Sie Ihre Organisationskennung auf dem Dispel-Anmeldebildschirm eingeben und sich mit Okta authentifizieren. Siehe [Wie sich Benutzer anmelden](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#how-users-sign-in).
* **Okta-Gruppen den Dispel-Gruppen zuordnen** damit die Mitgliedschaft synchron bleibt — siehe [OIDC-Gruppenmapping](/documentation/documentation-de/integrieren-and-administrieren/integrations/oidc-group-mapping.md).
* **MFA** Die in Okta erzwungenen Vorgaben gelten während der Anmeldung; die Einmalcodes per E-Mail von Dispel gelten nicht für SSO-Benutzer. Siehe [SSO und Multi-Faktor-Authentifizierung](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#sso-and-multi-factor-authentication).
* **Um Protokolle oder Anbieter zu wechseln**, trennen Sie zuerst die Verbindung. Siehe [Anbieter wechseln oder trennen](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#switching-or-disconnecting-a-provider).

## Häufig gestellte Fragen

<details>

<summary>Welches Protokoll soll ich mit Okta verwenden?</summary>

Beides funktioniert. Verwenden Sie das, was zu der App passt, die Sie in Okta erstellen — eine OIDC-App-Integration für OAuth oder eine SAML-2.0-App-Integration für SAML.

</details>

<details>

<summary>Muss ich Benutzer der Okta-App zuweisen?</summary>

Ja. Nur Benutzer (oder Gruppen), die der Okta-App zugewiesen sind, können sich darüber authentifizieren. Sie müssen außerdem zu Ihrer Dispel-Organisation eingeladen sein.

</details>

<details>

<summary>Meine SAML-Testverbindung ist fehlgeschlagen. Was sollte ich prüfen?</summary>

Bestätigen Sie, dass die SSO-URL, der Issuer und das Zertifikat mit den Anmeldeeinstellungen Ihrer Okta-App übereinstimmen, dass Sie Dispels SP Entity ID und ACS-URL in Okta-SAML-Einstellungen eingefügt haben und dass der Testbenutzer der Okta-App zugewiesen und zu Ihrer Dispel-Organisation eingeladen ist.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/okta.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.