Quản lý khóa ADI
Định dạng khô hạn, sự sáng tạo dòng chảy, 8 phạm vi cho phép, xe đạp, cách phân tích và thực hành an ninh tốt nhất.
Chìa khóa ARI là thẻ tín dụng duy nhất của anh để nói chuyện với nền tảng mở Braidrun. Mỗi chìa khóa bao gồm một loạt các phạm vi và một khẩu Token. Nếu mất hay bị rò rỉ, tạo vật mới sẽ bị thu hồi ngay lập tức.
Định dạng Token
dyk_<id>_<secret>
例：dyk_a3b9c8d7e6f5a1b2_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789dyk_— Dấu hiệu tiền tố để làm cho git bí mật-canning / log desensidentation công cụ nhận diện<id>— Một mã nhận diện công cộng 16-character cơ sở2, sử dụng như một khóa tra cứu (không nhạy cảm)<secret>— bí mật 32- byte, mã cơ sở 64url (nhật cảm, không có bản ghi/ thông điệp khủng bố được phép tải lên)
Khi tạo ra một khoá API, mẫu gốc Token chỉ được hiển thị một lần trong hộp thoại tạo ra. Sau khi đóng cửa, máy phục vụ chỉ giữ lại con tàu Argon2id hash và không thể xem lại văn bản gốc. Vui lòng sao chép và lưu vào công cụ quản lý chìa khóa (Biểu tượng/Vault/Doppler/GitHub Secrets/etc).
Đã Cập nhật
- Truy cập vào các thiết lập tài khoản giao diện vội vã
- Nhấn "Các phím API mới"
- Hãy ghi tên (để nhận diện), 1 / 10
- Hãy nhắp vào « Phím Quý tộc » để sao chép Token ngay bây giờ
Phạm vị
Phạm vi là sự cho phép tốt — tổng cộng là 8: bạn có thể tự cung cấp cho mình, và CLTER ADMIN chỉ là admin-min. Hãy ban cho càng ít chìa khóa càng tốt; hãy làm theo đặc ân tối thiểu.
| Scope | những gì có thể làm | Kịch bản tiêu biểu |
|---|---|---|
WEBHOOK_TRIGGER | Gây ra móc nối Web tới phím này | GitHub Push làm việc luồng; hệ thống kinh doanh ngược dòng gọi trở lại |
APPROVAL_RESPOND | Chấp thuận hoặc từ chối các bước bằng tay công nhận — bao gồm các bước chấp thuận Webhoook và các điểm phụ kiện v1 (/api/v1/ approvals/ *, bao gồm liệt kê các sự chấp thuận được hoãn lại, đọc chi tiết và gửi đơn chấp thuận đã chỉnh sửa) | Liên kết tán thành một lần bằng email hoặc Slack; hợp nhất với hệ thống chấp thuận bên ngoài |
WORKFLOW_READ | Tên | Hiển thị danh sách workflow hiện thời trên bảng điều khiển bên ngoài |
WORKFLOW_EXECUTE | Khởi động workflow thông qua hệ thống ADI (đang thay thế chế độ mạng) | Sự kết hợp SDK; kiểm tra tự động; tác vụ hàng loạt |
EXECUTION_READ | Truy vấn trạng thái thực hiện / đọc kết quả hoàn chỉnh | Tên |
EXECUTION_CANCEL | Hủy bỏ thực hiện đang chạy | "Dừng lại" nút trên bảng điều khiển/máy phát điện khẩn cấp |
ARTIFACT_READ | Liệt kê các sản phẩm thực hiện/ nhận được liên kết tải về | Tên |
CLUSTER_ADMIN | Chỉ Quản trị: đọc trạng thái cụm và quản lý các chính sách tự động tính. Chỉ có manmins có thể cung cấp nó; khi một không admin tạo ra một khóa, phạm vi này được tự động gỡ bỏ | Dịch vụ tài khoản hoạt động tự lập |
Chu kỳ sống
- tạo — Dịch vụ tự phục vụ; phạm vi + hiệu lực được quyết định bởi bạn
- Dùng — Mỗi cuộc gọi thành công tự động tích lũy sử dụng và cập nhật nhãn thời gian mới nhất.
- Thu hồi — Người dùng có thể nhấn "Revoke" vào trang "API Key" tại bất cứ lúc nào
- Hạn sử dụng — Hết hiệu lực ngay khi đến expiresAt; không cần chủ động thu hồi
Phân tích độ sâu
Đối với mỗi phím, nhấn "Usage" trong bảng "API Key" và một phân tích biểu đồ sẽ xuất hiện:
- Số cuộc gọi tích phân + trong cửa sổ (7/30/90/180 ngày)
- Ngày cao nhất (ngày nào được gọi nhiều nhất)
- Biểu đồ cuộc gọi hàng ngày
- Gọi biểu đồ phân phối kết thúc điểm (Webrok.trigger/work Flu.excut/etc)
- Lần sử dụng cuối cùng
Sử dụng chỉ tính khả năng trả lời thành công (HTTP 2x). Yêu cầu xác thực thất bại/ hạn chế độ cao không được tính.
Những thực hành tốt nhất về an ninh khóa
- Dùng phím độc lập cho mỗi môi trường (sinh sản/ địa chỉ) - chỉ môi trường bị ảnh hưởng sẽ bị thu hồi trong trường hợp có sự cố
- Mỗi tích hợp bên ngoài sử dụng một phím riêng biệt - sử dụng "Usage" để xem sự tích hợp nào đang được sử dụng
- Không bao giờ chịu thua trong kho mã
- Đã cập nhật
- Quan sát rằng thời gian "thường được sử dụng" khác với mong đợi của bạn thu hồi ngay lập tức và kiểm tra các bản ghi
- Chìa khóa đưa ra cho đối tác ngắn hạn phải được đặt để hết hạn tại (chỉ trong vòng 90 ngày)