Extension d’API MID Hermes
L’API MID Hermes est une extension qui permet de Serveur MID communiquer Hermes via un Serveur MID fichier .
Envoyer des charges utiles de message à une Hermes rubrique avec les includes de script MID et l’API du créateur MID Hermes. Le script MID inclut des données push via Hermes une interface API scriptable, ils ne sont donc Connexion au flux pas obligatoires. Activez le module d’extension ServiceNow API MID Hermes (com.glide.mid.hermes_api) pour utiliser cette extension.
Enregistrements de contexte d’extension
- Affichez l’état du contexte d’extension.
- Démarrez, arrêtez et redémarrez le contexte d’extension.
- Mettre à jour les paramètres.
- Affichez les rubriques autorisées Hermes et modifiez ou créez des rubriques.
Statistiques
Vous pouvez afficher les statistiques de l’extension d’API MID Hermes en accédant à ou d’accéder directement à la table Statistiques de l’API MID Hermes [sys_mid_hermes_api_metric].
- Nombre d’octets : nombre d’octets produits pendant l’intervalle de collecte.
- Heure de collecte : heure à laquelle l’intervalle de collecte s’est terminé.
- Intervalle de collecte (secondes) : durée de l’intervalle de collecte. La valeur par défaut est de 60 secondes.
- Nombre de messages : nombre de messages produits pendant l’intervalle de collecte.
- Contexte d’extension de l’API MID Hermes : nom de l’enregistrement de contexte d’extension utilisé pour produire des messages.
- Serveur MID: référence au contexte d’exécution Serveur MID de l’extension.
- Rubrique : nom de la rubrique vers laquelle Hermes le contexte d’extension génère des messages.
Les mesures de cette table sont collectées en mémoire par (extension_context, rubrique) et agrégées en continu pendant chaque intervalle de 60 secondes. Ils sont ensuite transmis en tant que lot unique à ServiceNow, ce qui donne un enregistrement de base de données par combinaison contexte-rubrique unique par intervalle plutôt que des enregistrements individuels pour chaque message.
Cette table dispose d’un nettoyeur de table qui purge automatiquement les anciens enregistrements de statistiques en fonction des politiques de conservation des données, ce qui permet d’éviter une croissance illimitée de la table.
Certificats d’accès
Les certificats d’accès mTLS Hermes contiennent des ACL de rubrique. Lorsque le génère Serveur MID la CSR, la valeur du champ topics_acl de la table Contexte d’extension MID est définie comme l’ACL sur la CSR. L’appel REST permettant de signer la CSR transmet le sys_id de contexte d’extension MID, afin que le serveur puisse vérifier que l’ACL correspond à la configuration du contexte.
Si l’ACL du Hermes certificat d’accès ne correspond pas à l’ACL de l’enregistrement du contexte d’extension MID, il Serveur MID retente automatiquement la vérification jusqu’à trois fois de plus. Entre chaque tentative, le Serveur MID récupère la dernière ACL de l’instance. Si l’ACL ne correspond toujours pas après la dernière tentative, une erreur REST est renvoyée et consignée.
Lorsque le contexte d’extension MID démarre, la chaîne ACL de rubrique qu’il fournit est comparée à celle qui fait partie du certificat d’accès mTLS Hermes . Si c’est différent, un nouveau certificat mTLS avec l’ACL correcte est généré.
Si les rubriques autorisées changent, les règles métier redémarrent automatiquement le contexte d’extension MID. Lorsqu’une extension redémarre, la production fonctionne toujours avec l’ancienne configuration jusqu’à ce que la nouvelle configuration soit chargée.
Les certificats sont valables sept jours. Lorsqu’un certificat est créé, un minuteur de cinq jours commence à redemander le certificat d’accès avant qu’il n’expire.
Configurer l’extension d’API MID Hermes
Configurez l’extension d’API MID Hermes pour permettre à l’API du créateur MID Hermes de produire des messages vers Hermes via un Serveur MID.
Avant de commencer
- Rôle requis : kafka_admin
- Déployez et démarrez un Serveur MID.
- Activez le module d’extension ServiceNow API MID Hermes (com.glide.mid.hermes_api).