Mengonfigurasi email

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X.
info

Secara default, portal Layanan Developer mengirim email untuk merespons peristiwa tertentu. Sebagai Misalnya, saat developer baru mendaftar di portal, portal tersebut akan otomatis mengirimkan respons email kepada pengembang. Atau, jika developer kehilangan sandi, developer dapat meminta email berisi kata sandi sementara.

Sebagai penyedia API, Anda dapat mengontrol semua aspek email yang dibuat oleh portal, termasuk:

  • Memformat email otomatis yang dikirim oleh portal
  • Menentukan server SMTP yang digunakan oleh portal
  • Menambahkan aturan untuk membuat email sebagai respons terhadap peristiwa di portal

Mengirim email dari portal berbasis cloud

Konfigurasi email default untuk portal berbasis cloud yang di-deploy di Pantheon atau Acquia harus hanya digunakan di lingkungan non-produksi. Email yang dikirim dari server {i>cloud<i} anonim mungkin diblokir atau ditandai sebagai spam.

Untuk portal produksi, gunakan salah satu opsi berikut untuk mengirim email:

Mengirim email dari portal lokal

Secara default, email dikirim menggunakan PHP mail(). PHP mencoba mengirim email menggunakan {i>sendmail<i} di sistem lokal, yang dapat dikonfigurasikan pada php.ini PHP .

Untuk portal produksi, Anda dapat menggunakan modul SMTP yang dijelaskan di bawah untuk mengirim email melalui Server SMTP atau server perusahaan.

Mengonfigurasi server SMTP

Portal developer mengharuskan Anda mengonfigurasi server SMTP untuk mengirim pesan email. Kepada mengonfigurasi server SMTP, Anda harus terlebih dahulu mengaktifkan Modul Dukungan Autentikasi SMTP Drupal di developer portal.

Setelah Anda mengonfigurasi server SMTP, semua email yang dikirim oleh portal developer akan menggunakan SMTP server tertentu. Email ini mencakup email yang dikirim ke developer baru, email yang dikirim ke developer yang tidak terdaftar sandi, dan email yang dikirim ke developer yang akunnya diblokir.

Untuk mengonfigurasi server SMTP:

  1. Login ke portal Anda sebagai pengguna dengan hak istimewa admin atau pembuatan konten.
  2. Pilih Modules di menu administrasi Drupal.
    Halaman Modules akan terbuka.
  3. Aktifkan modul Dukungan Autentikasi SMTP.
  4. Simpan konfigurasi.
  5. Setelah modul diaktifkan, pilih Configure di SMTP Authentication Mendukung entri di halaman Module.
    Halaman konfigurasi Dukungan Autentikasi SMTP akan muncul.
  6. Di bagian Turn this module on or off, pilih On.
  7. Di area setelan server SMTP, masukkan informasi berikut:
    • Alamat server SMTP. Misalnya, untuk server SMTP keluar Gmail, gunakan smtp.gmail.com.
    • Secara opsional, masukkan alamat server SMTP cadangan. Nilai ini bukan tidak diperlukan.
    • Masukkan port SMTP. Nilai porta ini dapat berbeda berdasarkan protokol enkripsi yang dipilih. Misalnya, untuk Gmail, port-nya adalah 465 saat menggunakan SSL dan 587 untuk TLS.
    • Pilih protokol enkripsi sebagai Tidak ada, SSL, atau TLS.
  8. Di area SMTP Authentication, tentukan nama pengguna dan sandi yang digunakan untuk autentikasi SMTP. Nama pengguna dan sandi ini harus valid di server SMTP.
  9. Di bagian Opsi email, masukkan alamat email dan nama pengguna menghasilkan pesan email. Nilai-nilai ini berkaitan dengan kolom "From" alamat email Anda.
  10. Secara opsional, di bagian Send test e-mail message, masukkan alamat email dengan portal mengirimkan pesan uji coba.
  11. Simpan konfigurasi.
    Menyimpan konfigurasi akan membuat pesan email pengujian dan menampilkan konfigurasi apa pun yang sama. Periksa kotak masuk alamat email pesan pengujian untuk memastikan bahwa pesan tersebut tiba.
  12. Pilih Configuration > Sistem > Informasi Situs di Drupal menu administrasi.
  13. Di bagian Site Details, setel alamat E-mail ke alamat email yang sama dengan yang Anda tentukan pada Langkah 9.
    Beberapa modul Drupal yang membuat email menggunakan kolom ini untuk menentukan elemen "Dari" alamat email, dan bukan nilai di laman Dukungan Autentikasi SMTP.
  14. Simpan konfigurasi.

Mengonfigurasi dan memformat email notifikasi

Anda dapat mengkonfigurasi berbagai pemberitahuan email yang dikirim sebagai tanggapan atas aktivitas seperti mendaftarkan, menghapus, memblokir, dan membatalkan pemblokiran akun developer.

Anda juga dapat mengontrol alamat email Anda.

Untuk mengonfigurasi notifikasi email:

  1. Login ke portal Anda sebagai pengguna dengan hak istimewa admin atau pembuatan konten.
  2. Pilih Configuration > Orang > Setelan akun di Drupal menu administrasi. Tindakan ini akan membuka halaman Setelan akun.
  3. Pilih jenis notifikasi email di bagian Email pada halaman setelan Akun. Misalnya, Anda dapat memilih "Selamat datang (tidak perlu persetujuan)", yang akan mengirim email saat akun developer akan disetujui secara otomatis selama proses pendaftaran developer.

  4. Edit Subjek dan Isi notifikasi email.
    Tempatkan kursor pada kolom, seperti Subjek, lalu pilih Tautan Jelajahi token yang tersedia di bagian bawah formulir untuk melihat daftar token yang dapat Anda gunakan di lapangan. Muncul {i>popup<i} yang memungkinkan Anda memilih token yang akan ditambahkan, sebagai [user:name], yang sesuai dengan nama pengguna developer.
  5. Klik Simpan konfigurasi.

Anda juga dapat mengubah di notifikasi email.

Untuk mengubah "Dari" nama dan alamat:

  1. Login ke portal Anda sebagai pengguna dengan hak istimewa admin atau pembuatan konten.
  2. Pilih Configuration > Sistem > Dukungan Autentikasi SMTP di Menu administrasi Drupal. Tindakan ini akan membuka halaman Dukungan Autentikasi SMTP.
  3. Tentukan "Dari" alamat email di kolom E-Mail From Address.
  4. Tentukan "Dari" di kolom E-Mail From Name.
  5. Klik Simpan konfigurasi.
  6. Pilih Configuration > Sistem > Informasi situs di Drupal menu administrasi.
  7. Masukkan alamat email yang sama dengan yang Anda gunakan di Langkah 3 di kolom Alamat Email.
  8. Klik Simpan konfigurasi.

Membuat email saat ada peristiwa

Salah satu penggunaan aturan yang umum adalah membuat email sebagai tanggapan atas suatu peristiwa. Portal ini sudah ada di dalamnya dukungan untuk membuat email bagi peristiwa yang telah ditentukan, seperti saat developer baru mendaftarkan menggunakan akun layanan. Namun, Anda dapat menambahkan aturan sendiri untuk membuat email. Sebagai contoh, Anda dapat membuat email saat developer menambahkan, menghapus, atau mengubah aplikasi.

Bagian ini berisi contoh cara membuat aturan untuk menghasilkan email ketika developer mendaftarkan aplikasi. Ubah prosedur ini seperlunya guna menghasilkan email untuk peristiwa lainnya.

Untuk membuat email saat developer membuat aplikasi:

  1. Login ke portal Anda sebagai pengguna dengan hak istimewa admin atau pembuatan konten.
  2. Pilih Modules di menu administrasi Drupal.
  3. Pastikan modul UI Aturan diaktifkan.
  4. Pilih Configuration > Alur kerja > Aturan dalam administrasi Drupal Google Spreadsheet. Tindakan ini akan membuka halaman Aturan.
  5. Pilih tombol Tambahkan aturan baru.
  6. Di halaman aturan baru, tentukan:
    • Nama aturan, misalnya "Kirim aturan email".
    • (Opsional) Tentukan tag apa pun yang digunakan untuk mengategorikan aturan untuk cari.
    • Di dropdown React on event, pilih Devconnect > Setelah dibuat aplikasi developer.
  7. Simpan aturan.
    Menyimpan aturan akan membuka formulir edit Aturan dengan tiga panel: Events (yang baru saja dibuat), Kondisi, dan Tindakan.
  8. Di bagian Tindakan, pilih Tambahkan tindakan.
  9. Dari dropdown Select the Action to Add, pilih System > kirim email.
    Pilihan ini akan membuka halaman yang memungkinkan Anda memformat email. Gunakan formulir ini untuk menentukan "Kepada", "Subjek", "Pesan", dan kolom lainnya pada email.

    Luaskan link pola Penggantian di bawah setiap kolom untuk melihat daftar yang dapat Anda gunakan di lapangan. Misalnya, jika Anda memperluas Pola penggantian di bagian kolom Kepada, Anda akan melihat daftar pola yang menyertakan [app:developer]. Jika Anda menentukan hal ini di kolom Kepada, email akan dikirim ke pembuat aplikasi.
  10. Tetapkan kolom seperti yang ditunjukkan di bawah ini:
  11. Pilih Simpan untuk kembali ke halaman pengeditan aturan.
  12. Pilih Simpan perubahan.

Uji aturan dengan menambahkan aplikasi baru di portal. Anda akan menerima notifikasi email di respons yang muncul seperti di bawah ini:

Subject: App test email app created

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