3月 12, 2021
CertCentral Services API: Auto-reissue support for Multi-year Plans
We are happy to announce that the CertCentral Services API now supports automatic certificate reissue requests (auto-reissue) for Multi-year Plans. The auto-reissue feature makes it easier to maintain SSL/TLS coverage on your Multi-year Plans.
You can enable auto-reissue for individual orders in your CertCentral account. When auto-reissue is enabled, we automatically create and submit a certificate reissue request 30 days before the most recently issued certificate on the order expires.
Enable auto-reissue for a new order
To give you control over the auto-reissue setting for new Multi-year Plans, we added a new request parameter to the endpoints for ordering DV, OV, and EV TLS/SSL certificates: auto_reissue.
By default, auto-reissue is disabled for all orders. To enable auto-reissue when you request a new Multi-year Plan, set the value of the auto_reissue parameter to 1 in the body of your request.
Example request body:
Note: In new order requests, we ignore the auto_reissue parameter if:
- The product does not support Multi-year Plans.
- Multi-year Plans are disabled for the account.
Update auto-reissue setting for existing orders
To give you control over the auto-reissue setting for existing Multi-year Plans, we added a new endpoint: Update auto-reissue settings. Use this endpoint to enable or disable the auto-reissue setting for an order.
Get auto-reissue setting for an existing order
To help you track the auto-reissue setting for existing certificate orders, we added a new response parameter to the Order info endpoint: auto_reissue. The auto_reissue parameter returns the current auto-reissue setting for the order.
ICA certificate chain selection for public DV flex certificates
We are happy to announce that select public DV certificates now support Intermediate CA certificate chain selection:
- GeoTrust DV SSL
- Thawte SSL 123 DV
- RapidSSL Standard DV
- RapidSSL Wildcard DV
- Encryption Everywhere DV
You can add a feature to your CertCentral account that enables you to control which DigiCert ICA certificate chain issues the end-entity certificate when you order these public DV products.
This feature allows you to:
- Set the default ICA certificate chain for each supported public DV certificate.
- Control which ICA certificate chains certificate requestors can use to issue their DV certificate.
Configure ICA certificate chain selection
To enable ICA selection for your account:
- Contact your account manager or our Support team.
- Then, in your CertCentral account, in the left main menu, go to Settings > Product Settings.
- On the Product Settings page, configure the default and allowed intermediates for each supported and available DV certificate.
For more information and step-by-step instructions, see the Configure the ICA certificate chain feature for your public TLS certificates.
DigiCert Services API: DV certificate support for ICA certificate chain selection
In the DigiCert Services API, we made the following updates to support ICA selection in your DV certificate order requests:
- Updated the Product list endpoint
After adding the ICA certificate selection chain feature to your account, the Product list endpoint returns each ICA certificate's name and ID available to issue end-entity certificates for the supported DV products (see allowed_ca_certs). - Updated the Product limits endpoint
After you configure the allowed and default ICA certificates for a DV product, the Product limits endpoint returns the default issuing ICA (default_intermediate) and allowed issuing ICAs (allowed_intermediates) that certificate requestor with a given container and user role assignment can select. - Updated the Product info endpoint
The Product list endpoint now returns the name, ID, and certificate chain information for the issuing ICAs you can select when you request a given product (see allowed_ca_certs). - Added support for ICA chain selection to these DV certificate order requests:
Pass in the issuing ICA certificate's ID as the value for the ca_cert_id parameter in your order request's body.
Example DV certificate request:
For more information about using ICA selection in your API integrations, see DV certificate lifecycle – Optional ICA selection.
12月 2, 2020
CertCentral Services API:ドキュメント更新
CertCentral Services API のドキュメントに次の更新を行いましたので、お知らせいたします。
- 新しいバウチャー価格推定 API
［バウチャー価格推定］ エンドポイントに新しいレファレンストピックを発行しました。バウチャーを使用するお客様は、このエンドポイントを使用して、個別バウチャー構成のオーダーのコスト（税込み）を推定することができます。 - API 用語集更新
各組織認証ステータス値を定義するため、新しいテーブルとあわせ、用語集を更新しました。「用語集 - 組織認証ステータス」 を参照してください。 - 要求パラメータを追加してアカウントメールドキュメントを更新
emergency_emails要求パラメータを、［アカウントメールを更新する］ エンドポイント用ドキュメントに追加しました。このパラメータを使用して、デジサートから緊急通知を受け取るメールアドレスを更新します。
例 アカウントメールを更新する 要求本文:
- 製品情報ドキュメントに応答パラメータを追加
validation_type,allowed_ca_certs,とdefault_intermediate応答パラメータを、［製品情報］ エンドポイントに追加しました。validation_typeパラメータを使用して、所定製品の認証タイプを取得します。allowed_ca_certsパラメータを使用して、所定製品をオーダーするときに選択可能な ICA 証明書についての情報を取得できます。*default_intermediateパラメータを使用して、所定製品のデフォルト ICA の ID を取得します。*
例 製品情報 応答データ:
* 注記:［製品情報］ エンドポイントは、ICA 選択をサポートする allowed_ca_certs と default_intermediates パラメータのみを返します。また、ICA 選択 (OV と EV フレックス証明書) をサポートするパブリック SSL 証明書の場合、これらのパラメータは、ICA 選択がアカウントについて有効な場合のみ、返されます。また、default_intermediates パラメータは、管理者がアカウントで管理グループまたはユーザーロール用に製品設定をカスタマイズした場合のみ、返されます。詳細は、「パブリック OV と EV フレックス証明書の ICA 証明書チェーンオプション」 を参照してください。
10月 13, 2020
パブリック OV と EV フレックス証明書用 ICA 証明書チェーンの選択
フレックス証明書付きパブリック OV と EV 証明書は現在、中間 CA 証明書チェーンの選択をサポートしていることをお知らせいたします。
どの DigiCert ICA 証明書チェーンがパブリック OV および EV "フレックス" 証明書を発行するかを管理できるオプションを CertCentral アカウントに追加することができます。
このオプションでは次のことが可能です。
- デフォルト ICA 証明書チェーンを各パブリック OV および EV フレックス製品向けに設定します。
- 証明書要求者がどの ICA 証明書チェーンを使用してフレックス証明書を発行するか管理します。
ICA 証明書チェーンの選択を構成する
お使いのアカウントについて ICA 選択を有効にするには、アカウントマネージャまたは サポートチーム にお問い合わせください。次に、製品設定ページの CertCentral アカウント（左メインメニューで ［設定］ >［製品設定］ の順に進む) で OV と EV フレックス証明書の各タイプについて、デフォルトおよび許可された中間証明書を構成します。
詳細およびステップ別の手順は、「パブリック OV と EV フレックス証明書の ICA 証明書チェーンオプション」 を参照してください。
DigiCert Services API は ICA 証明書チェーンの選択をサポート
DigiCert Services API では、お使いの API 統合で ICA 選択をサポートするため、次の更新を行いました。
- 新規作成済 製品制限エンドポイント
このエンドポイントを使用して、お使いのアカウントの各管理グループについて有効になった製品の制限と設定に関する情報を取得します。こには、各製品のデフォルトおよび許可された ICA 証明書チェーンの ID 値が含まれます。 - パブリック TLS OV と EV フレックス証明書オーダー要求への ICA 選択のサポートを追加
製品について許可された中間証明書を構成した後、API を使用してオーダー要求を提出するときに証明書を発行する ICA 証明書チェーンを選択することができます。
発行 ICA 証明書の ID をオーダー要求本文のca_cert_idパラメータ用の値にパスします。
フレックス証明書要求の例:
API 統合の ICA 選択についての詳細は、「OV/EV 証明書の使用期間 – (オプション) ICA 選択」 を参照してください。