Trường tùy biến (Cài đặt → Trường tùy biến)
Quản trị viên khai báo tối đa 20 trường; mọi vai trò xem được. Mỗi trường có:
| Thuộc tính | Ý nghĩa |
|---|---|
| Tên hiển thị | Hiện trên dashboard, cột CSV |
| Mã | a-z, 0-9, _, bắt đầu bằng chữ, tối đa 32 ký tự. Không đổi được sau khi tạo: giá trị trên chứng chỉ lưu theo mã |
| Kiểu | Văn bản, Số, Ngày (YYYY-MM-DD), Email, Danh sách chọn (1–50 giá trị) |
| Bắt buộc | Khi sửa một chứng chỉ có trường tùy biến, trường bắt buộc phải có giá trị |
| Cột trong danh sách | Hiện thành cột trong Chứng chỉ SSL/TLS |
Nhập giá trị ở mục Quản lý trong chi tiết chứng chỉ (vai trò Vận hành trở lên). Giá trị được kiểm theo kiểu (số, ngày, email, giá trị có trong danh sách chọn), tối đa 200 ký tự. Xóa một trường khỏi khai báo không xóa giá trị đã nhập: giá trị chỉ ẩn đi, thêm lại trường cùng mã thì hiện lại. Trường đang dùng trong điều kiện của một nhóm động thì không xóa được.
Giá trị trường tùy biến có trong ô tìm kiếm của danh sách chứng chỉ và trong file Xuất CSV (mỗi trường một cột).
Sửa hàng loạt
Trong Chứng chỉ SSL/TLS hoặc Chứng thư số, tích ô đầu dòng (hoặc ô ở tiêu đề để chọn cả trang) rồi bấm Sửa hàng loạt. Chỉ các ô đã điền được ghi; ô để trống giữ nguyên giá trị của từng chứng chỉ. Sửa được nhãn, người phụ trách, ứng dụng, môi trường, mức quan trọng, phơi nhiễm và trường tùy biến; tối đa 500 chứng chỉ mỗi lần. Giá trị sai thì không chứng chỉ nào bị ghi.
Các giá trị đặt trên dashboard (nhãn, người phụ trách, ứng dụng, môi trường, mức quan trọng, phơi nhiễm, trường tùy biến) được giữ nguyên khi chứng chỉ được quét lại hoặc agent báo lại.
Nhóm chứng chỉ (Cài đặt → Nhóm chứng chỉ)
| Loại | Thành viên |
|---|---|
| Động | Mọi chứng chỉ khớp điều kiện, kể cả chứng chỉ tìm thấy sau này. Tối đa 10 điều kiện, kết hợp khớp mọi điều kiện hoặc khớp một trong các điều kiện |
| Tĩnh | Chọn tay: trong danh sách chứng chỉ, tích các dòng rồi bấm Thêm vào nhóm (thêm hoặc bỏ). Tối đa 5000 chứng chỉ |
Điều kiện của nhóm động gồm trường, phép so sánh và giá trị, không phân biệt hoa thường:
| Trường | Giá trị |
|---|---|
| Nhãn, Người phụ trách, Dịch vụ, CA phát hành | Theo chứng chỉ |
| Tên miền | Tên chung (CN) và mọi SAN |
| Môi trường | Mã môi trường của chính sách (đặt trên chứng chỉ hoặc tự nhận) |
| Nguồn phát hiện | scan, ct, agent, upload, netscan, store |
| Loại chứng chỉ | tls, signing |
| Trường tùy biến | Giá trị đã nhập |
Phép so sánh: là, không là, chứa, khớp mẫu ( và ?, vd .congty.vn; * khớp cả dấu chấm). Một chứng chỉ có thể thuộc nhiều nhóm.
Nhóm dùng ở:
- Danh sách chứng chỉ: ô chọn nhóm trên thanh lọc; chi tiết chứng chỉ hiện các nhóm chứa nó.
- Bộ lọc kênh cảnh báo: kênh chỉ nhận cảnh báo về chứng chỉ thuộc một trong các nhóm đã chọn (cùng với các điều kiện khác của bộ lọc).
- Báo cáo: chọn nhóm trên trang Báo cáo, và trong lịch gửi email định kỳ.
Nhóm đang được dùng ở bộ lọc kênh hoặc báo cáo định kỳ thì cần bỏ ra trước khi xóa. Tạo, sửa, xóa nhóm và khai báo trường cần vai trò Quản trị; mọi thay đổi ghi vào nhật ký hoạt động.
API
| Method | Đường dẫn | Ghi chú | ||
|---|---|---|---|---|
| GET / PUT | /api/v1/settings/custom-fields | {fields: [{key, label, type, options[], required, list}]}; sửa: Quản trị | ||
| PATCH | /api/v1/certificates/{fingerprint} | Thêm custom: {key: value}; "" xóa giá trị | ||
| PATCH | /api/v1/certificates | Sửa hàng loạt {fingerprints[], label?, owner?, service?, environment?, criticality?, exposure?, custom?} → {updated, not_found}; Vận hành | ||
| GET / POST | /api/v1/groups | Danh sách kèm số chứng chỉ; tạo `{name, description, kind: static\ | dynamic, members[], match: all\ | any, rules[{field, op, value}]}` |
| GET / PUT / DELETE | /api/v1/groups/{id} | Xóa trả 409 khi nhóm đang dùng | ||
| POST | /api/v1/groups/{id}/members | Nhóm tĩnh: {add[], remove[]} | ||
| GET | /api/v1/certificates?group={id} | Lọc theo nhóm; mỗi chứng chỉ có groups[] | ||
| GET | /api/v1/reports/summary?group={id}, /api/v1/reports/certificates.csv?group={id} | Báo cáo theo nhóm (lặp group để chọn nhiều nhóm) |