Workday-Instanz für die Datenreplikation konfigurieren

Wenn Sie Daten aus einer Workday-Instanz in ein unterstütztes Ziel wie BigQuery oder Cloud Storage replizieren möchten, können Sie Workday als Datastream-Quelle verbinden. Sie authentifizieren die Verbindung, indem Sie einen Integrationssystemnutzer (ISU) erstellen, Sicherheitsgruppenberechtigungen gewähren und einen API-Client für OAuth 2.0 registrieren.

Hinweis

Bevor Sie Workday für die Verwendung mit Datastream konfigurieren, müssen Sie Folgendes tun:

  • Sie müssen Zugriff auf eine aktive Workday-Instanz haben.
  • Kenntnisse zur Navigation und zum Ändern von Einstellungen in Workday
  • Sie müssen wissen, wie Sie Integrationssystemnutzer und Sicherheitsgruppen in Workday erstellen.

Workday-Instanz für die Verwendung mit Datastream konfigurieren

Um eine Verbindung zwischen Ihrer Workday-Instanz und Datastream herzustellen, müssen Sie beim Erstellen eines Workday-Verbindungsprofils den Hostnamen und den Mandantennamen Ihrer Instanz sowie OAuth 2.0-Clientanmeldedaten wie eine Client-ID, einen Clientschlüssel und ein Aktualisierungstoken angeben.

Hostnamen und Mandantennamen ermitteln

Sie können den Hostnamen und den Mandantennamen Ihrer Workday-Instanz auf eine der folgenden Arten ermitteln:

  • Über Ihre Anmelde-URL. Der Hostname und der Mandantenname sind Teil der Instanz-URL, mit der Sie sich in Workday anmelden. Wenn Ihre Anmelde-URL beispielsweise https://wd5-impl.workday.com/google/d/home.html lautet, ist der Teil wd5-impl.workday.com der Hostname und der Kurzname oder Alias Ihrer Instanz, der direkt nach dem Hostnamen in der URL angezeigt wird, ist der Mandantenname (in diesem Fall google).

  • Verwenden Sie die Details Ihres registrierten API-Clients. Wenn Sie bereits einen API-Client registriert haben, können Sie diese Informationen direkt über die REST-Endpunkt-URL abrufen:

    1. Suchen Sie in Workday nach der Aufgabe View API Client (API-Client ansehen) und wählen Sie sie aus.
    2. Suchen Sie unter Client Details (Clientdetails) nach dem Feld Workday REST API Endpoint (Workday REST API-Endpunkt), z. B. https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant.

    3. So finden Sie Ihre Anmeldedaten:

      • Der Hostname ist der Domainteil der URL, z. B. wd2-impl-services1.workday.com.
      • Der Mandantenname ist das letzte Pfadsegment der URL nach /v1/ (z. B. mytenant).

Weitere Informationen zum Ermitteln Ihrer API-Endpunkte finden Sie in der Dokumentation zu Workday-APIs.

Nutzer und Sicherheitsgruppe konfigurieren

Wenn Sie Daten aus Workday streamen möchten, müssen Sie einen dedizierten Integration System User (ISU) konfigurieren, ihn einer uneingeschränkten Sicherheitsgruppe zuweisen und der Gruppe die erforderlichen Domainberechtigungen erteilen.

Integration System User (ISU) erstellen

  1. Suchen Sie in der Workday-Suchleiste nach der Aufgabe Create Integration System User (Integrationssystemnutzer erstellen) und wählen Sie sie aus.

  2. Konfigurieren Sie das ISU-Konto:

    1. Geben Sie einen Nutzernamen ein, z. B. datastream_isu.
    2. Erstellen Sie ein sicheres Passwort.
    3. Geben Sie im Feld Zeitlimit für Sitzungen in Minuten den Wert 0 (kein Zeitlimit) ein.
    4. Entfernen Sie das Häkchen aus dem Kästchen UI-Sitzungen nicht zulassen.

  3. Klicken Sie auf OK und dann auf Fertig.

Sicherheitsgruppe für das Integrationssystem erstellen

  1. Suchen Sie nach der Aufgabe Sicherheitsgruppe erstellen und wählen Sie sie aus.

  2. Konfigurieren Sie die Optionen für die Sicherheitsgruppe:

    1. Wählen Sie im Drop-down-Menü Type of Tenanted Security Group die Option Integration System Security Group (Unconstrained) aus.
    2. Geben Sie im Feld Name einen Namen für die Sicherheitsgruppe ein, z. B. datastream_sg.

  3. Klicken Sie auf OK.

  4. Suchen Sie auf der folgenden Seite im Feld Integration System Users nach dem ISU, den Sie im vorherigen Schritt erstellt haben, und wählen Sie ihn aus.

  5. Klicken Sie auf OK.

Berechtigungen für Domainsicherheitsrichtlinien gewähren

Damit alle Standarddatendomains abgedeckt sind, müssen Sie der Sicherheitsgruppe die Berechtigungen Nur abrufen für die erforderlichen Workday-Domains gewähren:

  1. Klicken Sie auf der Detailseite der Sicherheitsgruppe auf das Dreipunkt-Menü (...) für Zugehörige Aktionen neben dem Namen der Sicherheitsgruppe.
  2. Gehen Sie zu Sicherheitsgruppe > Domainberechtigungen für Sicherheitsgruppe verwalten.

  3. Fügen Sie in der Tabelle Berechtigungen für die Domainsicherheitsrichtlinie die folgenden Domains hinzu:

    • Worker Data: Public Worker Reports
    • Workday Usage Metrics
    • Manage: Organization Integration
    • Worker Data: All Positions
    • Job Requisition Data
    • Manage: Evergreen Requisitions
    • Special OX Web Services
    • Prospects
    • Candidate Data: Job Application
    • Worker Data: Skills and Experience
    • Payroll Interface
    • Job Information
    • Staffing Organizations: Header
    • Staffing Organizations: Company
    • Staffing Organizations: Region
    • Staffing Organizations: Business Unit
    • Staffing Organizations: Custom Organization

  4. Klicken Sie für jede hinzugefügte Domain das Kästchen in der Spalte Nur abrufen an.

  5. Klicken Sie auf OK und dann auf Fertig.

ISU vom Ablauf des Passworts ausnehmen

Damit der Stream nicht aufgrund abgelaufener Passwörter unterbrochen wird, sollten Sie das ISU von den Standardregeln für den Passwortablauf Ihres Mandanten ausnehmen:

  1. Suchen Sie nach der Aufgabe Maintain Password Rules (Passwortregeln verwalten) und wählen Sie sie aus.
  2. Fügen Sie im Feld Systemnutzer, die vom Ablauf des Passworts ausgenommen sind das von Ihnen erstellte ISU hinzu.
  3. Klicken Sie auf OK und dann auf Fertig.

Änderungen an Sicherheitsrichtlinien aktivieren

Achten Sie darauf, die Änderungen der Domainberechtigungen explizit zu aktivieren, da sie sonst nicht wirksam werden:

  1. Suchen Sie nach der Aufgabe Ausstehende Änderungen an Sicherheitsrichtlinien aktivieren und wählen Sie sie aus.
  2. Geben Sie im Feld Kommentar eine Beschreibung für die Änderungen ein, z. B. Grant permissions for Datastream Workday integration.
  3. Klicken Sie auf OK.
  4. Klicken Sie auf der Bestätigungsseite das Kästchen Bestätigen an.
  5. Klicken Sie auf OK, um die Änderungen zu aktivieren.

API-Client erstellen und einrichten

Führen Sie die folgenden Aufgaben in Workday aus, um die für Ihr Datastream-Verbindungsprofil erforderlichen Anmeldedaten zu generieren.

API-Client registrieren

  1. Suchen Sie in der Workday-Suchleiste nach der Aufgabe Register API Client for Integrations und wählen Sie sie aus.

  2. Konfigurieren Sie den API-Client:

    1. Geben Sie einen Namen für die Datastream-Integration ein.
    2. Wählen Sie unter Client Grant Type (Client-Genehmigungstyp) die Option Authorization Code Grant (Authorization Code Grant) aus.
    3. Wählen Sie unter Zugriffstokentyp die Option Bearer aus.
    4. Klicken Sie auf das Kästchen Benutzerdefinierten Ablauf von Zugriffstokens erzwingen und geben Sie dann eine Ablaufzeit Ihrer Wahl an.

    5. Optional können Sie das Kästchen Nicht ablaufende Aktualisierungstokens aktivieren, um Verbindungsunterbrechungen zu vermeiden.

    6. Unter Bereiche empfehlen wir, die folgenden Funktionsbereiche einzubeziehen, um eine vollständige Abdeckung der Standarddatenbereiche zu gewährleisten:

      • Implementation
      • Jobs & Positions
      • Organizations and Roles
      • Payroll Interface
      • Pre-Hire Process
      • Recruiting
      • Staffing
      • System
      • Talent Pipeline

      Die erforderlichen Bereiche hängen von den Endpunkten ab, von denen Sie Daten streamen möchten.

    7. Klicken Sie auf das Kästchen Workday-eigenen Bereich einschließen.

  3. Klicken Sie auf OK.

  4. Kopieren und speichern Sie die generierte Client-ID und den Clientschlüssel. Sie benötigen diese Anmeldedaten, um das Datastream-Verbindungsprofil zu erstellen.

Aktualisierungstokens für Integrationen verwalten

  1. Klicken Sie nach der Registrierung des Clients auf das Dreipunkt-Menü (...) neben dem Clientnamen und wählen Sie Aktualisierungstokens für Integrationen verwalten aus.
  2. Wählen Sie den zuvor erstellten Integration System User (ISU) aus.

  3. Klicken Sie auf Generate New Refresh Token (Neues Aktualisierungstoken generieren).

API-Client-Sicherheitsgruppen bearbeiten

  1. Suchen Sie nach der Aufgabe API-Client bearbeiten, um sicherzustellen, dass der API-Client von Ihrer ISU verwendet werden kann.
  2. Wählen Sie Ihren registrierten Client aus und rufen Sie die Sicherheitseinstellungen auf.
  3. Fügen Sie die mit Ihrem ISU verknüpfte Integration System Security Group der Liste der zulässigen Sicherheitsgruppen für diesen Client hinzu.

API-Client ansehen

  1. Wenn Sie Ihre Client-ID und Ihren Clientschlüssel abrufen möchten, suchen Sie nach der Aufgabe View API Client oder rufen Sie die Detailseite des API-Clients auf.
  2. Suchen Sie unter Clientdetails die Client-ID und kopieren Sie sie.
  3. Klicken Sie auf Manage Consumer Details (Nutzerdetails verwalten), um den Clientschlüssel aufzurufen und zu kopieren.

Nächste Schritte