Tham chiếu · Tin cậy và xác minh
GET /api/v1/signing-key
Lấy khoá công khai để xác minh, và cách xoay khoá.
Lấy khoá công khai để xác minh phản hồi.
GET /api/v1/signing-key?siteKey=pk_live_...
Vì sao có tham số `siteKey`#
Khoá ký là của từng workspace. Câu trả lời khác nhau tuỳ site, nên phải nói rõ hỏi về site nào.
Phản hồi#
{
"trustedKeys": [
{ "kid": "hg_<ws>_<yyyymm>", "publicKey": "-----BEGIN PUBLIC KEY-----\n..." }
]
}trustedKeys là một mảng, không phải một khoá. Lý do nằm ở phần xoay khoá bên dưới.
Đây là bước khởi tạo, không phải bước xác minh#
Đừng gọi endpoint này trên mỗi lần xác minh. Lấy khoá một lần, lưu lại, và chỉ gọi lại khi gặp một kid bạn chưa biết. Một lần xác minh phụ thuộc vào một lần gọi mạng là một lần xác minh hỏng khi mạng hỏng.
Xoay khoá#
kid có dạng hg_<workspace>_<yyyymm>.
Khi một workspace có khoá riêng đầu tiên, khoá chung của collector vẫn tiếp tục được công bố trong bốn chu kỳ cache. Nhờ vậy việc chuyển sang khoá riêng không cần khởi động lại và không có khoảng thời gian nào phản hồi không xác minh được.
Người ký và tập khoá công bố luôn đổi cùng nhau, nên trang và chữ ký không bao giờ bất đồng.
Khoá riêng được lưu thế nào#
Nửa riêng tư được niêm phong trước khi lưu vào cơ sở dữ liệu, nên một bản dump cơ sở dữ liệu không ký được gì.