筛选方式: revoke certificate endpoint x 清除
enhancement

CertCentral Services API: More versatile revoke certificate endpoint

In CertCentral, we added new Certificate Revocations (API Only) settings that allow you to determine how the revoke certificate endpoint works for your API integration:

  • Revoke an individual certificate (default configuration)
    • Allows you to use this endpoint to revoke a single certificate on an order.
    • Leaves the order active so you can continue issuing certificates on the order.
    • No refunds provided.
  • Revoke order when all certificates are revoked
    • Allows you to use this endpoint to revoke a single certificate on an order.
    • Additionally, if all certificates on the order have been revoked, it will also revoke the order.
    • If eligible, refunds are provided.

To revoke an order and all the certificates on the order, use the revoke order certificates endpoint.

Certificate Revocations (API Only) in CertCentral

To use these new revoke certificate endpoint API settings:

  1. In your CertCentral account, in the left main menu, go to Settings > Preferences.
  2. On the Division Preferences page, expand Advanced Settings.
  3. The new settings are in the Certificate Requests section, under Certificate Revocations (API Only).
enhancement

CertCentral Services API: Improved Revoke order certificates and Revoke certificate endpoints

In the DigiCert Services API, we updated the Revoke order certificates and Revoke certificate endpoints, enabling you to skip the approval step when revoking a certificate.

Note: Previously, the approval step was required and could not be skipped.

We added a new optional parameter, "skip_approval": true, that allows you to skip the approval step when submitting a request to revoke one certificate or all certificates on an order.

Note: For skip approvals to work for certificate revoke requests, the API key must have admin privileges. See Authentication.

Now, on your revoke certificate and revoke order certificate requests, you can skip the approval step and immediately submit the request to DigiCert for certificate revocation.

Example request for the revoke certificate and revoke order certificates endpoints

Example revoke certificate request with skip_approval parameter

fix

Bug fix: DV certificate issuance emails did not respect certificate format settings

We fixed a bug in the DV certificate issuance process where the Your certificate for your-domain email notification did not deliver the certificate in the format specified in your account settings.

Note: Previously, we included a certificate download link in all DV certificate issued email notifications.

Now, when we issue your DV certificate order, the email delivers the certificate in the format specified in your account's Certificate Format settings.

Configure certificate format for certificate issuance emails

In the left main menu, go to Settings > Preferences. On the Division Preferences page, expand Advance Settings. In the Certificate Format section, select the certificate format: attachment, plain text, or download link. Click Save Settings.

fix

CertCentral 服务 API:修复了吊销证书端点错误

在 DigiCert 服务 API,我们修复了吊销证书端点中的错误,即,为吊销订单上的单个证书而提交的请求是针对订单上的所有证书而提交的。

注意:提交"单个证书"吊销请求后,我们返回 201 Created 响应,其中包含关于吊销订单上的所有证书的请求详情。

现在,如果使用吊销证书端点提交吊销订单上的单个证书的请求,我们会返回 201 Created 响应,其中包含关于仅吊销订单上的该单个证书的请求详情。

30 天退款保证

吊销证书端点会吊销订单上的证书,而不会吊销订单本身。我们的 30 天退款保证与订单绑定,而不是与订单上的"证书"绑定。要获取 30 天退款保证,需在 30 天内吊销订单。请参阅吊销订单证书

证书吊销流程

所有吊销请求,包括通过服务 API 提交的吊销请求,必须由管理员批准后,DigiCert 才会吊销证书。必须执行该审批步骤,不可跳过,也不能从证书吊销流程中移除。

*有关吊销证书端点的须知事项

该端点用于吊销订单上的证书,它不会吊销证书订单。

如果吊销只有一个证书的订单上的证书:

  • 订单仍然处于活跃状态
  • 对已吊销的证书不退款
  • 您仍然可以补发该订单上的证书

如果您不打算补发该订单的证书,则使用吊销订单证书端点吊销订单。