클라이언트 인증서 주문

POST

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

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

이 엔드포인트를 사용하여 client_premium_sha2, client_email_security_plus, client_authentication_plus 또는 client_digital_signature_plus_sha2을(를) client_certificate_id(으)로 사용하는 클라이언트 인증서 요청을 제출합니다.

cURL

curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{client_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "certificate": {
    "common_name": "Lock Cole",
    "emails": [
      "locke.cole@example.com"
    ],
    "signature_hash": "sha256",
    "organization_units": [
      "Accounting"
    ],
    "csr": "<csr>"
  },
  "skip_approval": true,
  "organization": {
    "id": 112233
  },
  "container": {
    "id": 445566
  },
  "validity_years": 1,
  "payment_method": "balance"
}'

Python

import requests

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

payload = "{\n  \"certificate\": {\n    \"common_name\": \"Lock Cole\",\n    \"emails\": [\n      \"locke.cole@example.com\"\n    ],\n    \"signature_hash\": \"sha256\",\n    \"organization_units\": [\n      \"Accounting\"\n    ],\n    \"csr\": \"<csr>\"\n  },\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 112233\n  },\n  \"container\": {\n    \"id\": 445566\n  },\n  \"validity_years\": 1,\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)

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"certificate\": {\n    \"common_name\": \"Lock Cole\",\n    \"emails\": [\n      \"locke.cole@example.com\"\n    ],\n    \"signature_hash\": \"sha256\",\n    \"organization_units\": [\n      \"Accounting\"\n    ],\n    \"csr\": \"<csr>\"\n  },\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 112233\n  },\n  \"container\": {\n    \"id\": 445566\n  },\n  \"validity_years\": 1,\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/{{client_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'Lock Cole',
        emails: [ 'locke.cole@example.com' ],
        signature_hash: 'sha256',
        organization_units: [ 'Accounting' ],
        csr: '<csr>' },
     skip_approval: true,
     organization: { id: 112233 },
     container: { id: 445566 },
     validity_years: 1,
     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
}

요청 매개 변수

이름	필수/옵션	유형	설명
certificate	필수	object	인증서 상세 정보입니다.
.. common_name	필수	string	보호할 이름입니다.
.. emails	필수	array	인증서에 포함할 이메일입니다.
.. signature_hash	필수	string	인증서를 서명하기 위해 사용되는 해시 알고리즘입니다. 허용되는 값: `sha256`
.. organization_units	옵션	array	이 인증서와 연결된 조직의 부서입니다.
.. csr	옵션	string	CSR(인증서 서명 요청)
auto_renew	옵션	int	인증서가 자동으로 갱신되는 횟수입니다.
renewal_of_order_id	옵션	int	주문이 갱신인 경우, 이전 주문의 ID를 입력합니다.
skip_approval	옵션	bool	주문이 승인 단계를 건너뛰어야 하며 즉시 유효성 검사에 제출하고 완료되면 발급해야 하는지 지정합니다. 기본값: `false`
organization	필수	object	주문과 연결할 조직입니다.
.. id	필수	int	조직 ID입니다.
container	옵션	object	필요한 경우, 주문이 포함될 컨테이너를 지정합니다.
.. id	옵션	int	컨테이너 ID입니다.
validity_years	필수	int	인증서가 유효한 연도의 수입니다. `custom_expiration_date`(으)로 교체할 수 있습니다. 허용되는 값: `1`, `2`
custom_expiration_date	옵션	string	인증서에 대한 사용자 지정 만료 날짜입니다. 날짜는 앞으로 825일 이내여야 합니다. `validity_years`을(를) 재정의합니다. 형식: `yyyy-MM-dd`
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`인 경우 반환됩니다.

요청 매개 변수

응답 매개 변수

정보