Aller au contenu

Fonctions utilisateur

Une fonction d'extension est un point d'extension personnalisable qui permet aux organisations d'améliorer et de personnaliser le comportement du flux de travail Hire2Retire sans modifier sa logique de base. Il permet aux utilisateurs de connecter leurs propres scripts ou sous-programmes, hébergés en externe, pour répondre à des exigences ou à des politiques commerciales spécifiques.

Lorsqu'elles sont intégrées à Hire2Retire, ces fonctions sont exécutées au moment de l'exécution, ce qui permet une interaction dynamique entre le flux de travail principal et votre logique personnalisée. Il s'agit d'un moyen flexible et puissant de mettre en œuvre des validations, des transformations ou des actions spécifiques à l'organisation.

Dans l'implémentation actuelle, Hire2Retire prend en charge l'intégration avec Azure Functions, vous permettant de configurer et de déclencher votre propre logique hébergée par Entra ID en réponse à des événements du cycle de vie tels que l'embauche, les changements de rôle ou les licenciements.

Entra ID Formulaire de connexion au bus de service

Hire2Retire utilise Entra ID Service Bus pour envoyer en toute sécurité les événements du cycle de vie des employés (tels que l'embauche, les changements de rôle et les licenciements) à votre fonction Azure. Pour établir cette connexion, nous avons besoin des informations suivantes :

  • Espace de noms Service Bus
  • Nom de la politique d'accès partagé (nom de clé)
  • Clé primaire

Ces informations d'identification permettent à Hire2Retire d'authentifier et de publier des messages dans votre file d'attente ou dans votre rubrique Service Bus, déclenchant ainsi votre fonction Azure dans le cadre de votre flux d'automatisation.

  1. Nom d'hôte Service Bus : il s'agit du nom unique au monde de votre instance Service Bus. Pour le trouver :

    • Accédez au portail Azure → https://portal.azure.com
    • Dans la barre de recherche, tapez Service Bus et sélectionnez votre espace de noms.
    • Dans l'onglet Overview, localisez le Service Bus Namespace en haut de la page.

  2. Nom de la clé : il s'agit du nom de la politique d'accès partagé utilisée pour l'authentification. Pour le trouver :

    • Dans votre espace de noms Service Bus, accédez à Paramètres → Politiques d'accès partagé.
    • Vous verrez une liste de politiques. Le nom de la politique est le Nom clé.

  3. Clé principale : il s'agit du secret réel utilisé pour signer et autoriser les demandes de Service Bus. Pour le trouver :

    • Cliquez sur la politique que vous avez choisie (à l'étape précédente).
    • La Clé primaire* est affichée sur la droite.
    • Cliquez sur l'icône copier pour le copier en toute sécurité.

Une fois que vous avez les trois valeurs, saisissez-les dans le formulaire de connexion pour établir un lien sécurisé avec votre bus de service Entra ID.

Azure Function Connection Form

Configuration de la fonction d'extension

  1. Nom de la configuration de la fonction d'extension : nom de la configuration actuelle. Cette valeur sera affichée dans l'événement de la page Observer pour identifier l'événement à partir de cette fonction d'extension. Il est conseillé d'avoir un nom unique pour chaque configuration.

  2. Choisissez l'activité du cycle de vie : choisissez les opérations du cycle de vie sur lesquelles la fonction d'extension sera déclenchée.

  3. Condition de traitement des employés : Ne traitez que les employés qui répondent à des conditions définies. Azure Function Form

  4. Nom de la file d'attente de l'éditeur : nom de la file d'attente à laquelle les données des employés seront envoyées. Votre fonction Azure doit écouter cette file d'attente pour recevoir la charge utile.

  5. En-têtes de message : chaque message contiendra 2 en-têtes définis par le système :

    • Correlation ID : Cela sera ajouté par Hire2Retire. Ce champ sera utilisé pour corréler la réponse de la fonction Entra ID avec l'événement principal Hire2Retire. La réponse envoyée par la fonction Entra ID du client doit contenir ce champ et la valeur doit être la même que celle présente dans la charge utile qu'elle reçoit.
    • Time to live: By default, cette valeur est définie pour 14 jours par le bus de service Entra ID. Les clients peuvent le modifier en le définissant comme un en-tête personnalisé sur l'interface utilisateur Hire2Retire.
    • En plus de ces en-têtes définis par le système, l'utilisateur peut définir Custom Headers en fonction de son utilisation.

  6. Charge utile du message : les utilisateurs peuvent définir la charge utile en fonction de leur cas d'utilisation. Ils peuvent soit mettre une valeur statique, soit mapper les attributs HR/AD.

  7. Nom de la file d'attente du récepteur : nom de la file d'attente à laquelle Hire2Retire recevra la réponse de la fonction Azure. Votre fonction Azure doit publier une réponse à cette file d'attente.

  8. Exemple de charge utile de réussite/d'échec : une zone de texte non modifiable s'affichera. Elle contiendra tous les champs obligatoires avec leur type de données respectif, comme prévu dans la réponse Hire2Retire Azure Function.

AzEntra IDure Function Form