Show Menu
화제×

Brand Portal로 AEM Assets 구성

AEM(Adobe Experience Manager) 자산은 브랜드 포털 테넌트의 승인을 위해 IMS 토큰을 구입하는 Adobe 개발자 콘솔을 통해 브랜드 포털로 구성됩니다.
구성 작동 방식
브랜드 포털 임차인(조직)으로 AEM Assets 클라우드 인스턴스를 구성하려면 AEM Assets 클라우드 인스턴스와 Adobe 개발자 콘솔에서 구성이 필요합니다.
  1. AEM Assets 클라우드 인스턴스에서 IMS 계정을 만들고 공개 인증서(공개 키)를 생성합니다.
  2. Adobe 개발자 콘솔에서 브랜드 포털 테넌트(조직)에 대한 프로젝트를 만듭니다.
  3. 프로젝트 아래에서 공개 키를 사용하여 API를 구성하여 서비스 계정(JWT) 연결을 만듭니다.
  4. 서비스 계정 자격 증명과 JWT 페이로드 정보를 가져옵니다.
  5. AEM Assets 클라우드 인스턴스에서 서비스 계정 자격 증명과 JWT 페이로드를 사용하여 IMS 계정을 구성합니다.
  6. AEM Assets 클라우드 인스턴스에서 IMS 계정 및 브랜드 포털 끝점(조직 URL)을 사용하여 브랜드 포털 클라우드 서비스를 구성합니다.
  7. AEM Assets 클라우드 인스턴스의 자산을 브랜드 포털에 게시하여 구성을 테스트합니다.
브랜드 포털 테넌트는 하나의 AEM Assets 클라우드 인스턴스로 구성되어야 합니다.
여러 AEM Assets 클라우드 인스턴스로 브랜드 포털 테넌트를 구성하지 마십시오.

전제 조건

Brand Portal을 사용하여 AEM Assets를 구성하려면 다음 항목이 필요합니다.
  • 실행 중인 AEM Assets 클라우드 인스턴스
  • Brand Portal 테넌트 URL
  • Brand Portal 테넌트의 IMS 조직에 대한 시스템 관리자 권한이 있는 사용자
자세한 내용은 고객 지원 센터에 문의하십시오.

구성 만들기

브랜드 포털에서 AEM Assets 클라우드 인스턴스를 구성하려면 지정된 시퀀스에서 다음 단계를 수행하십시오.

IMS 구성 만들기

IMS 구성은 AEM Assets 작성자 인스턴스를 사용하여 Brand Portal 테넌트를 인증합니다.
IMS 구성에는 두 단계가 포함됩니다.

공개 인증서 받기

공용 인증서를 사용하면 Adobe 개발자 콘솔에서 프로필을 인증할 수 있습니다.
  1. AEM Assets 클라우드 인스턴스에 로그인합니다.
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Adobe IMS 구성 페이지에서 만들기를 클릭합니다 .
  4. Adobe IMS 기술 계정 구성 페이지로 리디렉션됩니다 . By default, the Certificate tab opens.
    클라우드 솔루션 Adobe 브랜드 포털을 선택합니다 .
  5. Mark the check box Create new certificate and specify an alias for the certificate. 별칭은 대화 상자의 이름으로 사용됩니다.
  6. 인증서 만들기 ​를 클릭합니다. 그런 다음 대화 상자에서 확인을 클릭하여 공용 인증서를 생성합니다.
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    인증서 파일은 브랜드 포털 테넌트에 대한 API를 구성하고 Adobe 개발자 콘솔에서 서비스 계정 자격 증명을 생성하는 추가 단계에 사용됩니다.
  8. 다음 ​을 클릭합니다.
    # 탭에서 Adobe IMS 계정을 만들지만, 이를 위해서는 Adobe 개발자 콘솔에서 생성된 서비스 계정 자격 증명이 필요합니다. 우선은 이 페이지를 열어 두십시오.
    새 탭을 열고 Adobe 개발자 콘솔에서 JWT(서비스 계정) 연결을 만들어 IMS 계정을 구성하기 위한 자격 증명과 JWT 페이로드를 가져옵니다.

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

Adobe 개발자 콘솔에서 프로젝트 및 API는 조직(브랜드 포털 테넌트) 수준에서 구성됩니다. API를 구성하면 Adobe 개발자 콘솔에서 JWT(서비스 계정) 연결이 만들어집니다. 키 쌍(개인 및 공개 키)을 생성하거나 공개 키를 업로드하여 API를 구성하는 두 가지 방법이 있습니다. 브랜드 포털에서 AEM Assets 클라우드 인스턴스를 구성하려면 AEM Assets 클라우드 인스턴스에서 공개 인증서(공개 키)를 생성하고 공개 키를 업로드하여 Adobe 개발자 콘솔에서 자격 증명을 만들어야 합니다. 이 공개 키는 선택한 브랜드 포털 조직에 대한 API를 구성하는 데 사용되며 서비스 계정에 대한 자격 증명과 JWT 페이로드를 생성합니다. 이러한 자격 증명은 AEM Assets 클라우드 인스턴스에서 IMS 계정을 구성하는 데 추가로 사용됩니다. IMS 계정이 구성되면 AEM Assets 클라우드 인스턴스에서 브랜드 포털 클라우드 서비스를 구성할 수 있습니다.
서비스 계정 자격 증명과 JWT 페이로드를 생성하려면 다음 단계를 수행합니다.
  1. IMS 조직(브랜드 포털 테넌트)에 대한 시스템 관리자 권한으로 Adobe 개발자 콘솔에 로그인합니다. 기본 URL은
    오른쪽 위 모서리에 있는 드롭다운(조직 목록)에서 올바른 IMS 조직(브랜드 포털 테넌트)을 선택했는지 확인합니다.
  2. Click Create new project . 조직에 대해 빈 프로젝트가 만들어집니다.
    프로젝트 편집 을 클릭하여 프로젝트 제목 및 설명 ​을 업데이트하고 ,저장을 클릭한 다음을 클릭합니다.
  3. 프로젝트 개요 탭에서 API 추가를 클릭합니다 .
  4. API 추가 창에서 AEM 브랜드 포털 을 선택하고 다음을 클릭합니다 .
    AEM 브랜드 포털 서비스에 대한 액세스 권한이 있는지 확인합니다.
  5. API 구성 창에서 공개 키 업로드를 클릭합니다 . 그런 다음 파일 선택을 클릭하고 공개 인증서 가져오기 섹션에서 다운로드한 공개 인증서(.crt 파일)를 업로드합니다.
    다음 ​을 클릭합니다.
  6. 공용 인증서를 확인하고 #클릭합니다 .
  7. 기본 제품 프로필 자산 브랜드 포털을 선택하고 구성 저장을 클릭합니다 .
  8. API가 구성되면 API 개요로 리디렉션됩니다. 자격 증명 아래의 왼쪽 탐색 ​에서 서비스 계정(JWT)을 클릭합니다 .
    필요에 따라 자격 증명을 보고 기타 작업(JWT 토큰 생성, 자격 증명 세부 사항 복사, 클라이언트 암호 검색 등)을 수행할 수 있습니다.
  9. 클라이언트 자격 증명 탭에서 클라이언트 ID를 복사합니다 .
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
이제 클라이언트 ID(API 키), 클라이언트 암호 및 JWT 페이로드를 사용하여 AEM Assets 클라우드 인스턴스에서 IMS 계정 IMS 계정 구성 을 구성할 수 있습니다.

IMS 계정 구성

다음 절차를 수행했는지 확인하십시오.
다음 단계를 수행하여 공개 인증서를 획득하여 만든 IMS 계정을 구성합니다 .
  1. IMS 구성을 열고 계정 탭으로 이동합니다. 공개 인증서를 받는 동안 페이지 를 열어 두셨습니다 .
  2. IMS 계정에 대한 제목 ​을 지정합니다.
    인증 서버 ​에서 URL https://ims-na1.adobelogin.com/ 을 입력하십시오.
    만들기 ​를 클릭합니다.
    IMS 계정이 구성되었습니다.
  3. Select the IMS account configuration and click Check Health .
    대화 상자에서 확인을 클릭합니다. 구성이 성공하면 토큰이 성공적으로 검색된다는 메시지가 나타납니다 .
IMS 구성은 하나만 있어야 합니다. IMS 구성을 여러 개 만들지 마십시오.
IMS 구성이 상태 검사를 통과하는지 확인합니다. 구성이 상태 검사를 통과하지 않으면 구성이 잘못된 것입니다. 이 구성을 삭제하고 유효한 새 구성을 만들어야 합니다.

클라우드 서비스 구성

브랜드 포털 클라우드 서비스를 구성하려면 다음 단계를 수행하십시오.
  1. AEM Assets 클라우드 인스턴스에 로그인합니다.
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. 브랜드 포털 구성 페이지에서 만들기를 클릭합니다 .
  4. 구성에 대한 제목 ​을 지정합니다.
    In the Service URL , enter your Brand Portal tenant (organization URL).
  5. 저장 후 닫기 ​를 클릭합니다. 클라우드 구성이 만들어집니다. 이제 AEM Assets 클라우드 인스턴스가 Brand Portal 테넌트로 구성되었습니다.

구성 테스트

다음 단계를 수행하여 구성을 확인합니다.
  1. AEM Assets 클라우드 인스턴스에 로그인합니다.
  2. From the Tools panel, navigate to Deployment > Distribution .
  3. 배포 페이지에서 브랜드 포털에 bpdistributionagent0 게시하기 위해 브랜드 포털 배포 에이전트 ​만들어졌음을 확인할 수 있습니다.
    Brand Portal에 게시 ​를 클릭합니다.
    기본적으로 Brand Portal 테넌트에 대해 하나의 분배 에이전트가 만들어집니다.
  4. Distribution Agent 페이지에서 상태 탭 아래에 배포 대기열을 볼 수 있습니다.
    분배 에이전트에는 두 개의 큐가 있습니다.
    • 처리 큐 : 를 참조하십시오.
    • error-queue : for the assets where distribution has failed.
    오류를 검토하고 오류 큐를 정기적으로 지우는 것이 좋습니다.
  5. AEM Assets와 Brand Portal 간의 연결을 확인하려면 연결 테스트 ​를 클릭합니다.
    테스트 패키지가 성공적으로 전달되었다는 메시지가 페이지 하단에 나타납니다.
    자산 분배(큐에서 실행)가 실패하는 원인이 될 수 있으므로 분배 에이전트를 비활성화하지 마십시오.
AEM Assets 클라우드 인스턴스가 Brand Portal을 사용하여 성공적으로 구성되었으므로 이제 다음 작업을 수행할 수 있습니다.
위의 항목 외에도 AEM Assets의 메타데이터 스키마, 이미지 사전 설정, 검색 패싯 및 태그를 Brand Portal 포털에 게시할 수 있습니다.
자세한 내용은 Brand Portal 설명서 를 참조하십시오.

분배 로그

배포 에이전트가 수행하는 작업에 대한 자세한 내용은 로그를 확인할 수 있습니다.
예를 들어, 구성을 확인하기 위해 AEM Assets의 자산을 브랜드 포털에 게시했습니다.
  1. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  2. 로그 ​를 클릭하여 분배 로그를 확인합니다. 여기에서 처리 및 오류 로그를 볼 수 있습니다.
분배 에이전트는 다음 로그를 생성합니다.
  • 정보: 배포 에이전트를 활성화하는 성공적인 구성을 트리거하는 시스템 생성 로그입니다.
  • DSTRQ1(요청 1): 테스트 연결에 대해 트리거합니다.
자산을 게시할 때 다음 요청 및 응답 로그가 생성됩니다.
분배 에이전트 요청 :
  • DSTRQ2(요청 2): 자산 게시 요청이 트리거됩니다.
  • DSTRQ3(요청 3): 시스템이 자산이 있는 폴더를 게시하고 브랜드 포털에서 폴더를 복제하는 다른 요청을 트리거합니다.
분배 에이전트 응답 :
  • queue-bpdistributionagent0(DSTRQ2): 자산이 Brand Portal에 게시됩니다.
  • queue-bpdistributionagent0(DSTRQ3): 시스템이 Brand Portal에서 자산을 포함하는 폴더를 복제합니다.
위 예에서 추가 요청 및 응답이 트리거됩니다. 자산이 처음으로 게시되었기 때문에 시스템이 브랜드 포털에서 상위 폴더(경로 추가)를 찾을 수 없으므로 자산이 게시된 브랜드 포털에서 동일한 이름의 상위 폴더를 만들기 위한 추가 요청을 트리거합니다.
상위 폴더가 Brand Portal에 없거나(위 예에서), 상위 폴더가 AEM Assets에서 수정된 경우에 추가 요청이 생성됩니다.