Computer >> Hướng Dẫn Máy Tính >  >> Phần Mềm >> Thư Điện Tử

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Nodemailer là một module Node.js cho phép bạn gửi email từ máy chủ một cách dễ dàng. Cho dù bạn muốn giao tiếp với người dùng hay chỉ thông báo cho mình khi có sự cố, email là một lựa chọn phổ biến.

Có nhiều bài viết hướng dẫn sử dụng Nodemailer ở dạng cơ bản, nhưng bài này không phải. Ở đây tôi sẽ trình bày cách phổ biến nhất để gửi email từ backend Node.js bằng Nodemailer và Gmail.

Bắt đầu với Nodemailer

Trước tiên, thiết lập boilerplate Node.js với Express. Kiểm tra Node và npm đã cài đặt:

node -v npm -v

Nếu cả hai hiển thị phiên bản, bạn đã sẵn sàng. Nếu không, hãy cài đặt phần còn thiếu.

Tạo thư mục dự án, ví dụ nodemailerProject:

mkdir nodemailerProject

Vào thư mục và chạy:

npm init

Điều này khởi tạo file package.json.

Cài đặt Express:

npm install express

Mở file entry point (mặc định index.js) và dán mã sau:

const express = require('express')
const app = express()
const port = 3000
app.listen(port, () => {
  console.log(`nodemailerProject is listening at https://localhost:${port}`)
})

index.js

Chạy máy chủ:

node index.js

Cài đặt Nodemailer

Cài đặt Nodemailer:

npm install nodemailer

API của Nodemailer khá đơn giản, yêu cầu:

  1. Tạo đối tượng Transporter
  2. Tạo đối tượng MailOptions
  3. Sử dụng phương thức Transporter.sendMail

Tạo transporter object:

let transporter = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    type: 'OAuth2',
    user: process.env.MAIL_USERNAME,
    pass: process.env.MAIL_PASSWORD,
    clientId: process.env.OAUTH_CLIENTID,
    clientSecret: process.env.OAUTH_CLIENT_SECRET,
    refreshToken: process.env.OAUTH_REFRESH_TOKEN
  }
});
✋ Lưu ý: ngoài user và pass (thông tin đăng nhập Gmail của bạn), ba khóa còn lại cần lấy sau khi thiết lập OAuth.

Gmail có mức bảo mật cao. Có nhiều cách khắc phục, chúng ta chọn cách thiết lập dự án trên Google Cloud Platform để có thông tin xác thực OAuth.

Đọc thêm về phức tạp khi dùng Gmail với Nodemailer tại đây.

Cấu hình Google Cloud Platform

Nếu chưa có tài khoản GCP, hãy tạo. Tạo dự án mới từ menu góc trên bên trái.

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Chọn "New Project":

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Đặt tên dự án (ví dụ: NodemailerProject), vị trí để "No organization".

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Sau vài giây, bạn sẽ thấy màn hình:

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Mở menu điều hướng (ba gạch ngang góc trên trái) và chọn APIs and Services:

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Để dùng Nodemailer với Gmail, cần OAuth2. Nếu không quen, OAuth là giao thức xác thực. Tôi không đi sâu vào chi tiết, nhưng bạn có thể đọc thêm tại đây.

Đầu tiên, cấu hình OAuth Consent Screen:

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Nếu không phải thành viên G-Suite, chỉ có tùy chọn "External" cho User Type.

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Sau khi tạo, điền thông tin ứng dụng (máy chủ của bạn):

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Điền email của bạn vào "User support email" và "Developer contact information". Nhấn "Save and Continue" đến phần Scopes. Bỏ qua phần này, chuyển sang Test Users.

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Thêm bản thân làm user và nhấn "Save and continue".

Cấu hình OAuth Settings

Tạo OAuth credentials cho Nodemailer. Vào tab Credentials, nhấn dấu cộng (➕) "Create Credentials" và chọn OAuth Client ID.

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Chọn "Web Application":

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Trong "Authorized Redirect URIs", thêm OAuth2 Playground (https://developers.google.com/oauthplayground) để lấy refresh token.

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Sau khi tạo, bạn nhận được client id và client secret. Giữ bí mật, không bao giờ công khai.

Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail

Lấy OAuth Refresh Token

Vào OAuth2 Playground. Chúng ta đã phê duyệt URI này trước đó.

  1. Nhấn biểu tượng bánh răng (OAuth2 Configuration), tích "Use your own OAuth2 credentials":
    Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail
  2. Bên trái, cuộn xuống chọn Gmail API v1:
    Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail
  3. Nhấn Authorize APIs.
  4. Đăng nhập Gmail (chọn tài khoản đã thêm làm Test user).
  5. Màn hình cảnh báo ứng dụng chưa được Google xác minh. Nhấn Continue.
    Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail
  6. Cấp quyền cho dự án truy cập Gmail.
    Làm chủ Nodemailer: Gửi email tin cậy từ máy chủ Node.js với Gmail
  7. Quay lại OAuth Playground, thấy authorization code bên trái. Nhấn nút xanh Exchange authorization code for tokens.

Các trường refresh token và access token sẽ được điền.

Quay lại máy chủ

Sau cấu hình, nhập dữ liệu vào transporter. Dùng package dotenv để bảo mật credentials, nhớ thêm .env vào .gitignore.

let transporter = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    type: 'OAuth2',
    user: process.env.MAIL_USERNAME,
    pass: process.env.MAIL_PASSWORD,
    clientId: process.env.OAUTH_CLIENTID,
    clientSecret: process.env.OAUTH_CLIENT_SECRET,
    refreshToken: process.env.OAUTH_REFRESH_TOKEN
  }
});

Tạo mailOptions object:

let mailOptions = {
  from: 'your-email@gmail.com',
  to: 'recipient@gmail.com',
  subject: 'Nodemailer Project',
  text: 'Hi from your nodemailer project'
};

Object này có thể có nhiều trường và nhiều người nhận hơn, nhưng không đi sâu ở đây.

Gửi email:

transporter.sendMail(mailOptions, function(err, data) {
  if (err) {
    console.log("Error " + err);
  } else {
    console.log("Email sent successfully");
  }
});

Chạy ứng dụng, bạn sẽ thấy email mới trong hộp thư đến.

Bài viết lấy cảm hứng từ dự án tôi dùng Nodemailer. Xem thêm tại đây.