Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về Apigee X. thông tin
Theo mặc định, cổng thông tin Dịch vụ dành cho nhà phát triển sẽ gửi email để phản hồi một số sự kiện nhất định. Cho ví dụ: khi nhà phát triển mới đăng ký trên cổng thông tin, cổng đó sẽ tự động gửi lời chào mừng gửi email cho nhà phát triển. Hoặc nếu mất mật khẩu, nhà phát triển có thể yêu cầu email kèm mật khẩu tạm thời.
Là nhà cung cấp API, bạn có thể kiểm soát tất cả khía cạnh của email do cổng thông tin tạo ra, bao gồm:
- Định dạng các email tự động do cổng thông tin gửi đi
- Chỉ định máy chủ SMTP được cổng thông tin sử dụng
- Thêm quy tắc để tạo email phản hồi cho các sự kiện trên cổng thông tin
Gửi email từ cổng thông tin trên đám mây
Cấu hình email mặc định cho cổng trên đám mây được triển khai trên Pantheon hoặc Acquia phải chỉ được dùng trong môi trường không sản xuất. Email được gửi từ máy chủ đám mây ẩn danh có thể bị chặn hoặc đánh dấu là spam.
Đối với cổng thông tin phát hành công khai, hãy sử dụng một trong các cách sau để gửi email:
- Sử dụng mô-đun SMTP, định tuyến email tới máy chủ SMTP của công ty bạn như mô tả trong Định cấu hình máy chủ SMTP.
- Sử dụng dịch vụ thư bên ngoài như SendGrid hoặc Amazon SES (Simple Email Service). Cho để biết thêm thông tin, hãy xem:
Gửi email từ một cổng thông tin tại cơ sở hạ tầng riêng
Theo mặc định, thư được gửi bằng PHP mail(). PHP cố gắng gửi email bằng sendmail trên hệ thống cục bộ, có thể là được định cấu hình trong php.ini của PHP .
Đối với các cổng thông tin sản xuất, bạn có thể sử dụng mô-đun SMTP được mô tả dưới đây để gửi email thông qua Máy chủ SMTP hoặc máy chủ công ty.
Định cấu hình máy chủ SMTP
Cổng thông tin dành cho nhà phát triển yêu cầu bạn định cấu hình máy chủ SMTP để gửi thông báo qua email. Người nhận định cấu hình máy chủ SMTP, trước tiên bạn phải bật mô-đun hỗ trợ xác thực SMTP trên trang dành cho nhà phát triển cổng thông tin.
Sau khi bạn định cấu hình máy chủ SMTP, tất cả email do cổng thông tin dành cho nhà phát triển gửi đều sử dụng SMTP máy chủ. Những email này bao gồm email gửi cho nhà phát triển mới, email gửi cho những nhà phát triển đã mất quyền truy cập mật khẩu của mình và email gửi đến nhà phát triển có tài khoản bị chặn.
Cách định cấu hình máy chủ SMTP:
- Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền của quản trị viên hoặc quyền tạo nội dung.
- Chọn Modules (Mô-đun) trong trình đơn quản trị Drupal.
Trang Mô-đun sẽ mở ra. - Bật mô-đun Hỗ trợ xác thực SMTP.
- Lưu cấu hình.
- Sau khi bật mô-đun, hãy chọn Định cấu hình trong mục Xác thực SMTP
Mục hỗ trợ trên trang Mô-đun.
Trang cấu hình Hỗ trợ xác thực SMTP sẽ xuất hiện. - Trong phần Turn this module on or of (Bật hoặc tắt mô-đun này), hãy chọn On (Bật).
- Trong phần cài đặt máy chủ SMTP, hãy nhập thông tin sau:
- Địa chỉ máy chủ SMTP. Ví dụ: đối với máy chủ SMTP thư đi của Gmail, sử dụng smtp.gmail.com.
- Nhập địa chỉ máy chủ SMTP dự phòng (không bắt buộc). Giá trị này không là bắt buộc.
- Nhập cổng SMTP. Giá trị của cổng này có thể khác nhau dựa trên giao thức mã hoá đã chọn. Ví dụ: đối với Gmail, cổng là 465 khi sử dụng SSL và 587 đối với TLS.
- Chọn giao thức mã hóa là Không có, SSL hoặc TLS.
- Trong phần Xác thực SMTP, hãy chỉ định tên người dùng và mật khẩu được sử dụng để xác thực SMTP. Đây phải là tên người dùng và mật khẩu hợp lệ trên máy chủ SMTP.
- Trong phần Tuỳ chọn email, hãy nhập địa chỉ email và tên của người dùng đang tạo nội dung email. Các giá trị này tương ứng với cột "Từ" của bạn.
- Trong phần Gửi email thử nghiệm (không bắt buộc), hãy nhập một địa chỉ email mà cổng sẽ gửi tin nhắn thử nghiệm.
- Lưu cấu hình.
Việc lưu cấu hình sẽ tạo email thử nghiệm và hiển thị mọi cấu hình . Kiểm tra hộp thư đến trong địa chỉ email của thư thử nghiệm để đảm bảo rằng đến. - Chọn Cấu hình > Hệ thống > Thông tin về trang web trong Drupal trình đơn quản trị.
- Trong Chi tiết trang web, hãy đặt Địa chỉ email giống với địa chỉ email
mà bạn đã chỉ định ở Bước 9.
Một số mô-đun Drupal tạo email sử dụng trường này để xác định trường "Từ" địa chỉ của email chứ không phải là giá trị trên trang Hỗ trợ xác thực SMTP. - Lưu cấu hình.
Định cấu hình và định dạng email các thông báo
Bạn có thể định cấu hình các thông báo qua email khác nhau được gửi đi để phản hồi cho chẳng hạn như đăng ký, xoá, chặn và bỏ chặn tài khoản nhà phát triển.
Bạn cũng có thể kiểm soát "Từ" địa chỉ của các email.
Cách thiết lập chế độ thông báo qua email:
- Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền của quản trị viên hoặc quyền tạo nội dung.
- Chọn Cấu hình > Mọi người > Chế độ cài đặt tài khoản trong Drupal trình đơn quản trị. Thao tác này sẽ mở trang Cài đặt tài khoản.
- Chọn loại thông báo qua email trong phần Email trên trang cài đặt Tài khoản. Ví dụ: bạn có thể chọn "Chào mừng (không cần phê duyệt)" để gửi email khi tài khoản nhà phát triển sẽ được phê duyệt tự động trong quá trình đăng ký dành cho nhà phát triển.
- Chỉnh sửa Tiêu đề và Nội dung của thông báo qua email.
Đặt con trỏ vào một trường, chẳng hạn như Tiêu đề, sau đó chọn Đường liên kết Duyệt qua các mã thông báo hiện có ở cuối biểu mẫu để xem danh sách mã thông báo mà bạn có thể sử dụng trong trường này. Một cửa sổ bật lên sẽ xuất hiện cho phép bạn chọn một mã thông báo để thêm, chẳng hạn như dưới tên [user:name], tương ứng với tên người dùng của nhà phát triển. - Nhấp vào Lưu cấu hình.
Bạn cũng có thể thay đổi "Từ" tên và địa chỉ trong thông báo qua email.
Để thay đổi "Từ" tên và địa chỉ:
- Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền của quản trị viên hoặc quyền tạo nội dung.
- Chọn Cấu hình > Hệ thống > Hỗ trợ xác thực SMTP trong Trình đơn quản trị Drupal. Thao tác này sẽ mở trang Hỗ trợ xác thực SMTP.
- Chỉ định "Từ" địa chỉ email trong trường Địa chỉ gửi email.
- Chỉ định "Từ" trong trường Tên từ email.
- Nhấp vào Lưu cấu hình.
- Chọn Cấu hình > Hệ thống > Thông tin trang web trong Drupal trình đơn quản trị.
- Chỉ định chính địa chỉ email mà bạn đã sử dụng ở Bước 3 trong trường Địa chỉ email.
- Nhấp vào Lưu cấu hình.
Tạo email khi sự kiện xảy ra
Một cách sử dụng phổ biến quy tắc là tạo email phản hồi cho một sự kiện. Cổng thông tin được tích hợp để hỗ trợ tạo email cho các sự kiện được xác định trước, chẳng hạn như khi nhà phát triển mới đăng ký tài khoản. Tuy nhiên, bạn có thể thêm các quy tắc của riêng mình để tạo email. Ví dụ: bạn có thể tạo email khi nhà phát triển thêm, xoá hoặc sửa đổi ứng dụng.
Phần này có ví dụ về cách tạo quy tắc để tạo email khi một nhà phát triển đăng ký một ứng dụng. Hãy sửa đổi quy trình này nếu cần để tạo email cho các sự kiện khác.
Cách tạo email khi nhà phát triển tạo ứng dụng:
- Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền của quản trị viên hoặc quyền tạo nội dung.
- Chọn Modules (Mô-đun) trong trình đơn quản trị Drupal.
- Đảm bảo rằng bạn đã bật mô-đun Rules UI (Giao diện người dùng quy tắc).
- Chọn Cấu hình > Quy trình công việc > Các quy tắc trong trang quản trị Drupal . Thao tác này sẽ mở ra trang Quy tắc.
- Chọn nút Thêm quy tắc mới.
- Trên trang quy tắc mới, hãy chỉ định:
- Tên quy tắc, ví dụ: "Gửi quy tắc email".
- Nếu muốn, hãy chỉ định bất kỳ thẻ nào dùng để phân loại quy tắc cho tìm kiếm.
- Trong trình đơn thả xuống React on event (Phản hồi khi sự kiện), hãy chọn Devconnect > Sau khi tạo của một ứng dụng của nhà phát triển.
- Lưu quy tắc này.
Khi lưu quy tắc, biểu mẫu Chỉnh sửa quy tắc sẽ mở ra với 3 ngăn: Sự kiện (mà bạn vừa tạo), điều kiện và Hành động. - Trong phần Thao tác, hãy chọn Thêm hành động.
- Trong trình đơn thả xuống Select the Action to Add (Chọn hành động cần thêm), hãy chọn System (Hệ thống) >
gửi thư.
Lựa chọn này sẽ mở ra một trang cho phép bạn định dạng email. Sử dụng biểu mẫu này để chỉ định "Đến", "Tiêu đề", "Thư" và các trường khác của email.
Mở rộng đường liên kết đến các mẫu Thay thế bên dưới mỗi trường để xem danh sách mà bạn có thể sử dụng trong trường. Ví dụ: nếu bạn mở rộng Mẫu thay thế trong trường Đến, bạn sẽ thấy danh sách các mẫu bao gồm [app:developer]. Nếu bạn chỉ định thông tin này trong trường Đến, email sẽ được gửi đến người tạo ứng dụng. - Thiết lập các trường như sau:
- Chọn Lưu để quay lại trang chỉnh sửa quy tắc.
- Chọn Lưu thay đổi.
Kiểm tra quy tắc này bằng cách thêm một ứng dụng mới trên cổng thông tin. Bạn sẽ nhận được thông báo qua email trong câu trả lời xuất hiện như dưới đây:
Subject: App test email app created App: test email app API products: PremiumWeatherAPI, weatherapikey-Product Created at: Mon, 01/27/2014 - 10:16