Tài liệu › Cấp & gia hạn

Trường tùy biến và nhóm chứng chỉ

Gắn thông tin riêng của tổ chức (hợp đồng, khách hàng, SLA) vào từng chứng chỉ, sửa hàng loạt, và gom chứng chỉ thành nhóm tĩnh hoặc động để lọc cảnh báo, báo cáo và danh sách.

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ểuVăn bản, Số, Ngày (YYYY-MM-DD), Email, Danh sách chọn (1–50 giá trị)
Bắt buộcKhi 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áchHiệ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ạiThành viên
ĐộngMọ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ĩnhChọ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ườngGiá trị
Nhãn, Người phụ trách, Dịch vụ, CA phát hànhTheo chứng chỉ
Tên miềnTên chung (CN) và mọi SAN
Môi trườngMã 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ệnscan, ct, agent, upload, netscan, store
Loại chứng chỉtls, signing
Trường tùy biếnGiá 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ẫnGhi 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/certificatesSửa hàng loạt {fingerprints[], label?, owner?, service?, environment?, criticality?, exposure?, custom?} → {updated, not_found}; Vận hành
GET / POST/api/v1/groupsDanh 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}/membersNhó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)
Cập nhật 13/10/2026Bài này có hữu ích?