Zum Hauptinhalt springen

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
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:

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.
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