> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/dein-workspace/team/okta-sso.md).

# Okta-SSO- und SCIM-Konfiguration

Konfigurieren Sie Okta für AirOps: SCIM-Benutzerbereitstellung, Single Sign-on mit OAuth 2.0/OIDC und Anmeldung mit Okta.

Verbinden Sie Okta mit AirOps, damit Ihr Identity-Team den AirOps-Zugriff über Okta verwaltet. Es gibt zwei Komponenten, und Sie können jede davon einzeln einrichten:

* **SCIM** stellt AirOps-Mitglieder automatisch bereit und entfernt sie wieder, wenn Sie die App in Okta zuweisen oder die Zuweisung aufheben.
* **OIDC** ermöglicht Arbeitsbereichsmitgliedern, sich mit ihren Okta-Zugangsdaten bei AirOps anzumelden.

Beide befinden sich in derselben Okta-Anwendung. Konfigurieren Sie sie in der AirOps-App, die Sie in Ihrer Okta-Organisation erstellen, und melden Sie sich dann mit dem Workspace-Slug an.

## SCIM konfigurieren

SCIM hält die AirOps-Mitgliedschaft mit Okta synchron. Wenn Sie einem Benutzer die AirOps-App zuweisen, erstellt Okta die AirOps-Mitgliedschaft. Wenn Sie die Zuweisung aufheben oder den Benutzer deaktivieren, deaktiviert Okta die Mitgliedschaft.

{% hint style="info" %}
Die Okta-SCIM-Bereitstellung ist in Platform-Tarifen verfügbar. Wenden Sie sich an Ihr AirOps-Account-Team, um zu bestätigen, dass Ihr Workspace berechtigt ist, bevor Sie beginnen.
{% endhint %}

### Bevor Sie beginnen

Sie benötigen Ihren **Workspace-API-Schlüssel**, verfügbar in AirOps unter **Einstellungen → Workspace**. Okta sendet diesen Schlüssel bei jeder SCIM-Anfrage als Bearer-Token. Nur Admins und Entwickler können ihn sehen.

### SCIM in der Okta-App aktivieren

1. Öffnen Sie in Okta die AirOps-Anwendung und gehen Sie zu **Allgemein** Tab.
2. Klicken Sie auf **Bearbeiten** auf **App-Einstellungen**.
3. Wählen Sie **SCIM-Bereitstellung aktivieren**.
4. Stellen Sie sicher, dass die App als interne Anwendung markiert ist und dass **App-Anmelde-URL** ist `https://app.airops.com`.
5. Klicken Sie auf **Speichern**.

{% hint style="info" %}
Wenn **SCIM-Bereitstellung aktivieren** nicht sichtbar ist, wenden Sie sich an den Okta-Support, um die Funktion für Ihre Organisation zu aktivieren.
{% endhint %}

### Die Bereitstellungsverbindung konfigurieren

Gehen Sie zu **Bereitstellung** Registerkarte, dann **Integration**, und klicken Sie auf **API-Integration konfigurieren**.

| Einstellung                                      | Wert                                                                       |
| ------------------------------------------------ | -------------------------------------------------------------------------- |
| **Basis-URL des SCIM-Connectors**                | `https://app.airops.com/public_api/okta_scim`                              |
| **Eindeutiges Identifikationsfeld für Benutzer** | `E-Mail`                                                                   |
| **Unterstützte Bereitstellungsaktionen**         | **Neue Benutzer übertragen** und **Profilaktualisierungen übertragen** nur |
| **Authentifizierungsmodus**                      | HTTP-Header                                                                |
| **Authorization**                                | Ihr AirOps-Workspace-API-Schlüssel                                         |

Klicken Sie auf **Connector-Konfiguration testen**, dann **Speichern**.

### Die Bereitstellungsaktionen aktivieren

Auf der **Bereitstellung** Registerkarte, öffnen Sie **Zu App** und klicken Sie auf **Bearbeiten**. Aktivieren Sie:

* **Benutzer erstellen**
* **Benutzerattribute aktualisieren**
* **Benutzer deaktivieren**
* **Passwort synchronisieren**

Lassen Sie die anderen Aktionen deaktiviert.

### Die Anmelde- und Benutzernameneinstellungen festlegen

1. Auf der **Anmeldung** Registerkarte, wählen Sie **Sichere Webauthentifizierung**.
2. Setzen Sie **Format des Anwendungsbenutzernamens** auf **E-Mail**.
3. Setzen Sie **Anwendungsbenutzernamen aktualisieren bei** auf **Erstellen und aktualisieren**.
4. Optional aktivieren **Passwort anzeigen** damit Benutzer ihr Passwort sehen können. Wir empfehlen dies, es ist jedoch nicht erforderlich.
5. Klicken Sie auf **Speichern**.

Benutzer melden sich mit ihrer E-Mail als Benutzernamen an, daher sollte ein Okta-Administrator den Benutzernamen festlegen, anstatt die Benutzer dazu aufzufordern, einen anzugeben.

### Standardrolle für bereitgestellte Mitglieder

Die SCIM-Erstellung und Reaktivierung über Okta verwenden die im Workspace konfigurierte Okta-Standardrolle. Das Wiederherstellen einer entfernten Mitgliedschaft über Okta SSO verwendet ebenfalls den aktuellen Standard des Anbieters. Wenn kein Standard konfiguriert ist, verwendet AirOps stattdessen **Admin**.

Bestehende aktive Mitglieder behalten ihre zugewiesenen Rollen. Das Ändern des Standards aktualisiert frühere Mitgliedschaften nicht, überprüfen Sie diese also separat, wenn sie eine andere Rolle verwenden sollen.

## OIDC konfigurieren

OIDC übernimmt die Anmeldung. AirOps Okta SSO verwendet OAuth 2.0/OIDC, daher ist die Okta-Anwendung eine Webanwendung, die den Authorization-Code-Flow verwendet.

### Die Okta-App-Integration erstellen

1. Gehen Sie in Okta zu **Anwendungen**.
2. Klicken Sie auf **App-Integration erstellen**.
3. Wählen Sie **OIDC - OpenID Connect** als Anmeldemethode.
4. Wählen Sie **Webanwendung** als Anwendungstyp.
5. Klicken Sie auf **Weiter**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5acd08ed533ed75bd4f08c42931bf162047da317%2Fokta-sso-01-create-app-integration.png?alt=media" alt="Create an Okta OIDC app integration for AirOps"><figcaption><p>Erstellen Sie eine OIDC-App-Integration in Okta.</p></figcaption></figure>

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-38ddb66ef7d132b7d739ffffa56ef0382e68f6e7%2Fokta-sso-02-web-app-settings.png?alt=media" alt="Select Web Application as the Okta application type"><figcaption><p>Wählen Sie Webanwendung als Okta-Anwendungstyp.</p></figcaption></figure>

### Die Okta-App-Einstellungen konfigurieren

Konfigurieren Sie diese Einstellungen in der **Allgemeine Einstellungen** Phase des Erstellungsassistenten oder später auf der **Allgemein** Registerkarte der App. OIDC-Webanwendungen haben keine Single-Sign-On-Registerkarte; diese Registerkarte erscheint nur bei SAML-Apps.

1. Setzen Sie **Name der App-Integration** auf `AirOps`.
2. Unter **ANMELDUNG**, setzen Sie **Anmelde-Weiterleitungs-URIs** auf `https://app.airops.com/users/auth/okta/callback`.
3. Unter **Vertrauenswürdige Ursprünge**, setzen Sie **Basis-URIs** auf `https://app.airops.com`.
4. Unter **Zuweisungen**, wählen Sie die Benutzer oder Gruppen aus, die Zugriff auf AirOps haben sollen.
5. Klicken Sie auf **Speichern**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0fbbdb6f69d1ded2eb8ffb8e9ca68a03a9cce4ee%2Fokta-sso-03-assignments.png?alt=media" alt="Configure Okta assignments for the AirOps application"><figcaption><p>Weisen Sie die AirOps-Anwendung den Benutzern oder Gruppen zu, die Zugriff benötigen.</p></figcaption></figure>

### Wählen Sie die Endpunkte des Okta-Autorisierungsservers

AirOps fragt die Endpunkt-URLs direkt ab. Wählen Sie den Okta-Autorisierungsserver, den Ihre Organisation verwendet, und kopieren Sie dann die passenden URLs in AirOps.

Verwenden Sie den Organisations-Autorisierungsserver, wenn Ihre Okta-Organisation keinen benutzerdefinierten Autorisierungsserver hat. Diese URLs verwenden Ihre Okta-Domain ohne `/oauth2/default`.

| AirOps-Feld            | URL des Organisations-Autorisierungsservers             |
| ---------------------- | ------------------------------------------------------- |
| **Autorisierungs-URL** | `https://your-okta-domain.okta.com/oauth2/v1/authorize` |
| **Token-URL**          | `https://your-okta-domain.okta.com/oauth2/v1/token`     |
| **Benutzerinfo-URL**   | `https://your-okta-domain.okta.com/oauth2/v1/userinfo`  |

Verwenden Sie einen benutzerdefinierten Autorisierungsserver nur, wenn Ihre Okta-Organisation einen eingerichtet hat. Okta-Entwicklerorganisationen enthalten oft den `default` benutzerdefinierten Autorisierungsserver, aber manche Produktionsorganisationen nicht.

| AirOps-Feld            | URL des benutzerdefinierten Autorisierungsservers               |
| ---------------------- | --------------------------------------------------------------- |
| **Autorisierungs-URL** | `https://your-okta-domain.okta.com/oauth2/default/v1/authorize` |
| **Token-URL**          | `https://your-okta-domain.okta.com/oauth2/default/v1/token`     |
| **Benutzerinfo-URL**   | `https://your-okta-domain.okta.com/oauth2/default/v1/userinfo`  |

{% hint style="info" %}
Wenn Ihr Okta-Administrator Ihnen eine andere ID für den benutzerdefinierten Autorisierungsserver als `default`, ersetzen Sie `default` in den URLs des benutzerdefinierten Autorisierungsservers durch diese ID.
{% endhint %}

### Die Okta-Konfiguration in AirOps hinzufügen

1. Melden Sie sich bei AirOps an unter `https://app.airops.com`.
2. Navigieren Sie zu **Einstellungen → Einmalanmeldung**.
3. Auf der **SSO-Anbieter** Seite und klicken Sie auf **Konfigurieren** in der **Okta** Zeile.
4. Geben Sie die Okta-Client-Anmeldedaten und die Endpunkt-URLs ein.
5. Klicken Sie auf **Hinzufügen**.

Um eine vorhandene Okta-Konfiguration zu bearbeiten, öffnen Sie **Aktionen → Anmeldedaten aktualisieren** in der **Okta** Zeile, aktualisieren Sie die Felder und klicken Sie auf **Aktualisieren**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-39ee14932a4fe29c64e72b1f5d133a55fb5d9ceb%2Fsso-okta-01-providers.png?alt=media" alt="SSO Providers settings with the Email and password login toggle and Configure buttons for Okta, Azure, and Rippling"><figcaption><p>Öffnen Sie die Single-Sign-On-Einstellungen in AirOps.</p></figcaption></figure>

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-8a7960b5227d82d5ad001c7fda4184a0d105b47c%2Fsso-okta-02-credentials.png?alt=media" alt="Add Okta Credentials dialog with Client ID, Client Secret, Site, Authorize URL, Token URL, and User Info URL fields"><figcaption><p>Geben Sie die Okta-SSO-Konfigurationswerte in AirOps ein.</p></figcaption></figure>

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-24082f1d744b2cf4ac4ea64684921b7cc6405292%2Fsso-okta-03-save.png?alt=media" alt="Add Okta Credentials form filled in with a spaceops.okta.com site and its authorize, token, and user info URLs"><figcaption><p>Speichern Sie die Okta-SSO-Konfiguration.</p></figcaption></figure>

### OIDC-Parameter

| Feld                   | Wert                                                                                                                                                                                                                    |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Client-ID**          | Navigieren Sie in Okta zu **Anwendungen → Ihre App** und kopieren Sie den **Client-ID**.                                                                                                                                |
| **Client Secret**      | Navigieren Sie in Okta zu **Anwendungen → Ihre App** und kopieren Sie den **Client Secret**.                                                                                                                            |
| **Website**            | Ihre Okta-Domain ohne einen Pfad für den Autorisierungsserver, z. B. `https://dev-123456.okta.com`.                                                                                                                     |
| **Autorisierungs-URL** | Der Authorize-Endpunkt für den Okta-Autorisierungsserver, den Sie ausgewählt haben, z. B. `https://your-okta-domain.okta.com/oauth2/v1/authorize` oder `https://your-okta-domain.okta.com/oauth2/default/v1/authorize`. |
| **Token-URL**          | Der Token-Endpunkt für den Okta-Autorisierungsserver, den Sie ausgewählt haben, z. B. `https://your-okta-domain.okta.com/oauth2/v1/token` oder `https://your-okta-domain.okta.com/oauth2/default/v1/token`.             |
| **Benutzerinfo-URL**   | Der Userinfo-Endpunkt für den Okta-Autorisierungsserver, den Sie ausgewählt haben, z. B. `https://your-okta-domain.okta.com/oauth2/v1/userinfo` oder `https://your-okta-domain.okta.com/oauth2/default/v1/userinfo`.    |

## Kontoanmeldung

Nachdem Sie die Okta-Konfiguration gespeichert haben, melden Sie sich von AirOps ab und gehen Sie zu `https://app.airops.com/users/sign_in`.

Wählen Sie **Mit Okta anmelden**, geben Sie Ihren **AirOps-Workspace-Slug**, und klicken Sie auf **Weiter**. Dies ist Ihr AirOps-Workspace-Slug, nicht Ihre Okta-Domain oder Ihr Okta-Slug. Sie finden ihn in Ihren AirOps-Workspace-Einstellungen.

{% hint style="info" %}
Um die manuelle Eingabe des Workspace-Slugs zu überspringen, verwenden Sie `https://app.airops.com/users/sign_in?okta-workspace-slug=YOUR_WORKSPACE_SLUG`.
{% endhint %}

## Video-Anleitung

{% embed url="<https://www.loom.com/share/40208396fcba439fae71392b26090a0c?sid=4fe81aec-2a8c-401e-90c0-764cd2ed4644>" %}


---

# 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.airops.com/docs/de/dein-workspace/team/okta-sso.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.
