Partager via

Authentification de serveur à serveur pour l’API d’intégration ATS

S’applique aux applications Dynamics 365 suivantes :
Human Resources

Cet article décrit comment configurer l’authentification de serveur à serveur pour les intégrations d’applications par rapport à l’API d’intégration du système de suivi des candidats (ATS) Dynamics 365 Human Resources. Il y a quelques couches de sécurité qui doivent être gérées pour que le principal du service puisse accéder à la table virtuelle Microsoft Dataverse et aux données associées. L’utilisateur doit avoir accès à la table virtuelle Dataverse dans Microsoft Power Platform et accès aux données dans Dynamics 365 Human Resources.

Activer l’accès aux tables virtuelles Dataverse dans Power Platform

La première étape pour accéder aux tables virtuelles Dataverse dans Power Platform consiste à configurer votre application dans Power Platform pour l’authentification par rapport à des points de terminaison de tables virtuelles Dataverse. Pour plus d’informations, consultez le Guide du développeur Microsoft Dataverse.

Création d’un rôle de sécurité pour les intégrations ATS

L’une des étapes après la création de l’utilisateur de l’application consiste à attribuer à l’utilisateur un rôle de sécurité qui définit l’accès que l’application aura aux points de terminaison. Il s’agit de l’étape 7 dans Création d’utilisateurs de l’application pour les enregistrements d’applications à locataire unique, et Créer un rôle de sécurité pour l’utilisateur de l’application pour les inscriptions à plusieurs locataires.

Le rôle auquel vous attribuez l’utilisateur de l’application doit avoir accès aux entités de données utilisées pour votre intégration ATS. Cela n’existe pas par défaut, un nouveau rôle de sécurité doit donc être créé. Le nouveau rôle peut être créé en suivant les étapes décrites dans Créer un rôle de sécurité.

Pour le nouveau rôle, un accès approprié doit être attribué, au minimum, aux entités suivantes dans l’onglet Entités personnalisées du nouveau rôle. Vous devrez peut-être ajouter des entités supplémentaires si l’intégration utilise des données d’application plus étendues. Une fois le nouveau rôle créé, il peut être attribué à l’utilisateur de l’application.

  • Collaborateur de base (mshr)
  • Candidat à l’embauche (mshr)
  • Compétence – Certificat (mshr)
  • Type de certificat (mshr)
  • Société
  • Fonction de rémunération (mshr)
  • Type de fonction de rémunération (mshr)
  • Pays/régions (mshr)
  • Service (mshr)
  • Compétence en éducation (mshr)
  • Diplôme d’études (mshr)
  • Disciplines de formation (mshr)
  • Exigences scolaires (mshr)
  • Identification (mshr)
  • Type d’identification (mshr)
  • Établissement (mshr)
  • Agence émettrice (mshr)
  • Rémunération du poste (mshr)
  • Postes (mshr)
  • Niveau d’études (mshr)
  • Contacts de la partie (mshr)
  • Personnes (mshr)
  • Adresses des personnes (mshr)
  • Filtrage de la personne (mshr)
  • Type de poste (mshr)
  • Postes V2 (mshr)
  • Compétence expérience professionnelle (mshr)
  • Niveau de classement (mshr)
  • Modèles de classement (mshr)
  • Codes de motif (mshr)
  • Demande de recrutement (mshr)
  • Emplacement de la demande de recrutement (mshr)
  • Poste de la demande de recrutement (mshr)
  • Compétences de la demande de recrutement (mshr)
  • Type de filtrage (mshr)
  • Compétence (mshr)
  • Qualifications (mshr)
  • Titres (mshr)
  • Statut de vétéran (mshr)
  • Collaborateur (mshr)

Accorder des autorisations d’application aux données des ressources humaines

La deuxième étape consiste à s’assurer que l’application dispose des autorisations appropriées sur les données des ressources humaines en la liant à un utilisateur dans l’application Human Resources. Pour un utilisateur d’application, les appels de serveur à serveur via les tables virtuelles Dataverse sont effectués dans le contexte de l’identité de l’utilisateur (app) dans Dataverse qui invoque l’action. Le service d’adaptateur de table virtuelle recherche ensuite l’utilisateur associé dans les ressources humaines et exécute la requête dans le contexte de cet utilisateur. Cela signifie qu’un utilisateur doit être créé dans Human Resources avec les bons rôles attribués afin de fournir un accès aux données dont l’application d’intégration aura besoin.

L’utilisateur de Human Resources doit également disposer des autorisations appropriées pour les données dans Human Resources. Le rôle Demande de recrutement (HcmRecruitingIntegrator) est disponible avec des privilèges sur les entités principales requises pour l’intégration avec les données de recrutement. Ce rôle peut être attribué à l’utilisateur de l’application sur la page Utilisateurs pour accorder un accès approprié aux données. Pour plus d’informations sur les rôles de sécurité des ressources humaines, consultez Sécurité basée sur les rôles.

Configurer le nouvel utilisateur avec les autorisations appropriées

Pour configurer le nouvel utilisateur avec les autorisations appropriées, suivez les étapes ci-après :

  1. Ouvrez la page Utilisateurs dans les ressources humaines et sélectionnez Nouveau.

  2. Entrez un Identifiant d’utilisateur et un Nom d’utilisateur pour le nouvel utilisateur de l’application. Par exemple, vous pouvez entrer « IntégrationRecrutement ».

    Remarque

    Si l’application n’a pas de compte d’utilisateur ou d’adresse e-mail Microsoft Microsoft Entra, vous pouvez mettre quelque chose comme « AppRecrutement » dans les champs d’adresse e-mail et de fournisseur pour l’utilisateur.

  3. Dans l’onglet rapide Rôle de l’utilisateur, sélectionnez l’action Affecter des rôles.

  4. Dans le volet Attribuer des rôles à l’utilisateur, sélectionnez Demande de recrutement, puis sélectionnez OK.

  5. Enregistrez le nouvel enregistrement d’utilisateur.

Une fois l’utilisateur créé, un enregistrement doit être créé pour l’application dans la page Applications Microsoft Entra pour lier l’application à l’utilisateur de Human Resources.

  1. Ouvrez la page Applications Microsoft Entra et sélectionnez Nouveau.
  2. Dans le champ Identité du client, entrez l’ID client de l’utilisateur de l’application créé pour l’application.
  3. Dans le champ Nom, entrez le nom de l’application d’intégration.
  4. Dans le champ Identifiant utilisateur, sélectionnez le nouvel utilisateur des ressources humaines créé pour l’intégration du recrutement.
  5. Enregistrez le nouvel enregistrement.

L’application aura alors accès aux données des ressources humaines, limitées uniquement aux données nécessaires aux intégrations d’applications de recrutement.

Voir également :

Recruter des candidats à un poste
Qu’est-ce que Microsoft Dataverse ?
Utiliser l’API Web Microsoft Dataverse
Créer et mettre à jour des ensembles d’options à l’aide de l’API Web