Configurer une instance Workday pour la réplication des données

Pour répliquer des données d'une instance Workday vers une destination compatible telle que BigQuery ou Cloud Storage, vous pouvez connecter Workday en tant que source Datastream. Vous authentifiez la connexion en créant un utilisateur du système d'intégration (ISU), en accordant des autorisations de groupe de sécurité et en enregistrant un client API pour OAuth 2.0.

Avant de commencer

Avant de commencer à configurer Workday pour l'utiliser avec Datastream, vous devez :

  • Avoir accès à une instance Workday active.
  • Savoir naviguer dans Workday et modifier ses paramètres.
  • Savoir comment créer des utilisateurs de système d'intégration et des groupes de sécurité dans Workday

Configurer une instance Workday à utiliser avec Datastream

Pour établir une connexion entre votre instance Workday et Datastream, vous devez fournir le nom d'hôte et le nom de locataire de votre instance, ainsi que des identifiants client OAuth 2.0, tels qu'un ID client, un code secret du client et un jeton d'actualisation, lorsque vous créez un profil de connexion Workday.

Identifier le nom d'hôte et le nom du locataire

Vous pouvez trouver le nom d'hôte et le nom du locataire de votre instance Workday de l'une des manières suivantes :

  • Utiliser votre URL de connexion Le nom d'hôte et le nom du locataire font partie de l'adresse URL de l'instance que vous utilisez pour vous connecter à Workday. Par exemple, si votre URL de connexion est https://wd5-impl.workday.com/google/d/home.html, la partie wd5-impl.workday.com est le nom d'hôte, et le nom court ou l'alias de votre instance qui apparaît immédiatement après le nom d'hôte dans l'URL est le nom du locataire (dans ce cas, google).
  • Utilisez les informations de votre client API enregistré. Si vous avez déjà enregistré un client API, vous pouvez récupérer ces informations directement à partir de l'adresse URL du point de terminaison REST :

    1. Dans Workday, recherchez et sélectionnez la tâche View API Client (Afficher le client API).
    2. Sous Client Details (Informations sur le client), recherchez le champ Workday REST API Endpoint (Point de terminaison de l'API REST Workday), par exemple : https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant.
    3. Recherchez vos identifiants :

      • Le nom d'hôte est la partie domaine de l'URL, par exemple wd2-impl-services1.workday.com.
      • Le nom du locataire est le dernier segment de chemin d'accès de l'URL après /v1/ (par exemple, mytenant).

Pour en savoir plus sur la recherche de vos points de terminaison d'API, consultez la documentation sur les API Workday.

Configurer un utilisateur et un groupe de sécurité

Pour diffuser des données depuis Workday, vous devez configurer un utilisateur du système d'intégration (ISU) dédié, l'attribuer à un groupe de sécurité sans contrainte et accorder au groupe les autorisations de domaine nécessaires.

Créer l'utilisateur du système d'intégration (ISU)

  1. Dans la barre de recherche Workday, recherchez et sélectionnez la tâche Create Integration System User (Créer un utilisateur du système d'intégration).
  2. Configurez le compte ISU :

    1. Saisissez un nom d'utilisateur, par exemple datastream_isu.
    2. Créez un mot de passe sécurisé.
    3. Saisissez 0 (pas de délai avant expiration) dans le champ Session Timeout Minutes (Délai avant expiration de la session en minutes).
    4. Décochez la case Ne pas autoriser les sessions d'interface utilisateur.
  3. Cliquez sur OK, puis sur OK.

Créer un groupe de sécurité du système d'intégration

  1. Recherchez et sélectionnez la tâche Create Security Group (Créer un groupe de sécurité).
  2. Configurez les options du groupe de sécurité :

    1. Dans le menu déroulant Type of Tenanted Security Group (Type de groupe de sécurité locataire), sélectionnez Integration System Security Group (Unconstrained) (Groupe de sécurité du système d'intégration (sans contrainte)).
    2. Dans le champ Nom, saisissez un nom pour le groupe de sécurité, par exemple datastream_sg.
  3. Cliquez sur OK.

  4. Sur la page qui s'affiche, dans le champ Utilisateurs du système d'intégration, recherchez et sélectionnez l'ISU que vous avez créé à l'étape précédente.

  5. Cliquez sur OK.

Accorder des autorisations pour les règles de sécurité du domaine

Pour garantir une couverture complète des domaines de données standards, vous devez accorder au groupe de sécurité des autorisations Get Only pour les domaines Workday requis :

  1. Sur la page d'informations du groupe de sécurité, cliquez sur l'icône de points de suspension Actions associées (...) à côté du nom du groupe de sécurité.
  2. Accédez à Security Group > Maintain Domain Permissions for Security Group (Groupe de sécurité > Gérer les autorisations de domaine pour le groupe de sécurité).
  3. Dans le tableau Autorisations de la stratégie de sécurité du domaine, ajoutez les domaines suivants :

    • 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. Pour chaque domaine ajouté, cochez la case dans la colonne d'accès Get Only (Obtenir uniquement).

  5. Cliquez sur OK, puis sur OK.

Exclure l'ISU de l'expiration du mot de passe

Pour éviter les interruptions de flux dues à l'expiration des mots de passe, excluez l'ISU des règles d'expiration des mots de passe standards de votre locataire :

  1. Recherchez et sélectionnez la tâche Maintain Password Rules (Gérer les règles de mot de passe).
  2. Dans le champ Utilisateurs système exemptés de l'expiration du mot de passe, ajoutez l'ISU que vous avez créé.
  3. Cliquez sur OK, puis sur OK.

Activer les modifications de la stratégie de sécurité

Veillez à activer explicitement les modifications des autorisations de domaine, sinon elles ne prendront pas effet :

  1. Recherchez et sélectionnez la tâche Activate Pending Security Policy Changes (Activer les modifications en attente de la stratégie de sécurité).
  2. Dans le champ Commentaire, saisissez une description des modifications, par exemple Grant permissions for Datastream Workday integration.
  3. Cliquez sur OK.
  4. Sur la page de confirmation, cochez la case Confirmer.
  5. Cliquez sur OK pour activer les modifications.

Créer et configurer un client API

Utilisez les tâches suivantes dans Workday pour générer les identifiants nécessaires à votre profil de connexion Datastream.

Enregistrer le client API

  1. Dans la barre de recherche Workday, recherchez et sélectionnez la tâche Register API Client for Integrations (Enregistrer le client API pour les intégrations).
  2. Configurez le client API :

    1. Saisissez un nom pour votre intégration Datastream.
    2. Sous Type d'attribution client, sélectionnez Attribution de code d'autorisation.
    3. Sous Type de jeton d'accès, sélectionnez Porteur.
    4. Cochez la case Appliquer l'expiration personnalisée du jeton d'accès, puis spécifiez le délai d'expiration de votre choix.
    5. Vous pouvez également cocher la case Jetons d'actualisation sans expiration pour éviter les interruptions de connexion.

    6. Sous Champs d'application, nous vous recommandons d'inclure les domaines fonctionnels suivants pour assurer une couverture complète des domaines de données standards :

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

      Les champs d'application requis dépendent des points de terminaison à partir desquels vous souhaitez diffuser des données.

    7. Cochez la case Inclure le champ d'application appartenant à Workday.

  3. Cliquez sur OK.

  4. Copiez et enregistrez l'ID client et le code secret du client générés. Vous en aurez besoin pour créer le profil de connexion Datastream.

Gérer les jetons d'actualisation pour les intégrations

  1. Après avoir enregistré le client, cliquez sur l'icône représentant des points de suspension (...) à côté du nom du client, puis sélectionnez Gérer les jetons d'actualisation pour les intégrations.
  2. Sélectionnez l'utilisateur du système d'intégration (ISU) que vous avez créé précédemment.
  3. Cliquez sur Generate New Refresh Token (Générer un nouveau jeton d'actualisation).

Modifier les groupes de sécurité du client API

  1. Pour vous assurer que le client API peut être utilisé par votre ISU, recherchez la tâche Modifier le client API.
  2. Sélectionnez votre client enregistré, puis accédez aux paramètres de sécurité.
  3. Ajoutez le groupe de sécurité du système d'intégration associé à votre ISU à la liste des groupes de sécurité autorisés pour ce client.

Afficher le client API

  1. Pour récupérer votre ID client et votre code secret du client, recherchez la tâche Afficher le client API ou accédez à la page d'informations du client API.
  2. Sous Informations sur le client, recherchez et copiez l'ID client.
  3. Cliquez sur Manage Consumer Details (Gérer les détails du client) pour afficher et copier le code secret du client.

Étapes suivantes