Private SSL 주문

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

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

이 엔드포인트를 사용하여 private_ssl_plus, private_ssl_wildcard, 또는 private_ssl_multi_domain을(를) private_ssl_certificate_id(으)로 사용하는 비공개 인증서 요청을 제출합니다.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{private_ssl_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "192.168.1.195",
        "dns_names": [
        	"192.168.1.196",
        	"192.168.1.197"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 45
        },
        "signature_hash": "sha256",
        "ca_cert_id": "10A101A05684",
        "organization_units": [
            "Accounting department"
        ]
    },
    "validity_years": 1,
    "comments": "Message for the approver",
    "disable_renewal_notifications": true,
    "locale": "en",
    "payment_method": "balance",
    "skip_approval": true,
    "organization": {
        "id": 123456
    }
}'
Python
import requests

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

payload = "{\n    \"certificate\": {\n        \"common_name\": \"192.168.1.195\",\n        \"dns_names\": [\n        \t\"192.168.1.196\",\n        \t\"192.168.1.197\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"ca_cert_id\": \"10A101A05684\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 1,\n    \"comments\": \"Message for the approver\",\n    \"disable_renewal_notifications\": true,\n    \"locale\": \"en\",\n    \"payment_method\": \"balance\",\n    \"skip_approval\": true,\n    \"organization\": {\n        \"id\": 123456\n    }\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/{{private_ssl_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"192.168.1.195\",\n        \"dns_names\": [\n        \t\"192.168.1.196\",\n        \t\"192.168.1.197\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"ca_cert_id\": \"10A101A05684\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 1,\n    \"comments\": \"Message for the approver\",\n    \"disable_renewal_notifications\": true,\n    \"locale\": \"en\",\n    \"payment_method\": \"balance\",\n    \"skip_approval\": true,\n    \"organization\": {\n        \"id\": 123456\n    }\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/{{private_ssl_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: '192.168.1.195',
        dns_names: [ '192.168.1.196', '192.168.1.197' ],
        csr: '<csr>',
        server_platform: { id: 45 },
        signature_hash: 'sha256',
        ca_cert_id: '10A101A05684',
        organization_units: [ 'Accounting department' ] },
     validity_years: 1,
     comments: 'Message for the approver',
     disable_renewal_notifications: true,
     locale: 'en',
     payment_method: 'balance',
     skip_approval: true,
     organization: { id: 123456 } },
  json: true };

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

  console.log(body);
});
201 (one-step)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "pending"
    }
  ]
}
201 (two-step)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "submitted"
    }
  ]
}
201 (auto)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],
  "certificate_id": 113
}
201 (skip)
{
  "id": 112233,
  "certificate_id": 113
}
201 (immediate)
{
  "id": 112233,
  "certificate_id": 113,
  "certificate_chain": [
    {
      "subject_common_name": "example.com",
      "pem": "<pem_certificate>"
    },
    {
      "subject_common_name": "DigiCert SHA2 Secure Server CA",
      "pem": "<pem_certificate>"
    },
    {
      "subject_common_name": "DigiCert Global Root CA",
      "pem": "<pem_certificate>"
    }
  ]
}

요청 매개 변수

제품 목록 엔드포인트를 사용하고 allowed_ca_certs 배열을 찾아서 가능한 ca_cert_id 값을 식별합니다.

이름 필수/옵션 유형 설명
certificate 필수 object 인증서 상세 정보입니다.
.. common_name 필수 string 보호할 도메인입니다.
.. dns_names 옵션 array 보호할 추가 도메인입니다.
추가 비용이 발생할 수 있습니다. (모범 사례 — 도메인의 두 개 버전 모두를 무료로 받기를 참조하십시오.)
.. csr 필수 string CSR(인증서 서명 요청)
.. signature_hash 필수 string 인증서를 서명하기 위해 사용되는 해시 알고리즘입니다.
코드 서명 인증서는 SHA-256만 지원합니다.
.. ca_cert_id 옵션* string 인증서를 서명해야 한느 CA 인증서의 ID입니다.
*여러 CA 인증서가 구성되어 있는 경우 필수입니다.
.. organization_units 옵션 array 조직 내에서 인증서를 이용하는 부서입니다.
.. server_platform 옵션 object 서버 플랫폼 유형입니다.
기본값: -1 (기타)
.. .. id 필수 int 서버 플랫폼 ID입니다.
용어집 — 서버 플랫폼을 참조하십시오.
.. profile_option 옵션 string 사용자 지정 인증서 프로필을 사용하는 경우, 프로필 이름을 지정합니다.
renewed_thumbprint 옵션 string 주문이 갱신인 경우, 이전 주문의 주요 인증서의 SHA-1 지문을 입력합니다.
validity_years 필수 int 인증서가 유효한 연도의 수입니다.
validity_days 또는 custom_expiration_date(으)로 교체할 수 있습니다.
허용되는 값: 1, 2
validity_days 옵션 int 발급된 후에 인증서가 유효한 기간(일)입니다.
validity_years을(를) 재정의합니다.
custom_expiration_date 옵션 string 인증서에 대한 사용자 지정 만료 날짜입니다. 날짜는 앞으로 825일 이내여야 합니다.
validity_daysvalidity_years을(를) 재정의합니다.
형식: yyyy-MM-dd
comments 옵션 string 승인자에게 주문에 대한 설명입니다.
auto_renew 옵션 int 인증서를 자동으로 갱신해야 하는지 지정합니다.
기본값: 0
허용되는 값: 0 (사용 안 함), 1 (사용)
custom_renewal_message 옵션 string 갱신 알림에 포함할 사용자 지정 메시지입니다.
disable_renewal_notifications 옵션 bool 갱신 알림 이메일을 사용 중지해야 하는지 지정합니다.
기본값: false
additional_emails 옵션 array 인증서 알림 이메일(예, 인증서 발급, 복제 인증서, 인증서 갱신 등)을 받는 주가 이메일 주소입니다.
renewal_of_order_id 옵션 int 주문이 갱신인 경우, 이전 주문의 ID를 입력합니다.
payment_method 옵션 string 사용할 결제 방법을 지정합니다.
허용되는 값: balance, card, profile
기본값: balance
dcv_method 옵션 string 도메인 제어를 확인할 때 사용할 DCV 방법입니다.
용어집 — DCV 방법을 참조하십시오.
skip_approval  옵션 bool 주문이 승인 단계를 건너뛰어야 하며 즉시 유효성 검사에 제출하고 완료되면 발급해야 하는지 지정합니다.
기본값: false
disable_ct 옵션 bool 인증서에 대한 CT 로깅을 사용 중지해야 하는지 지정합니다.
주문별 CT 로깅을 사용해야 하며 그렇지 않으면 무시됩니다. 사용자를 CT 로그에서 제외하는 것을 허용을 참조하십시오.
기본값: false
organization 필수 object 조직 상세 정보에 대한 컨테이너입니다.
.. id 필수 int 주문과 연결할 조직의 ID입니다.
또는 주문을 제출할 때 조직 개체를 전달하여 새 조직을 추가할 수 있습니다. 개체 구조 요구 사항은 조직 만들기를 참조하십시오.
container 옵션 object 필요한 경우, 주문이 포함될 컨테이너를 지정합니다.
.. id 필수 int 컨테이너 ID입니다.
custom_fields 옵션* array 계정별 사용자 지정 필드입니다.
*이 필드의 필요 여부는 사용자 지정 필드 설정에 따라 다릅니다.
.. metadata_id 필수 int 사용자 지정 필드 ID입니다.
.. value 필수 string 사용자 지정 필드에 대한 값입니다.
데이터 유효성 검사 유형은 사용자 지정 필드에 따라 다릅니다.

응답 매개 변수

이름 유형 설명
id int 주문 ID입니다.
organization object 새 조직 상세 정보에 대한 컨테이너입니다.
이 주문으로 새 조직이 만들어진 경우에만 반환됩니다.
.. id int 새 조직에 대한 조직 ID입니다.
requests array 요청에 대한 정보를 포함합니다.
.. id int 요청 ID입니다.
.. status string 요청 상태입니다.
가능한 값: pending, submitted, approved, rejected
certificate_id int 인증서 ID입니다.
요청 상태가 approved인 경우 반환됩니다.