요구 사항

사전 지식

  • AEM Mobile 이해
  • 온디맨드 포털을 통한 콘텐츠 제작 및 게시 관련 지식
  • On-Demand Services API 사용 경험

요구 제품

  • AEM Mobile
  • On-Demand Services API에 대한 액세스

소개

Adobe Experience Manager Mobile(AEM Mobile)은 아티클, 컬렉션, 제품, 푸시 알림 등을 프로그래밍 방식으로 관리할 수 있는 강력한 기능의 On-Demand Services API를 제공합니다. 또한 이 API는 이제 대부분의 기능을 사용할 수 있는 콘텐츠 관리 시스템, 웹 기반 제작 도구, 게시 워크플로 시스템을 통해 서드 파티 시스템과의 통합을 가능케 합니다. (추가 정보는 AEM Mobile과 서드 파티 시스템 통합을 참조하십시오.)

On-Demand Services API와 연결되는 사용자 정의 코드를 작성하고자 하는 경우와 서드 파티 시스템과의 통합으로 인한 기존의 장점을 취하려는 경우 모두 유효한 API 자격 증명이 필요합니다. 이 아티클에서는 API 키가 사용되는 방법을 설명합니다.

 

API 자격 증명

API 자격 증명은 다음과 같은 항목으로 구성됩니다.

  • API 키클라이언트 암호는 API 게이트웨이에 액세스하기 위한 자격 증명입니다.
  • 디바이스 ID디바이스 토큰은 API 사용자를 식별하기 위한 자격 증명입니다.

API 사용 시나리오 및 요구 사항

On-Demand Services API를 통해 연결하고자 하는 방식에 따라 다음과 같은 요구 사항이 적용됩니다.

호스팅되는 (멀티 테넌트) 솔루션

예: WoodWing Enterprise, WoodWing Inception, Storied, Specle

  • 호스팅되는 모든 솔루션은 고유의 API 키가 필요합니다.
  • 호스팅되는 모든 솔루션의 사용자는 자신의 API 키가 필요하지 않습니다.
  • 솔루션 소유자가 이 API 키를 사용자/고객에게 제공합니다.
  • 호스팅되는 솔루션의 사용자는 API 키를 사용하여 자신의 디바이스 ID 및 디바이스 토큰을 생성한 다음 이들 자격 증명을 호스팅되는 솔루션에 입력합니다.

온프레미스 (싱글 테넌트) 솔루션

예: Adobe Experience Manager, vjoon K4, WordPress 및 Drupal

  • 온프레미스 솔루션을 배포하려는 모든 고객은 자신의 API 키가 필요합니다.
  • 고객은 자신이 구현하는 여러 온프레미스 솔루션에 자신의 API 키를 사용할 수 있습니다.
  • 고객은 자신의 디바이스 ID 및 디바이스 토큰을 생성하고 이들 자격 증명을 자신의 온프레미스 솔루션에 입력해야 합니다.

사용자 정의 통합

예: 파트너나 고객이 코딩한 사용자 정의 워크플로

  • 온프레미스 (싱글 테넌트) 경우의 요구 사항과 동일합니다.
  • 고객은 자신의 API 키, 디바이스 ID, 디바이스 토큰이 필요합니다.

필요한 API 자격 증명을 얻기 위한 정보는 다음 섹션을 참조하십시오.

API 키 요청

API 키는 Adobe API 게이트웨이에 대한 액세스 권한을 얻는 데 사용됩니다. 이 게이트웨이는 API에서도 사용되는 일반적인 인프라입니다. 모든 공개 API는 Adobe API 게이트웨이 뒤에 있습니다. API 게이트웨이 뒤에 있는 서비스와 상호 작용하려면 API 키가 필요합니다. API 키는 개별 Adobe ID에 연결되어 있지 않으며 Adobe가 이를 해지하지 않는 한 만료되지 않습니다. API 키는 이름 및 암호, 두 부분으로 구성됩니다. 이 암호를 API 키용 “암호”로 간주해도 됩니다.

API 키와 클라이언트 암호는 가끔 다른 이름으로 불리기도 합니다. 다음의 용어는 모두 같은 것입니다.

API 키 = “IMS 클라이언트 ID” = “클라이언트 ID” = “Adobe API 키” = “Adobe 키”

클라이언트 암호 = “암호” = “Adobe API 암호” = “Adobe 암호”

API 키를 요청하려면 요청서 PDF를 다운로드하여 제출합니다. 자세한 내용은 AEM Mobile과 서드 파티 시스템 통합: API 키를 참조하십시오.

API 액세스에 마스터 관리자 Adobe ID를 사용하지 않는 것이 좋습니다. 프로젝트를 제작하고 필요한 프로젝트 각각에 전용 계정을 추가하는 용도로만 마스터 관리자 계정을 사용하십시오. 예를 들어 Drupal 인스턴스와 WordPress 인스턴스를 가지고 있고 마스터 관리자가 aemm_master@adobe.com인 경우 Drupal에 대한 전용 API Adobe ID는 aemm_drupal@adobe.com(마스터 관리자 아님)이 될 수 있습니다. WordPress에 대한 전용 Adobe ID는 aemm_wordpress@adobe.com(마스터 관리자 아님)이 될 수 있습니다. 이후, 예를 들어 aemm_master@adobe.com으로 “Drupal Mag” 및 “WordPress Mag”라 칭하는 프로젝트를 제작하고 필요한 역할과 권한만 포함하여 이들 프로젝트에 aemm_drupal@adobe.com 및 aemm_wordpress@adobe.com을 추가합니다. (이들 전용 API 계정에 “콘텐츠 추가 및 편집”, “콘텐츠 삭제”, “콘텐츠 보기”, “콘텐츠 게시” 등 API 사용과 관련하여 필요한 권한만 부여합니다. 요구되는 특정 권한에 대한 솔루션 관련 설명서를 확인하십시오. AEM Mobile용 계정 관리를 참조하십시오.

요청이 처리되면 IMS 클라이언트 ID(내 API 키)와 클라이언트 암호를 받게 됩니다. 지정한 Adobe ID는 “화이트리스트” 게재 상태가 되며 다음 단계의 설명에 따라 관련 디바이스 ID와 디바이스 토큰을 만들 수 있습니다.

 

 

 

디바이스 ID 및 디바이스 토큰 생성

API 키와 클라이언트 암호를 얻고 나면 API 사용자를 식별하기 위한 디바이스 ID 및 디바이스 토큰을 생성해야 합니다.

  1. https://aex.aemmobile.adobe.com/에서 IMS 디바이스 토큰 생성기(“AEX 포털”)로 이동하여 내 API 키/IMS 클라이언트 ID를 입력합니다.
  2. 디바이스 ID/토큰을 만들려는 화이트리스트에 게재된 Adobe ID(API 키 요청 양식에 지정한 Adobe ID 중 하나)를 사용하여 로그인합니다.
  3. 디바이스 ID와 디바이스 토큰이 생성되고 표시됩니다. 이를 복사하여 안전한 장소에 저장합니다.

Adobe ID 암호를 변경하면 이 디바이스 ID/디바이스 토큰은 사용할 수 없다는 점을 참고하십시오. 이 디바이스 ID/디바이스 토큰을 Adobe ID 및 암호의 해시라고 생각하면 됩니다.

디바이스 ID/디바이스 토큰은 6개월 동안 유효하며 사용하지 않으면 더 이상 유효하지 않게 된다는 점도 참고하십시오. 사용하는 경우에는 자동으로 갱신됩니다.

AEM Mobile API 액세스

API를 통해 지원되는 서드 파티 시스템에 연결하는 경우 시스템의 설정 과정에서 적절한 필드에 API 키 및 클라이언트 암호(온프레미스/싱글 테넌트 솔루션만 해당), 디바이스 ID 및 디바이스 토큰만 간단히 입력하면 됩니다.

자신의 사용자 정의 코드를 통해 API에 직접 액세스하는 경우에는 On-Demand Services API 패키지에 있는 다음의 설명을 참조하십시오.

  • 디바이스 ID/디바이스 토큰은 인증 API 끝점을 통한 액세스 토큰을 생성하는 데 사용됩니다.
  • 모든 API 호출에 대해 API 키와 액세스 토큰의 조합이 필요합니다.

개발 및 제작 환경에서 API 키 사용

사용자 정의 통합을 개발 중인 경우나 별도의 제작 및 개발 온프레미스 시스템이 있는 경우 별도의 제작 및 개발용 API 키를 사용해야 합니다.

시스템을 새로 개발 중인 경우에는 위에 설명된 절차에 따라 API 키를 요청할 수 있습니다. 시스템을 제작에 배포하고 나면 API를 추가로 요청해야 합니다.

디바이스 ID 및 디바이스 토큰 기술 계정 단계적 폐지

향후 디바이스 ID 및 디바이스 토큰 워크플로는 온디맨드 포털을 통해 관리되는 새로운 기술 계정의 구현으로 인해 사용이 중단될 예정입니다. API 키는 계속 사용됩니다. 디바이스 ID 및 디바이스 토큰을 사용하여 인증하고 액세스 토큰을 구하는 대신, 시스템에서는 액세스 토큰을 요청하는 데 사용할 수 있는 “기술 계정”을 제공하게 됩니다. 프로세스를 부트스트래핑하기 위해 “일회용 토큰”이 생성됩니다. 이 식별자는 오직 한 번만 사용할 수 있습니다. 계정 정보의 소비자는 Adobe 서비스를 통해 일회용 토큰을 인증 토큰으로 교환합니다. 이렇게 해서 얻어진 토큰은 저장했다가 향후 인증 시 사용할 수 있습니다.

이 작업에는 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License의 라이센스가 부여되었습니다.  Twitter™ 및 Facebook 게시물은 Creative Commons 약관을 적용받지 않습니다.

법적 고지 사항   |   온라인 개인 정보 보호 정책