SSL(type_hint) 주문

POST
https://www.digicert.com/services/v2/order/certificate/ssl

이 엔드포인트는 제출한 데이터에 기초하여 요청에 대해 적합한 SSL 제품을 자동으로 결정합니다. 제품을 결정할 수 없는 경우, 400 ambiguous_product 오류가 반환됩니다.

이 엔드포인트를 사용하여 제품 type_hint을(를) 사용하는 인증서 요청을 제출합니다.

cURL
curl -X POST \
  https://www.digicert.com/services/v2/order/certificate/ssl \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "certificate": {
    "common_name": "example.com",
    "dns_names": [
      "example2.com",
      "example3.com"
    ],
    "csr": "<csr>",
    "signature_hash": "sha256",
    "organization_units": [
      "Not Fake Company Inc."
    ],
    "organization": {
      "id": 112233
    },
    "server_platform": {
      "id": 2
    }
  },
  "validity_years": 1,
  "comments": "Example certificate for API documentation.",
  "container": {
    "id": 11
  },
  "product": {
    "type_hint": "ov"
  },
  "auto_renew": 1,
  "disable_renewal_notifications": false,
  "additional_emails": [
    "john.smith@digicert.com"
  ],
  "disable_ct": false,
  "skip_approval": true,
  "organization": {
    "id": 112233
  }
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/ssl"

payload = "{\n  \"certificate\": {\n    \"common_name\": \"example.com\",\n    \"dns_names\": [\n      \"example2.com\",\n      \"example3.com\"\n    ],\n    \"csr\": \"<csr>\",\n    \"signature_hash\": \"sha256\",\n    \"organization_units\": [\n      \"Not Fake Company Inc.\"\n    ],\n    \"organization\": {\n      \"id\": 112233\n    },\n    \"server_platform\": {\n      \"id\": 2\n    }\n  },\n  \"validity_years\": 1,\n  \"comments\": \"Example certificate for API documentation.\",\n  \"container\": {\n    \"id\": 11\n  },\n  \"product\": {\n    \"type_hint\": \"ov\"\n  },\n  \"auto_renew\": 1,\n  \"disable_renewal_notifications\": false,\n  \"additional_emails\": [\n    \"john.smith@digicert.com\"\n  ],\n  \"disable_ct\": false,\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 112233\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/ssl"

	payload := strings.NewReader("{\n  \"certificate\": {\n    \"common_name\": \"example.com\",\n    \"dns_names\": [\n      \"example2.com\",\n      \"example3.com\"\n    ],\n    \"csr\": \"<csr>\",\n    \"signature_hash\": \"sha256\",\n    \"organization_units\": [\n      \"Not Fake Company Inc.\"\n    ],\n    \"organization\": {\n      \"id\": 112233\n    },\n    \"server_platform\": {\n      \"id\": 2\n    }\n  },\n  \"validity_years\": 1,\n  \"comments\": \"Example certificate for API documentation.\",\n  \"container\": {\n    \"id\": 11\n  },\n  \"product\": {\n    \"type_hint\": \"ov\"\n  },\n  \"auto_renew\": 1,\n  \"disable_renewal_notifications\": false,\n  \"additional_emails\": [\n    \"john.smith@digicert.com\"\n  ],\n  \"disable_ct\": false,\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 112233\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/ssl',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'example2.com', 'example3.com' ],
        csr: '<csr>',
        signature_hash: 'sha256',
        organization_units: [ 'Not Fake Company Inc.' ],
        organization: { id: 112233 },
        server_platform: { id: 2 } },
     validity_years: 1,
     comments: 'Example certificate for API documentation.',
     container: { id: 11 },
     product: { type_hint: 'ov' },
     auto_renew: 1,
     disable_renewal_notifications: false,
     additional_emails: [ 'john.smith@digicert.com' ],
     disable_ct: false,
     skip_approval: true,
     organization: { id: 112233 } },
  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 보호할 도메인입니다.
.. dns_names 옵션 array 보호할 추가 도메인입니다.
추가 비용이 발생할 수 있습니다. (모범 사례 — 도메인의 두 개 버전 모두를 무료로 받기를 참조하십시오.)
.. csr 필수* string CSR(인증서 서명 요청)
*용어집 — CSR 요구 사항을 참조하십시오.
.. signature_hash 필수 string 인증서를 서명하기 위해 사용되는 해시 알고리즘입니다.
코드 서명 인증서는 SHA-256만 지원합니다.
.. ca_cert_id 필수* string 인증서를 서명해야 한느 CA 인증서의 ID입니다.
*type_hint이(가) private인 경우에만 허용됩니다.
.. organization_units 옵션 array 조직 내에서 인증서를 이용하는 부서입니다.
.. server_platform 옵션 object 서버 플랫폼 유형입니다.
코드 서명 인증서 주문에 필수입니다.
기본값: -1 (기타)
.. .. id 필수 int 서버 플랫폼 ID입니다.
용어집 — 서버 플랫폼을 참조하십시오.
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 승인자에게 주문에 대한 설명입니다.
product 옵션 object
.. type_hint 옵션 string 전달되는 제품 유형을 지정합니다.
허용되는 값: ov, ev, grid, private
auto_renew 옵션 int 인증서를 자동으로 갱신해야 하는지 지정합니다.
기본값: 0
허용되는 값: 0 (사용 안 함), 1 (사용)
disable_renewal_notifications 옵션 bool 갱신 알림 이메일을 사용 중지해야 하는지 지정합니다.
기본값: false
additional_emails 옵션 array 인증서 알림 이메일(예, 인증서 발급, 복제 인증서, 인증서 갱신 등)을 받는 주가 이메일 주소입니다.
renewal_of_order_id 옵션 int 주문이 갱신인 경우, 이전 주문의 ID를 입력합니다.
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입니다.

응답 매개 변수

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