このページは、まだ日本語ではご利用いただけません。翻訳中です。
Monitoring and debugging
The ACME plugin exposes several endpoints through the Admin API that can be used for debugging and monitoring certificate creation and renewal.
To configure and enable the plugin itself, use the /plugins
API endpoint.
The /acme
endpoints only appear once the plugin has been enabled.
Apply certificate
Endpoint
/acme
Applies or renews the certificate and returns the result.
Request body
Attribute | Description |
---|---|
host required |
The domain where to create the certificate. |
test_http_challenge_flow optional |
When set, only checks if the configuration is valid. Does not apply the certificate. |
Update certificate
Apply or renew the certificate and return the result. Unlike POST
, PATCH
runs the process in the background.
Endpoint
/acme
Request body
Attribute | Description |
---|---|
host required |
The domain where to create the certificate. |
test_http_challenge_flow optional |
When set, only checks if the configuration is valid. Does not apply the certificate. |
Get ACME certificates
List the certificates being created by the ACME plugin. You can use this endpoint to monitor certificate existence and expiry.
Endpoint
/acme/certificates
Get certificate by host
List certificates with a specific host.
Endpoint
/acme/certificates/{HOST}
Attribute | Description |
---|---|
HOST |
The IP or hostname of the host to target. |
Example response for listing certificates:
{
"data": [
{
"not_after": "2022-09-21 23:59:59",
"pubkey_type": "id-ecPublicKey",
"digest": "A9:49:55:06:A7:B6:1D:2B:13:47:C5:58:5B:AC:DA:43:B5:25:E0:86",
"issuer_cn": "ZeroSSL ECC Domain Secure Site CA",
"valid": true,
"host": "subdomain1.domain.com",
"not_before": "2022-06-23 00:00:00",
"serial_number": "93:B8:E9:D5:C6:36:ED:B4:A8:B3:FD:C5:9E:A8:08:88"
},
{
"not_after": "2022-09-21 23:59:59",
"pubkey_type": "id-ecPublicKey",
"digest": "26:12:A2:C4:6A:F5:A5:90:9D:03:15:CB:FE:A7:BF:32:1C:42:49:CE",
"issuer_cn": "ZeroSSL ECC Domain Secure Site CA",
"valid": true,
"host": "subdomain2.domain.com",
"not_before": "2022-06-23 00:00:00",
"serial_number": "F1:15:74:E3:E1:DD:21:72:48:C0:4F:06:25:1B:71:F7"
}
]
}