E-Mail konfigurieren

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Standardmäßig sendet das Entwicklerdienste-Portal E-Mails als Reaktion auf bestimmte Ereignisse. Wenn sich beispielsweise ein neuer Entwickler im Portal registriert, sendet das Portal automatisch eine Begrüßungs-E-Mail an den Entwickler. Wenn der Entwickler sein Passwort verliert, kann er eine E-Mail mit einem temporären Passwort anfordern.

Als API-Anbieter können Sie alle Aspekte der vom Portal generierten E-Mails steuern, darunter:

  • Automatisierte E-Mails formatieren, die über das Portal gesendet werden
  • Vom Portal verwendeten SMTP-Server angeben
  • Regeln zum Generieren von E-Mails als Reaktion auf Ereignisse im Portal hinzufügen

E-Mails über ein cloudbasiertes Portal senden

Die Standard-E-Mail-Konfiguration für ein cloudbasiertes Portal, das in Pantheon oder Acquia bereitgestellt wird, sollte nur in Nicht-Produktionsumgebungen verwendet werden. E-Mails, die von einem anonymen Cloud-Server gesendet werden, werden möglicherweise blockiert oder als Spam markiert.

Verwenden Sie bei Produktionsportalen eine der folgenden Optionen zum Senden von E-Mails:

E-Mails von einem lokalen Portal senden

Standardmäßig werden E-Mails mit der Funktion PHP mail() gesendet. PHP versucht, E-Mails mit Sendmail auf dem lokalen System zu senden, das in der PHP-Datei php.ini konfiguriert werden kann.

Bei Produktionsportalen können Sie das unten beschriebene SMTP-Modul verwenden, um E-Mails über einen SMTP-Server oder einen Unternehmensserver zu senden.

SMTP-Server konfigurieren

Für das Entwicklerportal ist es erforderlich, dass Sie einen SMTP-Server zum Senden von E-Mail-Nachrichten konfigurieren. Zum Konfigurieren des SMTP-Servers müssen Sie zuerst das Modul zur Drupal-SMTP-Authentifizierungsunterstützung im Entwicklerportal aktivieren.

Nachdem Sie den SMTP-Server konfiguriert haben, wird für alle vom Entwicklerportal gesendeten E-Mails der SMTP-Server verwendet. Dazu gehören E-Mails an neue Entwickler, an Entwickler, die ihr Passwort vergessen haben, und an Entwickler mit blockierten Konten.

So konfigurieren Sie den SMTP-Server:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Verwaltungsmenü Module aus.
    Die Seite „Module“ wird geöffnet.
  3. Aktivieren Sie das Modul SMTP-Authentifizierungsunterstützung.
  4. Speichern Sie die Konfiguration.
  5. Nachdem das Modul aktiviert wurde, wählen Sie auf der Seite „Module“ im Eintrag für die SMTP-Authentifizierungsunterstützung die Option Konfigurieren aus.
    Die Konfigurationsseite für die SMTP-Authentifizierungsunterstützung wird angezeigt.
  6. Wählen Sie unter Dieses Modul aktivieren oder deaktivieren die Option An aus.
  7. Geben Sie im Bereich mit den SMTP-Servereinstellungen die folgenden Informationen ein:
    • SMTP-Serveradresse: Verwenden Sie für den ausgehenden SMTP-Server von Gmail beispielsweise smtp.gmail.com.
    • Geben Sie optional die Adresse des Back-up-SMTP-Servers ein. Dieser Wert ist nicht erforderlich.
    • Geben Sie den SMTP-Port ein. Der Wert dieses Ports kann je nach ausgewähltem Verschlüsselungsprotokoll unterschiedlich sein. Für Gmail ist der Port beispielsweise 465 bei Verwendung von SSL und 587 für TLS.
    • Wählen Sie als Verschlüsselungsprotokoll Keines, SSL oder TLS aus.
  8. Geben Sie im Bereich SMTP-Authentifizierung den Nutzernamen und das Passwort für die SMTP-Authentifizierung an. Dabei muss es sich um einen gültigen Nutzernamen und ein gültiges Passwort auf dem SMTP-Server handeln.
  9. Geben Sie unter E-Mail-Optionen die E-Mail-Adresse und den Namen des Nutzers ein, der die E-Mail-Nachricht generiert. Diese Werte entsprechen der Absenderadresse der E-Mail.
  10. Optional können Sie unter Test-E-Mail senden eine E-Mail-Adresse eingeben, an die das Portal eine Testnachricht sendet.
  11. Speichern Sie die Konfiguration.
    Wenn Sie die Konfiguration speichern, wird die Test-E-Mail erstellt und eventuelle Konfigurationsfehler werden angezeigt. Prüfen Sie den Posteingang der E-Mail-Adresse der Testnachricht, um sicherzustellen, dass sie ankommt.
  12. Wählen Sie im Verwaltungsmenü von Drupal Configuration > System > Site Information (Konfiguration > System > Standortinformationen).
  13. Geben Sie unter Standortdetails die E-Mail-Adresse an, die Sie in Schritt 9 angegeben haben.
    Einige Drupal-Module, die E-Mails generieren, verwenden dieses Feld, um die „Von“-Adresse der E-Mail zu bestimmen, und nicht den Wert auf der Seite für die SMTP-Authentifizierungsunterstützung.
  14. Speichern Sie die Konfiguration.

E-Mail-Benachrichtigungen konfigurieren und formatieren

Du kannst verschiedene E-Mail-Benachrichtigungen konfigurieren, die als Reaktion auf bestimmte Aktivitäten wie Registrierung, Löschen, Blockieren und Aufheben der Blockierung von Entwicklerkonten gesendet werden.

Sie können auch die Absenderadresse der E-Mails festlegen.

So konfigurierst du E-Mail-Benachrichtigungen:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Verwaltungsmenü von Drupal Konfiguration > Personen > Kontoeinstellungen. Die Seite „Kontoeinstellungen“ wird geöffnet.
  3. Wählen Sie auf der Einstellungsseite für die Konten im Abschnitt E-Mails einen Benachrichtigungstyp aus. Wenn Sie beispielsweise „Willkommen (keine Genehmigung erforderlich)“ auswählen, erhalten Sie eine E-Mail, wenn das Entwicklerkonto bei der Registrierung als Entwickler automatisch genehmigt wird.

  4. Bearbeiten Sie den Betreff und den Text der E-Mail-Benachrichtigung.
    Platzieren Sie den Cursor in einem Feld wie Betreff und klicken Sie unten im Formular auf den Link Verfügbare Tokens suchen, um die Liste der Tokens aufzurufen, die Sie im Feld verwenden können. Ein Pop-up-Fenster wird angezeigt, in dem Sie ein Token zum Hinzufügen auswählen können, z. B. [user:name], das dem Nutzernamen des Entwicklers entspricht.
  5. Klicken Sie auf Save configuration (Konfiguration speichern).

Sie können den Namen und die Adresse unter „Von“ in einer E-Mail-Benachrichtigung auch ändern.

So ändern Sie den Namen und die Adresse im Feld „Von“:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > System > SMTP-Authentifizierungsunterstützung aus. Die Seite für die SMTP-Authentifizierungsunterstützung wird geöffnet.
  3. Geben Sie im Feld E-Mail-Absenderadresse eine "Von"-E-Mail-Adresse ein.
  4. Geben Sie im Feld E-Mail-Adresse von Name einen Absendernamen ein.
  5. Klicken Sie auf Save configuration (Konfiguration speichern).
  6. Wählen Sie im Verwaltungsmenü von Drupal Configuration > System > Site information (Konfiguration > System > Websiteinformationen).
  7. Geben Sie im Feld E-Mail-Adresse dieselbe E-Mail-Adresse an, die Sie in Schritt 3 verwendet haben.
  8. Klicken Sie auf Save configuration (Konfiguration speichern).

E-Mail generieren, wenn ein Ereignis eintritt

Eine häufige Verwendung von Regeln ist das Generieren von E-Mails als Reaktion auf einen Termin. Das Portal unterstützt das Generieren von E-Mails für vordefinierte Ereignisse, z. B. wenn ein neuer Entwickler ein Konto registriert. Sie können jedoch auch eigene Regeln zum Generieren von E-Mails hinzufügen. Sie können beispielsweise eine E-Mail generieren, wenn der Entwickler eine App hinzufügt, entfernt oder ändert.

Dieser Abschnitt enthält ein Beispiel für die Erstellung einer Regel zum Generieren einer E-Mail, wenn ein Entwickler eine App registriert. Ändern Sie dieses Verfahren nach Bedarf, um E-Mails für andere Ereignisse zu generieren.

So erstellen Sie eine E-Mail, wenn ein Entwickler eine App erstellt:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Verwaltungsmenü Module aus.
  3. Achten Sie darauf, dass das Regel-UI-Modul aktiviert ist.
  4. Wählen Sie im Drupal-Verwaltungsmenü Configuration > Workflow > Rules (Konfiguration > Workflow > Regeln) aus. Die Seite „Regeln“ wird geöffnet.
  5. Wählen Sie die Schaltfläche Neue Regel hinzufügen aus.
  6. Geben Sie auf der Seite „Neue Regeln“ Folgendes an:
    • Den Namen der Regel, z. B. „E-Mail-Regel senden“.
    • Geben Sie optional Tags an, die zum Kategorisieren der Regeln für die Suche verwendet werden.
    • Wählen Sie im Drop-down-Menü Auf Ereignis reagieren die Option „Devconnect“ > „Nach dem Erstellen einer Entwickler-App“ aus.
  7. Speichern Sie die Regel.
    Wenn Sie die Regel speichern, wird das Formular zur Regelbearbeitung mit drei Bereichen geöffnet: Ereignisse (die Sie gerade erstellt haben), Bedingungen und Aktionen.
  8. Wählen Sie unter Aktionen die Option Aktion hinzufügen aus.
  9. Wählen Sie im Drop-down-Menü Wählen Sie die hinzuzufügende Aktion aus die Option System > E-Mail senden aus.
    Dadurch wird eine Seite geöffnet, auf der Sie die E-Mail formatieren können. Verwenden Sie dieses Formular, um „An“, „Betreff“, „Nachricht“ und andere Felder der E-Mail anzugeben.

    Maximieren Sie unter jedem Feld den Link Ersatzmuster, um die Liste der Muster aufzurufen, die Sie im Feld verwenden können. Wenn Sie beispielsweise im Feld „An“ die Option „Ersetzungsmuster“ maximieren, sehen Sie eine Liste mit Mustern, die [app:developer] enthält. Wenn Sie dieses Muster im Feld „An“ angeben, wird die E-Mail an den Ersteller der Anwendung gesendet.
  10. Legen Sie die Felder so fest:
  11. Wählen Sie Speichern aus, um zur Seite für die Regelbearbeitung zurückzukehren.
  12. Wähle Änderungen speichern aus.

Testen Sie die Regel, indem Sie eine neue App im Portal hinzufügen. Als Antwort sollten Sie eine E-Mail-Benachrichtigung erhalten, die in etwa so aussieht:

Subject: App test email app created

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