> 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/rippling-sso.md).

# Rippling-SSO-Konfiguration

Konfigurieren Sie Rippling SAML Single Sign-on für Ihren AirOps-Workspace, ordnen Sie Mitarbeiterattribute zu und testen Sie die Anmeldung über AirOps und Rippling.

Verbinden Sie Rippling mit Ihrem AirOps-Workspace, damit sich Mitarbeitende mit ihrem Rippling-Konto anmelden können. Ein Administrator richtet die Verbindung einmal ein und weist dann die AirOps-App in Rippling den Mitarbeitenden zu.

Bei der Einrichtung werden zwei Wertesätze ausgetauscht: AirOps stellt die Ziel-URLs bereit, und Rippling stellt die Metadaten des Identitätsanbieters bereit.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-807c59ee1a49bf7780e4ef92a4d971913c5ecb3b%2Frippling-sso-00-overview.png?alt=media" alt="Copy the ACS URL and SP entity ID from AirOps to Rippling, then import Rippling IdP metadata XML into AirOps"><figcaption><p>Lassen Sie beide Admin-Seiten geöffnet. Sie kopieren Werte in beide Richtungen.</p></figcaption></figure>

## Bevor Sie beginnen

Sie benötigen:

* Einen AirOps-Workspace mit aktiviertem Rippling SSO und Berechtigung zum Verwalten der SSO-Einstellungen. Wenden Sie sich an Ihr AirOps-Kontoteam, wenn Rippling in der Anbieterliste fehlt.
* Die Berechtigung, in Ihrem Rippling-Unternehmen eine benutzerdefinierte SAML-Anwendung zu erstellen und zu konfigurieren.
* Einen Mitarbeitenden, den Sie zum Testen zuweisen können, mit einer geschäftlichen E-Mail-Adresse und einem Vornamen in Rippling.

Lassen Sie Ihre aktuelle AirOps-Admin-Sitzung geöffnet, während Sie in einem separaten Browserprofil oder privaten Fenster testen.

## So richten Sie es ein

Befolgen Sie diese Schritte in der angegebenen Reihenfolge. Lassen Sie AirOps und Rippling in separaten Tabs geöffnet, damit Sie die Verbindungsdetails vor dem Anmelde-Test austauschen können. Jeder kommentierte Onboarding-Screenshot enthält nummerierte Hinweisfelder für die zu verwendenden Steuerelemente. Klicken Sie auf ein Bild, um es zu vergrößern.

### 1. Kopieren Sie die Verbindungsdetails aus AirOps

In Ihrem **AirOps** Registerkarte:

1. Öffnen **Einstellungen → Einmalanmeldung**.
2. Suche **Rippling** und klicken Sie auf **Konfigurieren**.
3. Kopieren Sie die **ACS-URL** und **SP-Entity-ID**. Lassen Sie dieses Formular geöffnet; Sie kehren in Schritt 8 darauf zurück.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5966527e78da4fd419065326b0e64f32be85e3fc%2Fsso-rippling-01-connection.png?alt=media" alt="Add Rippling SAML connection dialog with the ACS URL and SP entity ID and their copy buttons"><figcaption><p>Kopieren Sie beide Werte aus Ihrem eigenen Workspace.</p></figcaption></figure>

### 2. Starten Sie eine benutzerdefinierte Integration in Rippling

Wechseln Sie zu **Rippling**:

1. Öffnen **IT → Zugriff durch Drittanbieter**.
2. Klicken Sie auf **Integration hinzufügen**.
3. Wählen Sie **Neue benutzerdefinierte Integration erstellen**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-671cecbb4b87af80cf2de7c97963c58b8476322d%2Frippling-sso-02-add-integration.jpg?alt=media" alt="Rippling Add integration menu with Create new custom integration"><figcaption><p>Öffnen Sie das Formular zum Erstellen einer benutzerdefinierten Integration.</p></figcaption></figure>

### 3. Geben Sie den App-Namen, die Kategorie und das Logo ein

In **Neue Integration erstellen**, füllen Sie aus:

| Feld                     | Was einzugeben ist                                                               |
| ------------------------ | -------------------------------------------------------------------------------- |
| **Name**                 | Ein wiedererkennbarer Name, z. B. `AirOps SSO`.                                  |
| **Kategorien auswählen** | Wählen Sie eine Kategorie, z. B. **Produktivität**.                              |
| **Logo hochladen**       | Laden Sie das Logo hoch, das Mitarbeitende auf ihrer AirOps-Kachel sehen sollen. |

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2805edfe525c635b5fa076a3d473b83eb8e383d2%2Frippling-sso-app-details-full.svg?alt=media" alt="Rippling Create new integration form showing the app Name, Productivity category, and an uploaded logo"><figcaption><p>Die Beispiel-App heißt AirOps SSO. Wählen Sie einen Namen, den Mitarbeitende wiedererkennen.</p></figcaption></figure>

Bleiben Sie auf dieser Seite und scrollen Sie nach unten zu **Typ der benutzerdefinierten Integration**.

### 4. Wählen Sie SAML-Einmalanmeldung

Im unteren Teil desselben Formulars:

1. Wählen Sie **Integration des Benutzerzugriffs**.
2. Unter **Funktionen**, aktivieren Sie **Einmalanmeldung**.
3. Wählen Sie **SAML** im angezeigten Dropdown-Menü.
4. Lassen Sie **Kontobereitstellung und -aufhebung über SCIM** deaktiviert.
5. Aktivieren Sie **Unterstützt Just-in-Time-Bereitstellung** wenn Mitarbeitende bei ihrer ersten erfolgreichen Anmeldung ein AirOps-Konto erhalten sollen. Die AirOps-Anmeldebeschränkungen gelten weiterhin.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-310ae5bc1a46256990da53bf9d08fe0ce787b71a%2Frippling-sso-app-saml-full.svg?alt=media" alt="Rippling form with User access integration selected, Single sign-on checked, SAML selected, SCIM unchecked, and just-in-time provisioning enabled"><figcaption><p>Wählen Sie die SAML-Funktion und das Bereitstellungsverhalten für Ihre Einführung.</p></figcaption></figure>

Klicken Sie auf **Weiter** um die Integration zu erstellen.

### 5. Wählen Sie den Installierenden aus

In **Wählen Sie einen Installierenden aus**:

1. Wählen Sie **Ja, ich werde diese Integration installieren** wenn Sie die AirOps-Integration für Ihr Unternehmen verwalten.
2. Klicken Sie auf **Weiter** um zu erreichen **SSO-Einrichtungsanweisungen**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9866733f83400a6d74636dba862b0821f38f6482%2Frippling-sso-installer-full.svg?alt=media" alt="Rippling installer selection screen with numbered callouts for choosing the installer and continuing"><figcaption><p>Wählen Sie die Person aus, die die Verbindung konfigurieren wird. Der Screenshot zeigt das Formular, bevor eine Auswahl getroffen wurde.</p></figcaption></figure>

Öffnen Sie bei einer vorhandenen Installation **Zugriff → Einmalanmeldung (SSO) → Konfiguration** und klicken Sie auf **Neu konfigurieren** unter **Allgemein** um den Assistenten erneut zu öffnen.

### 6. Kopieren oder laden Sie die XML-Metadaten von Rippling herunter

In **SSO-Einrichtungsanweisungen**, suchen Sie **Schritt 1 - SAML-Konfigurationsfelder eingeben**, und suchen Sie dann **IdP-Metadaten**. Dieses XML enthält die Rippling-Verbindungsdetails, die AirOps benötigt.

Wählen Sie eine Option:

* **XML herunterladen:** Klicken Sie auf das Download-Symbol rechts neben **IdP-Metadaten** und speichern Sie die Datei. Sie laden sie in Schritt 8 in AirOps hoch.
* **XML kopieren:** Kopieren Sie den vollständigen XML-Inhalt aus **IdP-Metadaten**. Wechseln Sie zu Ihrem AirOps-Tab und fügen Sie ihn in **Oder Metadaten-XML einfügen** ein und kehren Sie dann zu Rippling zurück. Lassen Sie das AirOps-Formular geöffnet.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-44ef5f9ff6b79bd19ac24d3bda9c7ad150213073%2Frippling-sso-05-rippling-metadata.jpg?alt=media" alt="Rippling IdP Metadata section showing the XML contents and its download icon"><figcaption><p>Kopieren oder laden Sie die vollständige IdP-Metadaten-XML für die AirOps-Konfiguration herunter.</p></figcaption></figure>

Bei einer installierten App ist der Download auch verfügbar unter **Zugriff → Einmalanmeldung (SSO) → Konfiguration → Metadaten → Metadaten-XML**.

Lassen Sie die Rippling-Einrichtungsseite geöffnet, um als Nächstes die AirOps-URLs einzugeben.

### 7. Fügen Sie die AirOps-URLs in Rippling ein

Auf derselben **SSO-Einrichtungsanweisungen** -Seite scrollen Sie zu **Schritt 2 - Metadaten des Serviceproviders bereitstellen**. Kopieren Sie jeden Wert aus dem AirOps-Formular in das passende Rippling-Feld:

| Rippling-Feld                      | Einzufügender Wert           |
| ---------------------------------- | ---------------------------- |
| **Assertion Consumer Service URL** | Ihr AirOps **ACS-URL**.      |
| **Service-Provider-Entity-ID**     | Ihr AirOps **SP-Entity-ID**. |

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-fc52a7014db2a452acddf222c3546301e832bef4%2Frippling-sso-02-rippling-endpoints.jpg?alt=media" alt="Rippling SSO setup instructions showing Assertion Consumer Service URL and Service Provider Entity ID"><figcaption><p>Der Screenshot zeigt Beispiel-URLs aus einem AirOps-Workspace. Kopieren Sie die generierten URLs für Ihren eigenen Workspace und Ihre eigene Umgebung.</p></figcaption></figure>

Diese beiden Felder stellen die Metadaten des Serviceproviders bereit. Sie können die alternative **Metadaten-URL** und **Metadaten** bei Verwendung dieser Methode leer lassen.

Lassen Sie Rippling geöffnet und wechseln Sie zurück zu AirOps.

### 8. Speichern Sie die Verbindung in AirOps

Im geöffnet gelassenen AirOps-Formular:

1. Wenn Sie das XML in Schritt 6 heruntergeladen haben, wählen Sie **IdP-Metadaten-XML hochladen** und wählen Sie die Datei aus. Wenn Sie sie kopiert haben, verwenden Sie den bereits eingefügten Inhalt in **Oder Metadaten-XML einfügen**.
2. Klicken Sie auf **Metadaten prüfen**.
3. Überprüfen Sie die importierte **IdP-Entity-ID**, **SSO-URL**, und **Signaturzertifikate**.
4. Geben Sie die exakten Attributnamen ein, die in Ihrer Rippling-App konfiguriert sind. **Die folgenden Namen sind Beispiele; Ihre App kann andere Namen verwenden.** Siehe [Schritt 16: Konfigurieren Sie die Mitarbeitendenattribute](#16-configure-the-employee-attributes) um sie vor dem Anmelde-Test zu überprüfen oder zu erstellen.

| AirOps-Feld                               | Beispiel         | Was Sie für Ihre Verbindung eingeben sollen                                                                                        |
| ----------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **NameID-Format**                         | **emailAddress** | Dasselbe NameID-Format, das in Rippling konfiguriert ist.                                                                          |
| **Attribut für die geschäftliche E-Mail** | `emailAddress`   | Der exakte Attributname, den Rippling verwendet, um die geschäftliche E-Mail des Mitarbeitenden zu senden.                         |
| **Attribut für den Vornamen**             | `firstName`      | Der exakte Attributname, den Rippling verwendet, um den Vornamen des Mitarbeitenden zu senden.                                     |
| **Attribut für den Nachnamen (optional)** | `lastName`       | Der exakte Attributname, den Rippling verwendet, um den Nachnamen des Mitarbeitenden zu senden. Leer lassen, wenn nicht verwendet. |
| **Standardrolle**                         | **Mitglied**     | Wählen Sie die AirOps-Rolle, die neue Workspace-Mitglieder erhalten sollen.                                                        |

Diese Felder enthalten Attributnamen. Rippling liefert die tatsächliche E-Mail-Adresse und den Namen des Mitarbeitenden, wenn sie sich anmelden.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a73f137f2c676a7da8f47c82cc2f5b0a3f8f5ead%2Fsso-rippling-02-attributes.png?alt=media" alt="Rippling SAML connection with NameID format emailAddress, the emailAddress, firstName, and lastName attributes, and Member as the default role"><figcaption><p>Beispielkonfiguration. Verwenden Sie Ihre Rippling-Attributnamen und wählen Sie die AirOps-Rolle für neue Mitglieder.</p></figcaption></figure>

Klicken Sie auf **Verbindung hinzufügen**. Bestätigen Sie, dass AirOps anzeigt **Rippling-Verbindung gespeichert.**

{% hint style="info" %}
Die importierte **IdP-Entity-ID** identifiziert Rippling. Die **SP-Entity-ID** Sie in Schritt 1 kopiert haben, identifiziert den AirOps-Workspace. Jeder gehört auf seine eigene Seite der Verbindung.
{% endhint %}

### 9. Legen Sie die Zugriffsregeln für die SSO-App fest

Kehren Sie zur Rippling **SSO-Einrichtungsanweisungen** -Seite zurück und klicken Sie auf **Zu nächstem Schritt**. Unter **Zugriffsregeln für SSO-Apps**wählen Sie aus, wer die AirOps-App erhalten soll:

1. Verwenden Sie **Gruppe zuweisen** um Ihre Pilotgruppe zuzuweisen, oder **Person zuweisen** um Ihren Testmitarbeitenden zuzuweisen. Sie können beide Methoden verwenden.
2. Überprüfen **Zugewiesene Gruppen**, **Zugewiesene Personen**, und **Ausschlüsse**. Halten Sie die erste Zuweisung auf die Personen in Ihrem Pilotprojekt beschränkt.
3. 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-dddcad45377a78d57a8daa11cbd0c244500afba0%2Frippling-sso-access-rules-full.svg?alt=media" alt="Full Rippling SSO app access rules screen with numbered boxes and arrows around the group assignment, individual assignment, and Continue controls"><figcaption><p>Weisen Sie die App Ihrem Testmitarbeitenden oder Ihrer Pilotgruppe zu. Die SSO-Berechtigung ist eine separate Auswahl in Schritt 14.</p></figcaption></figure>

### 10. Überprüfen Sie das Timing für den Zugriff

In **Bereitstellungszeit**, **Zugriffszeit für neue Mitarbeitende** legt fest, wann eine Person, die den Zugriffsregeln der App entspricht, für den Zugriff berechtigt ist.

| Option                                                                         | Wann der Zugriff verfügbar wird                                                                |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| **Sobald sie ihren Arbeitsvertrag oder ihre Vereinbarung unterzeichnet haben** | Nachdem der Mitarbeitende den Arbeitsvertrag oder die Vereinbarung unterzeichnet hat.          |
| **An ihrem Startdatum, nicht vorher**                                          | Am Startdatum des Mitarbeitenden.                                                              |
| **Zu einem festen Zeitpunkt vor ihrem Startdatum**                             | Zu dem von Ihnen konfigurierten Intervall vor dem Startdatum des Mitarbeitenden.               |
| **Sobald der Administrator sie einstellt**                                     | Wenn der Administrator den Mitarbeitenden einstellt, bevor er eine Vereinbarung unterzeichnet. |

Wählen Sie das Timing, das zu den Onboarding- und Zugriffsrichtlinien Ihrer Organisation passt, und klicken Sie dann auf **Weiter**. AirOps erstellt beim ersten erfolgreichen Anmelden ein berechtigtes neues Konto, vorbehaltlich der Anmeldebeschränkungen.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-48af3406e4495e5a900210991f747f681e9e8ff6%2Frippling-sso-provision-time-full.svg?alt=media" alt="Full Rippling Provision time screen highlighting the available access timing options and Continue"><figcaption><p>Die ausgewählte Option ist ein Beispiel. Wählen Sie das Timing, das zu den Richtlinien Ihrer Organisation passt.</p></figcaption></figure>

### 11. Überprüfen Sie die SSO-Optionen für Administratoren

In **SSO für Admins**, fragt Rippling, ob die Rippling-Admins Ihres Unternehmens sich bei einem gemeinsamen AirOps-Admin-Konto anmelden dürfen sollen.

| Option                                                                                                 | Was es steuert                                                                                                                  |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Administratoren von \[your company] dürfen sich bei dem Admin-Konto von \[your app] anmelden**       | Rippling gewährt Volladministratoren Zugriff auf das als gemeinsames Admin-Konto der App festgelegte Konto.                     |
| **Administratoren von \[your company] dürfen sich nicht bei dem Admin-Konto von \[your app] anmelden** | Lässt den gemeinsamen Admin-Zugriff deaktiviert. Administratoren können SSO weiterhin mit ihren individuellen Konten verwenden. |

Für diese Einrichtung empfehlen wir, **Administratoren von \[your company] dürfen sich nicht bei dem Admin-Konto von \[your app] anmelden** zu wählen, damit sich jede Person mit ihrem eigenen AirOps-Konto anmeldet. AirOps-Administratoren können SSO weiterhin verwenden und ihre zugewiesenen Workspace-Rollen behalten.

Nachdem Sie die Einstellung überprüft haben, klicken Sie auf **Weiter**. Verwalten Sie die Workspace-Rollen einzelner Benutzer in AirOps.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-db7c7ba0da198a6319fb2f9847411972a2085ece%2Frippling-sso-admin-sso-full.svg?alt=media" alt="Full Rippling Shared Admin SSO screen highlighting the recommended Don&#x27;t let option and Continue"><figcaption><p>Der Screenshot zeigt die empfohlene Auswahl für diese Einrichtung. Unternehmens- und App-Namen entsprechen Ihrer Integration.</p></figcaption></figure>

### 12. Überprüfen Sie optionale Gruppenattribute

**Gruppenattribute** erlauben es Rippling, gruppenbezogene Werte in die SAML-Anmeldungsantwort aufzunehmen. Ein `Gruppen` Attribut könnte zum Beispiel `Engineering` für Mitarbeitende in Ihrer Engineering-Gruppe senden.

Überprüfen Sie alle Gruppenattribute, die bereits für Ihre App konfiguriert sind. Wenn die SAML-Einrichtung Ihrer Organisation zusätzliche Gruppeninformationen erfordert, verwenden Sie **Neu erstellen** um die Werte und die Personen zu definieren, für die sie gelten. Sie können auch fortfahren, ohne Gruppenattribute hinzuzufügen.

Für AirOps sind diese Attribute optional und weisen keine Workspace-Rollen zu. Neue Workspace-Mitglieder erhalten die **Standardrolle** in Schritt 8 ausgewählt wurde; bestehende aktive Mitglieder behalten ihre Rollen. App-Zuweisungen und SSO-Berechtigungen werden separat in den Schritten 9 und 14 konfiguriert. Die Attribute für Mitarbeitenden-E-Mail und -Name werden in Schritt 16 konfiguriert.

Nachdem Sie die Konfiguration überprüft haben, 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-1fe53e2abbc0baa7c71d5f6ba24496abb90fd253%2Frippling-sso-group-attributes-full.svg?alt=media" alt="Full Rippling Group attributes screen for AirOps SSO showing no configured group attributes and highlighting Continue"><figcaption><p>In diesem Beispiel sind keine Gruppenattribute konfiguriert. Konfigurieren Sie optionale Werte passend zur Einrichtung Ihrer Organisation.</p></figcaption></figure>

### 13. Verschieben Sie den ersten Verbindungstest auf später

Die **SSO-Integration überprüfen** Schritt zeigt **Ripplings Verbindung zu \[your app] testen** und eine **Über Rippling verbinden** Schaltfläche.

Die Mitarbeitendenattribute und Dashboard-Einstellungen müssen nach der Installation noch überprüft werden. Klicken Sie **Weiter** vorerst darauf und kehren Sie in Schritt 19 zu diesem Test zurück. Das Fortfahren über diesen Bildschirm hinaus bestätigt keine erfolgreiche Anmeldung.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5349c853c1ae22549b809c3df02ffdae1b7d5599%2Frippling-sso-connection-test-full.svg?alt=media" alt="Full Test Rippling&#x27;s connection screen highlighting only Continue"><figcaption><p>Klicken Sie auf Weiter, um mit der Einrichtung der App fortzufahren. Führen Sie den Verbindungstest in Schritt 19 aus.</p></figcaption></figure>

{% hint style="info" %}
Der generische Testtext von Rippling erwähnt das Erstellen und Deaktivieren von Benutzern. Diese SAML-Einrichtung erstellt bei der Anmeldung berechtigte neue AirOps-Konten. Sie konfiguriert weder SCIM noch entfernt sie automatisch die AirOps-Mitgliedschaft, wenn eine Rippling-Zuweisung entfernt wird.
{% endhint %}

### 14. Wählen Sie aus, welche zugewiesenen Benutzer sich per SSO anmelden können

In **SSO-Berechtigung**, fragt die Seite **Welche zugewiesenen Benutzer können sich per SSO anmelden?**:

1. Wählen Sie **Alle zugewiesenen Benutzer** wenn alle in Schritt 9 zugewiesenen Personen SSO verwenden sollen. Um SSO mit einer kleineren Teilmenge der zugewiesenen Benutzer der App zu testen, wählen Sie **Nur ausgewählte zugewiesene Benutzer** und schließen Sie Ihren Testmitarbeitenden in die angezeigten Regeln ein.
2. Überprüfen **Benutzer ausschließen (optional)** und prüfen Sie, dass Ihr Testmitarbeitender nicht ausgeschlossen ist. Verwenden Sie **Personen in der Vorschau anzeigen** um das Ergebnis beliebiger Regeln zu prüfen.
3. 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-884b2ba441aa1c86691228b058c0bf61ca4f9eea%2Frippling-sso-sso-eligibility-full.svg?alt=media" alt="Full Rippling SSO Eligibility screen highlighting All assigned users or Only selected assigned users, exclusion rules, and Continue"><figcaption><p>Ein Mitarbeitender muss sowohl eine App-Zuweisung als auch SSO-Berechtigung haben. Der Screenshot zeigt, dass Alle zugewiesenen Benutzer ausgewählt ist.</p></figcaption></figure>

### 15. Schließen Sie die Installation ab und öffnen Sie die Konfiguration

Schließen Sie alle verbleibenden Eingabeaufforderungen ab, die Rippling für Ihre Installation anzeigt. Wenn Sie **\[your app] installation complete**erreichen, klicken Sie auf **Zur Integration wechseln**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-072c9125d3994f115872f7d80cc343547028ed95%2Frippling-sso-installation-complete-full.svg?alt=media" alt="Full Rippling installation complete screen with a numbered arrow pointing to Go to integration"><figcaption><p>Öffnen Sie die installierte App, um ihre Mitarbeitendenattribute und erweiterten Einstellungen zu überprüfen.</p></figcaption></figure>

In Ihrer AirOps-Integration:

1. Wählen Sie **Zugriff**.
2. Wählen Sie **Einmalanmeldung (SSO)**.
3. Öffnen **Konfiguration**.

Lassen Sie diese Seite für die Mitarbeitendenattribute und erweiterten Einstellungen unten geöffnet.

### 16. Konfigurieren Sie die Mitarbeitendenattribute

In **Rippling**, öffnen Sie Ihre AirOps-Integration und gehen Sie zu **Zugriff → Einmalanmeldung (SSO) → Konfiguration → SAML-Attribute**.

Suchen Sie zuerst in der **Name** -Spalte die Attribute für geschäftliche E-Mail, Vorname und optionalen Nachnamen. Verwenden Sie vorhandene Attribute erneut und erstellen Sie nur die Zuordnungen, die fehlen.

Die Tabelle unten zeigt Beispielnamen und Mitarbeitendenfelder. Ihre Attributnamen können abweichen; jeder Name muss dem entsprechenden Feld in AirOps entsprechen.

| AirOps-Feld aus Schritt 8                 | Beispielname des Rippling-Attributs | Beispielwert für Rippling-Mitarbeitende                                                                            |
| ----------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Attribut für die geschäftliche E-Mail** | `emailAddress`                      | **E-Mail-Adresse des Benutzers**, die die geschäftliche E-Mail des Mitarbeitenden enthält.                         |
| **Attribut für den Vornamen**             | `firstName`                         | **Bevorzugter Vorname des Benutzers**.                                                                             |
| **Attribut für den Nachnamen (optional)** | `lastName`                          | **Bevorzugter Nachname des Benutzers**. Lassen Sie diese Zuordnung weg, wenn das Nachnamenfeld in AirOps leer ist. |

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-866aef3dabc10630713be92a856b5e67790c2b0b%2Frippling-sso-03-rippling-attributes.jpg?alt=media" alt="Rippling SAML attributes table showing emailAddress, firstName, and lastName mapped to employee fields"><figcaption><p>AirOps SSO verwendet in diesem Beispiel bevorzugte Vor- und Nachnamen. Die Spalte Name muss mit den in AirOps gespeicherten Attributnamen übereinstimmen.</p></figcaption></figure>

**Fehlendes Attribut erstellen**

Für jede fehlende Zeile:

1. Klicken Sie auf **Neu erstellen** in **SAML-Attribute**.
2. In **SAML-Attribut erstellen**, wählen Sie **Globales Attribut**. Damit können Sie für jede anmeldende Person ein Mitarbeitendenfeld zuordnen.
3. In **Name des globalen Attributs**, geben Sie den Namen ein, den Sie auch in AirOps verwenden werden. Geben Sie zum Beispiel ein `firstName` für eine neue Vornamen-Zuordnung.
4. Öffnen **Wert** und wählen Sie das entsprechende Mitarbeitendenfeld aus. Für `firstName`, wählen Sie **Bevorzugter Vorname des Benutzers**. Wählen Sie das Feld im Dropdown aus, damit Rippling den Wert für die anmeldende Person verwendet.
5. Klicken Sie auf **Speichern**, und prüfen Sie dann, dass die Zeile unter **SAML-Attribute**.
6. Wiederholen Sie dies für jede fehlende Zuordnung von geschäftlicher E-Mail oder Nachname und verwenden Sie dabei Ihre gewählten Attributnamen und die entsprechenden Mitarbeitendenfelder. Die Tabelle zeigt `emailAddress` und `lastName` als Beispiele. Überspringen Sie jede Zuordnung, die bereits vorhanden ist.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-7ecfc5baa42f448c6bcaf8fb0a5dc607a772ddac%2Frippling-sso-create-employee-attribute-full.svg?alt=media" alt="Rippling Create SAML attribute form with numbered callouts for Global attribute, the firstName name, the dynamic Preferred first name value, and Save"><figcaption><p>Beispiel für das Erstellen von firstName, wenn es fehlt. Verwenden Sie die obige Tabelle für emailAddress und lastName. Der Screenshot zeigt ein nicht gespeichertes Formular.</p></figcaption></figure>

**Ein vorhandenes Attribut überprüfen oder korrigieren**

1. Öffnen Sie das Menü der Attributzeile und wählen Sie **Bearbeiten**.
2. Prüfung **Wert** an der Tabelle aus und wählen Sie bei Bedarf das passende Mitarbeitendenfeld aus.
3. Klicken Sie auf **Speichern** wenn Sie den Wert geändert haben. Wiederholen Sie dies für die anderen vorhandenen Attribute.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f4a30675e85a29519c7a349ca5fb299c87fb8412%2Frippling-sso-03-rippling-attribute-editor.jpg?alt=media" alt="Rippling Edit SAML attribute dialog showing firstName and the Value dropdown set to User&#x27;s Preferred first name"><figcaption><p>Bearbeiten Sie eine vorhandene Zeile, anstatt eine doppelte zu erstellen.</p></figcaption></figure>

**Passen Sie die Namen in AirOps an**

Die Rippling **Name** Werte müssen mit dem **Attribut für die geschäftliche E-Mail**, **Attribut für den Vornamen**, und optionalen **Attribut für den Nachnamen** übereinstimmen, die Sie in Schritt 8 gespeichert haben. Wenn Sie andere Namen verwendet haben, öffnen Sie **AirOps → Einstellungen → Einmalanmeldung → Rippling → Aktionen → Zugangsdaten aktualisieren**, geben Sie diese exakten Namen ein und klicken Sie auf **Verbindung speichern**. Rippling legt die Namen seiner Standardattribute fest, verwenden Sie daher die Namen, die Ihre App tatsächlich sendet.

{% hint style="info" %}
Namen unterscheiden zwischen Groß- und Kleinschreibung. Wenn Ihr Rippling-Attribut für die geschäftliche E-Mail zum Beispiel heißt `emailAddress`, geben Sie `emailAddress` in AirOps ein und wählen Sie **E-Mail-Adresse des Benutzers** als seinen dynamischen Wert in Rippling. AirOps benötigt das E-Mail-Attribut auch dann, wenn NameID eine E-Mail enthält. Die optionale **Gruppenattribute** -Seite im Einrichtungsassistenten konfiguriert diese Identitätsfelder der Mitarbeitenden nicht.
{% endhint %}

### 17. Passen Sie das NameID-Format und die Signierungseinstellungen an

Scrollen Sie zu **Erweiterte Einstellungen** und klicken Sie auf **Bearbeiten**.

Das Beispiel in diesem Leitfaden verwendet **emailAddress** für **Standardmäßiges zu verwendendes NameID-Format**:

```
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
```

Wählen Sie das Format, das zu Ihrer AirOps-Verbindung passt. Lassen Sie **Standard-Relay-Zustand** leer.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f82be7ba5d74c0859f7e37906f25681c96d63f75%2Frippling-sso-04-nameid.jpg?alt=media" alt="Rippling advanced settings showing emailAddress as the default NameID format and a blank default relay state"><figcaption><p>Verwenden Sie in Rippling und AirOps dasselbe NameID-Format.</p></figcaption></figure>

Überprüfen Sie die restlichen Einstellungen:

| Einstellung                           | Wert                      |
| ------------------------------------- | ------------------------- |
| **Signaturalgorithmus**               | **RSA-SHA256** empfohlen. |
| **Digest-Algorithmus für Assertions** | **SHA-256** empfohlen.    |
| **Assertions verschlüsseln**          | **Nein**.                 |

AirOps benötigt eine signierte SAML-Assertion. Das Signieren nur der Antwort erfüllt diese Anforderung nicht.

Wenn Sie eine bestehende Verbindung aktualisieren, behalten Sie ihren stabilen NameID-Wert und ihr Format bei und stimmen Sie diese in AirOps ab. Bleiben Sie in **Erweiterte Einstellungen** für den nächsten Schritt.

### 18. Aktivieren Sie den Schnellzugriff auf das Dashboard

Im selben **Erweiterte Einstellungen** Formular Folgendes fest:

| Einstellung                                                                                                                        | Wert                                        |
| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| **Deaktivieren Sie das Feld 'InResponseTo' in Assertions für IdP-initiiertes SSO**                                                 | **Ja**                                      |
| **Die Anwendung unterstützt nur Anmeldungen, die von der Anwendung aus gestartet werden, auch als SP-initiierten Flow bezeichnet** | **Nein**                                    |
| **Deaktivieren Sie die automatische Standardisierung von Attributen**                                                              | **Ja**, um die Attributnamen beizubehalten. |

Klicken Sie auf **Speichern**, öffnen Sie dann erneut **Erweiterte Einstellungen** und prüfen Sie die gespeicherten Werte.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-3f9e670465251d3f32189a17710105f6ad73e8d6%2Frippling-sso-04-rippling-quick-access.jpg?alt=media" alt="Saved Rippling advanced settings with Disable InResponseTo set to Yes and SP-initiated-only set to No"><figcaption><p>Bestätigen Sie nach dem Speichern die beiden Schnellzugriffswerte: Ja für Disable InResponseTo und Nein für SP-initiated-only.</p></figcaption></figure>

Die `InResponseTo` Die Option gilt für Starts vom Dashboard. Antworten auf eine von AirOps gestartete Anmeldung müssen weiterhin mit der ursprünglichen Anfrage übereinstimmen. Rippling beschreibt die verfügbaren Optionen in seinem [SAML-SSO-Referenz](https://developer.rippling.com/documentation/developer-portal/v2-guides/saml).

### 19. Testen Sie die abgeschlossene Verbindung

Beide Seiten sind jetzt gespeichert. Lassen Sie Ihre AirOps-Adminsitzung geöffnet und testen Sie die Anmeldung in einem separaten Browserprofil oder in einem privaten Fenster.

Wenn Sie ein bestehendes AirOps-Konto zum ersten Mal verbinden, befolgen Sie [Ein bestehendes AirOps-Konto verbinden](#connect-an-existing-airops-account) bevor Sie eine Anmeldung im abgemeldeten Zustand testen.

**Von AirOps aus anmelden**

1. Öffne das [AirOps-Anmeldeseite](https://app.airops.com/users/sign_in).
2. Klicken Sie auf **Mit Rippling anmelden** um das **Workspace-Slug** Feld anzuzeigen.
3. Geben Sie Ihren AirOps-Workspace-Slug ein und klicken Sie auf **Weiter**.
4. AirOps leitet Sie zu Rippling weiter. Melden Sie sich mit Ihrem Rippling-Konto an und beantworten Sie alle Authentifizierungsaufforderungen. Wenn Sie bereits eine aktive Rippling-Sitzung haben, kann Rippling fortfahren, ohne Sie erneut zur Anmeldung aufzufordern.
5. Rippling leitet Sie zurück zu AirOps. Bestätigen Sie, dass sich Ihr Workspace öffnet und dass Sie mit der erwarteten Rolle darauf zugreifen können.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f3d9f24bd63e5db30df157e5f34454b28b7bfb33%2Frippling-sso-07-airops-sign-in.png?alt=media" alt="AirOps sign-in flow: choose Sign in with Rippling, enter the workspace slug and click Proceed, authenticate with Rippling, and return to the AirOps workspace"><figcaption><p>Wählen Sie „Mit Rippling anmelden“, geben Sie Ihren Workspace-Slug ein und klicken Sie auf „Weiter“.</p></figcaption></figure>

**Über das Rippling-Dashboard anmelden**

1. Öffnen Sie Rippling und klicken Sie auf die AirOps-Schnellzugriffskachel.
2. Klicken Sie auf der AirOps-Fortsetzungsseite auf **Zum Workspace fortfahren**.
3. Schließen Sie alle Rippling-Anmeldeaufforderungen ab und bestätigen Sie dann, dass Sie den vorgesehenen AirOps-Workspace erreichen.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b7a06114c36d8a1488a5ea9348572d553091e8ca%2Frippling-sso-06-sign-in.png?alt=media" alt="Rippling quick-access flow: AirOps tile, Continue to workspace, Rippling verification, and AirOps workspace"><figcaption><p>Die AirOps-Fortsetzungsseite ist ein erwarteter Bestandteil der Anmeldung über das Dashboard.</p></figcaption></figure>

**Führen Sie den Verbindungstest von Rippling erneut durch**

Sie können auch zum Installationsassistenten zurückkehren **Über Rippling verbinden** Test:

1. Unter **Konfiguration → Allgemein**erreichen, klicken Sie auf **Neu konfigurieren**.
2. Öffnen Sie den Schrittauswähler oben links und wählen Sie **SSO-Integration überprüfen**.
3. Prüfen Sie die Mitarbeiter-E-Mail, die auf **Ripplings Verbindung testen**, klicken Sie dann auf **Über Rippling verbinden**.
4. Schließen Sie die Anmeldung ab. Wenn AirOps **Zum Workspace fortfahren**, klicken Sie darauf und bestätigen Sie, dass Sie den vorgesehenen Workspace erreichen.

Wenn ein Test fehlschlägt, prüfen Sie die Konfiguration, bevor Sie das Setup als abgeschlossen betrachten. Das bloße Abschließen des Rippling-Assistenten verifiziert die AirOps-Verbindung nicht.

Prüfen Sie, dass ein neues Mitglied die konfigurierte Standardrolle erhält und ein bestehendes aktives Mitglied seine Rolle behält.

## AirOps-Konfigurationsreferenz

| Feld                                      | Was einzugeben ist                                                                                                                                                |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ACS-URL / SP-Entitäts-ID**              | Von AirOps generiert. Kopieren Sie beide in die Rippling-SAML-Anwendung.                                                                                          |
| **IdP-Metadaten-XML**                     | Aus der zugehörigen Rippling-Anwendung exportieren. Laden Sie eine Datei bis zu 250 KB hoch oder fügen Sie sie ein und klicken Sie dann auf **Metadaten prüfen**. |
| **NameID-Format**                         | Passen Sie das Format von Rippling an und verwenden Sie eine stabile Mitarbeiterkennung. Behalten Sie Kennung und Format nach der Einführung konsistent bei.      |
| **Attribut für die geschäftliche E-Mail** | Exakter, Groß-/Kleinschreibung berücksichtigender SAML-Attributname, der die Arbeits-E-Mail des Mitarbeiters enthält. Erforderlich.                               |
| **Attribut für den Vornamen**             | Exakter SAML-Attributname, der den Vornamen des Mitarbeiters enthält. Erforderlich.                                                                               |
| **Attribut für den Nachnamen (optional)** | Exakter SAML-Attributname, der den Nachnamen des Mitarbeiters enthält. Leer lassen, wenn nicht verwendet.                                                         |
| **Standardrolle**                         | Rolle für neue Workspace-Mitglieder. Bestehende aktive Mitglieder behalten ihre aktuelle Rolle.                                                                   |

Um eine Verbindung zu aktualisieren, öffnen Sie **Einstellungen → Single Sign On → Rippling → Aktionen → Anmeldedaten aktualisieren**, nehmen Sie Ihre Änderungen vor und klicken Sie auf **Verbindung speichern**. Importieren Sie neue Metadaten, wenn Rippling seine Signaturzertifikate rotiert, bevor die vorhandenen Zertifikate ablaufen.

## Anmeldebeispiele

### Anmeldeanweisungen teilen

Teilen Sie die [AirOps-Anmeldeseite](https://app.airops.com/users/sign_in) und Ihren Workspace-Slug mit den Mitarbeitern. Sie können **Mit Rippling anmelden**, den Slug eingeben und auf **Weiter**.

Mitarbeiter können auch die AirOps-SAML-Kachel auf ihrem Rippling-Dashboard verwenden.

### Ein bestehendes AirOps-Konto verbinden

Für die erste Rippling-Anmeldung bei einem bestehenden AirOps-Konto:

1. Melden Sie sich bei AirOps mit der aktuellen Anmeldemethode des Kontos an.
2. Im **dasselbe Browserprofil**, öffnen Sie die AirOps-SAML-Kachel auf Ihrem Rippling-Dashboard und klicken Sie auf **Zum Workspace fortfahren**.
3. Schließen Sie die Rippling-Anmeldung mit der passenden Arbeits-E-Mail ab.

Nachdem das Konto verknüpft wurde, testen Sie eine Anmeldung im abgemeldeten Zustand. Wenn AirOps Sie auffordert, Ihren ursprünglichen Anmeldeanbieter zu verwenden, wenden Sie sich an Ihr AirOps-Kontoteam, um die Umstellung zu organisieren.

### Mitgliedschaftsverhalten verstehen

AirOps erstellt bei der ersten erfolgreichen Anmeldung des Mitarbeiters ein neues Konto und eine Workspace-Mitgliedschaft, vorbehaltlich der Anmeldebeschränkungen Ihres Workspaces. Diese SSO-Verbindung synchronisiert die Mitgliedschaft oder Rollen der Mitarbeiter nicht über SCIM. Verwalten Sie bestehende AirOps-Mitgliedschaften separat, wenn Sie den Zugriff entfernen.

## Fehlerbehebung

| Was Sie sehen                                                              | Was zu prüfen ist                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rippling** fehlt in den AirOps-Einstellungen oder bei der Anmeldung      | Bitten Sie Ihr AirOps-Kontoteam, Rippling für den Workspace zu aktivieren.                                                                                                                                                                                                                                                                                                                                                             |
| **Rippling-Anmeldung konnte nicht verifiziert werden**                     | Bestätigen Sie, dass die ACS-URL und die SP-Entitäts-ID mit demselben AirOps-Workspace und derselben Umgebung übereinstimmen. Prüfen Sie die Metadaten, die Gültigkeit des Zertifikats, das NameID-Format und die Einstellung für signierte Assertions erneut. Prüfen Sie für Starts über das Dashboard außerdem beide Schnellzugriff-Schalter in Schritt 18 und lassen Sie Default Relay State leer. Starten Sie einen neuen Versuch. |
| Ein E-Mail- oder Vorname-Attribut fehlt                                    | Passen Sie die exakten Attributnamen an, einschließlich der Groß-/Kleinschreibung. Wählen Sie Mitarbeiterfelder als Werte in Rippling aus und bestätigen Sie, dass der zugewiesene Mitarbeiter diese Werte ausgefüllt hat.                                                                                                                                                                                                             |
| Die Schnellzugriffskachel öffnet die allgemeine AirOps-Anmeldeseite        | Bestätigen Sie, dass die Kachel die SAML-Anwendung startet und nicht ein Lesezeichen zur Anmeldeseite. Öffnen Sie die Schnellzugriffseinstellungen in Schritt 18 erneut und überprüfen Sie sie.                                                                                                                                                                                                                                        |
| AirOps fordert Sie auf, sich zuerst bei einem bestehenden Konto anzumelden | Befolgen Sie **Ein bestehendes AirOps-Konto verbinden** oben im selben Browserprofil.                                                                                                                                                                                                                                                                                                                                                  |
| **Verbindung hinzufügen** ist nicht verfügbar                              | Importieren Sie die Metadaten und klicken Sie auf **Metadaten prüfen**. Überprüfen Sie sie erneut, wenn Sie das XML ändern.                                                                                                                                                                                                                                                                                                            |
| Die Rolle eines bestehenden Mitglieds hat sich nicht geändert              | Die Standardrolle gilt für neue Mitglieder. Aktualisieren Sie die Rolle des bestehenden Mitglieds in AirOps.                                                                                                                                                                                                                                                                                                                           |

Wenn die Anmeldung weiterhin fehlschlägt, teilen Sie dem AirOps-Support den Workspace-Slug, den Einstiegspunkt, die Uhrzeit des Versuchs und die angezeigte Fehlermeldung mit. Fügen Sie keine SAML-Antwort oder Sitzungstoken hinzu.


---

# 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/rippling-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.
