Tài liệu › Kho chứng chỉ (nơi cài)

File: nginx, Apache, HAProxy, Tomcat

Agent ghi chứng chỉ, khóa và chuỗi CA ra file trong thư mục cho phép, rồi chạy lệnh kiểm tra và nạp lại.

Trường ở nơi cài

TrườngVí dụ
Định dạngPEM (cert + chain + key riêng), combined (HAProxy: một file), PKCS#12 (Tomcat/Java)
Đường dẫn chứng chỉ / khóa/etc/nginx/ssl/portal.crt, /etc/nginx/ssl/portal.key
Lệnh kiểm tra cấu hìnhnginx -t
Lệnh nạp lạisystemctl reload nginx
Kiểm tra sau khi cài127.0.0.1:443 (host:port) và tên SNI

Thư mục phải nằm trong allowed_dirs, lệnh phải nằm trong allowed_commands của agent (khớp chính xác).

Cách agent cài

  1. Ghi file mới cạnh file cũ (.new), đặt quyền 600 cho khóa.
  2. Chạy lệnh kiểm tra; lỗi thì dừng, giữ nguyên bản cũ.
  3. Đổi tên file (atomic), chạy lệnh nạp lại.
  4. Kết nối TLS tới địa chỉ kiểm tra; chứng chỉ không khớp hoặc nạp lại lỗi thì khôi phục bản cũ và nạp lại lần nữa.

Agent giữ bản đang dùng và bản trước để quay lui; bản cũ hơn bị xóa.

Tomcat / Java

Chọn định dạng PKCS#12; alias trong keystore là tên chứng chỉ; mật khẩu keystore nhập trên dashboard (mã hóa cho agent). Trong server.xml dùng certificateKeystoreType="PKCS12". Lệnh nạp lại thường là khởi động lại dịch vụ Tomcat.

Windows

Trên Windows, nơi cài dạng file dùng đường dẫn C:\certs\…; lệnh ví dụ iisreset /noforce nếu dùng file cho ứng dụng không phải IIS. Với IIS, dùng Windows store / IIS.

Cập nhật 10/10/2026Bài này có hữu ích?