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

Một chứng chỉ cho nhiều agent

Một agent cấp và gia hạn chứng chỉ, gửi cùng chứng chỉ và khóa riêng cho các agent khác (vùng mạng tách biệt), mã hóa tới từng agent; ghim bắt buộc ở cả hai máy.

Khi nào cần

Một agent đã cài được chứng chỉ lên nhiều máy mà nó với tới: file, IIS, máy khác qua SSH hoặc WinRM, F5, FortiGate, Kubernetes, cloud. Chỉ dùng tính năng này khi các máy nằm ở vùng mạng tách biệt (DMZ, chi nhánh, mạng khách hàng) mà một agent không với tới, và bạn muốn một chứng chỉ (một lần cấp) cho tất cả.

Mỗi chứng chỉ có một agent cấp và tối đa 10 agent nhận. Agent nhận cần phiên bản 0.7.0 trở lên. Có ở gói Pro và Enterprise.

Lưu ý khóa riêng sẽ nằm trên mọi máy nhận: lộ một máy là lộ chứng chỉ ở mọi nơi dùng nó. Nếu nghi lộ, thu hồi tại CA rồi cấp lại.

Cách hoạt động

  1. Agent cấp sinh khóa, xin cấp và gia hạn như chứng chỉ tự động bình thường.
  2. Sau mỗi lần cấp, nó mã hóa chứng chỉ và khóa tới từng agent nhận rồi gửi lên máy chủ Metta. Máy chủ chỉ chuyển gói, không đọc được khóa.
  3. Agent nhận lấy gói ở lần hỏi cấu hình kế tiếp (mỗi phút), kiểm tra gói đúng do agent cấp gửi, khóa khớp chứng chỉ, đúng tên miền, còn hạn, không cũ hơn bản đang cài; rồi cài vào nơi cài của chính nó và báo kết quả.

Hai agent không kết nối trực tiếp với nhau; cả hai chỉ gọi ra máy chủ Metta qua HTTPS như thường lệ.

Ghim: bắt buộc ở cả hai máy

Mỗi agent có một mã ghim (32 ký tự hex, 8 nhóm): xem ở trang Agent, trong trình cài đặt Windows, hoặc bằng lệnh certman-agent key-id trên máy.

MáyThêm vào agent.json (remote_config)Hoặc cờ dòng lệnh
Agent cấp"share_keys_to": ["<mã ghim agent nhận>", …]-share-keys-to
Agent nhận"accept_shared_from": ["<mã ghim agent cấp>"]-accept-shared-from

Trình cài đặt Windows có hai ô tương ứng. Khởi động lại agent sau khi sửa.

Ghim nằm trên máy, không đến từ máy chủ: kể cả khi máy chủ bị chiếm quyền, agent cấp không gửi khóa cho agent lạ và agent nhận không cài chứng chỉ do máy chủ tự tạo. Cài lại agent sinh khóa mới nên mã ghim đổi: ghim lại ở máy bên kia.

Trên dashboard

Cấp tự động → Dùng chung trên chứng chỉ (Quản trị viên):

  • Thêm agent nhận: chọn agent rồi khai báo nơi cài trên agent đó (cùng các loại nơi cài như chứng chỉ tự động).
  • Bảng hiện từng agent nhận: máy cấp và máy nhận đã ghim chưa (chấm xanh/vàng), trạng thái (Chờ agent cấp gửi, Đã gửi, Đã cài, Agent nhận báo lỗi, Máy cấp chưa ghim agent này), lỗi nếu có.
  • Phần Ghim trên các máy có sẵn đoạn cấu hình để sao chép.
  • Gửi lại (Vận hành): yêu cầu agent cấp gửi lại gói.
  • Bỏ: agent đó không nhận các bản gia hạn sau; khóa đã ở trên máy đó vẫn còn.

Trên trang agent nhận, chứng chỉ hiện nhãn Dùng chung, trạng thái và lỗi từng nơi cài như chứng chỉ khác; thu hồi tại CA làm ở agent cấp. Lưu một chứng chỉ tự động có tên miền trùng với chứng chỉ của agent khác thì dashboard nhắc dùng chung.

Mọi thay đổi (thêm, bỏ agent nhận, gửi, cài, từ chối, lỗi) ghi vào nhật ký hoạt động.

API

MethodĐường dẫnGhi chú
POST/PUT/api/v1/auto-certs, /api/v1/auto-certs/{id}Thêm share: [{agent_id, targets[], enabled}] (tối đa 10; đổi: Quản trị viên). Bỏ trường share = giữ nguyên
GET/api/v1/auto-certs/{id}/shareMã ghim agent cấp, trạng thái từng agent nhận
POST/api/v1/auto-certs/{id}/share/resendGửi lại (Vận hành)
Cập nhật 15/10/2026Bài này có hữu ích?