Aller au contenu principal

Acheminement des événements vers un service de messagerie à l’aide de SMTP

Vous pouvez configurer Lenovo XClarity Orchestrator pour acheminer les événements spécifiques vers une ou plusieurs adresses e-mail à l’aide de SMTP.

Avant de commencer

Avertissement
Aucune connexion sécurisée n’est établie lors du réacheminement des données vers ce service. Les données sont envoyées via un protocole texte en clair.

Pour permettre l'acheminement d'un e-mail vers un service de messagerie Web (par exemple, Gmail, Hotmail ou Yahoo), votre serveur SMTP doit prendre en charge l'acheminement d'e-mails sur le Web.

Avant de configurer un réexpéditeur d'événement vers un service Web Gmail, passez en revue les informations décrites dans Acheminement des événements vers un service Web SMTP Gmail.

À propos de cette tâche

Si le contrôle d’accès basé sur les ressources est activé, les données sont transférées uniquement pour les ressources auxquelles vous pouvez accéder à l’aide de listes de contrôle d’accès. Si vous n’êtes pas membre d’un groupe auquel le rôle Superviseur prédéfini est attribué, vous devez attribuer une ou plusieurs listes de contrôle d’accès aux réexpéditeurs que vous créez. Si vous souhaitez envoyer des données pour toutes les ressources auxquelles vous pouvez accéder, sélectionnez toutes les listes de contrôle d’accès associées disponibles. Si vous êtes membre d’un groupe auquel le rôle Superviseur prédéfini est attribué, vous pouvez choisir d’envoyer des données pour toutes les ressources ou d’affecter des listes de contrôle afin de limiter les ressources.

Des filtres de réacheminement de données courants sont utilisés pour définir la portée des événements que vous souhaitez acheminer, en fonction de codes d'événement, de classes d'événement, de gravités d'événement, de types de maintenance et de ressources qui ont généré l'événement. Assurez-vous que les filtres de ressources et d’appareils que vous souhaitez utiliser ce réexpéditeur sont déjà créés (voir Création de filtres de réacheminement des données).

L'exemple suivant illustre le format par défaut pour les données transférées vers un service de messagerie. Les mots entre crochets doubles sont les attributs qui sont remplacés par des valeurs réelles lors de l'acheminement des données.
Objet de l'e-mail
Event Forwarding
Corps de l’e-mail
{
"groups": [],
"acls": [],
"local": null,
"eventID": "FQXHMEM0216I",
"severity": "Warning",
"sourceID": "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
"componentID": "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
"msg": "The event forwarder destination cannot be reached. Therefore new events are not being
forwarded.",
"description": "The event forwarder destination cannot be reached. Therefore new events are not
being forwarded.",
"userAction": "Look in the online documentation to determinate more information about this event
based on the eventID. At the moment the orchestrator server can not offer more
information.",
"recoveryURL": null,
"flags": [],
"userid": null,
"action": "None",
"eventClass": "System",
"args": [],
"service": "None",
"lxcaUUID": "23C87F0A2CB6491097489193447A655C",
"managerID": "23C87F0A2CB6491097489193447A655C",
"failFRUNumbers": null,
"failFRUSNs": null,
"failFRUUUIDs": "[FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF]",
"msgID": null,
"timeStamp": "2021-03-12T18:32:14.000Z",
"eventDate": "2021-03-12T18:32:14Z",
"commonEventID": "FQXHMEM0216I",
"sequenceNumber": "17934247",
"details": null,
"device": {
"name": "xhmc194.labs.lenovo.com",
"mtm": null,
"serialNumber": null
},
"resourceType": "XClarity Administrator",
"componentType": "XClarity Administrator",
"sourceType": "Management",
"resourceName": "xhmc194.labs.lenovo.com",
"fruType": "other",
"ipAddress": "10.243.2.107",
"_id": 252349
}

Procédure

Procédez comme suit pour acheminer les données vers un service de messagerie.

  1. Dans la barre de menus deXClarity Orchestrator cliquez sur Surveillance (Icône Surveillance) > Acheminement, puis cliquez sur Réexpéditeurs de données dans la navigation de gauche pour afficher la carte Réexpéditeurs de données.
  2. Cliquez sur l'icône Créer (Icône Ajouter) pour afficher la boîte de dialogue Créer un réexpéditeur de données.
  3. Indiquez le nom de réexpéditeeur et une description facultative.
  4. Choisissez d'activer ou de désactiver le réexpéditeur en cliquant sur le commutateur État.
  5. Sélectionnez le type de réexpéditeur E-mail.
  6. Cliquez sur Configuration, puis indiquez les informations spécifiques au protocole.
    • Entrez le nom d'hôte ou l'adresse IP du serveur SMTP.
    • Entrez le port à utiliser pour l'acheminement des événements. La valeur par défaut est 25.
    • Entrez le délai d’attente (en secondes) pour la demande. La valeur par défaut est 30 secondes.
    • Entrez l'adresse e-mail de chaque destinataire. Si vous entrez plusieurs adresses e-mail, séparez-les à l'aide d'une virgule.
    • Facultatif : entrez l'adresse e-mail de l'expéditeur de l'e-mail (par exemple, john@company.com) et le domaine de l'expéditeur.

      Si vous ne spécifiez pas d'adresse e-mail, l'adresse de l'expéditeur est LXCO.<source_identifier>@<smtp_host> par défaut.

      Si vous spécifiez uniquement le domaine de l'expéditeur, le format de l'adresse de l'expéditeur est <LXCO_host_name>@<sender_domain> (par exemple, XClarity1@company.com).

      Remarque
      • Si vous configurez votre serveur SMTP de telle sorte qu'un nom d'hôte est requis pour l'acheminement e-mail et que vous ne configurez pas de nom d'hôte pour XClarity Orchestrator, les événements acheminés seront peut-être rejetés par le serveur SMTP. Si XClarity Orchestrator ne possède pas de nom d'hôte, l'événement est acheminé à l'aide de l'adresse IP. Si l’adresse IP ne peut pas être obtenue, « localhost » est envoyé à la place, ce qui peut entraîner le rejet de l’événement par le serveur SMTP.
      • Si vous spécifiez le domaine de l'expéditeur, la source n'est pas identifiée dans l'adresse de l'expéditeur. En revanche, des informations sur la source de l'événement sont incluses dans le corps de l'e-mail, y compris le nom de système, l'adresse IP, le type/modèle et le numéro de série.
      • Si le serveur SMTP accepte uniquement les e-mails qui ont été envoyés par un utilisateur enregistré, l'adresse d'expéditeur par défaut (LXCO.<source_identifier}@{smtp_host>) est rejetée. Dans ce cas, vous devez indiquer au moins un nom de domaine dans la zone De l'utilisateur.
    • Pour établir une connexion sécurisée au serveur SMTP, sélectionnez l'un des types de connexion suivants.
      • SSL. Utilise le protocole SSL pour établir une communication sécurisée.
      • STARTTLS. Utilise le protocole TLS pour établir une communication sécurisée via un canal non sécurisé.

      Si l'un de ces types de connexion est sélectionné, XClarity Orchestrator tente de télécharger et d'importer le certificat du serveur SMTP dans le fichier de clés certifiées XClarity Orchestrator. Vous êtes invité à accepter ce certificat.

    • Si l'authentification est requise, sélectionnez l'un des types d'authentification suivants.
      • Normal. Effectue l'authentification auprès du serveur SMTP spécifié à l'aide de l'ID utilisateur et du mot de passe spécifiés.
      • OAUTH2. Utilise le protocole SASL (Simple Authentication and Security Layer) pour l’authentification auprès du serveur SMTP spécifié à l’aide du nom d’utilisateur et du jeton de sécurité spécifiés. Généralement, le nom d’utilisateur correspond à l’adresse e-mail.
        Avertissement
        Le jeton de sécurité expire au terme d'un courte période. Il est de votre responsabilité d'actualiser le jeton de sécurité.
      • Aucun. Aucune authentification n'est utilisée.
  7. Cliquez sur Filtres, puis sélectionnez les filtres d’événements que vous souhaitez utiliser pour ce réexpéditeur.

    Vous pouvez sélectionner un filtre d’événements et un filtre de la ressource maximum.

    Si vous ne sélectionnez pas de filtre, les données sont transférées pour tous les événements générés par toutes les ressources (appareils, gestionnaires de ressources et XClarity Orchestrator).

    À partir de cet onglet, vous pouvez également choisir d’acheminer l’événement exclu en définissant Événements exclus sur Oui.

  8. Cliquez sur Listes de contrôle d’accès, puis sélectionnez une ou plusieurs listes de contrôle d’accès que vous souhaitez associer à ce réexpéditeur.

    Si l’accès basé sur les ressources est activé, vous devez sélectionner au moins une liste de contrôle d’accès.

    Conseil
    les utilisateurs qui font partie d’un groupe auquel le rôle Superviseur prédéfini est attribué peuvent, en option, sélectionner Faire correspondre tous les éléments au lieu de sélectionner des listes de contrôle d’accès afin que les données transférées ne soient pas restreintes.
  9. Cliquez sur Créer pour créer le réexpéditeur.

Après avoir terminé

Vous pouvez effectuer les actions suivantes à partir de la carte Réexpéditeurs de données.

  • Activer ou désactiver un réexpéditeur sélectionné en sélectionnant le bouton bascule dans la colonne État
  • Modifier un réexpéditeur sélectionné en cliquant sur l'icône Éditer (Icône Editer).
  • Retirer un réexpéditeur sélectionné en cliquant sur l'icône Supprimer (Icône Supprimer).