> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# PingOne

> PingOne-Benutzer synchronisieren, Audit-Aktivitäten erfassen und Behebungsmaßnahmen für Konten ausführen

## Voraussetzungen

Stellen Sie vor dem Verbinden von PingOne sicher, dass Sie über Folgendes verfügen:

1. Zugriff auf die PingOne-Admin-Konsole für die Umgebung, die Sie überwachen möchten
2. Eine PingOne-Worker-Anwendung, die den Grant `client_credentials` verwenden kann
3. Die PingOne-Umgebungs-ID der Umgebung, die Wirespeed verwalten soll
4. Der Worker-Anwendung zugewiesene Rollen, die das Verwalten von Verzeichnisbenutzern und das Lesen von Audit-Aktivitäten erlauben

## Schritt 1: Worker-Anwendung erstellen

1. Melden Sie sich bei der PingOne-Admin-Konsole an
2. Öffnen Sie die Umgebung, die Wirespeed überwachen soll
3. Navigieren Sie zu **Applications**
4. Erstellen Sie eine neue **Worker**-Anwendung
5. Aktivieren Sie den Grant-Typ `client_credentials`
6. Stellen Sie sicher, dass **Token Endpoint Auth Method** auf **Client Secret Basic** gesetzt ist (Standardeinstellung)
7. Speichern Sie die Anwendung

## Schritt 2: Erforderlichen Zugriff zuweisen

1. Öffnen Sie die erstellte Worker-Anwendung
2. Weisen Sie die Rollen zu, die für Folgendes erforderlich sind:
   * Verzeichnisbenutzer mit der Rolle **Identity Data Admin** auf Umgebungsebene verwalten
   * Audit-Aktivitäten der Umgebung lesen
3. Speichern Sie die Rollenzuweisungen

> [!TIP]
>
> Sie können stattdessen **Identity Data Read Only** zuweisen, wenn Wirespeed nur
> Verzeichnisbenutzer synchronisieren soll. Wählen Sie beim Hinzufügen der Integration
> unter den erweiterten Optionen **Schreibgeschützt**.

## Schritt 3: Verbindungsdetails ermitteln

Kopieren Sie die folgenden Werte aus der PingOne-Admin-Konsole:

* **Environment ID**
* **Client ID**
* **Client Secret**
* **Region** der Umgebung

Verwenden Sie in Wirespeed einen dieser Regionscodes:

| Region | Code | API-Domain | Auth-Domain |
| - | - | - | - |
| Nordamerika | `NA` | `api.pingone.com` | `auth.pingone.com` |
| Kanada | `CA` | `api.pingone.ca` | `auth.pingone.ca` |
| Europäische Union | `EU` | `api.pingone.eu` | `auth.pingone.eu` |
| Australien | `AU` | `api.pingone.com.au` | `auth.pingone.com.au` |
| Singapur | `SG` | `api.pingone.sg` | `auth.pingone.sg` |
| Asien-Pazifik | `AP` | `api.pingone.asia` | `auth.pingone.asia` |

## Schritt 4: Integration in Wirespeed hinzufügen

1. Melden Sie sich bei **Wirespeed** an
2. Navigieren Sie zu **Integrationen** > **Integration hinzufügen**
3. Wählen Sie **PingOne**
4. Geben Sie Folgendes ein:
   * **PingOne-Region**: `NA`, `CA`, `EU`, `AU`, `SG` oder `AP`
   * **Umgebungs-ID**
   * **Client-ID**
   * **Geheimer Clientschlüssel**
5. Klicken Sie auf **Integrieren**

Wirespeed tauscht die Zugangsdaten Ihrer Worker-Anwendung gegen ein Zugriffstoken und
beginnt, PingOne nach neuen Daten abzufragen.

> [!TIP]
>
> Während der Einrichtung prüft Wirespeed, ob die Worker-Anwendung Verzeichnisbenutzer
> und Audit-Aktivitäten der ausgewählten Umgebung lesen kann. Schlägt eine der
> erforderlichen Prüfungen fehl, wird die Integration nicht aktiviert.

## Was Wirespeed erfasst

Wirespeed erfasst derzeit Folgendes aus PingOne:

* Verzeichnisbenutzer
* Audit-Aktivitäten aus den Audit-Reporting-APIs von PingOne

## Behebungsmaßnahmen

Mit **Identity Data Admin**-Zugriff kann Wirespeed:

* Benutzer deaktivieren, um die Authentifizierung zu verhindern
* Benutzer wieder aktivieren, um die Authentifizierung wiederherzustellen
* Benutzer mit von PingOne verwalteten Passwörtern zwingen, ihr Passwort bei der nächsten Anmeldung zu ändern
* Die von PingOne vorgehaltenen Sitzungen eines Benutzers beenden

Das Deaktivieren eines Benutzers beendet bestehende Sitzungen nicht. Das Widerrufen von Sitzungen beendet
die von PingOne zurückgegebenen Sitzungen, garantiert jedoch nicht den Widerruf jedes OAuth-Tokens.

## Fehlerbehebung

* Wenn die Authentifizierung bei der Einrichtung fehlschlägt, prüfen Sie, ob die Worker-Anwendung für `client_credentials` konfiguriert ist und **Token Endpoint Auth Method** auf **Client Secret Basic** (nicht Client Secret Post) gesetzt ist
* Wenn die Einrichtung bei der Prüfung des Zugriffs auf Audit-Aktivitäten fehlschlägt, prüfen Sie, ob die ausgewählte Region und die Umgebungs-ID korrekt sind und die Worker-Anwendung Audit-Daten in der Zielumgebung lesen kann
* Wenn die Einrichtung bei der Prüfung des Zugriffs auf Verzeichnisbenutzer fehlschlägt, weisen Sie der Worker-Anwendung **Identity Data Admin** oder **Identity Data Read Only** auf Umgebungsebene zu
* Wenn eine Behebungsmaßnahme mit einem Berechtigungsfehler fehlschlägt, prüfen Sie, ob die Worker-Anwendung **Identity Data Admin**-Zugriff für die Umgebung oder Population des Benutzers hat
* Wenn Sie nicht sicher sind, welche Region Sie verwenden sollen, prüfen Sie die regionale Domain der PingOne-Umgebung in der Admin-Konsole und gleichen Sie sie mit der obigen Tabelle ab


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.