Intégration d'applications personnalisées

Étapes pour intégrer ADManager Plus avec une application personnalisée

1. Connectez-vous à ADManager Plus.
2. Accédez à Automation > Configuration > Application Integrations.
3. Cliquez sur la + Custom Applications vignette pour intégrer une nouvelle application.
4. Dans la fenêtre qui s'affiche, entrez un Nom et Descriptionappropriés, téléchargez un Logo pour l'application, et cliquez sur Save.
5. Cliquez sur l'application personnalisée ajoutée à l'étape précédente pour configurer les méthodes d'autorisation API, les points de terminaison et les webhooks.
6. Dans la Authorization section, sélectionnez le Authorization Type dans la liste déroulante :



• No Auth

  Sélectionnez No Auth comme Authorization Type si votre requête ne nécessite pas d'autorisation, puis cliquez sur Configure. Si vous faites cela, les détails d'autorisation ne seront pas partagés avec le client API.

• API Key

  Si vous sélectionnez API Key comme Authorization Type, entrez le nom et la valeur de la clé dans les Key et Value champs, respectivement. Associez la clé à un en-tête ou un paramètre de requête à l'aide de la Add to liste déroulante et cliquez sur Configure. Vous pouvez vous référer à la documentation API de votre application pour plus de détails.

• Basic Authentication

  Si vous sélectionnez Basic Authentication comme Authorization Type, spécifiez un Username et Password et cliquez sur Configure.

• Bearer

  Si vous sélectionnez Bearer comme Authorization Type, entrez la clé API de votre application dans le Jeton champ et cliquez Configure. La clé API peut être obtenue en suivant les étapes mentionnées dans la documentation API de votre application.

• OAuth 2.0

  Si vous sélectionnez OAuth 2.0 comme Authorization Type, spécifiez les éléments suivants :

  • Préfixe d'en-tête: Spécifiez une valeur de préfixe pour votre en-tête d'autorisation.
  • Type d'octroi: Code d'autorisation est la valeur par défaut Type d'octroi, mais vous pouvez choisir Identifiants du client comme Type d'octroi selon l'application.
  • URL de rappel: L' URL de rappel est l'endroit où vous serez redirigé après l'authentification. Pour les applications de la liste, elle est préremplie avec l'URL d'ADManager Plus.

    Par exemple: http://{hostname}/OAuthCode.do. Le nom d'hôte sera la machine sur laquelle l'instance d'ADManager Plus est installée.

    Lors de l'intégration d'une nouvelle application, cela doit être configuré dans la configuration OAuth du fournisseur d'API.

  • URL d'authentification: Spécifiez l'URL du point de terminaison d'autorisation obtenue de l'application que vous souhaitez intégrer lors de la configuration des détails OAuth. Vous pouvez consulter le document API de l'application pour plus d'informations.
  • URL du jeton d'accès: Entrez l'URL du serveur OAuth où l'application peut échanger le code d'autorisation contre un jeton d'accès. L'URL du serveur sera l'URI de redirection de l'application. Consultez la documentation API pour connaître les étapes permettant d'obtenir l'URI de redirection de l'application avec laquelle vous effectuez l'intégration.
  • ID client et Secret client: Entrez un ID valide et sa clé secrète obtenue de l'application que vous souhaitez intégrer à ADManager Plus.
  • Portée: Les portées sont définies dans la documentation API de l'application avec laquelle vous effectuez l'intégration. Elles limitent l'accès du client à des points de terminaison spécifiques et déterminent si le client ne peut que lire ou également écrire sur ces points de terminaison. Spécifiez les valeurs de portée dans ADManager Plus après consultation des valeurs de portée dans la documentation API.
  • Authentification du client: Vous pouvez utiliser cette option pour choisir si les identifiants du client doivent être inclus dans le corps de la requête ou dans l'en-tête. Par défaut, Envoyer les identifiants du client dans le corps de la requête sera sélectionné.
  • Options avancées: Cliquez sur cette option et choisissez les en-têtes ou les paramètres de requête dans la Add to liste déroulante.
• Autorisation basée sur l'API :

  Lors de l'intégration d'applications personnalisées avec ADManager Plus, vous avez désormais la possibilité d'obtenir les jetons d'authentification à partir de points de terminaison API pour l'autorisation. Ceci est pris en charge dans les types d'autorisation <Clé API> et <Porteur>. Pour utiliser cette option,

  1. Sélectionnez l'option API Key ou Bearer (selon la norme d'autorisation de l'application à intégrer) dans le Authorization Type liste déroulante.
  2. Dans la Value champ, cliquez sur l'icône du webhook comme indiqué dans l'image.
  3. Configurez le jeton d'authentification API dans l'URL du point de terminaison ou ajoutez-le soit dans les en-têtes, soit dans les paramètres.
  4. Cliquez sur Tester et configurer pour tester le webhook et procéder à sa configuration en tant que méthode d'autorisation.

  Remarque: Ceci sera également listé en tant que macro dans les webhooks entrants et sortants dans la fenêtre contextuelle Sélectionner une macro .

  

  1. Cliquez sur l'icône pour ajouter un webhook de jeton d'authentification

Un webhook entrant permet le transfert de données de l'application personnalisée vers ADManager Plus. Pour configurer ceci, fournissez les détails requis dans les sections Paramètres du point de terminaison et Paramètres de réponse.

Paramètres du point de terminaison

1. Sous Webhook entrant, sous Configuration du point de terminaison API, cliquez sur Paramètres du point de terminaison pour fournir les détails du point de terminaison répertoriés ci-dessous. Si nécessaire, vous pouvez configurer plusieurs points de terminaison pour une application personnalisée à l'aide du bouton + Ajouter un point de terminaison API .

   

   • URL du point de terminaison: Entrez l' URL du point de terminaison. L' URL du point de terminaison varie selon l'opération à effectuer et le type de données à récupérer de l'application.
     • Par exemple: L' URL du point de terminaison utilisée pour obtenir les données utilisateur sera différente de l'URL utilisée pour récupérer les données de groupe. Consultez la documentation API de l'application que vous intégrez à ADManager Plus.
   • Méthode: Choisissez l'une des options suivantes pour la méthode de requête HTTP. GET ou POST pour la méthode de requête HTTP.
   • En-têtes: Cliquez et configurez les en-têtes HTTP respectifs.
   • Paramètres: Cliquez et configurez les paramètres de requête.
   • Message du corps: Sélectionnez le type de données du message du corps parmi les options disponibles en fonction du type d'API :
     • JSON: Cette option est destinée à REST APIs.
     • XML: Cette option est destinée à APIs SOAP.
     • Aucun: Il s'agit de l'option par défaut.

     Remarque: Si le type de réponse est XML, accédez à la Paramètres de réponse section et définissez le type de réponse sur XML. Ensuite, retournez à l' Paramètres du point de terminaison onglet et sélectionnez un fichier CSV contenant les chemins d'attributs nécessaires pour analyser la réponse XML.

   • Pour charger un fichier CSV, cliquez sur Importation CSV sous le champ Fichier de chemin XML pour charger un fichier CSV et extraire les données requises de la réponse XML.
   • Cliquez sur Test et enregistrement.

   Remarque: Suivez ces étapes pour configurer les paramètres avancés.

Paramètres de réponse

2. Dans la Paramètres de réponse section,
   • Délai d'expiration de la réponse : Définissez le délai maximum d'attente d'une réponse de l'API avant expiration.

     Spécifiez le délai maximum en millisecondes dans le champ Délai d'expiration de la réponse .

   • Type de réponse : Choisissez le format dans lequel la réponse doit être renvoyée. Sélectionnez JSON ou XML dans le champ Type de réponse. Par défaut, il est défini sur JSON, mais vous pouvez le modifier en XML selon les exigences de l'API.
   • Paramètres de rappel : Configurez ces paramètres pour gérer la pagination lors d'appels répétés au point de terminaison.
     • Répéter les appels à ce point de terminaison :

       Activez la bascule Répéter l'appel à ce point de terminaison pour configurer un critère qui s'exécutera de manière répétée jusqu'à ce que toutes les données soient récupérées de l'application intégrée.

     • Configuration des appels répétés : Définissez comment les demandes répétées doivent être déclenchées pour assurer la récupération complète des données de l'application intégrée.

       Sélectionnez le type d'action dans la liste fournie dans la première liste déroulante. Dans la liste déroulante adjacente, mentionnez les paramètres de pagination pour obtenir les données par ensembles ordonnés jusqu'à ce que l'ensemble de données complet soit récupéré. Entrez la valeur des paramètres de pagination dans le Value .

     • Critères d'appel répété :

       Vous pouvez également définir une condition à l'aide de l'option Critères d'appel répété pour spécifier combien de temps vous pouvez attendre une réponse à un appel API.

   • Gestionnaire de réponse: Les paramètres du gestionnaire de réponse vous permettent de définir comment la réponse du point de terminaison doit être traitée et personnalisée.
     • Analyseur de réponse :

       Activez la bascule Bascule de l' Analyseur de réponse

     • Analyseur de réponse :

       pour configurer le traitement de la réponse du point de terminaison et les modifications de données personnalisées à l'aide de fonctions personnalisées. Par défaut, tous les droits liés aux objets sélectionnés sont inclus.

     • Fonction personnalisée utilisée pour modifier ou supprimer les champs indésirables de la réponse reçue.

       Arguments : Utilisez des macros dans le champ Arguments

   pour spécifier si les données doivent être récupérées à partir de l'en-tête de réponse, du corps de réponse, du code d'état de réponse ou de toute entrée personnalisée. Save ou Une fois terminé, cliquez surTest et enregistrement

   

3. Cliquez sur . Une fenêtre de réponse affichera tous les éléments demandés. Source de données - Mappage des attributs LDAP
   • pour mettre en correspondance les points de terminaison et mapper les attributs LDAP AD avec les attributs respectifs de l'application personnalisée. Entrez le et Description Nom de la configuration et sélectionnez la Catégorie d'automatisation
   • Dans la dans le menu déroulant. Sélectionnez le champ Point de terminaison , cochez la case du point de terminaison de l'application personnalisée et dans la liste déroulante
   • Dans la Clé primaire sélectionnez l'attribut unique pour les utilisateurs (employeeIdentifier, username, etc.), mais qui conserve la même valeur dans tous les points de terminaison. Si vous avez configuré des points de terminaison dépendants, sélectionnez également l'attribut unique pour ces points de terminaison. Mappage des attributs champ, sélectionnez l'attribut dans la liste déroulante

   Remarque:

   • Cliquez sur Nom de l'attribut LDAP et mappez-le avec l'attribut respectif de l'application personnalisée. SaveAjouter un nouveau format pour créer un nouveau format pour les attributs de dénomination d'utilisateur dans l'application personnalisée. Dans la fenêtre contextuelle Format de dénomination personnalisée, remplissez les détails et cliquez sur . Vous pouvez également ajouter des
   • macros
     • lors de la spécification des valeurs de format si nécessaire.Les attributs personnalisés suivants peuvent être utilisés lors du mappage et sont pris en charge dans toutes les intégrations de sources de données externes ainsi que l'intégration CSV.
     • templateName: Spécifie le nom du modèle qui peut être utilisé pour la création d'utilisateurs, d'ordinateurs, de groupes et de contacts, ainsi que pour la modification d'utilisateurs.
4. Cliquez sur Save.

executionTime

: Spécifie le délai d'exécution pour chaque objet pour les actions non basées sur des modèles. Comment utiliser les webhooks entrants Après avoir configuré un webhook entrant, vous pouvez l'utiliser comme source de données dans les automations planifiées, cliquez sur + Créer une nouvelle automatisation, et utiliser Sélectionner Plus option dans la section Sélectionner les objets. Cela vous permet d'automatiser l'action que vous souhaitez effectuer sur la liste des objets importés via le webhook entrant, soit une seule fois, soit périodiquement.

Configuration avancée des points de terminaison pour les points de terminaison imbriqués avec des webhooks entrants

Pour certaines configurations d'API, vous devrez peut-être configurer plusieurs points de terminaison où les points de terminaison dépendent les uns des autres. Par exemple, le premier point de terminaison récupère tous les identifiants d'employés de l'organisation, et vous devez appeler une autre API pour chaque identifiant d'employé reçu dans la réponse pour récupérer les détails de chaque employé. Dans ces cas, configurez la première API en tant que point de terminaison de base (le type par défaut) et le deuxième point de terminaison en tant que point de terminaison dépendant à l'aide de Avancé option dans Configuration du point de terminaison section.

Étapes pour configurer un point de terminaison dépendant

Basculer Avancé bouton sur activé sous Configuration du point de terminaison API pour remplir les informations lorsque le point de terminaison dépend du point de terminaison de l'API précédente.

• Dans la Configuration du point de terminaison section, activez l'option Avancé pour remplir les informations lorsqu'un point de terminaison dépend d'un point de terminaison de l'API précédente.
• À partir de Type de configuration liste déroulante, sélectionnez le type de point de terminaison. Par défaut, Point de terminaison de base option sera sélectionnée. Vous devez la changer en Point de terminaison dépendant.
• À partir de Dépend de liste déroulante, sélectionnez le point de terminaison de base pertinent sur lequel les données du point de terminaison dépendant reposent. Ainsi, le point de terminaison dépendant sera appelé pour chaque objet reçu du point de terminaison de base.
• Pour utiliser un champ de la réponse du point de terminaison de base, utilisez les macros de point de terminaison de base listées en tapant % ou en cliquant .

Étapes pour récupérer les valeurs d'une réponse d'API REST en utilisant des conditions

Suivez toutes les étapes mentionnées dans la Configuration du webhook entrant section. Lorsque Type de message est défini sur JSON et que vous devez récupérer des données à partir d'un tableau de réponses en fonction de conditions spécifiques, ADManager Plus vous permet de le faire en utilisant l'analyse conditionnelle JSON.

Cette option filtre les données requises de la réponse JSON de l'API contenant un tableau de valeurs pour une clé souhaitée, qui peut ensuite être mappée aux attributs LDAP correspondants. Le format de mappage peut être configuré en utilisant une ou plusieurs conditions, selon vos besoins.

Syntaxe de condition

Utilisez les formats suivants pour définir une condition :

<path of array object key>[?(('<path of condition key>')='<condition value>')].<path of value to be fetched>

<path of array object key>[?(('<path of condition key>')='<condition value>')&(('<path of condition key>')='<condition value>')].<path of value to be fetched>

Paramètres de syntaxe

Exemple de réponse JSON :

{
    "data": [
        {
            "id": 443,
            "name": "TestUser",
            "employee_id": 443,
            "address": [
                {
                    "position": {
                        "city": {
                            "name": "cityname1",
                            "isHome": "false"
                        },
                        "phone": {
                            "number": 999888777,
                            "isHome": "true"
                        }
                    }
                },
                {
                    "position": {
                        "city": {
                            "name": "cityname2",
                            "isHome": "true"
                        },
                        "phone": {
                            "number": 5556666444,
                            "isHome": "false"
                        }
                    }
                }
            ],
            "items": [
                {
                    "category": "department",
                    "reference": "department_reference",
                    "data": [
                        {
                            "value": "teamname1",
                            "type": "primary"
                        },
                        {
                            "value": "teamname2",
                            "type": "secondary",
                            "details": [
                                {
                                    "id": "oldteamid",
                                    "type": "old"
                                },
                                {
                                    "id": "newteamid",
                                    "type": "new"
                                }
                            ]
                        }
                    ]
                },
                {
                    "category": "group",
                    "reference": "group_reference",
                    "data": [
                        {
                            "value": "groupname1",
                            "type": "primary"
                        },
                        {
                            "value": "groupname2",
                            "type": "secondary",
                            "details": [
                                {
                                    "id": "oldgroupid",
                                    "type": "old"
                                },
                                {
                                    "id": "newgroupid",
                                    "type": "new"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}
											

Type 1 : Mappage utilisant une seule condition

Récupérer une valeur d'un tableau JSON basé sur une seule condition. Cette méthode est utile lorsque vous souhaitez filtrer et extraire une information spécifique qui répond à un seul critère de correspondance à partir d'un ensemble de données. La condition agit comme un simple filtre, garantissant que seul l'objet pertinent du tableau est sélectionné.

Exemple : Pour récupérer la valeur cityname2 de la réponse fournie, définissez le chemin de condition data[].address[].position.city.isHome à true et le chemin du tableau cible comme data[].address[].position.city.name.

Syntaxe : data[].address[?(('position.city.isHome')='true')].position.city.name

Explication :

• data[].address: Ceci est le chemin d'accès à l'objet tableau JSON.
• position.city.isHome: Ceci est le chemin de la clé de condition à l'intérieur des données du tableau data[].address.
• true: Ceci est la valeur de condition à faire correspondre.
• position.city.name: Ceci est le chemin de la valeur à récupérer.

Résultat : La condition donnée correspond au deuxième élément du tableau, donc la valeur résultante est cityname2.

Type 2 : Mappage utilisant plusieurs conditions

Récupérer une valeur d'un tableau JSON et la mapper à un attribut LDAP en appliquant plusieurs conditions. Cette méthode est idéale pour les données complexes ou imbriquées où plusieurs critères doivent être respectés pour mapper avec précision la valeur aux attributs LDAP. En combinant les conditions à l'aide de l'opérateur logique ET (&) ou OU (|), vous pouvez affiner la sélection à un objet qui répond à tous les critères spécifiés.

Exemple : Pour récupérer la valeur groupname2 de la réponse fournie, définissez les chemins de condition data[].items[].category à group et data[].items[].data[].type à secondary, et définir le chemin du tableau cible comme data[].items[].data[].value.

Syntaxe : data[].items[?(('category')='group')&(('data[].type')='secondary')].data[].value

Explication :

• data[].items: Ceci est le chemin d'accès à l'objet tableau JSON.
• category: Ceci est le premier chemin de clé de condition à l'intérieur de data[].items.
• group: Ceci est la première valeur de condition à correspondre.
• data[].type: Ceci est le deuxième chemin de clé de condition à l'intérieur de data[].items.
• secondary: Ceci est la deuxième valeur de condition à correspondre.
• data[].value: Ceci est le chemin de la valeur à récupérer.

Résultat : La condition donnée correspond au deuxième élément du tableau, donc la valeur résultante est groupname2.

Remarque:

• Un tableau doit être indiqué par [ ] après la clé.
• La condition doit suivre le format de syntaxe exact pour être enregistrée.
• Si la condition n'est pas remplie, la valeur de colonne sera vide.
• Si aucune condition n'est spécifiée, la première valeur de chemin correspondante sera renvoyée.
• Seul l'opérateur logique égal (=) est pris en charge dans les conditions.
• ET (&) peut être utilisé plusieurs fois dans une seule condition pour les tableaux JSON imbriqués.

  Exemple :

  data[].items[?(('category')='group')&(('data[].type')='secondary')&(('details[].type')='new')].details[].id

• OU (|) ne peut être utilisé qu'une seule fois dans une seule condition.

  Exemple :

  data[].items[?(('category')='contact')|(('category')='group')].reference

• AND et OR ne peut pas être combiné dans la même condition.

Comment configurer l'analyse basée sur les conditions dans ADManager Plus

Dans ADManager Plus, l'analyse basée sur les conditions peut être configurée de deux façons. La méthode 1, qui est recommandée, offre plus de flexibilité car vous pouvez définir plusieurs mappages de format avec différentes conditions pour le même tableau JSON et les réutiliser dans les attributs LDAP. La méthode 2, en revanche, est configurée directement au niveau du point de terminaison et permet une seule condition par chemin de tableau JSON, ce qui limite la récupération à une seule valeur du tableau. Cela la rend plus restrictive mais plus simple à configurer.

Méthode 1 : [recommandée]

1. Dans la . Une fenêtre de réponse affichera tous les éléments demandés. section, sélectionnez le point de terminaison.
2. Sélectionnez Nom de l'attribut LDAP dans la liste déroulante dans la Clé primaire .
3. Dans la Format Mapping Attribute pop-up, entrez le nom du format et sélectionnez le format.
4. Dans la Format Value champ, cliquez sur l' macro icône.
5. Dans la Sélectionnez Macros pop-up, accédez à Functions > Match Condition.
6. Entrez la valeur de condition dans la zone de texte.
7. Cliquez sur Add.
8. Cliquez sur Save.
9. Maintenant, vous pouvez utiliser ce format pour mapper avec n'importe quel attribut LDAP.

Remarque: Pour chaque attribut LDAP à mapper, vous pouvez créer plusieurs formats en utilisant cette méthode.

Méthode 2:

1. Après avoir rempli les détails de configuration du point de terminaison, cliquez sur Test et enregistrement ou sélectionnez le Response Fields icône.
2. Cliquez sur n'importe quel champ de type de données pour ouvrir le menu déroulant et sélectionnez Array.
3. Entrez la valeur de condition dans la zone de texte.
4. Cliquez sur Save.
5. Maintenant, vous pouvez utiliser cette colonne pour mapper avec n'importe quel attribut LDAP.

Résultat du test de configuration du webhook entrant montrant un schéma de réponse JSON analysé, où les types de données d'attributs tels que texte, nombre, horodatage et tableau peuvent être sélectionnés pour la configuration du point de terminaison.

Étapes pour configurer un point de terminaison SOAP API

Vous devez suivre toutes les étapes mentionnées dans la configuration du webhook entrant section sauf pour cette étape. Lorsque le Type de message est défini sur XML, ADManager Plus nécessite le Bascule de l' fichier CSV. Ce fichier aide à filtrer uniquement les données requises de la réponse XML du point de terminaison. Les attributs filtrés peuvent ensuite être liés aux attributs AD LDAP.

Le fichier CSV doit avoir trois colonnes comme indiqué ci-dessous:

• columnName: Ceci est le nom souhaité pour les données à filtrer de la réponse XML.
• xPath: Ceci est l'emplacement d'où les données doivent être extraites.
• isParameter: Si défini sur 1, il deviendra un attribut itérant lors des appels répétés. Par exemple, si un nœud nommé Page dans le corps du message doit augmenter d'un incrément d'un à chaque appel, le isParameter pour Page est défini sur 1.

Par exemple, comme illustré dans les images ci-dessous, la valeur de columnName Worker ID mise en surbrillance dans l'exemple de fichier CSV est extraite de l'attribut Worker_ID(value:100001) comme illustré dans l'exemple de réponse XML. Cette valeur peut être mappée à l'attribut AD LDAP employeeID ultérieurement.

Exemple de fichier CSV :

Exemple de réponse XML :

Cliquez sur ici pour télécharger un exemple de fichier CSV.

Indexation basée sur les valeurs

L'indexation basée sur les valeurs est une technique utilisée pour localiser et récupérer efficacement les données en appliquant des conditions spécifiques à leurs valeurs. Cette approche permet aux utilisateurs de créer un xPath spécifique, leur permettant de trouver efficacement les entrées qui correspondent aux critères définis.

Comme indiqué dans les images ci-dessous, la valeur de la colonne Entreprise dans l'exemple de fichier CSV est extraite de l' attribut Organization_Name (valeur : company1), mis en évidence dans la deuxième image. Puisqu'il existe plusieurs entrées de Worker__Organization_Data, une condition supplémentaire (Organization_Subtype_ID='company') est définie pour spécifier le bon Worker_Organization_Data. Cela signifie que la valeur finale est sélectionnée en fonction d'une condition liée à une autre valeur spécifique.

Ce xPath filtre les données sous Worker_Organization_Data en vérifiant si Organization_Subtype_ID est égal à Company. Il retourne ensuite le Organization Name de la condition correspondante.

Pour créer une condition, suivez ces étapes :

1. Identifiez le champ de données que vous souhaitez filtrer (par exemple, Organization_Subtype _ID).
2. Spécifiez la valeur à faire correspondre (par exemple, Company).
3. Appliquez la condition sous la forme [?(searchpath = 'value')] pour filtrer en fonction de l'attribut sélectionné.

Cette approche permet la création d'un xPath précis et de résultats basés sur une condition définie.

Un webhook sortant vous permet d'envoyer les modifications apportées dans AD à l'aide d'ADManager Plus à l'application personnalisée. Pour configurer un webhook sortant :

1. Sous Webhook sortant, cliquez sur <Application personnalisée> Configuration du webhook.
2. Cliquez sur + Ajouter un webhook.



3. Entrez un nom et une description pour ce webhook.
4. Consultez les références d'API de l'application personnalisée, décidez de l'action qui doit être effectuée, et identifiez l'API requise pour effectuer l'action.
5. Dans la liste déroulante, sélectionnez la méthode HTTP qui vous permettra d'effectuer l'action souhaitée sur le point de terminaison.
6. Entrez l'URL du point de terminaison. Elle variera en fonction des données que vous souhaitez transférer à l'application.
   • Par exemple: L'URL du point de terminaison utilisée pour mettre à jour les attributs des utilisateurs sera différente de l'URL du point de terminaison utilisée pour mettre à jour les mots de passe récemment modifiés des utilisateurs. Consultez la documentation API de l'application que vous intégrez avec ADManager Plus.
7. Configurez les En-têtes, Paramètres, et Type de message au format approprié en fonction de l'appel API pour l'action que vous souhaitez effectuer.
8. Cliquez sur Test et enregistrement. Une fenêtre contextuelle affichera ensuite une liste d'utilisateurs et de groupes.
9. Sélectionnez les utilisateurs et groupes souhaités sur lesquels cette demande API doit être testée et cliquez sur OK. Cela effectuera un appel en temps réel à l'URL du point de terminaison pour exécuter la fonction de l'API configurée sur les objets sélectionnés.
10. Une fenêtre contextuelle affichera ensuite la réponse du webhook et les détails de la demande. Si vous ne pouvez pas recevoir la réponse de la demande API, assurez-vous que les attributs mappés, les en-têtes, les paramètres et le message de demande sont corrects.

Remarque: Dans la fenêtre de réponse du webhook, vous pouvez modifier le type de données ou le format de la valeur d'attribut récupérée par l'appel API en utilisant l'option d'édition.

Par exemple: Le format de date utilisé dans l'application intégrée peut être différent du format de date utilisé dans ADManager Plus. Pour résoudre ce problème, utilisez l'option d'édition dans la fenêtre de réponse pour modifier le format de date.



Résultat du test de connexion de la configuration du webhook sortant permettant aux administrateurs de définir les types de données pour les en-têtes et les paramètres utilisés lors de l'exécution du webhook.

Comment utiliser les attributs supportés par les macros

• Vous pouvez soit taper %, soit cliquer sur pour ajouter les macros de votre choix dans les champs Entrez une URL, En-têtes, et Paramètres .
• Si vous devez ajouter les macros dans le corps du message, cliquez sur Sélectionnez Macros.

Comment utiliser les webhooks sortants

Après avoir configuré un webhook sortant pour l'action requise, utilisez-le comme bloc dans un modèle d'orchestration. Le modèle d'orchestration configuré peut être exécuté à l'aide d'automatisations basées sur les événements, d'automatisations planifiées ou de politiques d'automatisation. Il peut également être appliqué directement aux utilisateurs souhaités pour effectuer une séquence d'actions sur eux sous Management > Advanced Management > Orchestration.