Configurer la messagerie

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Par défaut, le portail de services pour les développeurs envoie des e-mails en réponse à certains événements. Pour Par exemple, lorsqu'un nouveau développeur s'inscrit sur le portail, celui-ci envoie automatiquement un message de bienvenue par e-mail au développeur. Si le développeur perd son mot de passe, il peut demander un e-mail avec un mot de passe temporaire.

En tant que fournisseur d'API, vous pouvez contrôler tous les aspects des e-mails générés par le portail, y compris:

  • La mise en forme des e-mails automatisés envoyés par le portail
  • Spécifier le serveur SMTP utilisé par le portail
  • Ajouter des règles pour générer des e-mails en réponse à des événements sur le portail

Envoyer des e-mails depuis un portail dans le cloud

La configuration de messagerie par défaut d'un portail cloud déployé sur Pantheon ou Acquia doit dans des environnements hors production. Les e-mails envoyés depuis un serveur cloud anonyme peuvent être bloqués ou marqués comme spam.

Pour les portails de production, utilisez l'une des options suivantes pour envoyer des e-mails:

Envoyer des e-mails depuis un portail sur site

Par défaut, les messages sont envoyés à l'aide de PHP mail(). PHP tente d'envoyer des e-mails en utilisant sendmail sur le système local, ce qui peut être configuré dans le fichier php.ini de PHP .

Pour les portails de production, vous pouvez utiliser le module SMTP décrit ci-dessous pour envoyer des e-mails via un serveur SMTP ou serveur d'entreprise.

Configuration d'un serveur SMTP

Le portail des développeurs nécessite la configuration d'un serveur SMTP pour envoyer des e-mails. À configurer le serveur SMTP, vous devez d'abord activer le module d'assistance pour l'authentification SMTP Drupal sur le site du développeur portail.

Une fois le serveur SMTP configuré, tous les e-mails envoyés par le portail des développeurs utilisent le protocole Google Cloud. Il peut s'agir d'e-mails envoyés aux nouveaux développeurs ou aux développeurs qui perdent leur mot de passe et les e-mails envoyés aux développeurs dont les comptes sont bloqués.

Pour configurer le serveur SMTP:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez Modules dans le menu d'administration Drupal.
    La page "Modules" s'ouvre.
  3. Activez le module Prise en charge de l'authentification SMTP.
  4. Enregistrez la configuration.
  5. Une fois le module activé, sélectionnez Configurer dans la section Entrée d'assistance sur la page Modules.
    La page de configuration "Prise en charge de l'authentification SMTP" s'affiche.
  6. Sous Activer ou désactiver ce module, sélectionnez Activé.
  7. Dans la zone des paramètres du serveur SMTP, saisissez les informations suivantes: <ph type="x-smartling-placeholder">
      </ph>
    • Adresse du serveur SMTP Par exemple, pour le serveur SMTP sortant Gmail, utilisez smtp.gmail.com.
    • Saisissez éventuellement l'adresse du serveur SMTP de secours. Cette valeur n'est pas obligatoire.
    • Indiquez le port SMTP. La valeur de ce port peut varier au protocole de chiffrement sélectionné. Par exemple, pour Gmail, le port est 465 lorsque SSL et 587 pour TLS.
    • Sélectionnez le protocole de chiffrement Aucun, SSL ou TLS :
  8. Dans la zone Authentification SMTP, indiquez le nom d'utilisateur et le mot de passe utilisés. pour l'authentification SMTP. Il doit s'agir d'un nom d'utilisateur et d'un mot de passe valides sur le serveur SMTP.
  9. Sous Options de messagerie, saisissez l'adresse e-mail et le nom de l'utilisateur. la génération de l'e-mail. Ces valeurs correspondent au champ "De" de l'e-mail.
  10. Sous Envoyer un e-mail test, vous pouvez saisir une adresse e-mail dans laquelle le portail envoie un message de test.
  11. Enregistrez la configuration.
    L'enregistrement de la configuration génère l'e-mail de test et affiche les éventuelles configurations les erreurs. Vérifiez la boîte de réception de l'adresse e-mail du message de test pour vous assurer arrive.
  12. Sélectionnez Configuration > Système > Informations sur le site dans le Drupal d'administration.
  13. Sous Site Details (Détails du site), indiquez la même adresse e-mail que pour que vous avez spécifié à l'étape 9.
    Certains modules Drupal qui génèrent des e-mails utilisent ce champ pour déterminer le champ "De" l'adresse du e-mail, et non la valeur figurant sur la page Prise en charge de l'authentification SMTP.
  14. Enregistrez la configuration.

Configuration et mise en forme des e-mails Notifications

Vous pouvez configurer différentes notifications par e-mail à envoyer en réponse à des telles que l'enregistrement, la suppression, le blocage et le déblocage de comptes de développeur.

Vous pouvez également contrôler le champ "De" l'adresse des e-mails.

Pour configurer les notifications par e-mail:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez Configuration > Personnes > Account settings (Paramètres de compte) dans l'application Drupal d'administration. La page "Paramètres du compte" s'ouvre.
  3. Sélectionnez un type de notification par e-mail dans la section "E-mails" de la page de configuration des comptes. Par exemple, vous pouvez sélectionner "Bienvenue (aucune approbation requise)", qui permet d'envoyer un e-mail lorsque le Le compte de développeur est automatiquement approuvé lors du processus d'inscription en tant que développeur.

  4. Modifiez l'objet et le corps de la notification par e-mail.
    Placez le curseur dans un champ (Objet, par exemple), puis sélectionnez l'icône Parcourir les jetons disponibles en bas du formulaire pour afficher la liste des jetons que vous pouvez utiliser dans le champ. Une fenêtre pop-up s'affiche pour vous permettre de sélectionner un jeton à ajouter, tel que en tant que [user:name], ce qui correspond au nom d'utilisateur du développeur.
  5. Cliquez sur Enregistrer la configuration.

Vous pouvez également modifier le champ "De" dans une notification par e-mail.

Pour modifier le champ "De" nom et adresse:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez Configuration > Système > Prise en charge de l'authentification SMTP dans le Menu d'administration Drupal. La page d'assistance de l'authentification SMTP s'ouvre.
  3. Indiquez le champ "De" dans le champ Adresse e-mail de l'expéditeur.
  4. Indiquez le champ "De" dans le champ Nom de l'expéditeur.
  5. Cliquez sur Enregistrer la configuration.
  6. Sélectionnez Configuration > Système > Informations sur les sites dans le Drupal d'administration.
  7. Indiquez la même adresse e-mail que celle utilisée à l'étape 3 dans le champ Adresse e-mail.
  8. Cliquez sur Enregistrer la configuration.

Générer un e-mail lorsqu'un événement se produit

Les règles sont couramment utilisées pour générer des e-mails en réponse à un événement. Le portail intègre la prise en charge de la génération d'e-mails pour des événements prédéfinis, comme lorsqu'un nouveau développeur enregistre un Google Cloud. Toutefois, vous pouvez ajouter vos propres règles pour générer des e-mails. Par exemple, vous pouvez générer un e-mail lorsque le développeur ajoute, supprime ou modifie une application.

Cette section contient un exemple de création d'une règle permettant de générer un e-mail lorsqu'un développeur enregistre une application. Modifiez cette procédure si nécessaire afin de générer des e-mails pour d'autres événements.

Pour générer un e-mail lorsqu'un développeur crée une application:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez Modules dans le menu d'administration Drupal.
  3. Vérifiez que le module Interface utilisateur des règles est activé.
  4. Sélectionnez Configuration > Flux de travail > Règles dans l'administration Drupal . La page "Règles" s'ouvre.
  5. Sélectionnez le bouton Ajouter une règle.
  6. Sur la page "Nouvelles règles", spécifiez les éléments suivants: <ph type="x-smartling-placeholder">
      </ph>
    • Nom de la règle, par exemple "Envoyer une règle d'e-mail".
    • Vous pouvez également spécifier des tags servant à classer les règles pour recherche.
    • Dans le menu déroulant React on event (Réagir à un événement), sélectionnez Devconnect > Lors de la création d'une application de développeur.
  7. Enregistrez la règle.
    Lorsque vous enregistrez la règle, le formulaire de modification des règles s'affiche à trois volets: Événements (que vous que vous venez de créer), Conditions et Actions.
  8. Sous Actions, sélectionnez Ajouter une action.
  9. Dans le menu déroulant Sélectionnez l'action à ajouter, sélectionnez Système > envoyer un e-mail.
    Cette sélection ouvre une page dans laquelle vous pouvez mettre en forme l'e-mail. Utilisez ce formulaire pour spécifier le champ "À", "Objet", "Message" et autres champs de l'e-mail.

    Développez le lien Motifs de remplacement sous chaque champ pour afficher la liste des des modèles que vous pouvez utiliser sur le terrain. Par exemple, si vous développez Modèles de remplacement sous Dans le champ "À", une liste de formats incluant [app:developer] s'affiche. Si vous indiquez schéma dans le champ "À", l'e-mail est envoyé au créateur de l'application.
  10. Définissez les champs comme indiqué ci-dessous:
  11. Sélectionnez Enregistrer pour revenir à la page de modification de la règle.
  12. Sélectionnez Enregistrer les modifications.

Testez la règle en ajoutant une nouvelle application sur le portail. Vous devriez recevoir une notification par e-mail dans qui s'affiche comme suit:

Subject: App test email app created

App: test email app
API products: PremiumWeatherAPI, weatherapikey-Product
Created at: Mon, 01/27/2014 - 10:16