Konfiguruję pocztę e-mail

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Domyślnie portal usług dla deweloperów wysyła e-maile w odpowiedzi na określone zdarzenia. Jeśli na przykład nowy deweloper zarejestruje się w portalu, automatycznie wyśle do niego e-maila powitalnego. Jeśli deweloper utraci hasło, może też poprosić o e-maila z hasłem tymczasowym.

Jako dostawca interfejsu API masz kontrolę nad wszystkimi aspektami e-maili generowanych przez portal, w tym:

  • Formatowanie automatycznych e-maili wysyłanych przez portal
  • Określanie serwera SMTP używanego przez portal
  • Dodawanie reguł służących do generowania e-maili w odpowiedzi na zdarzenia w portalu

Wysyłanie e-maila z portalu w chmurze

Domyślnej konfiguracji poczty e-mail dla portalu działającego w chmurze wdrożonego w Pantheon lub Acquia należy używać tylko w środowiskach nieprodukcyjnych. E-maile wysyłane z anonimowego serwera w chmurze mogą być blokowane lub oznaczane jako spam.

W przypadku portali produkcyjnych użyj jednej z tych opcji wysyłania e-maili:

Wysyłanie e-maila z portalu lokalnego

Domyślnie poczta jest wysyłana za pomocą funkcji PHP mail(). PHP próbuje wysyłać e-maile za pomocą funkcji sendmail w systemie lokalnym, którą można skonfigurować w pliku php.ini.

W przypadku portali produkcyjnych możesz użyć opisanego poniżej modułu SMTP do wysyłania e-maili przez serwer SMTP lub serwer firmowy.

Konfigurowanie serwera SMTP

Portal dla programistów wymaga skonfigurowania serwera SMTP do wysyłania e-maili. Aby skonfigurować serwer SMTP, musisz najpierw włączyć moduł pomocy uwierzytelniania SMTP w usłudze Drupal w portalu dla programistów.

Gdy skonfigurujesz serwer SMTP, wszystkie e-maile wysyłane z portalu dla programistów będą używać serwera SMTP. Te e-maile obejmują e-maile wysyłane do nowych deweloperów, e-maile wysyłane do deweloperów, którzy utracą hasło, oraz e-maile do deweloperów, których konta są zablokowane.

Aby skonfigurować serwer SMTP:

  1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
  2. W menu administracyjnym Drupal wybierz Modules (Moduły).
    Pojawi się strona Moduły.
  3. Włącz moduł Obsługa uwierzytelniania SMTP.
  4. Zapisz konfigurację.
  5. Po włączeniu modułu wybierz Skonfiguruj we wpisie Obsługa uwierzytelniania SMTP na stronie Moduły.
    Pojawi się strona konfiguracji obsługi uwierzytelniania SMTP.
  6. W sekcji Włącz ten moduł lub > kliknij Włącz.
  7. W obszarze ustawień serwera SMTP wpisz te informacje:
    • Adres serwera SMTP. Na przykład w przypadku wychodzącego serwera SMTP Gmaila użyj smtp.gmail.com.
    • Opcjonalnie wpisz adres zapasowego serwera SMTP. Ta wartość nie jest wymagana.
    • Wpisz Port SMTP. Wartość tego portu może się różnić w zależności od wybranego protokołu szyfrowania. Na przykład w Gmailu port to 465, jeśli używany jest protokół SSL, i 587 w przypadku protokołu TLS.
    • Wybierz protokół szyfrowania Brak, SSL lub TLS.
  8. W obszarze Uwierzytelnianie SMTP podaj nazwę użytkownika i hasło używane do uwierzytelniania SMTP. Musi to być prawidłowa nazwa użytkownika i hasło na serwerze SMTP.
  9. W sekcji Opcje e-mail wpisz adres e-mail i nazwę użytkownika generującego e-maila. Wartości te odpowiadają adresowi „Od” e-maila.
  10. Opcjonalnie w polu Wyślij testową wiadomość e-mail wpisz adres e-mail, na który portal wyśle wiadomość testową.
  11. Zapisz konfigurację.
    Zapisanie konfiguracji spowoduje wygenerowanie testowego e-maila i wyświetlenie wszystkich błędów konfiguracji. Sprawdź skrzynkę odbiorczą adresu e-mail wiadomości testowej, aby upewnić się, że dotrze.
  12. W menu administrowania Drupal wybierz Konfiguracja > System > Informacje o witrynie.
  13. W sekcji Szczegóły witryny wpisz ten sam adres e-mail, który został podany w kroku 9.
    Niektóre moduły Drupal generujące e-maile używają tego pola do określenia adresu „Od” e-maila, a nie wartości na stronie Obsługa uwierzytelniania SMTP.
  14. Zapisz konfigurację.

Konfigurowanie i formatowanie powiadomień e-mail

Możesz skonfigurować różne powiadomienia e-mail, które są wysyłane w odpowiedzi na określone działania, takie jak rejestracja, usunięcie, zablokowanie czy odblokowanie kont dewelopera.

Możesz też kontrolować adres „Od” e-maili.

Aby skonfigurować e-maile z powiadomieniami:

  1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
  2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Ustawienia konta. Otworzy się strona „Ustawienia konta”.
  3. Wybierz typ powiadomienia e-mail w sekcji E-maile na stronie ustawień Konta. Możesz na przykład wybrać opcję „Witamy (nie jest wymagane zatwierdzenie)”, co spowoduje wysłanie e-maila, gdy konto dewelopera zostanie automatycznie zatwierdzone podczas procesu rejestracji.

  4. Zmień temat i treść e-maila z powiadomieniem.
    Umieść kursor w polu, takim jak Temat, a następnie wybierz link Przeglądaj dostępne tokeny u dołu formularza, aby wyświetlić listę tokenów, których możesz użyć w tym polu. Pojawi się wyskakujące okienko, w którym możesz wybrać token do dodania, np. [user:name], który odpowiada nazwie użytkownika dewelopera.
  5. Kliknij Save setup (Zapisz konfigurację).

Możesz też zmienić nazwę i adres w polu „Od” w e-mailu z powiadomieniem.

Aby zmienić nazwę i adres w polu „Od”:

  1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
  2. W menu administrowania Drupal wybierz Konfiguracja > System > Obsługa uwierzytelniania SMTP. Spowoduje to otwarcie strony Obsługa uwierzytelniania SMTP.
  3. W polu Adres e-mail nadawcy podaj adres e-mail w polu „Od”.
  4. W polu Nazwa nadawcy e-maila podaj nazwę nadawcy.
  5. Kliknij Save setup (Zapisz konfigurację).
  6. W menu administrowania Drupal wybierz Konfiguracja > System > Informacje o witrynie.
  7. Podaj ten sam adres e-mail, który został użyty w kroku 3 w polu Adres e-mail.
  8. Kliknij Save setup (Zapisz konfigurację).

generowanie e-maili po wystąpieniu zdarzenia.

Jednym z typowych zastosowań reguł jest generowanie e-maili w odpowiedzi na zdarzenie. Portal ma wbudowaną obsługę generowania e-maili dotyczących wstępnie zdefiniowanych zdarzeń, takich jak zarejestrowanie konta przez nowego dewelopera. Możesz jednak dodać własne reguły generowania e-maili. Możesz na przykład wygenerować e-maila, gdy deweloper doda, usunie lub zmieni aplikację.

Ta sekcja zawiera przykład tworzenia reguły generującej e-maila, gdy deweloper rejestruje aplikację. W razie potrzeby zmień tę procedurę, aby generować e-maile dla innych zdarzeń.

Aby wygenerować e-maila, gdy deweloper utworzy aplikację:

  1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
  2. W menu administracyjnym Drupal wybierz Modules (Moduły).
  3. Upewnij się, że moduł Interfejs reguł jest włączony.
  4. W menu administrowania Drupal wybierz Konfiguracja > Przepływ pracy > Reguły. Otworzy się strona Reguły.
  5. Kliknij przycisk Dodaj nową regułę.
  6. Na stronie nowych reguł określ:
    • Nazwa reguły, na przykład „Wyślij regułę e-mail”.
    • Opcjonalnie określ tagi używane do kategoryzowania reguł wyszukiwania.
    • W menu Reaguj na wydarzenie wybierz Devconnect > Po utworzeniu aplikacji dewelopera.
  7. Zapisz regułę.
    Zapisanie reguły otwiera formularz edycji reguł z 3 panelami: Zdarzenia (właśnie utworzone), Warunki i Działania.
  8. W sekcji Działania wybierz Dodaj działanie.
  9. W menu Wybierz działanie do dodania kliknij System > wyślij pocztę.
    Otworzy się strona, na której możesz sformatować e-maila. Użyj tego formularza, aby określić pola „Do”, „Temat”, „Wiadomość” i inne pola e-maila.

    Rozwiń link Zamiennik pod każdym polem, aby zobaczyć listę wzorców, których możesz użyć w tym polu. Jeśli na przykład rozwiniesz Wzorce zamienników w polu Do, zobaczysz listę wzorców zawierającą ciąg [app:developer]. Jeśli określisz ten wzorzec w polu Do, e-mail zostanie wysłany do twórcy aplikacji.
  10. Ustaw pola w podany niżej sposób:
  11. Wybierz Zapisz, aby wrócić na stronę edytowania reguły.
  12. Kliknij Zapisz zmiany.

Przetestuj regułę, dodając nową aplikację w portalu. W odpowiedzi otrzymasz e-maila z tym powiadomieniem:

Subject: App test email app created

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