GeoTrust DV SSL 주문

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

GeoTrust DV SSL 인증서를 요청하려면 이 엔드포인트를 사용합니다.

이 더 유연한 GeoTrust DV SSL 인증서는 니즈에 맞는 GeoTrust DV 인증서를 받기 더 쉽게 합니다. 이 인증서는 GeoTrust Standard DV, GeoTrust Cloud DV 및 GeoTrust Wildcard DV 제품을 대체합니다.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
        	"sub.example.com",
        	"log.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 2
        }
    },
    "custom_expiration_date": "",
    "comments": "Message for the approver.",
    "container": {
        "id": 69748
    },
    "custom_renewal_message": "Renew me.",
    "skip_approval": true,
    "disable_ct": 0,
    "validity_years": 1,
    "custom_fields": [
        {
            "metadata_id": 12,
            "value": "Invoice #12345"
        }
    ],
    "payment_method": "balance",
    "dcv_method": "email",
    "dcv_emails": [
    	{
    		"dns_name": "example.com",
    		"email_domain": "example.com",
    		"email": "admin@example.com"
    	},
    	{
    		"dns_name": "sub.example.com",
    		"email_domain": "example.com",
    		"email": "jim.smith@example.com"
    	},
    	{
    		"dns_name": "log.example.com",
    		"email_domain": "example.com",
    		"email": "it@example.com"
    	}
    ],
    "locale": "en",
    "technical_contact": {
        "first_name": "Jim",
        "last_name": "Smith",
        "telephone": "555-555-5555",
        "job_title": "IT Admin",
        "email": "jim.smith@example.com"
    }
}'
Python
import requests

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

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\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_dv_geotrust_flex"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\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_dv_geotrust_flex',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'log.example.com' ],
        csr: '<csr>',
        server_platform: { id: 2 } },
     custom_expiration_date: '',
     comments: 'Message for the approver.',
     container: { id: 69748 },
     custom_renewal_message: 'Renew me.',
     skip_approval: true,
     disable_ct: 0,
     validity_years: 1,
     custom_fields: [ { metadata_id: 12, value: 'Invoice #12345' } ],
     payment_method: 'balance',
     dcv_method: 'email',
     dcv_emails: 
      [ { dns_name: 'example.com',
          email_domain: 'example.com',
          email: 'admin@example.com' },
        { dns_name: 'sub.example.com',
          email_domain: 'example.com',
          email: 'jim.smith@example.com' },
        { dns_name: 'log.example.com',
          email_domain: 'example.com',
          email: 'it@example.com' } ],
     locale: 'en',
     technical_contact: 
      { first_name: 'Jim',
        last_name: 'Smith',
        telephone: '555-555-5555',
        job_title: 'IT Admin',
        email: 'jim.smith@example.com' } },
  json: true };

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

  console.log(body);
});
201 201 Created (email)
{
  "id": 6484932,
  "certificate_id": 6079436
}
201 201 Created (dns-txt-toke or http-token)
{
  "id": 6484932,
  "certificate_id": 6079436
  "dcv_random_value": "icru1984rnekfj"
}

요청 매개 변수

인증서 필드에 대해 허용된 값에 대한 정보는 일반 인증서 - 업계 표준을 위반하는 데이터 엔트리를 참조하십시오.

이름 필수/옵션 유형 설명
certificate 필수 object 인증서 상세 정보입니다.
.. common_name 필수 string 보호할 도메인입니다.
.. dns_names 옵션 array 보호할 추가 도메인입니다.
추가 비용이 발생할 수 있습니다. ( 모범 사례 — 도메인의 두 개 버전 모두를 무료로 받기를 참조하십시오.)
.. csr 필수* string CSR(인증서 서명 요청)입니다.
.. organization_units 옵션 array 조직 내에서 인증서를 이용하는 부서입니다.
.. server_platform 옵션 object 서버 플랫폼 유형입니다.
기본값: -1 (기타)
.. .. id 필수 int 서버 플랫폼 ID입니다.
 용어집 — 서버 플랫폼을 참조하십시오.
renewed_thumbprint 옵션 string 주문이 갱신인 경우, 이전 주문의 주요 인증서의 SHA-1 지문을 입력합니다.
validity_years 필수 int 인증서가 유효한 연도의 수입니다.
 validity_days 또는 custom_expiration_date(으)로 대체할 ㅅ 있습니다.
허용된 값: 12.
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 사용할 결제 방법을 지정합니다.
허용된 값: balancecardprofile
기본값: balance
dcv_method 필수 string 도메인 제어를 확인할 때 사용할 DCV 방법입니다.
 용어집 — DCV 방법을 참조하십시오.
dcv_emails 옵션 array DCV 이메일을 보낼 때 이메일 범위를 지정하는 목록입니다.
인증서로 보호하는 각 DNS 이름에 대해 항목을 추가할 수 있습니다.
.. dns_name 필수 string 이 범위가 적용되어야 하는 인증서에 DNS 이름입니다.
.. email_domain 필수 string 이메일 주소를 확인하기 위해 사용하는 WHOIS 도메인 레코드입니다.
이 값은  dns_names  기본 도메인과  반드시  일치해야 합니다.
.. email 옵션 string DCV 이메일 보낼 때 사용하는 이메일 주소입니다.
이 이메일 주소는  반드시   email_domain  매개 변수에서 지정한 도메인에 대한 WHOIS 레코드에 있어야 합니다.
locale 옵션 string DCV 이메일에서 사용하는 언어입니다.
 용어집 — 로캘 코드를 참조하십시오.
skip_approval 옵션 bool 주문이 승인 단계를 건너뛰어야 하며 즉시 유효성 검사에 제출하고 완료되면 발급해야 하는지 지정합니다.
기본값: false
disable_ct 옵션 bool 인증서에 대한 CT 로깅을 사용 중지해야 하는지 지정합니다.
주문 지정 CT 로깅을 사용해야 하며 그렇지 않으면 무시됩니다.
 사용자를 CT 로그에서 제외하는 것을 허용을 참조하십시오.
기본값: false
container 옵션 object 필요한 경우, 주문이 포함될 컨테이너를 지정합니다.
.. id 필수 int 컨테이너 ID입니다.
custom_fields 옵션* array 계정별 사용자 지정 필드입니다.
*이 필드의 필요 여부는 사용자 지정 필드 설정에 따라 다릅니다.
.. metadata_id 필수 int 사용자 지정 필드 ID입니다.
.. value 필수 string 사용자 지정 필드에 대한 값입니다.
데이터 유효성 검사 유형은 사용자 지정 필드에 따라 다릅니다.
technical_contact 옵션 object 기술 연락처 상세 정보입니다.
.. first_name 필수 string
.. last_name 필수 string
.. telephone 필수 string
.. job_title 옵션 string
.. email 필수 string

응답 매개 변수

이름 유형 설명
id int 주문 ID입니다.
certificate_id int 인증서 ID입니다.
dcv_random_value string 도메인 제어 유효성 검사에 사용하는 임의의 값입니다.
 dns-txt-token 또는 http-token 을(를) DCV 방법으로 사용하는 경우에만 반환됩니다.