Brand Portal에서 AEM Assets 구성

Adobe Experience Manager Assets Brand Portal을 사용하면 Adobe Experience Manager Assets에서 승인한 브랜드 자산을 Brand Portal에 게시하고 Brand Portal 사용자에게 배포할 수 있습니다.

AEM Assets은 Brand Portal 개발자 콘솔을 통해 Brand Portal으로 구성되며, Adobe 테넌트의 인증을 위해 IMS(Adobe Identity Management Services) 계정 토큰을 받습니다.

노트

AEM 6.5.4.0 이상에서 Adobe 개발자 콘솔을 통해 Brand Portal에 AEM Assets을 구성할 수 있습니다.

이전에는 Brand Portal이 기존 OAuth 게이트웨이를 통해 구성되었으며, 이 게이트웨이는 인증을 위해 IMS 액세스 토큰을 가져오는 데 JWT(JSON 웹 토큰) 교환을 사용합니다.

기존 OAuth 게이트웨이를 통한 구성은 2020년 4월 6일부터 더 이상 지원되지 않으며, Adobe 개발자 콘솔로 변경되었습니다.

기존 고객 전용

기존 OAuth 게이트웨이 구성을 계속 사용하는 것이 좋습니다. 기존 OAuth 게이트웨이 구성 문제가 발생하는 경우 기존 구성을 삭제하고 Adobe 개발자 콘솔을 통해 새 구성을 만드십시오.

이 도움말은 다음 두 가지 사용 사례에 대해 설명합니다.

  • 새 구성: 새 Brand Portal 사용자이고 Brand Portal으로 AEM Assets 작성자 인스턴스를 구성하려는 경우 Adobe 개발자 콘솔을 통해 구성을 만들 수 있습니다.
  • 구성 업그레이드: 기존 OAuth 게이트웨이에 대한 구성이 있는 기존 Brand Portal 사용자인 경우 기존 구성을 삭제하고 Adobe 개발자 콘솔을 통해 새 구성을 만드십시오.

제공된 정보는 이 도움말을 읽는 사람이 다음 기술을 잘 알고 있다는 가정을 기반으로 합니다.

  • Adobe Experience Manager 및 AEM 패키지 설치, 구성 및 관리.

  • Linux 및 Microsoft Windows 운영 체제 사용.

전제 조건

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

  • 최신 서비스 팩으로 실행 중인 AEM Assets 작성자 인스턴스
  • Brand Portal 테넌트 URL
  • Brand Portal 임차인의 IMS 조직에 대한 시스템 관리자 권한이 있는 사용자

AEM 6.5 다운로드 및 설치

최신 AEM 서비스 팩 다운로드 및 설치

AEM 6.5 다운로드 및 설치

AEM 작성자 인스턴스를 설정하려면 AEM 6.5가 있어야 합니다. AEM을 실행하지 않은 경우 다음 위치에서 다운로드하십시오.

AEM을 다운로드한 후 AEM 작성자 인스턴스를 설정하는 방법은 배포 및 유지 관리를 참조하십시오.

AEM 최신 서비스 팩 다운로드 및 설치

세부 지침은 다음을 참조하십시오.

최신 AEM 패키지 또는 서비스 팩을 찾을 수 없는 경우 지원 센터에 문의​하십시오.

구성 만들기

Brand Portal과 AEM Assets을 구성하려면 AEM Assets 작성자 인스턴스뿐만 아니라 Adobe 개발자 콘솔에서 구성이 필요합니다.

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

AEM Assets 작성자 인스턴스는 하나의 Brand Portal 테넌트로 구성해야 합니다.

Brand Portal을 사용하여 AEM Assets을 처음 구성하는 경우 나열된 순서로 다음 단계를 수행하십시오.

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

IMS 구성 만들기

IMS 구성은 Brand Portal 테넌트로 AEM Assets 작성자 인스턴스를 인증합니다.

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

공개 인증서 받기

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

  1. AEM Assets 작성자 인스턴스에 로그인합니다. 기본 URL은 http://localhost:4502/aem/start.html.

  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. 도구 도구 패널에서 클라우드 서비스 > AEM Brand Portal​로 이동합니다.

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

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

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

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

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

    이제 AEM Assets 작성자 인스턴스가 Brand Portal 테넌트로 구성됩니다.

구성 테스트

다음 단계를 수행하여 구성을 확인합니다.

  1. AEM Assets 클라우드 인스턴스에 로그인합니다.

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

  3. 복제 페이지에서 작성자의 에이전트​를 클릭합니다.

    Brand Portal 테넌트에 대해 생성된 4개의 복제 에이전트를 볼 수 있습니다.

    Brand Portal 임차인의 복제 에이전트를 찾고 복제 에이전트 URL을 클릭합니다.

    노트

    복제 에이전트가 동시에 작동하여 작업 분포를 동일하게 공유하므로 게시 속도가 원래 속도보다 4배 더 빨라집니다. 클라우드 서비스가 구성된 후에는 여러 자산의 병렬 게시를 활성화하기 위해 기본적으로 활성화된 복제 에이전트를 활성화하는 데 추가 구성이 필요하지 않습니다.

  4. AEM Assets과 Brand Portal 간의 연결을 확인하려면 연결 테스트 아이콘을 클릭합니다.

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

  5. 4개의 복제 에이전트 모두에 대한 테스트 결과를 확인합니다.

    노트

    자산 복제(큐에서 실행)가 실패할 수 있으므로 복제 에이전트를 비활성화하지 마십시오.

    시간 초과 오류를 방지하기 위해 4개의 복제 에이전트가 모두 구성되었는지 확인합니다. Brand Portal🔗에 동시 게시 시 문제 해결 을 참조하십시오.

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

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

구성 업그레이드

나열된 순서로 다음 단계를 수행하여 기존 구성을 Developer Console로 업그레이드합니다.

  1. 실행 중인 작업 확인
  2. 기존 구성 삭제
  3. 구성 만들기

실행 중인 작업 확인

수정하기 전에 AEM Assets 작성자 인스턴스에서 게시 작업이 실행되고 있지 않은지 확인합니다. 이러한 경우 4개의 복제 에이전트 모두에 대해 활성 작업의 상태를 확인하고 큐가 유휴 상태인지 확인할 수 있습니다.

  1. AEM Assets 작성자 인스턴스에 로그인합니다.

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

  3. 복제 페이지에서 작성자의 에이전트​를 클릭합니다.

  4. Brand Portal 임차인의 복제 에이전트를 찾습니다.

    모든 복제 에이전트에 대해 큐가 유휴 상태​인지, 활성 상태인 게시 작업이 없는지 확인합니다.

기존 구성 삭제

기존 구성을 삭제하는 동안 다음 체크리스트를 실행해야 합니다.

  • 4개의 복제 에이전트 모두 삭제
  • Brand Portal 클라우드 서비스 삭제
  • MAC 사용자 삭제
  1. AEM Assets 작성자 인스턴스에 로그인하고 CRX Lite를 관리자로 엽니다. 기본 URL은 http://localhost:4502/crx/de/index.jsp.

  2. /etc/replications/agents.author로 이동하고 Brand Portal 임차인의 4개 복제 에이전트를 모두 삭제합니다.

  3. /etc/cloudservices/mediaportal 로 이동하고 Brand Portal 클라우드 서비스 구성을 삭제합니다.

  4. /home/users/mac로 이동하고 Brand Portal 임차인의 MAC 사용자​를 삭제합니다.

이제 AEM 6.5 작성자 인스턴스에서 Adobe 개발자 콘솔을 통해 구성을 만들 수 있습니다.

이 페이지에서는