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)

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_days` 및 `validity_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`인 경우 반환됩니다.

요청 매개 변수

응답 매개 변수

정보