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단계)을 저장합니다. 액세스 토큰이 더 이상 유효하지 않은 경우 토큰을 다시 생성해야 합니다.