설명서Experience PlatformData Governance 안내서

공개 인증서 끝점

Last update: Wed Sep 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

이 안내서에서는 공개 인증서 끝점을 사용하여 조직의 Adobe 애플리케이션에 대한 공개 인증서를 안전하게 검색하는 방법을 설명합니다. 여기에는 개발자가 데이터 교환을 인증하고 확인하는 데 도움이 되는 샘플 API 호출 및 세부 지침이 포함되어 있습니다.

시작하기

계속하기 전에 시작 안내서에서 필수 헤더와 예제 API 호출을 읽는 방법 등 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.

API 경로 paths

다음 정보는 mTLS 서비스 API를 사용하는 데 필요한 필수 API 경로입니다. 여기에는 플랫폼 게이트웨이 URL, API의 기본 경로 및 공개 인증서를 검색하기 위한 전체 경로의 예가 포함됩니다.

  • 플랫폼 게이트웨이 URL: https://platform.adobe.io/
  • 이 API의 기본 경로: /data/core/mtls
  • 전체 경로의 예: https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate

공개 인증서 검색 list

/v1/certificate/public-certificate 끝점에 대한 GET 요청을 통해 조직의 Adobe 응용 프로그램에 대한 공개 인증서를 검색할 수 있습니다.

API 형식

GET /v1/certificate/public-certificate

공개 인증서를 검색할 때 다음의 선택적 쿼리 매개 변수를 사용할 수 있습니다.

쿼리 매개 변수
설명
예
page
요청 결과가 시작될 페이지를 지정합니다.
page=5
limit
페이지당 검색할 최대 공개 인증서 수입니다.
limit=20

요청

조직과 연결된 공개 인증서를 반환하는 샘플 요청은 아래의 축소 가능 섹션에 표시됩니다.

샘플 요청
code language-shell 
curl -X GET https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}'

응답

성공적인 응답은 HTTP 상태 200을 반환하고 조직에 대한 공개 인증서를 나열합니다.

샘플 성공 응답
code language-json 
{
   "results":[
      {
         "certCommonName":"Adobe Experience Platform",
         "publicCertificate":"-----BEGIN CERTIFICATE-----\nMIIDQTCCAimgAwIBAgITBmyfACAfma......KJY5u89CjAwj\n-----END CERTIFICATE-----",
         "expiryDate":"2024-07-17T21:27:57.434Z"
      }
   ],
   "total":0,
   "count":0,
   "_links":{
      "next":{
         "href":"string",
         "templated":true
      },
      "prev":{
         "href":"string",
         "templated":true
      },
      "page":{
         "href":"string",
         "templated":true
      }
   }
}
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
속성 설명
certCommonName 인증서의 일반 이름(CN)이며, 일반적으로 인증서를 발급하는 서버나 엔티티의 이름 또는 ID를 나타냅니다.
publicCertificate 통신을 인증하고 암호화하는 데 사용되는 문자열 형식의 실제 공개 인증서입니다.
expiryDate 공개 인증서가 만료되는 날짜 및 시간으로 ISO 8601(UTC) 형식으로 지정됩니다.

다음 단계

이제 이 안내서를 읽고 Adobe Experience Platform API를 사용하여 공개 인증서를 검색하는 방법을 이해합니다. 규정 및 조직 정책을 준수하도록 고객 데이터를 관리하는 방법에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하세요.

recommendation-more-help
834e0cae-2761-454a-be4d-62f0fd4b4456