Brand Portal을 사용하여 AEM Assets을 Cloud Service으로 구성

Adobe Experience Manager Assets Brand Portal을 구성하면 Adobe Experience Manager Assets에서 승인된 브랜드 자산을 Cloud Service 인스턴스로 Brand Portal에 게시하고 Brand Portal 사용자에게 배포할 수 있습니다.

Cloud Manager를 사용하여 Brand Portal 활성화

Cloud Manager 사용자는 AEM Assets에 대해 Cloud Service 인스턴스로 Brand Portal을 활성화합니다. 활성화 워크플로우는 백엔드에 필수 구성(인증 토큰, IMS 구성 및 Brand Portal 클라우드 서비스)을 만들고 Cloud Manager에서 Brand Portal 테넌트의 상태를 반영합니다. Brand Portal을 활성화하면 AEM Assets 사용자가 자산을 Brand Portal에 게시하여 Brand Portal 사용자에게 배포할 수 있습니다.

전제 조건

AEM Assets에서 Cloud Service 인스턴스로 Brand Portal을 활성화하려면 다음 항목이 필요합니다.

  • Cloud Service 인스턴스로 실행 중인 AEM Assets.
  • Cloud Manager 제품의 프로필에 할당된 Cloud Manager에 액세스할 수 있는 사용자. 자세한 내용은 Cloud Manager액세스 를 참조하십시오.
노트

Cloud Service 인스턴스로 AEM Assets은 하나의 Brand Portal 테넌트와만 연결할 수 있습니다. AEM Assets에 Cloud Service 인스턴스로 여러 환경(개발, 프로덕션 및 스테이지)이 있을 수 있으며, 여기서 Brand Portal은 하나의 환경에서 활성화됩니다.

Brand Portal 활성화 절차

AEM Assets에 대한 환경을 Cloud Service 인스턴스로 만들거나 별도로 Brand Portal을 활성화할 수 있습니다. 환경이 이미 만들어졌다고 가정하고 이제 Brand Portal을 활성화해야 합니다.

  1. Cloud Manager에 로그인하고 환경​으로 이동합니다.

    환경 페이지에는 모든 기존 환경의 목록이 표시됩니다.

  2. 목록에서 환경(하나씩)을 선택하여 환경 세부 사항을 확인합니다.

    Brand Portal은 사용 가능한 환경 중 하나에 액세스할 수 있으며 환경 정보​에 반영됩니다.

    Brand Portal과 연관된 환경이 발견되면 Brand Portal 활성화 단추를 클릭하여 활성화 워크플로우를 시작합니다.

    Brand Portal 활성화

  3. 활성화 워크플로우가 백엔드에서 필요한 구성을 만들므로 Brand Portal 테넌트를 활성화하는 데 몇 분이 소요됩니다. Brand Portal 테넌트가 활성화되면 상태가 활성화됨으로 변경됩니다.

    상태 보기

노트

Brand Portal은 Cloud Service 인스턴스와 AEM Assets의 동일한 IMS 조직에서 활성화되어야 합니다.

IMS 조직(org1-existing)에 대해 Adobe 개발자 콘솔🔗)을 사용하여 수동으로 구성한 기존 Brand Portal 클라우드 구성()이 있고 다른 IMS 조직(org2-new)에 대해 Cloud Service 인스턴스가 구성된 경우, Cloud Manager에서 Brand Portal을 활성화하면 Brand Portal IMS 조직이 org2-new로 재설정됩니다. org1-existing에 수동으로 구성된 클라우드 구성은 AEM Assets 작성자 인스턴스에 표시되지만, Cloud Manager에서 Brand Portal을 활성화한 후에는 더 이상 사용할 수 없습니다.

기존 Brand Portal 클라우드 구성 및 Cloud Service 인스턴스로 AEM Assets이 동일한 IMS 조직(org1)을 사용하는 경우 Cloud Manager에서 Brand Portal을 활성화하기만 하면 됩니다.

자동 생성된 설정은 수정하지 마십시오.

참고 항목:

Brand Portal 테넌트에 로그인:

Cloud Manager에서 Brand Portal 테넌트가 활성화되면 Admin Console에서 또는 테넌트 URL을 사용하여 Brand Portal에 직접 로그인할 수 있습니다.

Brand Portal 테넌트의 기본 URL은 다음과 같습니다. https://<tenant-id>.brand-portal.adobe.com/

여기서 테넌트 ID는 IMS 조직입니다.

Brand Portal URL을 모르는 경우 다음 단계를 수행하십시오.

  1. Admin Console에 로그인하고 Products​로 이동합니다.

  2. 왼쪽 레일에서 Adobe Experience Manager Brand Portal - Brand Portal​을 선택합니다.

  3. Brand Portal​로 이동 을 클릭하여 브라우저에서 직접 Brand Portal을 엽니다.

    또는 Brand Portal 링크로 이동 링크에서 Brand Portal 테넌트 URL을 복사하여 브라우저에 붙여 넣어 Brand Portal 인터페이스를 엽니다.

    Brand Portal 액세스

연결 테스트

다음 단계를 수행하여 AEM Assets as a Cloud Service 인스턴스와 Brand Portal 임차인 간의 연결을 확인합니다.

  1. AEM Assets에 로그인합니다.

  2. 도구 패널에서 배포 > 배포​로 이동합니다.

    Brand Portal 배포 에이전트(bpdistributionagent0)는 Brand Portal에 게시​에 만들어집니다.

  3. Brand Portal에 게시​를 클릭하여 분배 에이전트를 엽니다.

    상태 탭 아래에서 분배 큐를 볼 수 있습니다.

    분배 에이전트에는 두 개의 큐가 있습니다.

    • 처리 큐: Brand Portal에 자산을 분배하기 위해 사용됩니다.

    • 오류 큐: 배포가 실패한 자산에 대해 입니다.

    노트

    오류를 검토하고 error-queue 를 정기적으로 지우는 것이 좋습니다.

  4. AEM Assets을 Cloud Service (으)로 연결하고 Brand Portal 간의 연결을 확인하려면 연결 테스트 아이콘을 클릭합니다.

    테스트 패키지가 성공적으로 전달되었다는 메시지가 나타납니다.

    노트

    자산 분배(큐에서 실행)가 실패하는 원인이 될 수 있으므로 분배 에이전트를 비활성화하지 마십시오.

AEM Assets as a0/> 인스턴스와 Brand Portal 임차인 간의 연결을 확인하려면 AEM Assets의 자산을 Brand Portal에 게시합니다. Cloud Service 연결에 성공하면 게시된 자산이 Brand Portal 인터페이스에 표시됩니다.

이제 다음을 수행할 수 있습니다.

자세한 내용은 Brand Portal 설명서를 참조하십시오.

분배 로그

자산 게시 작업 과정에 대한 분배 에이전트 로그를 모니터링할 수 있습니다.

이제 AEM Assets에서 Brand Portal으로 자산을 게시하여 로그를 보도록 하겠습니다.

  1. 연결 테스트 섹션에 표시된 대로 절차(1에서 4)를 수행하고 분배 에이전트 페이지로 이동합니다.

  2. 로그​를 클릭하여 처리 및 오류 로그를 확인합니다.

분배 에이전트가 다음 로그를 생성했습니다.

  • 정보: 분배 에이전트의 성공적인 구성을 트리거하는 시스템 생성 로그입니다.
  • DSTRQ1(요청 1): 테스트 연결에 대해 트리거합니다.

자산을 게시할 때 다음 요청 및 응답 로그가 생성됩니다.

분배 에이전트 요청:

  • DSTRQ2(요청 2): 자산 게시 요청이 트리거됩니다.
  • DSTRQ3(요청 3): 시스템이 다른 요청을 트리거하여 AEM Assets 폴더(자산이 있는 폴더)를 게시하고 Brand Portal에서 폴더를 복제합니다.

분배 에이전트 응답:

  • queue-bpdistributionagent0(DSTRQ2): 자산이 Brand Portal에 게시됩니다.
  • queue-bpdistributionagent0(DSTRQ3): 시스템이 Brand Portal에서 AEM Assets 폴더(자산 포함)를 복제합니다.

위의 예에서 추가적인 요청 및 응답이 트리거됩니다. 자산이 처음으로 게시되었기 때문에 시스템이 Brand Portal에서 상위 폴더(경로 추가)를 찾을 수 없어서 자산이 게시된 Brand Portal에서 동일한 이름으로 상위 폴더를 만들라는 추가 요청을 트리거했습니다.

노트

상위 폴더가 Brand Portal에 없거나 AEM Assets에서 수정된 경우에 추가 요청이 생성됩니다.

AEM Assets에서 Brand Portal을 Cloud Service (으)로 활성화하기 위한 자동화 워크플로우와 함께 Adobe 개발자 콘솔을 사용하여 AEM Assets을 Cloud Service로 수동으로 구성하는 다른 방법이 있습니다. 이 방법은 더 이상 권장되지 않습니다.

노트

Brand Portal 테넌트를 활성화하는 동안 문제가 발생하는 경우 Adobe 지원 센터에 문의하십시오.

Adobe 개발자 콘솔을 사용한 수동 구성

다음 섹션에서는 Adobe 개발자 콘솔을 사용하여 Brand Portal을 사용하여 AEM Assets을 Cloud Service으로 수동으로 구성하는 방법에 대해 설명합니다.

이전에는 AEM Assets as a Cloud Service 가 Brand Portal 테넌트의 인증을 위해 IMS(Adobe Identity Management Services) 계정 토큰을 전달하는 Adobe 개발자 콘솔을 통해 Brand Portal으로 수동으로 구성되었습니다. AEM Assets과 Adobe 개발자 콘솔 모두에 구성이 필요합니다.

  1. AEM Assets에서 IMS 계정을 만들고 공개 키(인증서)를 생성합니다.
  2. Adobe 개발자 콘솔에서 Brand Portal 테넌트(조직)에 대한 프로젝트를 만듭니다.
  3. 프로젝트에서 공개 키로 API를 구성하여 서비스 계정 연결을 만듭니다.
  4. 서비스 계정 자격 증명과 JWT(JSON 웹 토큰) 페이로드 정보를 가져옵니다.
  5. AEM Assets에서 서비스 계정 자격 증명과 JWT 페이로드를 사용하여 IMS 계정을 구성합니다.
  6. AEM Assets에서 IMS 계정 및 Brand Portal 끝점(조직 URL)을 사용하여 Brand Portal 클라우드 서비스를 구성합니다.
  7. AEM Assets에서 Brand Portal으로 자산을 게시하여 구성을 테스트합니다.
노트

Cloud Service 인스턴스로서의 AEM Assets은 하나의 Brand Portal 테넌트로만 구성해야 합니다.

전제 조건

Brand Portal을 사용하여 AEM Assets를 구성하려면 다음 항목이 필요합니다.

  • AEM Assets을 Cloud Service 인스턴스로 실행 중인 경우
  • Brand Portal 테넌트 URL
  • Brand Portal 임차인의 IMS 조직에 대한 시스템 관리자 권한이 있는 사용자

구성 만들기

지정된 시퀀스에서 다음 단계를 수행하여 Brand Portal을 사용하여 AEM Assets을 구성합니다.

  1. 공개 인증서 받기
  2. 서비스 계정(JWT) 연결 만들기
  3. IMS 계정 구성
  4. 클라우드 서비스 구성

IMS 구성 만들기

IMS 구성은 Brand Portal 테넌트로 AEM Assets을 Cloud Service 인스턴스로 인증합니다.

IMS 구성에는 두 단계가 포함됩니다.

공개 인증서 받기

공개 키(인증서)는 Adobe 개발자 콘솔에서 프로필을 인증합니다.

  1. AEM Assets에 로그인합니다.

  2. 도구 패널에서 보안 > Adobe IMS 구성​으로 이동합니다.

  3. Adobe IMS 구성 페이지에서 만들기​를 클릭합니다. 이 페이지는 Adobe IMS 기술 계정 구성 페이지로 리디렉션됩니다. 기본적으로 인증서 탭이 열립니다.

  4. 클라우드 솔루션 드롭다운 목록에서 Adobe Brand Portal​을 선택합니다.

  5. 새 인증서 만들기 확인란을 선택하고 공개 키에 대해 별칭​을 지정합니다. 별칭은 공개 키의 이름으로 사용됩니다.

  6. 인증서 만들기​를 클릭합니다. 그런 다음 확인​을 클릭하여 공개 키를 생성합니다.

    인증서 만들기

  7. 공개 키 다운로드 아이콘을 클릭하고 공개 키(CRT) 파일을 컴퓨터에 저장합니다.

    공개 키는 나중에 Brand Portal 테넌트에 대한 API를 구성하고 Adobe 개발자 콘솔에서 서비스 계정 자격 증명을 생성하는 데 사용됩니다.

    인증서 다운로드

  8. 다음​을 클릭합니다.

    계정 탭에서 Adobe 개발자 콘솔에 생성된 서비스 계정 자격 증명이 필요한 Adobe IMS 계정이 만들어집니다. 우선은 이 페이지를 열어 두십시오.

    새 탭을 열고 Adobe 개발자 콘솔에 서비스 계정(JWT) 연결을 만들어 IMS 계정을 구성하기 위한 자격 증명과 JWT 페이로드를 가져옵니다.

서비스 계정(JWT) 연결 만들기

Adobe 개발자 콘솔에서 프로젝트 및 API는 Brand Portal 테넌트(조직) 수준에서 구성됩니다. API를 구성하면 서비스 계정(JWT) 연결이 만들어집니다. 키 쌍(개인 및 공개 키)을 생성하거나 공개 키를 업로드하여 API를 구성하는 두 가지 방법이 있습니다. Brand Portal으로 AEM Assets을 구성하려면 AEM Assets에서 공개 키(인증서)를 생성하고 공개 키를 업로드하여 Adobe 개발자 콘솔에서 자격 증명을 만들어야 합니다. 이러한 자격 증명은 AEM Assets에서 IMS 계정을 구성하는 데 필요합니다. IMS 계정이 구성되면 AEM Assets에서 Brand Portal 클라우드 서비스를 구성할 수 있습니다.

서비스 계정 자격 증명과 JWT 페이로드를 생성하려면 다음 단계를 수행합니다.

  1. IMS 조직(Brand Portal 테넌트)에 대한 시스템 관리자 권한으로 Adobe 개발자 콘솔에 로그인합니다. 기본 URL은 https://www.adobe.com/go/devs_console_ui.

    노트

    오른쪽 위 모서리에 있는 드롭다운(조직) 목록에서 올바른 IMS 조직(Brand Portal 테넌트)을 선택했는지 확인합니다.

  2. 새 프로젝트 만들기​를 클릭합니다. 조직에 대해 시스템 생성 이름이 있는 빈 프로젝트가 만들어집니다.

    프로젝트 편집​을 클릭하여 프로젝트 제목설명​을 업데이트하고 저장​을 클릭합니다.

  3. 프로젝트 개요 탭에서 API 추가​를 클릭합니다.

  4. API 추가 창​에서 AEM Brand Portal​을 선택하고 다음​을 클릭합니다.

    AEM Brand Portal 서비스에 대한 액세스 권한이 있는지 확인합니다.

  5. API 구성 창에서 공개 키 업로드​를 클릭합니다. 그런 다음 파일​을 선택하고 공개 인증서 가져오기 섹션에서 다운로드한 공개 키(.crt 파일)를 업로드합니다.

    다음​을 클릭합니다.

    공개 키 업로드

  6. 공개 키를 확인하고 다음​을 클릭합니다.

  7. Assets Brand Portal 를 기본 제품 프로필로 선택하고 구성된 API 저장 을 클릭합니다.

    제품 프로필 선택

  8. API가 구성되면 API 개요 페이지로 리디렉션됩니다. 자격 증명 아래의 왼쪽 탐색에서 서비스 계정(JWT) 옵션을 클릭합니다.

    노트

    자격 증명을 보고 JWT 토큰 생성, 자격 증명 세부 사항 복사, 클라이언트 암호 검색 등의 작업을 수행할 수 있습니다.

  9. 클라이언트 자격 증명 탭에서 클라이언트 ID​를 복사합니다.

    클라이언트 암호 검색​을 클릭하고 클라이언트 암호 키​를 복사합니다.

    서비스 계정 자격 증명

  10. JWT 생성 탭으로 이동하여 JWT 페이로드 정보를 복사합니다.

이제 클라이언트 ID(API 키), 클라이언트 암호 및 JWT 페이로드를 AEM Assets에서 IMS 계정을 구성할 수 있습니다.

IMS 계정 구성

다음 절차를 수행했는지 확인하십시오.

다음 단계를 수행하여 IMS 계정을 구성합니다.

  1. IMS 구성을 열고 계정 탭으로 이동합니다. 공개 인증서🔗를 가져오는 동안 페이지를 열어 두었습니다.

  2. IMS 계정에 대한 제목​을 지정합니다.

    인증 서버 필드에서 URL을 지정합니다. https://ims-na1.adobelogin.com/

    서비스 계정(JWT) 연결을 만드는 동안 복사한 API 키 필드, 클라이언트 암호페이로드(JWT 페이로드)에 클라이언트 ID를 지정합니다.

    만들기​를 클릭합니다.

    IMS 계정이 구성되었습니다.

    IMS 계정 구성

  3. IMS 계정 구성을 선택하고 상태 확인​을 클릭합니다.

    대화 상자에서 확인​을 클릭합니다. 구성이 성공하면 토큰이 성공적으로 검색되었습니다.​라는 메시지가 나타납니다.

주의

IMS 구성은 하나만 있어야 합니다.

IMS 구성이 상태 검사를 통과하는지 확인합니다. 구성이 상태 검사를 통과하지 않으면 구성이 잘못된 것입니다. 이 구성을 삭제하고 유효한 새 구성을 만들어야 합니다.

클라우드 서비스 구성

다음 단계를 수행하여 Brand Portal 클라우드 서비스를 구성합니다.

  1. AEM Assets에 로그인합니다.

  2. 도구 패널에서 Cloud Services > AEM Brand Portal​로 이동합니다.

  3. Brand Portal 구성 페이지에서 만들기​를 클릭합니다.

  4. 구성에 대한 제목​을 지정합니다.

    IMS 계정을 구성하는 동안 만든 IMS 구성을 선택합니다.

    서비스 URL 필드에서 Brand Portal 테넌트 URL을 지정합니다.

  5. 저장 후 닫기​를 클릭합니다. 클라우드 구성이 만들어집니다.

    이제 AEM Assets as a Cloud Service 인스턴스가 Brand Portal 테넌트로 구성됩니다.

이제 분배 에이전트를 확인하고 자산을 Brand Portal에 게시하여 구성을 테스트할 수 있습니다.

이 페이지에서는