코드 서명 인증서 주문

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

이 페이지는 code_signing_certificate 그룹 이름이 있는 제품을 설명합니다.(용어집 — 제품 식별자를 참조하십시오.)

이 엔드포인트를 사용하여 code_signing 또는 code_signing_ev을(를) code_signing_certificate_id(으)로 사용하는 코드 서명 인증서 요청 주문을 제출합니다.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{code_signing_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "certificate": {
    "organization_units": [
      "Engineering"
    ],
    "server_platform": {
      "id": 52
    },
    "signature_hash": "sha256"
  },
  "cs_provisioning_method": "ship_token",
  "validity_years": 1,
  "comments": "Message for the approver",
  "skip_approval": true,
  "organization": {
    "id": 123456
  },
  "ship_info": {
    "name": "Erin Guerra",
    "addr1": "360 Taylor Street",
    "addr2": "Floor 74",
    "city": "Richmond",
    "state": "va",
    "zip": "69662",
    "country": "us",
    "method": "EXPEDITED"
  },
  "auto_renew": 1,
  "custom_renewal_message": "Renew this please.",
  "custom_fields": [
    {
      "metadata_id": 12,
      "value": "123456"
    }
  ],
  "payment_method": "balance"
}'
Python
import requests

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

payload = "{\n  \"certificate\": {\n    \"organization_units\": [\n      \"Engineering\"\n    ],\n    \"server_platform\": {\n      \"id\": 52\n    },\n    \"signature_hash\": \"sha256\"\n  },\n  \"cs_provisioning_method\": \"ship_token\",\n  \"validity_years\": 1,\n  \"comments\": \"Message for the approver\",\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 123456\n  },\n  \"container\": {\n    \"id\": 654321\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\": \"EXPEDITED\"\n  },\n  \"auto_renew\": 1,\n  \"custom_renewal_message\": \"Renew this please.\",\n  \"custom_fields\": [\n    {\n      \"metadata_id\": 12,\n      \"value\": \"123456\"\n    }\n  ],\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/{{code_signing_certificate_id}}"

	payload := strings.NewReader("{\n  \"certificate\": {\n    \"organization_units\": [\n      \"Engineering\"\n    ],\n    \"server_platform\": {\n      \"id\": 52\n    },\n    \"signature_hash\": \"sha256\"\n  },\n  \"cs_provisioning_method\": \"ship_token\",\n  \"validity_years\": 1,\n  \"comments\": \"Message for the approver\",\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 123456\n  },\n  \"container\": {\n    \"id\": 654321\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\": \"EXPEDITED\"\n  },\n  \"auto_renew\": 1,\n  \"custom_renewal_message\": \"Renew this please.\",\n  \"custom_fields\": [\n    {\n      \"metadata_id\": 12,\n      \"value\": \"123456\"\n    }\n  ],\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/{{code_signing_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { organization_units: [ 'Engineering' ],
        server_platform: { id: 52 },
        signature_hash: 'sha256' },
     cs_provisioning_method: 'ship_token',
     validity_years: 1,
     comments: 'Message for the approver',
     skip_approval: true,
     organization: { id: 123456 },
     container: { id: 654321 },
     ship_info: 
      { name: 'Erin Guerra',
        addr1: '360 Taylor Street',
        addr2: 'Floor 74',
        city: 'Richmond',
        state: 'va',
        zip: '69662',
        country: 'us',
        method: 'EXPEDITED' },
     auto_renew: 1,
     custom_renewal_message: 'Renew this please.',
     custom_fields: [ { metadata_id: 12, value: '123456' } ],
     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 (auto approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "approved"
        }
    ],
    "certificate_id": 113
}

요청 매개 변수

별표(*)가 있는 매개 변수는 EV 코드 서명 주문에 대해서만 사용됩니다.

이름 필수/옵션 유형 설명
certificate 필수 object 인증서 상세 정보입니다.
.. csr 옵션 string CSR(인증서 서명 요청)
EV 코드 서명 인증서에 대해서는 필요하지 않습니다.
server_platform.id 값이 55 (Sun Java)인 경우 필수
.. signature_hash 필수 string 인증서를 서명하기 위해 사용되는 해시 알고리즘입니다.
허용되는 값: sha256
.. server_platform 옵션 object 서버 플랫폼 유형입니다.
기본값: -1 (기타)
.. .. id 필수 int 서버 플랫폼 ID입니다.
용어집 — 서버 플랫폼을 참조하십시오.
.. organization_units 옵션 array 이 인증서와 연결된 조직의 부서입니다.
auto_renew 옵션 int 인증서가 자동으로 갱신되는 횟수입니다.
additional_emails 옵션 array 인증서 알림 이메일(예, 인증서 발급, 복제 인증서, 인증서 갱신 등)을 받는 주가 이메일 주소입니다.
renewal_of_order_id 옵션 int 주문이 갱신인 경우, 이전 주문의 ID를 입력합니다.
skip_approval 옵션 bool 주문이 승인 단계를 건너뛰어야 하며 즉시 유효성 검사에 제출하고 완료되면 발급해야 하는지 지정합니다.
기본값: false
organization 필수 object 주문과 연결할 조직입니다.
.. id 필수 int 조직 ID입니다.
container 옵션 object 필요한 경우, 주문이 포함될 컨테이너를 지정합니다.
.. id 필수 int 컨테이너 ID입니다.
validity_years 필수 int 인증서가 유효한 연도의 수입니다.
허용되는 값: 1, 2, 3
cs_provisioning_method* 필수 string EV 코드 서명 인증서의 경우, 토큰을 받는 방식을 지정합니다.
용어집 — CS 프로비전 방법을 참조하십시오.
ship_info* 옵션 object EV 코드 서명 인증서의 경우, 토큰의 배송지 주소를 지정합니다.
.. name 필수 string
.. addr1 필수 string
.. addr2 옵션 string
.. city 필수 string
.. state 필수 string
.. zip 필수 string
.. country 필수 string
.. method 필수 string 토큰의 배송 우선 순위입니다.
허용되는 값: STANDARD, EXPEDITED (추가 비용 발생)
custom_fields 옵션* object 계정별 사용자 지정 필드입니다.
*이 필드의 필요 여부는 사용자 지정 필드 설정에 따라 다릅니다.
.. metadata_id 필수 int 사용자 지정 필드 ID입니다.
.. value 필수 string 사용자 지정 필드에 대한 값입니다.
데이터 유효성 검사 유형은 사용자 지정 필드에 따라 다릅니다.
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인 경우 반환됩니다.