이 엔드포인트를 사용하여 Secure Site Pro EV SSL 인증서 요청 주문을 제출합니다.
curl -X POST \
https://www.digicert.com/services/v2/order/certificate/ssl_ev_securesite_pro \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"certificate": {
"common_name": "example.com",
"dns_names": [
"sub.example.com",
"app.example.com"
],
"csr": "<csr>",
"signature_hash": "sha256",
"organization_units": [
"Shared Services"
],
"server_platform": {
"id": 45
}
},
"comments": "Certificate for app server.",
"container": {
"id": 334455
},
"auto_renew": 1,
"custom_renewal_message": "Keep this renewed.",
"organization": {
"id": 123456,
"contacts": [
{
"contact_type": "organization_contact",
"user_id": 565611
},
{
"contact_type": "technical_contact",
"user_id": 565615
},
{
"contact_type": "ev_approver",
"first_name": "Jill",
"last_name": "Valentine",
"job_title": "STAR Member",
"telephone": "8017019600",
"email": "jill.valentine@digicert.com"
}
]
},
"validity_years": 2,
"payment_method": "balance"
}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/ssl_ev_securesite_pro"
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 \"Shared Services\"\n ],\n \"server_platform\": {\n \"id\": 45\n }\n },\n \"comments\": \"Certificate for app server.\",\n \"container\": {\n \"id\": 334455\n },\n \"auto_renew\": 1,\n \"custom_renewal_message\": \"Keep this renewed.\",\n \"organization\": {\n \"id\": 123456,\n \"contacts\": [\n {\n \"contact_type\": \"organization_contact\",\n \"user_id\": 565611\n },\n {\n \"contact_type\": \"technical_contact\",\n \"user_id\": 565615\n },\n {\n \"contact_type\": \"ev_approver\",\n \"first_name\": \"Jill\",\n \"last_name\": \"Valentine\",\n \"job_title\": \"STAR Member\",\n \"telephone\": \"8017019600\",\n \"email\": \"jill.valentine@digicert.com\"\n }\n ]\n },\n \"validity_years\": 2,\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/ssl_ev_securesite_pro"
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 \"Shared Services\"\n ],\n \"server_platform\": {\n \"id\": 45\n }\n },\n \"comments\": \"Certificate for app server.\",\n \"container\": {\n \"id\": 334455\n },\n \"auto_renew\": 1,\n \"custom_renewal_message\": \"Keep this renewed.\",\n \"organization\": {\n \"id\": 123456,\n \"contacts\": [\n {\n \"contact_type\": \"organization_contact\",\n \"user_id\": 565611\n },\n {\n \"contact_type\": \"technical_contact\",\n \"user_id\": 565615\n },\n {\n \"contact_type\": \"ev_approver\",\n \"first_name\": \"Jill\",\n \"last_name\": \"Valentine\",\n \"job_title\": \"STAR Member\",\n \"telephone\": \"8017019600\",\n \"email\": \"jill.valentine@digicert.com\"\n }\n ]\n },\n \"validity_years\": 2,\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))
}
var request = require("request");
var options = { method: 'POST',
url: 'https://www.digicert.com/services/v2/order/certificate/ssl_ev_securesite_pro',
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: [ 'Shared Services' ],
server_platform: { id: 45 } },
comments: 'Certificate for app server.',
container: { id: 334455 },
auto_renew: 1,
custom_renewal_message: 'Keep this renewed.',
organization:
{ id: 123456,
contacts:
[ { contact_type: 'organization_contact', user_id: 565611 },
{ contact_type: 'technical_contact', user_id: 565615 },
{ contact_type: 'ev_approver',
first_name: 'Jill',
last_name: 'Valentine',
job_title: 'STAR Member',
telephone: '8017019600',
email: 'jill.valentine@digicert.com' } ] },
validity_years: 2,
payment_method: 'balance' },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "pending"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "submitted"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "approved"
}
],
"certificate_id": 113
}
{
"id": 112233,
"certificate_id": 113
}
{
"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>"
}
]
}
인증서 필드에 대해 허용된 값에 대한 정보는 일반 신뢰 인증서 - 업계 표준을 위반하는 데이터 엔트리를 참조하십시오.
이름 | 필수/옵션 | 유형 | 설명 |
---|---|---|---|
certificate | 필수 | object | 인증서 상세 정보입니다. |
.. common_name | 필수 | string | 보호할 도메인입니다. |
.. dns_names | 옵션 | array |
보호할 추가 도메인입니다. 추가 비용이 발생할 수 있습니다. (모범 사례 — 도메인의 두 개 버전 모두를 무료로 받기를 참조하십시오.) |
.. csr | 필수 | string | CSR(인증서 서명 요청) |
.. signature_hash | 필수 | string |
인증서를 서명하기 위해 사용되는 해시 알고리즘입니다. 코드 서명 인증서는 SHA-256만 지원합니다. |
.. 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
|
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 | 인증서 알림 이메일(예, 인증서 발급, 복제 인증서, 인증서 갱신 등)을 받는 주가 이메일 주소입니다. |
locale | 옵션 | string |
DCV 이메일에서 사용하는 언어입니다. 용어집 — 로캘 코드를 참조하십시오. |
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입니다. 또는 주문을 제출할 때 조직 개체를 전달하여 새 조직을 추가할 수 있습니다. 개체 구조 요구 사항은 조직 만들기를 참조하십시오. |
.. contacts | 필수 | array |
조직에 대한 조직 연락처의 목록입니다. 참고: ev_approver 연락처를 포함해야 합니다. 잠재적 EV 승인자를 받으려면 승인자 목록을 참조하십시오.
|
.. .. contact_type | 필수 | string |
주문에 추가할 연락처의 유형입니다. 허용되는 값: organization_contact , technical_contact , ev_approver
|
.. .. user_id | 필수* | int |
계정에 대한 기존 사용자 또는 연락처의 ID입니다. * 새 연락처를 추가하는 경우 생략할 수 있습니다. |
.. .. first_name | 옵션 | string |
새 연락처의 이름(성 제외)입니다. 참고: user_id 을(를) 생략하는 경우 필수입니다. user_id 을(를) 생략하지 않은 경우, 지정된 사용자의 정보가 새 값으로 업데이트됩니다.
|
.. .. last_name | 옵션 | string |
새 연락처의 성입니다. 참고: user_id 을(를) 생략하는 경우 필수입니다. user_id 을(를) 생략하지 않은 경우, 지정된 사용자의 정보가 새 값으로 업데이트됩니다.
|
.. .. job_title | 옵션 | string |
새 연락처의 직함입니다. 참고: user_id 을(를) 생략하는 경우 필수입니다. user_id 을(를) 생략하지 않은 경우, 지정된 사용자의 정보가 새 값으로 업데이트됩니다.
|
.. .. telephone | 옵션 | string |
새 연락처의 전화 번호입니다. 참고: user_id 을(를) 생략하는 경우 필수입니다. user_id 을(를) 생략하지 않은 경우, 지정된 사용자의 정보가 새 값으로 업데이트됩니다.
|
옵션 | string |
새 연락처의 이메일 주소입니다. 참고: user_id 을(를) 생략하는 경우 필수입니다. user_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 인 경우 반환됩니다.
|