Gestion des webhooks
Les modèles de webhooks de ManageEngine ADManager Plus vous permettent de créer un modèle pour configurer des points de terminaison API REST, des en-têtes, des paramètres, le type d'action et les messages, qui peuvent ensuite être ajoutés à vos modèles d'orchestration en tant que blocs. L'historique des webhooks vous permet de récupérer les détails des webhooks, tels que le modèle d'orchestration associé et de surveiller les modifications, ce qui permet de détecter les anomalies.
Étapes pour créer un nouveau modèle de webhook
- Connectez-vous à ADManager Plus en tant qu'administrateur.
- Accédez à Onglet Automation > Configuration > Modèle d'orchestration.
- Cliquez sur Configurer le webhook et sélectionnez Créer un nouveau modèle.
- Entrez un nom approprié et une description pour le modèle.
- Dans le URL champ, entrez l'appel API. Consultez cette note pour apprendre à utiliser les macros.
- Dans le Autorisation champ, sélectionnez l'application personnalisée associée à l'autorisation requise.
Remarque: Pour ajouter un nouveau type d'autorisation, incluez l'application personnalisée pour celui-ci et appliquez-le dans cette section.
Cliquez ici pour en savoir plus sur l'ajout d'une application personnalisée.
- Dans le Méthode champ, sélectionnez l'une des méthodes HTTP suivantes,
- Get: Pour lire
- Put: Pour mettre à jour ou remplacer
- Post: Pour créer
- Delete: Pour supprimer
- Dans le En-têtes champ, vous pouvez ajouter les en-têtes API requis et les mapper aux valeurs d'en-têtes appropriées.
- De même, dans le Paramètres champ, vous pouvez ajouter les paramètres API appropriés et les mapper à leurs valeurs de paramètre.
- Choisissez l'option Type de message appropriée.
- Sélectionnez Tester et enregistrer pour vérifier l'implémentation du webhook en temps réel pour des utilisateurs et des groupes spécifiques, ou cliquez simplement sur Enregistrer.
Remarque:
- Utilisez des macros dans les champs URL, Paramètres, En-têtes, et Message pour récupérer les données basées sur les objets. Ajoutez des macros à partir d'AD (y compris les attributs LDAP personnalisés), Microsoft 365, les variables d'environnement et les détails d'action en tapant % pour affiner la recherche de l'attribut requis. Vous pouvez également cliquer sur l'
icône et choisir l'attribut. Pour plus d'informations sur la création d'une variable d'environnement, cliquez sur ici.
- Dans les champs de valeur, entrez %% pour représenter le symbole %.
- Pour accéder aux macros spécifiques à AD et les utiliser, entrez la valeur dans %ad.attribute_name% format (par exemple, %ad.SamAccountName%).
- Pour accéder et utiliser les macros spécifiques à Microsoft 365, entrez la valeur dans %m365.attribute_name% format (par exemple, %m365.UserPrincipalName%).
- Pour accéder et utiliser les variables d'environnement en tant que macros, entrez la valeur au format %env.attribute_name% (par exemple, %env.ticketingtoolAuthToken%).
- Pour accéder et utiliser les détails des actions en tant que macros comme Timestamp ou Technician Name, entrez la valeur dans %act.Timestamp% ou %act.technician% format (par exemple, %act.timestamp_dd-MM-yy_current time%).
- Pour accéder et utiliser les données des applications tierces en tant que macros, entrez la valeur au format %tp.attribute_name% (par exemple, %tp.SamAccountName%).