Bỏ qua, đến nội dung chính
WisMail

Lấy API token DNS (tự động cấu hình)

Thay vì thêm từng bản ghi thủ công (hướng dẫn DNS thủ công), bạn có thể cấp cho WisMail một API token DNS. Trong Trạng thái, Cài đặt & Sức khỏe, chức năng tự động cấu hình DNS dùng token này để tạo các bản ghi còn thiếu (A, MX, SPF, DKIM, DMARC) tại nhà cung cấp DNS của bạn rồi kiểm tra lại. Hướng dẫn này chỉ cách tạo token chỉ làm được đúng việc đó. Mất khoảng 5 phút.

Token dùng để làm gì

  • Hostname máy chủ (quản trị viên). Quản trị viên máy chủ dùng token để tên máy chủ, ví dụ mail.example.com, có bản ghi A và các bản ghi thư của tên miền chính.
  • Khách hàng thêm tên miền hoặc tên miền con. Khách hàng thêm tên miền riêng (hoặc tên miền con như mail.khachhang.com) tạo token cho đúng vùng đó và WisMail công bố bản ghi cho họ.

Token không phải mật khẩu tài khoản DNS của bạn và không dùng để đăng nhập nhà cung cấp DNS.

Cấp quyền tối thiểu

Chỉ tạo token với quyền sửa bản ghi DNS, giới hạn ở một vùng (tên miền) bạn đang thiết lập. Không dùng khóa API toàn cục, không cấp quyền mọi vùng, thanh toán hay cài đặt tài khoản. Nếu token như vậy bị lộ, người khác chỉ sửa được bản ghi DNS của một tên miền, và bạn xóa token bất cứ lúc nào.

Hai cách dùng token

Chế độ Điều xảy ra Chọn khi
Một lần WisMail chỉ dùng token cho lần thiết lập này và không lưu. Sau đó hãy xóa token tại nhà cung cấp DNS. Bạn chỉ cần thiết lập ban đầu.
Lưu, mã hóa WisMail lưu token đã mã hóa trên máy chủ để sửa bản ghi về sau, ví dụ khi một bản ghi biến mất hoặc khóa DKIM đổi. Bạn có thể gỡ bất cứ lúc nào. Bạn muốn tự sửa lỗi lâu dài.

Nếu chưa chắc, hãy bắt đầu với một lần. Sau này bạn tạo token khác được.

Cloudflare

Cloudflare là nhà cung cấp DNS phổ biến nhất nên đặt trước. Giao diện có thể thay đổi; trang chính thức là nguồn đúng nhất: Create API token (tài liệu Cloudflare).

  1. Đăng nhập dash.cloudflare.com.
  2. Mở menu hồ sơ ở góc trên bên phải, chọn My Profile, rồi API Tokens.
  3. Bấm Create Token.
  4. Ở mẫu Edit zone DNS bấm Use template.
  5. Đặt tên token, ví dụ wismail-dns.
  6. Ở Permissions giữ đúng một dòng: Zone, DNS, Edit.
  7. Ở Zone Resources chọn Include, Specific zone và chọn một tên miền bạn đang thiết lập. Không chọn All zones.
  8. Tùy chọn: đặt TTL (ngày hết hạn) để token tự hết hạn.
  9. Bấm Continue to summary, kiểm tra tóm tắt chỉ có quyền sửa DNS trên một vùng đó, rồi Create Token.
  10. Sao chép token ngay. Cloudflare chỉ hiển thị một lần. Dán vào màn hình thiết lập của WisMail.
  11. Nếu chọn chế độ một lần, sau khi thiết lập xong hãy vào lại My Profile, API Tokens và xóa token (Roll hoặc Delete).

Để thử token trước khi dùng:

curl -s https://api.cloudflare.com/client/v4/user/tokens/verify -H "Authorization: Bearer TOKEN_CUA_BAN"

Token hợp lệ trả về "status":"active".

Nhà cung cấp khác (tóm tắt)

Nguyên tắc giống nhau: token hoặc khóa chỉ sửa được bản ghi DNS của một vùng. Các bước chi tiết cho những nhà cung cấp này sẽ được bổ sung; trong lúc chờ, hãy theo tài liệu của nhà cung cấp và dùng hướng dẫn thủ công nếu nơi đó không giới hạn được token.

  • DigitalOcean. Control Panel, API, Tokens, tạo token với phạm vi tùy chỉnh chỉ cho bản ghi tên miền (đọc và ghi); xem hướng dẫn personal access token của DigitalOcean.
  • Vultr. Account, API: khóa Vultr không giới hạn được theo từng tên miền, nên hãy giới hạn khóa theo IP máy chủ trong danh sách truy cập và xóa sau khi chạy một lần.
  • AWS Route 53. Tạo người dùng hoặc role IAM với chính sách cho phép route53:ChangeResourceRecordSets và route53:ListResourceRecordSets trên ARN của đúng một hosted zone, cộng route53:ListHostedZones; dùng cặp access key của nó.
  • Namecheap. Profile, Tools, API Access: khóa áp dụng cho cả tài khoản và cần IP máy chủ trong danh sách cho phép. Nếu muốn quyền tối thiểu, hãy dùng hướng dẫn DNS thủ công.

Khi có lỗi

  • Token bị từ chối. Sao chép lại, không có khoảng trắng, và kiểm tra token chưa hết hạn và vùng khớp tên miền.
  • Bản ghi không được tạo. Token thiếu quyền sửa DNS trên vùng đó, hoặc name server của tên miền ở nhà cung cấp khác.
  • Đã tạo nhưng vẫn đỏ trong Cài đặt & Sức khỏe. DNS cần thời gian cập nhật; bấm Chạy lại mọi kiểm tra sau vài phút. PTR không nằm trong chức năng này: nó đặt tại nhà cung cấp VPS hoặc IP (hướng dẫn DNS thủ công).

Bước tiếp theo