Aller au contenu principal

Acheminement des événements vers un service Web SMTP Gmail

Vous pouvez configurer Lenovo XClarity Orchestrator pour acheminer des événements vers un service de messagerie Web, par exemple, Gmail.

Servez-vous des exemples de configuration suivants pour vous aider à configurer votre système d'acheminement d'événement avec le service SMTP Gmail.

Remarque
Gmail recommande d'utiliser la méthode d'authentification OAUTH2 pour obtenir la communication la plus sécurisée qui soit. Si vous choisissez d'utiliser une authentification normale, vous recevez un e-mail indiquant qu'une application a tenté d'utiliser votre compte sans utiliser les dernières normes de sécurité. Cet e-mail contient des instructions vous permettant de configurer votre compte de messagerie afin d'accepter ces types d'application.

Pour plus d'informations sur la configuration d'un serveur SMTP Gmail, voir https://support.google.com/a/answer/176600?hl=en.

Authentification normale à l'aide de SSL sur le port 465

Cet exemple communique avec le serveur SMTP Gmail à l'aide du protocole SSL sur le port 465 et procède à l'authentification à l'aide d'un compte utilisateur et d'un mot de passe Gmail valides.

ParamètreValeur
Hôtesmtp.gmail.com
Port465
SSLSélectionner
STARTTLSEffacer
AuthentificationNormale
UtilisateurAdresse e-mail Gmail valide
Mot de passeMot de passe d'authentification SMTP Gmail
Depuis l'adresse(facultatif).

Authentification normale à l'aide de TLS sur le port 587

Cet exemple communique avec le serveur SMTP Gmail à l'aide du protocole TLS sur le port 587 et procède à l'authentification à l'aide d'un compte utilisateur et d'un mot de passe Gmail valides.

ParamètreValeur
Hôtesmtp.gmail.com
Port587
SSLEffacer
STARTTLSSélectionner
AuthentificationNormale
UtilisateurAdresse e-mail Gmail valide
Mot de passeMot de passe d'authentification SMTP Gmail
Depuis l'adresse(facultatif).

Authentification OAUTH2 à l'aide de TLS sur le port 587

Cet exemple communique avec le serveur SMTP Gmail à l'aide du protocole TLS sur le port 587 et procède à l'authentification à l'aide d'un compte utilisateur et d'un jeton de sécurité Gmail valides.

Utilisez l'exemple de procédure suivant pour obtenir le jeton de sécurité :

  1. Créez un projet dans la console des développeurs Google et récupérez l'ID client et le secret client. Pour plus d'informations, voir le site Web Page Web Connexion Google pour les sites Web.
    1. À partir d'un navigateur Web, ouvrez la Page Web API Google.
    2. Cliquez sur Select a project > Create a project dans le menu qui apparaît sur cette page Web. La boîte de dialogue New Project s'affiche.
    3. Tapez un nom, sélectionnez Yes pour accepter les dispositions du contrat de licence, puis cliquez sur Create.
    4. Sur l’onglet Présentation, tapez « gmail » dans la zone de recherche.

      Cliquez sur GMAIL API dans les résultats de la recherche.

    5. Cliquez sur Enable.
    6. Cliquez sur l'onglet Données d'identification.
    7. Cliquez sur Écran d'accord OAuth.
    8. Tapez un nom dans la zone Nom de produit affiché pour les utilisateurs, puis cliquez sur Save.
    9. Cliquez sur Create credentials > OAuth client ID.
    10. Sélectionnez Other et entrez un nom.
    11. Cliquez sur Créer. La boîte de dialogue OAuth client s'affiche avec votre ID client et votre secret client.
    12. Enregistrez l'ID client et le secret client afin de les utiliser ultérieurement.
    13. Cliquez sur OK pour fermer la boîte de dialogue.
  2. Utilisez le script Python oauth2.py pour générer et autoriser un jeton de sécurité en entrant l'ID client et le secret client générés lors de la création du projet.
    Remarque
    Python 2.7 est requis pour exécuter cette étape. Vous pouvez télécharger et installer Python 2.7 à partir du Site Web Python.
    1. À partir d'un navigateur Web, ouvrez la Page Web gmail-oauth2-tools.
    2. Cliquez sur Brut, puis enregistrez le contenu sous le nom de fichier oauth2.py sur votre système local.
    3. Exécutez la commande suivante dans une fenêtre de terminal (Linux) ou sur une ligne de commande (Windows).
      py oauth2.py --user={your_email> --client_id={client_id} 
      --client_secret={client_secret} --generate_oauth2_token

      Par exemple

      py oauth2.py --user=jon@gmail.com 
      --client_id=884243132302-458elfqjiebpuvdmvdackp6elip8kl63.apps.googleusercontent.com
      --client_secret=3tnyXgEiBIbT2m00zqnlTszk --generate_oauth2_token

      Cette commande renvoie une URL que vous devez utiliser pour autoriser le jeton et extraire un code de vérification à partir du site Web Google, par exemple :

      To authorize token, visit this url and follow the directions:

      https://accounts.google.com/o/oauth2/auth?client_id=884243132302
      -458elfqjiebpuvdmvdackp6elip8kl63.apps.googleusercontent.com&redirect_uri=
      urn%3Aietf%3Awg%3Aoauth%3A2.0%3Aoob&response_type=code&scope=https%3A%2F%2Fmail.
      google.com%2F

      Enter verification code:

    4. À partir d'un navigateur Web, ouvrez l'URL qui a été renvoyée au cours de l'étape précédente.
    5. Cliquez sur Allow pour accepter les conditions d'utilisation de ce service. Un code de vérification est renvoyé.
    6. Entrez le code de vérification dans la commande oauth2.py.

      La commande renvoie le jeton de sécurité et actualise le jeton, par exemple :

      Refresh Token: 1/K8lPGx6UQQajj7tQGYKq8mVG8lVvGIVzHqzxFIMeYEQMEudVrK5jSpoR30zcRFq6
      Access Token: ya29.CjHXAsyoH9GuCZutgIOxm1SGSqKrUkjIoH14SGMnljZ6rwp3gZmK7SrGDPCQx_KN-34f
      Access Token Expiration Seconds: 3600

      Important
      Le jeton de sécurité expire au terme d'une période définie. Vous pouvez utiliser le script Python oauth2.py et le jeton actualisé pour générer un nouveau jeton de sécurité. Il est de votre responsabilité de générer le nouveau jeton de sécurité et de mettre à jour le système d'acheminement d'événement dans Lenovo XClarity Orchestrator avec le nouveau jeton.
  3. Dans l'interface Web Lenovo XClarity Orchestrator, configurez le système d'acheminement d'événement pour un service de messagerie à l'aide des attributs suivants.
    ParamètreValeur
    Hôtesmtp.gmail.com
    Port587
    SSLEffacer
    STARTTLSSélectionner
    AuthentificationOAUTH2
    UtilisateurAdresse e-mail Gmail valide
    JetonJeton de sécurité
    Depuis l'adresse(facultatif).