Adobe Target API에 대한 인증 구성

Recommendations 관리 API를 비롯한 Adobe Target 관리 API는 인증으로 보호되므로 권한이 있는 사용자만 Adobe Target에 액세스할 수 있도록 합니다. Adobe 개발자 콘솔을 사용하여 Target를 비롯한 모든 Adobe Experience Cloud 솔루션에 대한 이 인증을 관리합니다.

이 단원에서는 Adobe Target API와 성공적으로 인터랙션하는 데 필요한 인증 토큰을 생성하는 데 필요한 예비 단계를 안내합니다. 다음 섹션에서 다음을 수행합니다.

  1. Adobe 개발자 콘솔에서 프로젝트(이전의 통합이라고 함)를 만듭니다.
  2. 프로젝트 세부 사항을 Postman으로 내보냅니다.
  3. 베어러 액세스 토큰을 생성합니다.
  4. 베어러 액세스 토큰을 테스트합니다.

전제 조건

리소스 세부 사항
Postman 이러한 단계를 성공적으로 완료하려면 운영 체제에 대한 Postman 앱을(를) 가져오십시오. Postman basic은 계정 생성으로 무료입니다. 일반적으로 Adobe Target API를 사용하기 위해 필요하지 않지만, Postman은 API 워크플로우를 보다 쉽게 만들고, Adobe Target은 API를 실행하고 작동 방식을 배우는 데 도움이 되는 여러 Postman 컬렉션을 제공합니다. 이 자습서의 나머지 부분에서는 Postman에 대한 작업 지식을 가정합니다. 도움이 필요한 경우 포스트맨 설명서를 참조하십시오.
참조 이 자습서의 나머지 부분에서는 다음 리소스에 대해 잘 알고 있다고 가정합니다.

Adobe I/O 프로젝트 만들기

이 단원에서는 Adobe 개발자 콘솔에 액세스하고 Adobe Target에 대한 프로젝트를 만듭니다. 자세한 내용은 프로젝트](https://www.adobe.io/apis/experienceplatform/console/docs.html#!AdobeDocs/adobeio-console/master/projects.md)에 대한 [설명서를 참조하십시오.

  1. Adobe Admin Console에서 Adobe 사용자 계정에 Target에 대한 제품 관리자개발자 수준 액세스 권한이 모두 부여되었는지 확인합니다.

  2. Adobe 개발자 콘솔에서 이 통합을 만들 Experience Cloud 조직을 선택합니다. (단일 Experience Cloud 조직에만 액세스할 수 있을 수 있습니다.)

    configure-io-target-createproject2.png

  3. 새 프로젝트 만들기​를 클릭합니다.

    configure-io-target-createproject3.png

  4. Adobe 서비스 및 제품에 액세스하려면 API 추가​를 클릭합니다.

    API 추가

  5. 통합할 Adobe 서비스로 Adobe Target​을 선택합니다. 나타나는 다음 단추를 클릭합니다.

    configure-io-target-createproject5

  6. 공개 및 개인 키를 Target에 대해 만드는 서비스 계정 통합에 연결하는 옵션을 선택합니다. 이 자습서에 대해 옵션 1:키 쌍​을 생성하고 키 쌍 생성​을 클릭합니다.
    configure-io-target-createproject6

  7. 결과를 확인하십시오! 필요에 따라 개인 키가 포함된 자동으로 다운로드된 구성 파일(config)을 적어 둡니다. 다음​을 클릭합니다.
    configure-io-target-createproject7

  8. 파일 시스템에서 이전 단계에서 만든 압축된 구성 파일인 config의 위치를 확인합니다. 이 config 파일에는 나중에 필요한 개인 키가 포함되어 있습니다. 파일 시스템 내의 정확한 위치는 여기에 표시된 위치와 다를 수 있습니다.
    configure-io-target-createproject8

  9. Adobe 개발자 콘솔에서 Recommendations을(를) 사용하고 있는 속성에 해당하는 제품 프로필을 선택합니다. 속성을 사용하지 않는 경우 기본 작업 공간 옵션을 선택합니다. 구성된 API 저장​을 클릭합니다.
    configure-io-target-createproject9

  10. 통합 만들기​를 클릭합니다. API가 성공적으로 구성되었다는 임시 메시지를 수신해야 합니다.

  11. 최종 단계로 프로젝트 이름을 원래 Project 1보다 의미 있는 이름으로 변경하십시오. 이렇게 하려면 표시된 탐색 경로를 사용하여 프로젝트로 이동하고 프로젝트 편집​을 클릭하여 **프로젝트 편집 모달에 액세스하고 프로젝트 이름을 변경합니다.

configure-io-target-createproject11

노트

이 자습서에서는 프로젝트 이름을 "Target 통합"이라고 지정합니다. Adobe Target 이상의 용도에서 프로젝트를 사용하려면 적절한 이름을 지정해야 합니다. 예를 들어 "Adobe API" 또는 "Experience Cloud API"라는 이름은 Adobe Experience Cloud의 다른 솔루션과 함께 사용할 수 있으므로 선택할 수 있습니다.

프로젝트 세부 사항 내보내기

이제 Target에 액세스하는 데 사용할 수 있는 Adobe 프로젝트가 있으므로 Adobe API 요청과 함께 해당 프로젝트의 세부 정보를 보내야 합니다. 이러한 세부 사항은 여러 Target API를 비롯한 여러 Adobe API와 상호 작용하기 위해 필요합니다. 예를 들어 통합 세부 사항에는 Target 관리 API에 필요한 인증 및 인증 정보가 포함됩니다. 따라서 Postman에서 API를 사용하려면 해당 세부 사항을 Postman으로 가져와야 합니다.

Postman에서 프로젝트의 세부 사항을 지정하는 방법은 여러 가지가 있지만, 이 섹션에서는 미리 만들어진 일부 기능과 컬렉션을 이용합니다. 먼저(이 섹션에서) 통합 세부 사항을 Postman 환경으로 내보냅니다. 다음(다음 섹션)에서는 필요한 Adobe 리소스에 액세스할 수 있도록 하는 베어러 액세스 토큰을 생성합니다.

노트

Target을(를) 비롯한 모든 Experience Cloud 솔루션에 해당하는 비디오 지침은 Experience Platform API와 함께 포스트만 사용을 참조하십시오. 다음 섹션은 Target API와 관련이 있습니다.

  1. Postman으로 Adobe I/O 통합 세부 사항 내보내기
  2. Postman을 사용하여 액세스 토큰 생성

이러한 단계는 아래에도 제공됩니다.

  1. 여전히 Adobe 개발자 콘솔에 있으며 새 프로젝트의 서비스 계정(JWT) 자격 증명을 볼 수 있습니다. 왼쪽 탐색 또는 자격 증명 섹션을 표시합니다.
    JWT1
    자격 증명 세부 사항 .​공개 키, 클라이언트 ID 및 서비스 계정과 관련된 기타 정보를 볼 수 있습니다.
    JWT1a

  2. Adobe Target API에 대한 정보를 탐색하려면 을 클릭합니다. 왼쪽 탐색 또는 연결된 제품 및 서비스 섹션을 표시하십시오.
    JWT2

  3. Postman 환경에 대한 인증 정보를 캡처하는 JSON 파일을 만들려면 Download for Postman > 서비스 계정(JWT)​을 클릭합니다.
    JWT3
    파일 시스템에 JSON 파일을 메모해 둡니다.
    JWT3a

  4. Postman에서 기어 아이콘을 클릭하여 환경을 관리하고 가져오기​를 클릭하여 JSON 파일(환경)을 가져옵니다.
    JWT4

  5. 파일을 선택하고 열기​를 클릭합니다.
    JWT5

  6. Postman 환경 관리 모달에서 새로 가져온 환경의 이름을 클릭하여 검사합니다. (환경 이름은 여기에 표시된 환경 이름과 다를 수 있습니다. 원하는 대로 이름을 편집합니다. Adobe 프로젝트 이름과 일치할 필요는 없습니다.)
    JWT6

  7. 참고: CLIENT_SECRETAPI_KEY(다른 변수와 함께)에는 Adobe 개발자 콘솔에서 정의된 대로 통합에서 생성된 값이 미리 채워집니다. (Postman CLIENT_SECRET 변수는 개발자 콘솔에 표시된 CLIENT SECRET Adobe 자격 증명과 일치해야 하고, Postman의 API_KEY는 개발자 콘솔의 CLIENT ID와 비슷하게 일치해야 합니다.) 이와 반대로 PRIVATE_KEY, JWT_TOKENACCESS_TOKEN는 비어 있음을 참고하십시오. 먼저 PRIVATE_KEY 값을 제공합니다.
    JWT7

    노트

    깜짝!

    퀴즈! 개인 열쇠가 어디 있는지 기억나니?
    맞습니다. Adobe 개발자 콘솔에서 이전에 다운로드한 config 파일에 있습니다!

  8. 파일 시스템에서 config 파일을 열고 private 키 파일을 엽니다.
    JWT8

  9. private 키 파일의 전체 내용을 선택하고 복사합니다.
    JWT9

  10. Postman에서 개인 키 값을 INITIAL VALUECURRENT VALUE 필드에 붙여 넣습니다.
    JWT10

  11. 업데이트​를 클릭하고 환경 양식을 닫습니다.

베어러 액세스 토큰 생성

이 섹션에서는 Adobe Target API와의 상호 작용을 인증하는 데 필요한 베어러 액세스 토큰을 생성합니다. 베어러 액세스 토큰을 생성하려면 통합 세부 사항(이전 섹션에 설정됨)을 Adobe Identity Management 서비스(IMS)로 보내야 합니다. 이 방법에는 몇 가지 다른 방법이 있지만, 이 자습서에서는 IMS API에 정확한 POST 요청을 만듭니다. 농담이지 이 자습서에서는 프로세스를 직접적이고 쉽게 만드는 미리 만들어진 IMS 호출이 포함된 Postman 컬렉션을 활용합니다. 컬렉션을 가져오면 필요할 때마다 다시 사용할 수 있으므로 Adobe Target뿐만 아니라 다른 Adobe API에 대한 새로운 토큰을 생성합니다.

  1. Adobe Identity Management Service API 샘플 호출으로 이동합니다.
    token1

  2. Adobe I/O 액세스 토큰 생성 Postman 컬렉션​을 클릭합니다.
    token2

  3. Raw​를 클릭한 다음 결과 JSON을 클립보드에 복사하여 이 컬렉션에 대한 원시 JSON을 가져옵니다. (또는 원시 JSON을 .json 파일로 저장할 수 있습니다.)
    token3

  4. Postman에서, 클립보드에 있는 원시 JSON을 붙여 넣고 제출하여 컬렉션을 가져옵니다. 또는 저장한 .json 파일을 업로드할 수 있습니다. 계속​을 클릭합니다.
    token4

  5. IMS::JWT Adobe I/O 액세스 토큰 생성 포스트만 컬렉션의 사용자 토큰 요청을 통해 + 인증을 생성하고, 사용자 환경이 선택되었는지 확인하고 보내기​를 클릭하여 토큰을 생성합니다.

    토큰5

    노트

    이 베어러 액세스 토큰은 24시간 동안 유효합니다. 새 토큰을 생성해야 할 때마다 요청을 다시 전송합니다.

  6. 환경 관리 양식을 다시 열고 환경을 선택합니다.
    token6

  7. 이제 ACCESS_TOKENJWT_TOKEN 값이 채워집니다.
    token7

노트

Q:JWT(JSON Web Token) 및 전달자 액세스 토큰을 생성하려면 Adobe I/O 액세스 토큰 생성 포스트만 컬렉션을 사용해야 합니까?

A:아니! Postman에서 JWT 및 전달자 액세스 토큰을 보다 쉽게 생성할 수 있도록 Adobe I/O 액세스 토큰 생성 포스트만 컬렉션을 편리하게 이용할 수 있습니다. 또는 Adobe 개발자 콘솔 내의 기능을 사용하여 직접 베어러 액세스 토큰을 생성할 수도 있습니다.

베어러 액세스 토큰 테스트

이 연습에서는 Target 계정에서 활동 목록을 검색하는 API 요청을 전송하여 새 베어러 액세스 토큰을 사용합니다. 성공적인 응답은 Adobe 프로젝트와 인증이 API를 사용하기 위해 예상대로 작동함을 나타냅니다.

  1. Adobe Target Admin API Postman 컬렉션을 가져옵니다. Postman에서 컬렉션을 가져올 때까지 모든 프롬프트를 따릅니다.
    testtoken1

  2. 컬렉션을 확장하고 목록 활동 요청을 메모하십시오.
    testtoken1

  3. {{access_token}} 등의 변수는 처음에 확인되지 않습니다. 이를 다양한 방법으로 해결할 수 있습니다. 예를 들어 {{access_token}}이라는 새 컬렉션 변수를 정의할 수 있지만 이 자습서에서는 이전에 사용하던 Postman 환경을 활용하도록 API 요청을 대신 변경합니다. 이렇게 하면 환경이 Adobe API에 공통되는 모든 변수를 하나의 일관된 통합 기능으로 계속 사용할 수 있습니다.
    testtoken2

  4. {{access_token}}을(를) {{ACCESS_TOKEN}}(으)로 바꿀 입력합니다.
    testtoken3

  5. {{api_key}}을(를) {{API_KEY}}(으)로 바꿀 입력합니다.
    testtoken4

  6. {{tenant}}을(를) {{TENANT_ID}}(으)로 바꿀 입력합니다. {{TENANT_ID}}은(는) 아직 인식되지 않습니다.
    testtoken4

  7. 환경 관리 양식을 열고 환경을 선택합니다.
    JWT11

  8. {{TENANT_ID}} 환경 변수를 추가하려면 입력합니다. 테넌트 ID 값을 복사하여 새 TENANT_ID 환경 변수에 대한 INITIAL VALUECURRENT VALUE 필드에 붙여 넣습니다.

    testtoken5

    노트

    테넌트 ID가 Target clientcode과(와) 다릅니다. 테넌트 ID는 Target에 로그인하면 URL에 있습니다. 테넌트 ID를 얻으려면 Adobe Experience Cloud에 로그인하고 Target을 열고 Target 카드를 클릭합니다. URL 하위 도메인에 명시된 테넌트 ID 값을 사용합니다.

    예를 들어 Adobe Target에 로그인할 때 URL이

    <https://mycompany.experiencecloud.adobe.com/...>

    그러면 테넌트 ID가 "mycompany"입니다.

  9. 올바른 환경을 선택했는지 확인한 후 요청을 보냅니다. 활동 목록이 포함된 응답을 받아야 합니다.
    testtoken6

축하합니다! Adobe 인증을 확인했으므로 Adobe Target API(및 다른 Adobe API)와 상호 작용할 때 사용할 수 있습니다. 예를 들어 Recommendations API를 사용하여 권장 사항을 만들거나 관리할 수 있습니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now