Show Menu
화제×

통합 개요 및 사전 요구 사항

이 정보는 Adobe I/O 및 Places Service 통합을 만드는 방법을 보여줍니다.

사용자 액세스를 위한 사전 요구 사항

조직의 시스템 관리자에게 다음 작업이 완료되었는지 확인합니다.
  • 조직의 관리 콘솔에 핵심 서비스가 나타납니다.
  • 조직에 추가되었습니다.
  • 귀사는 조직에서 핵심 서비스를 배치할 사용자로 추가되었습니다.
    자세한 내용은 장소 서비스에 사용자 또는 개발자 추가 및 위치 서비스에 대한 액세스 권한 부여에서 경험 플랫폼 시작 프로필을 장소 서비스 이용 참조하십시오.
  • 귀사는 귀사에서 핵심 서비스를 제공하기 위해 개발자로 추가되었습니다.
    개발자 추가에 대한 자세한 내용은 위치 서비스에 사용자 또는 개발자 추가 및 위치 서비스에 대한 액세스 권한 부여에서 경험 플랫폼 시작 프로필을 참조하십시오.
    개발자 역할에 대한 자세한 내용은 개발자 관리를 참조하십시오 .

REST API 요청

Places Service REST API에 대한 각 요청에는 다음 항목이 필요합니다.
  • 조직 ID
  • API 키
  • 베어러 토큰
Adobe I/O와의 통합에서는 JWT(JSON Web Token)를 사용하여 이러한 항목과 베어러 토큰을 요청하는 방법을 제공합니다.
Adobe I/O 콘솔에 로그인할 수 없거나, Places Service가 통합 만들기 페이지의 **​옵션이 아닌 경우, 웹 서비스 API 개요의 조직 요구 사항을 참조하십시오.

위치 서비스 통합 만들기

장소 서비스 통합을 만들려면 다음 작업을 완료하십시오.

공개 및 개인 키 쌍 생성

장소 서비스 통합을 만들려면 공개 및 개인 키 쌍이 필요합니다. 이러한 쌍을 구입하거나 자체 서명 키를 생성할 수 있습니다.
자체 서명된 키를 생성하려면 다음을 수행합니다.
  1. 터미널 창에서 다음 줄을 복사하여 붙여 넣은 다음 각 줄을 붙여넣은 Enter ​후 누릅니다.
       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    
    쉽게 참조할 수 있도록 키 이름을 지정하고 폴더에 저장하는 것이 좋습니다. 여러 통합을 만들 경우 어느 키가 어느 통합에 속하는지 쉽게 식별하고 관리할 수 있습니다.
  2. OpenSSL에서 요청한 정보를 입력합니다.
    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    
    
    OpenSSL에 대한 자세한 내용은 OpenSSL을 참조하십시오 .
    제공하는 정보는 키에 통합됩니다.
  3. 파일과 .key 파일이 있는 디렉토리로 .crt 이동합니다.
    예를 들어 MacOS에서는 Macintosh HD > users > (your user name) > Keys ​로 이동합니다.
다음 비디오에서는 키 쌍을 생성하는 과정을 안내합니다.

Adobe I/O 콘솔에서 Places Service 통합 만들기

위치 서비스 통합을 만들려면
  1. https://console.adobe.io 으로 이동하여 Adobe ID로 로그인합니다.
  2. 빠른 시작 섹션에서 통합 만들기를 클릭합니다 .
  3. 을 선택하고 Access an API ​클릭합니다​ Continue .
    Access an API ​는 기본 위치입니다.
  4. 두 개 이상의 Experience Cloud 조직에 액세스할 수 있는 경우 오른쪽 상단의 드롭다운 목록에서 조직을 선택합니다.
  5. Under Experience Cloud , select​ Places Service as the Adobe service to which you want to integrate and click Continue .
  6. 을 선택하고 New integration ​클릭합니다​ Continue .
  7. 새 통합 만들기 화면에서 이름과 설명을 입력합니다.
  8. 위에서 만든 xxxx_public.crt 파일을 드래그하여 Public keys certificates ​놓기 영역으로 놓습니다.
  9. 제품 프로필을 선택합니다.
    어떤 프로파일을 선택해야 할지 모르는 경우 시스템 관리자에게 문의하십시오.
  10. At the bottom of the page, click Create integration .
  11. 몇 초 후 #작성 화면에서 다음 메시지가 표시되는지 확인합니다.
    Your integration has been created.
  12. 통합 세부 사항 페이지가 맨 위에 통합 이름과 함께 나타납니다.
    Overview ​탭은 기본적으로 표시되며 API 키, 조직 ID, 기술 계정 ID 및 통합에 대한 기타 세부 정보를 표시합니다.

조직 ID 및 API 키 기록

  1. 통합 세부 사항 페이지에서 Services ​탭을 클릭하고 아래에​ Places Service 표시되는지 확인합니다 Configured Services .
  2. 탭에서 API 키(클라이언트 ID) 및 조직 ID를 찾아 기록합니다. Overview
    이러한 ID는 각 Places Service REST API 요청에 필요합니다.

JWT 토큰 생성

통합 세부 정보 페이지에서 JWT를 생성하고 교환 URL을 제공하여 통합을 테스트할 수 있도록 JWT ​탭을 클릭합니다.
JWT 토큰을 생성하려면
  1. 텍스트 편집기에서 위에서 만든 private.key 파일을 엽니다.
  2. On the JWT ​tab, copy the contents of the key and paste it in the​ Paste private key field.
  3. Generate JWT ​를 클릭합니다.
  4. In the Sample CURL command ​section, click​ Copy and paste the contents in your command prompt or terminal window.
  5. 키보드를 눌러 명령을 Enter ​실행합니다.
  6. "token_type": "bearer" 값을 찾습니다 "access_token" .
    베어러 액세스 토큰의 값은 Places Service API 요청에서 사용할 값입니다.
Adobe 액세스 토큰은 24시간 동안만 유효하므로 샘플 CURL 명령(5단계)을 저장합니다. 액세스 토큰이 더 이상 유효하지 않은 경우 토큰을 다시 생성해야 합니다.