ドキュメント署名証明書を申請(オーダー)する

POST
https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}

このページには、document_signing グループ名付きで製品説明が記載されます (「用語集 – 製品識別子」を参照してください)。

このエンドポイントを使用して、document_signing_org_1 または document_signing_org_2document_certificate_id として使用して、ドキュメント署名証明書申請を提出します。

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "server_platform": {
            "id": 21
        },
        "signature_hash": "sha256"
    },
    "cs_provisioning_method": "ship_token",
    "use_org_as_common_name": true,
    "validity_years": 2,
    "comments": "Comments for the the approver.",
    "organization": {
        "id": 334455
    },
    "container": {
        "id": 221122
    },
    "ship_info": {
        "name": "Erin Guerra",
        "addr1": "360 Taylor Street",
        "addr2": "Floor 74",
        "city": "Richmond",
        "state": "va",
        "zip": "69662",
        "country": "us",
        "method": "standard"
    },
    "subject": {
        "name": "Rene Pierce",
        "job_title": "School Counselor",
        "phone": "054-139-0798",
        "email": "rene.pierce@yahoo.com"
    },
    "csa_agreed_to": 1,
    "skip_approval": true,
    "payment_method": "balance"
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}"

payload = "{\n    \"certificate\": {\n        \"server_platform\": {\n            \"id\": 21\n        },\n        \"signature_hash\": \"sha256\"\n    },\n    \"cs_provisioning_method\": \"ship_token\",\n    \"use_org_as_common_name\": true,\n    \"validity_years\": 2,\n    \"comments\": \"Comments for the the approver.\",\n    \"organization\": {\n        \"id\": 334455\n    },\n    \"container\": {\n        \"id\": 221122\n    },\n    \"ship_info\": {\n        \"name\": \"Erin Guerra\",\n        \"addr1\": \"360 Taylor Street\",\n        \"addr2\": \"Floor 74\",\n        \"city\": \"Richmond\",\n        \"state\": \"va\",\n        \"zip\": \"69662\",\n        \"country\": \"us\",\n        \"method\": \"standard\"\n    },\n    \"subject\": {\n        \"name\": \"Rene Pierce\",\n        \"job_title\": \"School Counselor\",\n        \"phone\": \"054-139-0798\",\n        \"email\": \"rene.pierce@yahoo.com\"\n    },\n    \"csa_agreed_to\": 1,\n    \"skip_approval\": true,\n    \"payment_method\": \"balance\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"server_platform\": {\n            \"id\": 21\n        },\n        \"signature_hash\": \"sha256\"\n    },\n    \"cs_provisioning_method\": \"ship_token\",\n    \"use_org_as_common_name\": true,\n    \"validity_years\": 2,\n    \"comments\": \"Comments for the the approver.\",\n    \"organization\": {\n        \"id\": 334455\n    },\n    \"container\": {\n        \"id\": 221122\n    },\n    \"ship_info\": {\n        \"name\": \"Erin Guerra\",\n        \"addr1\": \"360 Taylor Street\",\n        \"addr2\": \"Floor 74\",\n        \"city\": \"Richmond\",\n        \"state\": \"va\",\n        \"zip\": \"69662\",\n        \"country\": \"us\",\n        \"method\": \"standard\"\n    },\n    \"subject\": {\n        \"name\": \"Rene Pierce\",\n        \"job_title\": \"School Counselor\",\n        \"phone\": \"054-139-0798\",\n        \"email\": \"rene.pierce@yahoo.com\"\n    },\n    \"csa_agreed_to\": 1,\n    \"skip_approval\": true,\n    \"payment_method\": \"balance\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
NodeJS
var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: { server_platform: { id: 21 }, signature_hash: 'sha256' },
     cs_provisioning_method: 'ship_token',
     use_org_as_common_name: true,
     validity_years: 2,
     comments: 'Comments for the the approver.',
     organization: { id: 334455 },
     container: { id: 221122 },
     ship_info: 
      { name: 'Erin Guerra',
        addr1: '360 Taylor Street',
        addr2: 'Floor 74',
        city: 'Richmond',
        state: 'va',
        zip: '69662',
        country: 'us',
        method: 'standard' },
     subject: 
      { name: 'Rene Pierce',
        job_title: 'School Counselor',
        phone: '054-139-0798',
        email: 'rene.pierce@yahoo.com' },
     csa_agreed_to: 1,
     skip_approval: true,
     payment_method: 'balance' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 Created (one-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "pending"
        }
    ]
}
201 Created (two-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "submitted"
        }
    ]
}
201 Created
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "approved"
        }
    ],
    "certificate_id": 113
}

申請パラメータ

名前 申請/オプション 種別 説明
certificate 必須 object 証明書詳細
.. csr 任意* string 証明書署名申請 (CSR).
*cs_provisioning_methodemailの場合は必須。
.. server_platform 任意 object サーバープラットフォームタイプ
デフォルト:-1 (その他)
.. .. id 必須 int サーバープラットフォーム ID
「用語集 — サーバープラットフォーム」を参照してください
.. signature_hash 必須 string 証明書の署名に使用するハッシュアルゴリズム
許可値:sha256
cs_provisioning_method 任意 string トークンの受け取り方法を指定します。
「用語集 — CS プロビジョニング方法」を参照してください。
use_org_as_common_name 任意 bool 組織名を証明書上でコモンネームとして使用する場合に指定します。
デフォルト:true
validity_years 必須 int 証明書が有効な年数。
許可値:1,2,3
comments 任意 string 承認者についてのオーダーに関してコメントします。
organization 必須 object オーダーと関連づける組織
.. id 必須 int 組織 ID.
container 任意 object 必要な場合、オーダーを入れるコンテナを指定します。
.. id 必須 int コンテナ ID
ship_info 任意 object トークンについて送信先アドレスを指定します。
.. name 必須 文字列
.. addr1 必須 文字列
.. addr2 任意 文字列
.. city 必須 文字列
.. state 必須 文字列
.. zip 必須 文字列
.. country 必須 文字列
.. method 必須 string トークンの配送優先順位
許可値:standard,expedited (追加コストが発生します)
subject 必須 object 証明書のサブジェクト情報。
.. name 必須 string サブジェクトのフルネーム
.. job_title 必須 string サブジェクトの役職
.. phone 必須 string サブジェクトの電話番号
.. email 必須 string サブジェクトのメールアドレス
custom_fields 任意* object アカウント別カスタムフィールド
*これらのフィールドが必須かどうかは、カスタムフィールド設定によって異なります。
.. metadata_id 必須 int カスタムフィールド ID
.. value 必須 string カスタムフィールドの値
データ認証タイプは、カスタムフィールド設定によって異なります。
user_id_assignments 任意 array オーダーを管理できるユーザー ID のリスト。
skip_approval 任意 bool オーダーが承認ステップをスキップし、すぐに認証に提出し、完了後に発行する場合に指定します。
デフォルト:false
payment_method 任意 string 使用する支払方法を指定します。
許可値:balance,card,profile
デフォルト:balance

応答パラメータ

名前 種別 説明
id int オーダー ID
organization object 新しい組織詳細向けコンテナ
新しい組織がオーダーで作成された場合のみ、返されます。
.. id int 新しい組織の組織 ID。
requests array 申請についての情報が含まれます。
.. id int 申請 ID
.. status string 申請ステータス
可能な値:pending,submitted,approved,rejected
certificate_id int 証明書 ID
申請ステータスが approvedの場合に返されます。