Show Menu
화제×

Privacy Service 개발자 가이드

Adobe Experience Platform Privacy Service은 Adobe Experience Cloud 응용 프로그램에서 데이터 주체(고객)의 개인 데이터를 관리(액세스 및 삭제)할 수 있도록 해주는 RESTful API 및 사용자 인터페이스를 제공합니다. 또한 Privacy Service은 Experience Cloud 응용 프로그램과 관련된 작업의 상태 및 결과에 액세스할 수 있는 중앙 감사 및 로깅 메커니즘을 제공합니다.
이 안내서에서는 Privacy Service API를 사용하는 방법에 대해 설명합니다. UI 사용 방법에 대한 자세한 내용은 Privacy Service UI 개요를 참조하십시오 . Privacy Service API에서 사용 가능한 모든 끝점의 전체 목록을 보려면 API 참조를 참조하십시오 .

시작하기

이 안내서에서는 다음 Experience Platform 기능을 이해하는 작업이 필요합니다.
  • Privacy Service : Adobe Experience Cloud 응용 프로그램에서 데이터 주체(고객)의 액세스 및 삭제 요청을 관리하고 삭제할 수 있도록 해주는 RESTful API 및 사용자 인터페이스를 제공합니다.
다음 섹션에서는 Privacy Service API를 성공적으로 호출하기 위해 알아야 할 추가 정보를 제공합니다.

샘플 API 호출 읽기

이 자습서에서는 요청의 서식을 지정하는 방법을 보여주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 올바른 형식의 요청 페이로드가 포함됩니다. API 응답으로 반환된 샘플 JSON도 제공됩니다. 샘플 API 호출 설명서에 사용된 규칙에 대한 자세한 내용은 Experience Platform 문제 해결 안내서의 예제 API 호출 플랫폼 FAQ 및 문제 해결 가이드 읽기 방법에 대한 섹션을 참조하십시오.

필수 헤더에 대한 값 수집

Privacy Service API를 호출하려면 먼저 필요한 헤더에 사용할 액세스 자격 증명을 수집해야 합니다.
  • 인증: 무기명 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
여기에는 Adobe Admin Console에서 Experience Platform에 대한 개발자 권한을 얻은 다음 Adobe 개발자 콘솔에서 자격 증명을 생성하는 작업이 포함됩니다.

개발자가 Experience Platform에 액세스

개발자가 Platform에 액세스하려면 Experience Platform 인증 자습서의 시작 단계를 따르십시오 . "Adobe 개발자 콘솔에서 액세스 자격 증명 생성" 단계에 도달하면 이 자습서로 돌아가 Privacy Service에 대한 자격 증명을 생성합니다.

액세스 자격 증명 생성

Adobe 개발자 콘솔을 사용하여 다음 세 가지 액세스 자격 증명을 생성해야 합니다.
  • {IMS_ORG}
  • {API_KEY}
  • {ACCESS_TOKEN}
사용자 {IMS_ORG} {API_KEY} 는 한 번만 생성되어야 하며 향후 API 호출에서 다시 사용할 수 있습니다. 그러나, 사용자 {ACCESS_TOKEN} 는 임시 작업이므로 24시간마다 다시 생성되어야 합니다.
이러한 값을 생성하는 단계는 아래에 자세히 설명되어 있습니다.

일회성 설정

Adobe Developer Console에서 Adobe ID으로 로그인합니다. 그런 다음 Adobe 개발자 콘솔 문서에서 빈 프로젝트 를 만드는 방법에 대한 자습서에 나와 있는 단계를 따릅니다.
새 프로젝트를 만들었으면 프로젝트 개요 화면에서 API _추가_를클릭합니다.
API _추가_화면이 나타납니다. 사용 가능한 API 목록에서​ Privacy Service API를​ ​선택한 다음​ ​다음을​ ​클릭합니다.
API _구성_화면이 나타납니다. 키 쌍​ ​을 생성하는 옵션을 선택한 다음​ ​오른쪽 아래 모서리에서 키 쌍​ ​생성을 클릭합니다.
키 쌍은 자동으로 생성되고 개인 키와 공용 인증서가 포함된 ZIP 파일이 로컬 컴퓨터에 다운로드됩니다(나중에 사용). 구성 API 저장을 선택하여 구성을 완료합니다.
API가 프로젝트에 추가되면 프로젝트 페이지가 Privacy Service API 개요 페이지에 다시 나타납니다. 여기에서 아래로 스크롤하여 Privacy Service API에 대한 모든 호출에 필요한 다음 액세스 자격 증명을 제공하는 _서비스 계정(JWT)_섹션으로 이동합니다.
  • 클라이언트 ID : 클라이언트 ID는 x-api-key 헤더 {API_KEY} 에서 제공해야 하는 데 필요합니다.
  • 조직 ID : 조직 ID는 x-gw-ims-org-id 헤더에서 사용해야 하는 {IMS_ORG} 값입니다.

각 세션에 대한 인증

수집해야 하는 최종 필수 자격 증명은 인증 헤더에서 사용되는 {ACCESS_TOKEN} 자격 증명입니다. 및 {API_KEY} 의 값과 {IMS_ORG} 달리 Platform API를 계속 사용하려면 24시간마다 새로운 토큰을 생성해야 합니다.
{ACCESS_TOKEN} 를 생성하려면 이전에 다운로드한 개인 키를 열고 액세스 토큰 _생성 옆에 있는 텍스트 상자에 해당_내용을 붙여넣은 후 토큰​ ​생성을​ ​클릭합니다.
새 액세스 토큰이 생성되고 토큰을 클립보드로 복사할 단추가 제공됩니다. 이 값은 필요한 인증 헤더에 사용되며 형식으로 제공해야 합니다 Bearer {ACCESS_TOKEN} .

다음 단계

이제 사용할 헤더를 이해하므로 Privacy Service API에 대한 호출을 시작할 준비가 되었습니다. 개인정보 보호 작업에 대한 문서는 Privacy Service API를 사용하여 수행할 수 있는 다양한 API 호출을 안내합니다. 각 예제 호출에는 일반 API 형식, 필요한 헤더를 표시하는 샘플 요청 및 샘플 응답이 포함됩니다.