certmanager
- GET /certificates/_routes
Get the certmanager route manifest
Returns the service name and the list of certmanager routes with their method, path and required permissions.
- Status Codes:
200 OK – service name and routes manifest
- POST /certificates/create
Issue a certificate
Issues a certificate for the requested DNS names through certbot; IP SANs are rejected.
- Request JSON Object:
dns_names[] (string)
ip_addresses[] (string)
- Status Codes:
200 OK – issued certificate and private key PEM
400 Bad Request – invalid body, no DNS names, or IP SANs supplied
500 Internal Server Error – cert manager not initialized or issuance failed
- Response JSON Object:
certificate_pem (string)
private_key_pem (string)
- GET /certificates/dashboard
Get the certificate dashboard
Collects certificates from this node and configured remote nodes, applies search and filters, and returns a summary with one page of results.
- Query Parameters:
page (integer) – page number, 1-based (default 1)
page_size (integer) – page size, 1 to 100 (default 10)
search (string) – search text
status (string) – status filter: valid, expiring or expired
type (string) – certificate type filter
service (string) – service name filter
algorithm (string) – key algorithm filter
- Status Codes:
200 OK – summary and paginated certificates
500 Internal Server Error – certificate collection failed
- Response JSON Object:
certificates[].algo_bits (string) – “2048-bit”, “256-bit”, etc
certificates[].algorithm (string) – “RSA-2048”, “ECDSA-256”, “RSA-4096”
certificates[].cns[] (string)
certificates[].days_left (integer)
certificates[].expiration (string) – ISO format date
certificates[].fingerprint (string) – SHA256 fingerprint
certificates[].issuer_ca (string)
certificates[].name (string)
certificates[].services[] (string)
certificates[].status (string) – “valid”, “expiring”, “expired”
certificates[].type (string) – “AGENT”, “MGMT”, “STORAGE”, “DB”, “LB”
current_page (integer)
page_size (integer)
summary.auto_renewal_count (integer)
summary.expired_count (integer)
summary.expiring_count (integer)
summary.expiring_days_remaining (integer)
summary.total_compute (integer)
summary.total_mgmt (integer)
summary.total_nodes (integer)
summary.valid_count (integer)
summary.valid_days_remaining (integer)
total_count (integer)
- GET /certificates/external-leaf
Get external edge certificate status
Reports whether an operator-managed edge certificate is installed, with its subject, expiry and days remaining when readable.
- Status Codes:
200 OK – installed flag, manager, marker and expiry details
500 Internal Server Error – marker file could not be read
- POST /certificates/external-leaf
Install an external edge certificate
Validates an uploaded cert and key (optional chain), swaps the Envoy edge chain and key, writes the operator-managed marker and schedules an Envoy restart.
- Status Codes:
200 OK – installed certificate details and restart status
400 Bad Request – missing or unreadable files, invalid cert, key mismatch, expired or not yet valid
500 Internal Server Error – backup directory, chain or key write failed
- GET /certificates/get/{domain}
Get a certificate
Returns certificate file info and parsed details for a domain.
- Parameters:
domain (string) – Certificate domain
- Status Codes:
200 OK – certificate info and parsed details
400 Bad Request – domain missing
404 Not Found – certificate not found
500 Internal Server Error – cert manager not initialized or certificate parse failed
- Response JSON Object:
algo_bits (string) – “2048-bit”, “256-bit”, etc
algorithm (string) – “RSA-2048”, “ECDSA-256”, “RSA-4096”
cert_path (string)
certificate_pem (string)
chain_path (string)
cns[] (string)
days_left (integer)
domain (string)
expiration (string) – ISO format date
fingerprint (string) – SHA256 fingerprint
fullchain_path (string)
issued_at (string)
issuer_ca (string)
key_path (string)
live_path (string)
name (string)
private_key_pem (string)
services[] (string)
status (string) – “valid”, “expiring”, “expired”
type (string) – “AGENT”, “MGMT”, “STORAGE”, “DB”, “LB”
- GET /certificates/list
List certificates
Lists all system certificates on this node for its node type.
- Status Codes:
200 OK – certificates and count
500 Internal Server Error – cert manager not initialized, node type unknown, or listing failed
- POST /certificates/renew/{domain}
Renew a certificate
Renews the certificate for a domain through certbot, optionally forcing renewal.
- Parameters:
domain (string) – Certificate domain
- Query Parameters:
force (boolean) – force renewal when true
- Status Codes:
200 OK – renewed certificate and private key PEM
400 Bad Request – domain missing
500 Internal Server Error – cert manager not initialized or renewal failed
- Response JSON Object:
certificate_pem (string)
private_key_pem (string)
- GET /certificates/root-ca
Download the root CA certificate
Returns the cluster root CA certificate as a downloadable PEM file.
- Status Codes:
200 OK – root CA certificate PEM
404 Not Found – root CA file not found
500 Internal Server Error – root CA file could not be read
- POST /certificates/rotate/certificateauthorities
Rotate the certificate authorities
Validates an uploaded CA cert and key (.crt and .key, max 10MB each), rotates the CAs and verifies the rotation; management server only.
- Status Codes:
200 OK – message, timestamp, version, duration and details
400 Bad Request – missing, misnamed, oversized or invalid files
403 Forbidden – not a management server
500 Internal Server Error – cert manager not initialized, rotation or verification failed