← RFC Reference

RFC 8058: Hủy đăng ký Email bằng Một Cú Nhấp Chuột

Tại Sao Tính Năng Này Tồn Tại

List-Unsubscribe header của RFC 2369 có một vấn đề cơ bản: các ứng dụng email không thể an toàn thực hiện hành động trên URL một cách tự động. Một URL HTTPS có thể dẫn đến trang có CAPTCHA, biểu mẫu đăng nhập, bước xác nhận, hoặc thậm chí một trang web độc hại. Các ứng dụng phải mở trình duyệt và để người dùng xử lý — điều này tạo thêm rào cản làm giảm khả năng sử dụng.

RFC 8058 giải quyết vấn đề này bằng cách giới thiệu header List-Unsubscribe-Post. Khi có mặt cùng với URL HTTPS List-Unsubscribe, nó báo hiệu rằng ứng dụng email có thể gửi yêu cầu HTTP POST trực tiếp để hủy đăng ký người dùng — không cần trình duyệt, không cần xác nhận, chỉ một cú nhấp chuột.

Kể từ tháng Hai 2024, Gmail và Yahoo yêu cầu tuân thủ RFC 8058 đối với những người gửi khối lượng lớn (những người gửi hơn 5.000 tin nhắn mỗi ngày cho người dùng của họ). Đây không còn là tùy chọn đối với email thương mại.

Cách Thức Hoạt Động

Cơ chế này yêu cầu hai header cùng hoạt động:

Header Bắt Buộc

List-Unsubscribe: <https://example.com/unsub?id=abc123>,
    <mailto:unsub-abc123@example.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

Khi ứng dụng email thấy cả hai header:

1. Nó hiển thị nút "Hủy đăng ký" nổi bật trong giao diện người dùng.
2. Khi người dùng nhấp vào nó, ứng dụng gửi HTTP POST tới URL HTTPS từ List-Unsubscribe.
3. Phần thân POST chính xác là: List-Unsubscribe=One-Click
4. Máy chủ của người gửi xử lý POST và hủy đăng ký người dùng.

Yêu Cầu HTTP POST

POST /unsub?id=abc123 HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 26

List-Unsubscribe=One-Click

Phản Hồi Của Máy Chủ

Máy chủ nên trả về trạng thái 200 OK để xác nhận hủy đăng ký đã thành công. Bất kỳ phản hồi 2xx nào đều cho biết thành công. Phần thân phản hồi không được hiển thị cho người dùng, do đó nó có thể trống rỗng hoặc chứa một xác nhận đơn giản.

Các Chi Tiết Kỹ Thuật Chính

Yêu Cầu Header

• Giá trị header List-Unsubscribe-Post phải chính xác là List-Unsubscribe=One-Click — không có biến thể.
• Header List-Unsubscribe phải bao gồm ít nhất một URL HTTPS (không phải HTTP). Phần URI mailto là tùy chọn nhưng được khuyến nghị làm dự phòng.
• Cả hai header phải có trên cùng một tin nhắn. List-Unsubscribe-Post mà không có List-Unsubscribe là vô nghĩa.

Yêu Cầu DKIM

Tin nhắn phải vượt qua xác thực DKIM, và chữ ký DKIM phải bao gồm cả header List-Unsubscribe và List-Unsubscribe-Post. Điều này ngăn chặn các kẻ tấn công tiêm hoặc sửa đổi URL hủy đăng ký trong quá trình truyền tải. Gmail kiểm tra điều này một cách rõ ràng.

Triển Khai Endpoint

; Trình xử lý máy chủ tối thiểu (mã giả)
function handleUnsubscribe(request):
    if request.method != "POST":
        return 405 Method Not Allowed

    if request.body != "List-Unsubscribe=One-Click":
        return 400 Bad Request

    subscriberId = request.queryParams["id"]
    suppressRecipient(subscriberId)
    return 200 OK

Ví Dụ Header Tin Nhắn Hoàn Chỉnh

From: newsletter@example.com
To: user@gmail.com
Subject: Your Weekly Update
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; d=example.com; s=sel1;
    h=from:to:subject:list-unsubscribe:list-unsubscribe-post;
    b=...
List-Unsubscribe: <https://example.com/unsub?id=abc123>,
    <mailto:unsub-abc123@example.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Content-Type: text/html; charset=utf-8

Những Lỗi Phổ Biến

• Sử dụng HTTP thay vì HTTPS. URL trong List-Unsubscribe phải sử dụng HTTPS. Các ứng dụng email sẽ không gửi yêu cầu POST tới các endpoint HTTP thường.
• Yêu cầu xác nhận sau POST. Điểm của một cú nhấp chuột là một cú nhấp chuột. Chỉ POST là phải hoàn thành hủy đăng ký. Không gửi email xác nhận yêu cầu người dùng "nhấp để xác nhận" — điều này làm mất ý nghĩa.
• Không bao gồm header trong chữ ký DKIM. Nếu chữ ký DKIM của bạn không bao gồm list-unsubscribe và list-unsubscribe-post trong thẻ h=, Gmail sẽ không tin tưởng các header và sẽ không hiển thị nút một cú nhấp chuột.
• Trả về lỗi hoặc chuyển hướng. Endpoint phải trả về mã trạng thái 2xx. Trả về chuyển hướng 301/302, 403 Forbidden, hoặc lỗi 500 sẽ khiến hủy đăng ký thất bại và có thể kích hoạt người dùng báo cáo thư rác.
• Hết hạn URL. Một số người gửi sử dụng URL được ký có thời hạn hết hạn ngắn. Nếu URL hết hạn trước khi người dùng nhấp vào "Hủy đăng ký" (có thể là vài tuần sau khi nhận tin nhắn), hủy đăng ký sẽ thất bại. Sử dụng mã thông bảo mật có thời gian lâu dài hoặc không hết hạn.
• Hủy đăng ký dựa trên GET. Endpoint phải xử lý POST, không phải GET. URL hủy đăng ký dựa trên GET có thể được kích hoạt bởi các quét liên kết email, bot xem trước, hoặc công cụ bảo mật — hủy đăng ký những người dùng chưa bao giờ nhấp vào bất cứ điều gì.
• Bỏ qua dự phòng mailto. Trong khi URL HTTPS xử lý một cú nhấp chuột, URI mailto: cung cấp dự phòng cho các ứng dụng email không hỗ trợ RFC 8058. Bao gồm cả hai.

Tác Động Đến Khả Năng Gửi

• Yêu cầu bắt buộc từ Gmail/Yahoo. Những người gửi khối lượng lớn (5.000+ tin nhắn/ngày) phải triển khai RFC 8058. Không tuân thủ dẫn đến tăng bộ lọc thư rác và khả năng từ chối. Đây là yêu cầu khả năng gửi có tác động lớn nhất được giới thiệu trong những năm gần đây.
• Giảm khiếu nại về thư rác. Hủy đăng ký một cú nhấp chuột cung cấp một giải pháp thay thế không có rào cản cho "Báo cáo thư rác". Những người dùng có thể dễ dàng từ chối đăng ký không cần phải phàn nàn, trực tiếp hạ tỷ lệ khiếu nại của bạn.
• Tín hiệu danh tiếng tích cực. Hủy đăng ký một cú nhấp chuột được triển khai đúng cách cho các nhà cung cấp hộp thư biết bạn là một người gửi có trách nhiệm tôn trọng tùy chọn người dùng. Điều này góp phần vào danh tiếng người gửi tích cực.
• Trải nghiệm người dùng. Người nhận thấy liên kết "Hủy đăng ký" rõ ràng, nổi bật trong Gmail, Yahoo Mail và Apple Mail. Điều này xây dựng lòng tin — người dùng có khả năng tương tác với email hơn khi họ biết họ có thể dễ dàng ngừng nó.
• Tốc độ xử lý quan trọng. Gmail có thể xác minh rằng endpoint POST thực sự hoạt động bằng cách kiểm tra nó. Nếu endpoint của bạn chậm hoặc không đáng tin cậy, nút một cú nhấp chuột có thể không xuất hiện. Giữ thời gian phản hồi dưới 1 giây.

Related RFCs