Transmettre les événements par push à l’API via le Serveur MID service Web

Configurez le collecteur d’événements MID WebService pour fournir une méthode d’URL pour transmettre par push les messages d’événements Serveur MID au .

Par défaut, le collecteur d’événements MID WebService vous permet de vous connecter à un générateur d’événements et d’envoyer des messages d’événements via le Serveur MID, à l’aide d’une URL au format suivant : http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/jsonv2

Le format JSON v2 est le même que celui que les clients utilisent pour envoyer des messages d’événements à l’instance. Cette URL offre de bonnes performances.

Pour plus d'informations, consultez Configurer le contexte du module de collection d’événements MID WebService.

Remarque :

Gestion des événements Accepte les événements dans le fuseau horaire par lequel l’écouteur Serveur MID a envoyé le message d’événement. Si vous avez besoin d’un fuseau horaire différent, vous pouvez configurer le script comme demandé, reportez-vous à la section Intégration avec les connecteurs par push.

URL pour transmettre par push les charges utiles personnalisées

Ils Serveur MID peuvent également recevoir une charge utile personnalisée au format JSON, XML ou en texte brut. Dans ce cas, il transforme les messages d’événement Serveur MID à l’aide de l’include de script que vous fournissez, puis envoie les événements à l’instance. L’URL dans ce cas est :

http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/inbound_event ? Transform={Transform_script_name} Pour obtenir un exemple d’include de script, consultez l’include de script TransformEvents_xmlSample par défaut.

Pour obtenir un exemple sur la façon dont le collecteur d’événements MID WebService transforme les messages d’événements au format JSON, reportez-vous à la section Collecte d’événements à partir de BMC TrueSight et BMC TrueSight_v2.

Pour envoyer des événements au format JSON générique, vous pouvez utiliser l’URL au format suivant :

http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/inbound_event ? Transform=TransformEvents_MidJsonGeneric

Dans ce cas, l’include de script MID TransformEvents_MidJsonGeneric fourni dans l’instance de base transforme les messages d’événement en champs d’événement. Tous les champs sont ajoutés en tant que champs Informations supplémentaires dans l’événement ServiceNow qui est généré.

Remarque :

L’URL au format http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/{transform_script_name}est également prise en charge.

L’URL de l’API REST pour la validation de la connectivité est la suivante : http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/ping

Include de script pour transformer les événements collectés

Utilisez l’include de script requis Serveur MID pour transformer (analyser) les messages d’événements collectés et les renseigner dans le champ d’événement mappé. Le Serveur MID nom de l’include de script est composé d’un préfixe et d’un suffixe. Le préfixe est le TransformEvents_ de texte obligatoire et le suffixe est le nom de transformation sur l’URL, par exemple, http://{MID_Server_IP} :{MID_Web_Server_Port}/api/mid/em/xmlSample . Le nom du script composé est donc TransformEvents_xmlSample.

Vous devez fournir un include de script qui reçoit les messages d’événement dans une variable texte. Le script doit avoir une fonction transform() qui effectue la transformation et prépare le tableau de retour des objets d’événement. Lorsque le module d’extension est activé, vous Gestion des événements recevez le TransformEvents_xmlSample exemple de script include qui transforme les événements du format XML.

Remarque :

Les champs d’événement qui ne sont pas identiques aux champs de la table d’événements sont enregistrés dans le champ Informations complémentaires .

En-têtes des messages d’événements

Spécifiez la valeur d’en-tête de demande appropriée pour le champ Type de contenu en fonction du format du message d’événement.

Tableau 1. Valeurs d’en-tête de demande pour le type de contenu

Format du message	Valeur de type de contenu
JSON	application/json
XML	application/xml
Texte	texte/brut

Options d’authentification et de sécurité des données

Options pour l'authentification et la sécurité des données :

• Type d’authentification, qui peut être défini sur Clé API, mTLS ou De base.
• Connexion sécurisée, qui vous permet de choisir si les données entrantes et sortantes sont sécurisées lors de leur transmission. Si vous choisissez l’option sécurisée avancée, vous devez obtenir un certificat d’une autorité de certification reconnue, puis fournir l’alias de certificat de magasin de clés et le mot de passe de magasin de clés.
• Utilisez le magasin de clés unifié MID, qui fournit une protection contre chiffrement et vous permet d’installer un certificat personnalisé dans le Serveur MID magasin de clés unifié. Pour plus d’informations, voir Installer des certificats personnalisés dans le magasin de clés unifié du serveur MID.
• Les utilisateurs doivent fournir un script qui reçoit les messages d’événements au format JSON, XML ou texte dans une variable texte. Le script doit avoir une fonction transform() qui effectue la transformation et prépare le tableau de retour des objets d’événements. Le script TransformEvents_xmlSample include qui transforme les événements au format XML est fourni à titre d’exemple lorsque le module d’extension Gestion des événements est activé.

Pour plus d’informations sur l’authentification et la sécurité des données, reportez-vous à la section Configurer l’extension Serveur Web MID.

Tâches associées

• Transmettre les événements par push à l’instance à l’aide de l’API de service Web