DigiCert ONE

DigiCert® ONE은 빠르고 유연한 PKI 배포를 위한 확장성이 있는 기반을 제공하는 최신 PKI 플랫폼입니다. DigiCert ONE API는 인증서 및 장치를 관리하고 워크플로를 사용자 지정 및 자동화하고 DigiCert ONE을 기존 PKI 관리 도구와 통합하는 강력한 인터페이스를 제공합니다.

DigiCert ONE은 다음 콘솔에 있는 작업을 관리하는 API를 포함합니다.

시작하기

DigiCert ONE API를 사용하려면 다음이 필요합니다.

  • DigiCert ONE 계정
  • DigiCert ONE API 키
  • REST API 요청을 만드는 능력

API 키 만들기

새 API 키를 만들려면 다음을 수행합니다.

  1. DigiCert ONE 계정에 로그인합니다.
  2. 계정 관리자 콘솔을 탐색합니다.
  3. 왼쪽 메뉴에서 액세스 > API 토큰을 선택합니다.
  4. API 토큰 만들기를 선택합니다.
  5. 양식을 채워서 키를 만듭니다.

각 API 키는 한 번만 표시됩니다. 분실한 API 키를 검색할 수 있는 방법은 없습니다. API 키를 잃어버리는 경우 해지하고 새 키를 생성하십시오.

인증

DigiCert ONE API는 헤더 기반 인증을 사용합니다. 각 요청은 사용자 지정 HTTP 헤더 x‑api‑key를 포함합니다. 요청을 제출할 때 자신의 API 키를 이 헤더의 값으로 사용합니다.

예를 들어, 새 장치를 만드는 엔드포인트의 요청은 다음과 같습니다.

cURL
curl -X POST \
  'https://one.digicert.com/iot/api/v1/device' \
  -H 'x-api-key: {{api_key}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "division_id": {{division_id}},
    "device_identifier": "MyDevice",
    "device_profile_id": {{device_profile_id}}
  }'
Python
import requests

url = "https://stage.one.digicert.com/iot/api/v1/device"

payload = "{\n  \"division_id\": {{division_id}},\n  \"device_identifier\": \"MyDevice\",\n  \"device_profile_id\": {{device_profile_id}}\n}"
headers = {
  'x-api-key': {{api_key}},
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
Go
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://stage.one.digicert.com/iot/api/v1/device"
  method := "POST"

  payload := strings.NewReader("{\n  \"division_id\": {{division_id}},\n  \"device_identifier\": \"MyDevice\",\n  \"device_profile_id\": {{device_profile_id}}\n}")

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("x-api-key", {{api_key}})
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}
NodeJS
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://stage.one.digicert.com/iot/api/v1/device',
  'headers': {
    'x-api-key': {{api_key}},
    'Content-Type': 'application/json'
  },
  body: "{\n  \"division_id\": {{division_id}},\n  \"device_identifier\": \"MyDevice\",\n  \"device_profile_id\": {{device_profile_id}}\n}"

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

기준 URL

이 기준 URL을 사용하여 DigiCert ONE API 요청을 구성합니다.

generic
https://one.digicert.com

URL 쿼리 문자열

일부 엔드포인트는 URL 쿼리 문자열을 사용하여 결과를 필터링합니다. 엔드포인트 URL에 쿼리 문자열을 추가하려면 ?를 사용합니다. 추가 쿼리 스트링을 추가하려면 &를 사용합니다.

이 예제는 division_id 쿼리 문자열을 사용하여 결과를 지정된 부서로 필터링합니다.

generic
https://one.digicert.com/iot/api/v1/device/{{device_identifier}}?division_id={{division_id}}

요청

모든 요청은 헤더 기반 인증 및 JSON 요청 유형을 포함한 REST 기능을 사용하는 RESTful URL을 통해 제출합니다.

요청에 대한 데이터 문자 집합 인코딩은 UTF-8입니다. 적합하게 구성된 요청은 포트 443을 사용하며 user-agentcontent-length HTTP 헤더가 지정되어 있습니다.

메서드

DigiCert ONE API는 다음을 포함하여 표준 HTTP 메서드를 사용합니다.

  • GET
  • POST
  • PUT
  • DELETE

본문

별도로 표시하지 않은 경우 대부분 요청은 JSON 또는 XML 형식 데이터를 전달해야 합니다. Content-Type 헤더에 대한 지원하는 값은 다음을 포함합니다.

  • application/json

응답

응답은 헤더 및 본문으로 구성됩니다. 응답 본문의 형식은 요청에서 지정하는 content-type(콘텐츠 유형)에 따라 다릅니다.

개별 HTTP 헤더 응답 코드에 대한 자세한 정보는 용어집 - 헤더를 참조하십시오.