Kết nối HostRepute

Tích hợp HostRepute kết nối một không gian làm việc với HostRepute, dịch vụ theo dõi uy tín email do chính đội ngũ phát triển ReputeCast xây dựng. Sau khi kết nối, HostRepute kiểm tra tên miền gửi thư và IP của bạn trên 84 danh sách chặn mỗi giờ, đồng thời đưa dữ liệu Google Postmaster Tools, Microsoft SNDS và báo cáo DMARC vào Khả năng vào hộp thư và Độ sẵn sàng gửi. Việc kết nối là không bắt buộc: mọi tính năng của ReputeCast đều hoạt động khi không có tích hợp HostRepute, với kiểm tra có sẵn thay thế.

Những gì được chia sẻ và những gì bạn nhận được

HostRepute là một dịch vụ riêng, có tài khoản và gói dịch vụ riêng. ReputeCast chỉ gửi cho HostRepute những gì cần để giám sát:

Gửi đến HostRepute	Không bao giờ gửi
Tên miền gửi thư và tên miền tổ chức của chúng	Liên hệ hay bất kỳ dữ liệu cá nhân nào
IP gửi thư riêng	Nội dung email, tiêu đề hay mẫu
Tên máy chủ của máy chủ tự triển khai, chỉ khi có người chọn Thêm vào giám sát	Báo cáo chiến dịch, sự kiện hay số liệu thống kê

Đổi lại, không gian làm việc nhận được:

• Tình trạng danh sách chặn từ 84 nguồn, kiểm tra mỗi giờ thay vì 8 nguồn mỗi ngày một lần, kèm lịch sử bị liệt kê và các yêu cầu gỡ khỏi danh sách mà bạn gửi ngay từ ReputeCast.
• Dữ liệu Google Postmaster Tools cho tên miền gửi thư của bạn (uy tín tên miền và IP, tỷ lệ spam, xác thực, chiến dịch bị gắn cờ) và dữ liệu Microsoft SNDS cho IP riêng của bạn (kết quả bộ lọc, tỷ lệ khiếu nại, lượt dính bẫy spam).
• Tóm tắt báo cáo tổng hợp DMARC (xem Đọc báo cáo tổng hợp DMARC).
• Cảnh báo khi bị liệt kê mới, khi được gỡ khỏi danh sách và khi uy tín giảm, gửi dưới dạng thông báo ReputeCast cho các thành viên xem được Khả năng vào hộp thư.

Trước khi bắt đầu

• Bạn cần quyền integrations:hostrepute. Chủ sở hữu và Quản trị viên có quyền này.
• Bạn cần một tài khoản và một nhóm (team) HostRepute. Gói HostRepute của bạn quy định nhóm giám sát được bao nhiêu tài sản; đó là giới hạn của HostRepute, và không có gì trong ReputeCast phụ thuộc vào giới hạn này.
• URL công khai của hệ thống phải mở được trong trình duyệt của bạn, vì HostRepute đưa bạn quay lại <public URL>/api/v1/integrations/hostrepute/callback sau khi bạn phê duyệt. Người vận hành đặt URL này bằng http.public_url (Tham chiếu cấu hình).

Kết nối với HostRepute

1. Mở Cài đặt › , rồi Tích hợp › , rồi HostRepute, hoặc chọn Kết nối HostRepute trên trang Khả năng vào hộp thư.

2. Đọc danh sách những gì được chia sẻ và những gì nhận về, rồi chọn Kết nối với HostRepute.

3. Đăng nhập HostRepute và phê duyệt yêu cầu cho các phạm vi (scope) monitor:read, alerts:read và assets:write. Yêu cầu hết hạn sau 15 phút.

4. Khi bạn quay lại ReputeCast, trang hiện tên nhóm HostRepute bạn đã kết nối và bắt đầu lần đồng bộ đầu tiên, mất khoảng một phút. Các tài sản HostRepute chưa giám sát được liệt kê dưới dạng đề xuất; chọn Thêm vào giám sát cho từng tài sản bạn muốn kiểm tra.

Chỉ người đã bắt đầu kết nối mới hoàn tất được kết nối đó. Việc đăng nhập dùng OAuth 2 với PKCE và một state chỉ dùng một lần, và các token được lưu mã hóa bằng khóa bí mật của hệ thống; API không bao giờ trả chúng về.

Kết nối bằng khóa API

Hãy dùng khóa API khi trình duyệt không thể mở HostRepute rồi quay lại, ví dụ trên một hệ thống không có URL công khai.

1. Trong HostRepute, tạo một khóa API với các phạm vi monitor:read, alerts:read và assets:write.

2. Trong ReputeCast, mở trang kết nối như trên và chọn Dùng khóa API thay thế.

3. Dán khóa (bắt đầu bằng hr_live_) và chọn Kết nối. ReputeCast kiểm tra khóa với HostRepute trước khi lưu.

Khóa là chỉ ghi: bạn có thể thay khóa nhưng không bao giờ đọc lại được. ReputeCast không thể thu hồi khóa API. Khi bạn ngắt kết nối, ReputeCast xóa khóa khỏi hệ thống, còn việc thu hồi khóa bạn làm trong HostRepute.

Kiểm tra kết quả

• Cài đặt › , rồi Tích hợp › , rồi HostRepute hiện nhóm đã kết nối, các phạm vi được cấp, các tài sản HostRepute đang giám sát và thời điểm đồng bộ gần nhất.
• Phần đầu trang Khả năng vào hộp thư cho biết HostRepute đã được kết nối với kiểm tra mỗi giờ, và bảng danh sách chặn liệt kê 84 nguồn.
• Để lấy dữ liệu mới ngay, chọn Đồng bộ ngay. Nếu không, ReputeCast đồng bộ mỗi giờ.

Thiết lập	Mặc định	Cách thay đổi
Kiểm tra danh sách chặn có sẵn	8 lists (Spamhaus ZEN, Spamhaus DBL, SURBL, URIBL, Barracuda BRBL, SpamCop, Mailspike, PSBL), daily, for sending domains and dedicated IPs	Chạy mọi kiểm tra ngay; bỏ qua khi một kết nối HostRepute ổn định đang cung cấp kết quả
Chạy mọi kiểm tra ngay	At most once a minute	Cố định
Thời gian chờ tra cứu DNS	4 s	Cấu hình dns.timeout; trình phân giải đặt trong dns.servers
Tải lên báo cáo tổng hợp DMARC	XML, .xml.gz or .zip, up to 20 MiB compressed and uncompressed	Cố định (cần quyền domains:manage)
Đồng bộ HostRepute	Hourly per connected workspace; failed syncs retry hourly and the built-in checks run meanwhile	Cố định
Lịch sử đọc từ HostRepute	Google Postmaster 30 days, Microsoft SNDS 30 days, DMARC 7 days	Cố định
Thời gian để phê duyệt kết nối trong HostRepute	15 minutes	Cố định
Dòng thời gian sự cố	Last 45 days, latest 8 items	Cố định

Khi không kết nối được HostRepute

• Không kết nối được HostRepute. ReputeCast tiếp tục hiển thị dữ liệu gần nhất, đánh dấu là đã cũ, thử lại mỗi giờ và chạy kiểm tra danh sách chặn có sẵn làm phương án dự phòng. Độ sẵn sàng gửi đánh dấu các kiểm tra danh sách chặn là Không rõ thay vì cho đạt; khi một yêu cầu đến HostRepute hết thời gian chờ trong lúc kiểm tra, bạn có thể chọn Tiếp tục chỉ với dữ liệu nhà cung cấp, thao tác này ghi các kiểm tra bị bỏ qua vào nhật ký kiểm tra và chạy lại chúng trong lúc gửi.
• Token đã bị thu hồi hoặc hết hạn. Kết nối cho biết cần kết nối lại, các thành viên có quyền integrations:hostrepute nhận được thông báo, và kiểm tra có sẵn tiếp quản. Độ sẵn sàng gửi hiện kiểm tra uy tín là Không rõ, không bao giờ là Chặn. Chọn Kết nối lại với HostRepute để khôi phục.

Những gì dừng lại khi bạn ngắt kết nối

Ngắt kết nối thu hồi các token OAuth và xóa dữ liệu đến từ HostRepute: kết quả danh sách chặn từ 84 nguồn, các bảng Postmaster Tools, SNDS và DMARC, và cảnh báo HostRepute. Kiểm tra có sẵn bắt đầu chạy ngay, và mọi tính năng khác vẫn hoạt động, gồm tình trạng nhà cung cấp, định tuyến, gửi có bảo vệ và báo cáo. Nhóm HostRepute của bạn vẫn tiếp tục giám sát trên hostrepute.com; không có gì bị xóa ở đó.

Khắc phục sự cố

• “Bạn đã từ chối yêu cầu trên HostRepute.” Chưa có gì được kết nối, hoặc kết nối hiện có vẫn giữ nguyên. Hãy bắt đầu lại và phê duyệt.
• “Lần chuyển này do người khác bắt đầu.” Lần quay về từ OAuth phải trở về đúng người đã bắt đầu. Hãy đăng nhập bằng tài khoản của chính bạn và bắt đầu lại.
• HostRepute không chấp nhận lần phê duyệt. Yêu cầu đã hết hạn sau 15 phút hoặc đã được dùng. Hãy bắt đầu lại.
• Đã đạt giới hạn giám sát. Gói của nhóm HostRepute của bạn đã đầy. Hãy nâng giới hạn trong HostRepute, hoặc đổi một tài sản: ReputeCast đề xuất một tài sản có thể ngừng giám sát, chẳng hạn một tên miền tổ chức, để nhường chỗ cho một tài sản thực sự gửi thư.
• Khóa API bị từ chối. Hãy dán toàn bộ khóa, không có khoảng trắng; khóa bắt đầu bằng hr_live_ và cần đủ cả ba phạm vi.
• Dữ liệu hiện là đã cũ. Không kết nối được HostRepute ở lần đồng bộ gần nhất. Lỗi và thời điểm xảy ra hiện trên trang tích hợp; ReputeCast thử lại mỗi giờ.

Liên quan

• Kiểm tra và gỡ tên khỏi danh sách chặn
• Giám sát tình trạng tên miền và nhà cung cấp
• Độ sẵn sàng gửi: kiểm tra trước khi gửi
• Kết nối các công cụ khác