Show Menu
화제×

Brand Portal에서 AEM Assets 구성

Adobe Experience Manager 자산 브랜드 포털에서는 승인된 브랜드 자산을 Adobe Experience Manager 자산에서 브랜드 포털에 게시하고 브랜드 포털 사용자에게 배포할 수 있습니다.
AEM Assets은 브랜드 포털 테넌트의 승인을 위해 Adobe Identity Management 서비스(IMS) 계정 토큰을 구입하는 Adobe 개발자 콘솔을 통해 브랜드 포털로 구성됩니다.
AEM 6.5.4.0 이상에서 Adobe 개발자 콘솔을 통해 Brand Portal에 AEM Assets을 구성할 수 있습니다.
이전에 브랜드 포털은 JWT(JSON Web Token) 교환을 사용하여 IMS 액세스 토큰을 인증하도록 하는 레거시 OAuth 게이트웨이를 통해 구성되었습니다.
기존 OAuth 게이트웨이를 통한 구성은 2020년 4월 6일부터 더 이상 지원되지 않으며, Adobe 개발자 콘솔로 변경되었습니다.
기존 고객 전용
기존 레거시 OAuth 게이트웨이 구성을 계속 사용하는 것이 좋습니다. 기존 OAuth 게이트웨이 구성 문제가 발생하는 경우 기존 구성을 삭제하고 Adobe 개발자 콘솔을 통해 새 구성을 만드십시오.
이 도움말은 다음 두 가지 사용 사례에 대해 설명합니다.
  • 새 구성 :새 브랜드 포털 사용자이고 브랜드 포털에서 AEM Assets 작성자 인스턴스를 구성하려면 Adobe 개발자 콘솔을 통해 구성을 만들 수 있습니다.
  • 업그레이드 구성 :기존 OAuth 게이트웨이에 대한 구성이 있는 기존 브랜드 포털 사용자의 경우 기존 구성을 삭제하고 Adobe 개발자 콘솔을 통해 새 구성을 만드십시오.
제공된 정보는 이 도움말을 읽는 사람이 다음 기술을 잘 알고 있다는 가정을 기반으로 합니다.
  • Adobe Experience Manager 및 AEM 패키지 설치, 구성 및 관리.
  • Linux 및 Microsoft Windows 운영 체제 사용.

전제 조건

Brand Portal을 사용하여 AEM Assets를 구성하려면 다음 항목이 필요합니다.
  • 최신 서비스 팩을 통해 실행 중인 AEM Assets 작성자 인스턴스
  • 브랜드 포털 테넌트 URL
  • Brand Portal 임차인의 IMS 조직에 대한 시스템 관리자 권한이 있는 사용자

AEM 6.5 다운로드 및 설치

AEM 작성자 인스턴스를 설정하려면 AEM 6.5가 있어야 합니다. AEM을 실행하지 않은 경우 다음 위치에서 다운로드하십시오.
AEM을 다운로드한 후 AEM 작성자 인스턴스를 설정하는 방법은 배포 및 유지 관리 를 참조하십시오.

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

세부 지침은 다음을 참조하십시오.
최신 AEM 패키지 또는 서비스 팩을 찾을 수 없는 경우 지원 센터에 문의 ​하십시오.

구성 만들기

브랜드 포털에서 AEM Assets을 구성하려면 Adobe 개발자 콘솔뿐만 아니라 AEM Assets 작성자 인스턴스에도 구성이 필요합니다.
  1. AEM Assets에서 IMS 계정을 만들고 공개 인증서(공개 키)를 생성합니다.
  2. Adobe 개발자 콘솔에서 Brand Portal 테넌트(조직)에 대한 프로젝트를 만듭니다.
  3. 프로젝트에서 공개 키로 API를 구성하여 서비스 계정(JWT) 연결을 만듭니다.
  4. 서비스 계정 자격 증명과 JWT 페이로드 정보를 가져옵니다.
  5. AEM Assets에서 서비스 계정 자격 증명과 JWT 페이로드를 사용하여 IMS 계정을 구성합니다.
  6. AEM Assets에서 IMS 계정 및 브랜드 포털 끝점(조직 URL)을 사용하여 브랜드 포털 클라우드 서비스를 구성합니다.
  7. AEM Assets에서 브랜드 포털에 자산을 게시하여 구성을 테스트합니다.
AEM Assets 작성자 인스턴스는 하나의 브랜드 포털 테넌트로 구성됩니다.
브랜드 포털에서 처음으로 AEM Assets을 구성하는 경우 나열된 시퀀스에서 다음 단계를 수행하십시오.

IMS 구성 만들기

IMS 구성은 브랜드 포털 테넌트로 AEM Assets 작성자 인스턴스를 인증합니다.
IMS 구성에는 두 단계가 포함됩니다.

공개 인증서 받기

공개 키(인증서)는 Adobe 개발자 콘솔에서 프로필을 인증합니다.
  1. AEM Assets 작성자 인스턴스에 로그인합니다. 기본 URL은 http://localhost:4502/aem/start.html .
  2. 도구 패널에서 보안 > Adobe IMS 구성 ​으로 이동합니다.
  3. Adobe IMS 구성 페이지에서 만들기 ​를 클릭합니다. It will redirect to the Adobe IMS Technical Account Configuration page. 기본적으로 인증서 탭이 열립니다.
  4. 클라우드 솔루션 드롭다운 목록에서 Adobe 브랜드 포털 ​선택합니다.
  5. 새 인증서 만들기 확인란을 선택하고 공개 키에 대한 별칭을 지정합니다. 별칭은 공개 키 이름 역할을 합니다.
  6. 인증서 만들기 ​를 클릭합니다. Then, click OK to generate the public key.
  7. Click the Download Public Key icon and save the public key (.crt) file on your machine.
    공개 키는 나중에 브랜드 포털 테넌트에 대한 API를 구성하고 Adobe 개발자 콘솔에서 서비스 계정 자격 증명을 생성하는 데 사용됩니다.
  8. 다음 ​을 클릭합니다.
    # 탭에서 Adobe 개발자 콘솔에서 생성된 서비스 계정 자격 증명이 필요한 Adobe IMS 계정이 만들어집니다. 우선은 이 페이지를 열어 두십시오.
    새 탭을 열고 Adobe 개발자 콘솔에 서비스 계정(JWT) 연결을 만들어 IMS 계정을 구성하기 위한 자격 증명과 JWT 페이로드를 가져옵니다.

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

Adobe 개발자 콘솔에서 프로젝트 및 API는 브랜드 포털 테넌트(조직) 수준에서 구성됩니다. API를 구성하면 서비스 계정(JWT) 연결이 만들어집니다. 키 쌍(개인 및 공개 키)을 생성하거나 공개 키를 업로드하여 API를 구성하는 두 가지 방법이 있습니다. 브랜드 포털에서 AEM Assets을 구성하려면 AEM Assets에서 공개 키(인증서)를 생성하고 공개 키를 업로드하여 Adobe 개발자 콘솔에서 자격 증명을 만들어야 합니다. 이러한 자격 증명은 AEM Assets에서 IMS 계정을 구성하는 데 필요합니다. IMS 계정이 구성되면 AEM Assets에서 브랜드 포털 클라우드 서비스를 구성할 수 있습니다.
서비스 계정 자격 증명과 JWT 페이로드를 생성하려면 다음 단계를 수행합니다.
  1. IMS 조직(Brand Portal 테넌트)에 대한 시스템 관리자 권한으로 Adobe 개발자 콘솔에 로그인합니다. 기본 URL은 https://www.adobe.com/go/devs_console_ui .
    오른쪽 위 모서리에 있는 드롭다운(조직) 목록에서 올바른 IMS 조직(브랜드 포털 테넌트)을 선택했는지 확인합니다.
  2. 새 프로젝트 만들기 ​를 클릭합니다. 조직에 대해 시스템에서 생성된 이름을 가진 빈 프로젝트가 만들어집니다.
    프로젝트 편집 ​을 클릭하여 프로젝트 제목 설명 ​을 업데이트하고 저장 ​을 클릭합니다.
  3. In the Project overview tab, click Add API .
  4. In the Add an API window , select AEM Brand Portal and click Next .
    AEM Brand Portal 서비스에 대한 액세스 권한이 있는지 확인합니다.
  5. In the Configure API window, click Upload your public key . Then, click Select a File and upload the public key (.crt file) that you have downloaded in the obtain public certificate section.
    다음 ​을 클릭합니다.
  6. Verify the public key and click Next .
  7. 기본 제품 프로필로 Assets 브랜드 포털 을 선택하고 구성된 API 저장을 클릭합니다 .
  8. API가 구성되면 API 개요 페이지로 리디렉션됩니다. From the left navigation under Credentials , click on the Service Account (JWT) option.
    자격 증명을 보고 JWT 토큰 생성, 자격 증명 세부 사항 복사, 클라이언트 암호 검색 등과 같은 작업을 수행할 수 있습니다.
  9. 클라이언트 자격 증명 탭에서 클라이언트 ID ​를 복사합니다.
    클라이언트 암호 검색 ​을 클릭하고 클라이언트 암호 키 ​를 복사합니다.
  10. Navigate to the Generate JWT tab and copy the JWT Payload information.
You can now use the client ID (API key), client secret, and JWT payload to configure the IMS account in AEM Assets.

IMS 계정 구성

다음 절차를 수행했는지 확인하십시오.
IMS 계정을 구성하려면 다음 단계를 수행하십시오.
  1. Open the IMS Configuration and navigate to the Account tab. You kept the page open while obtaining the public certificate .
  2. IMS 계정에 대한 제목 ​을 지정합니다.
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/ .
    Specify client ID in the API key field, Client Secret , and Payload (JWT payload) that you have copied while creating the service account (JWT) connection .
    만들기 ​를 클릭합니다.
    IMS 계정이 구성되었습니다.
  3. Select the IMS account configuration and click Check Health .
    대화 상자에서 확인 ​을 클릭합니다. 구성이 성공하면 토큰이 성공적으로 검색되었습니다. ​라는 메시지가 나타납니다.
IMS 구성은 하나만 있어야 합니다.
IMS 구성이 상태 검사를 통과하는지 확인합니다. 구성이 상태 검사를 통과하지 않으면 구성이 잘못된 것입니다. 이 구성을 삭제하고 유효한 새 구성을 만들어야 합니다.

클라우드 서비스 구성

브랜드 포털 클라우드 서비스를 구성하려면 다음 단계를 수행하십시오.
  1. AEM Assets 작성자 인스턴스에 로그인합니다.
  2. 도구 패널에서 클라우드 서비스 > AEM Brand Portal ​로 이동합니다.
  3. Brand Portal 구성 페이지에서 만들기 ​를 클릭합니다.
  4. 구성에 대한 제목 ​을 지정합니다.
    IMS 계정을 구성 하는 동안 만든 IMS 구성을 선택합니다.
    In the Service URL field, specify your Brand Portal tenant (organization) URL.
  5. 저장 후 닫기 ​를 클릭합니다. 클라우드 구성이 만들어집니다.
    이제 AEM Assets 작성자 인스턴스가 Brand Portal 테넌트로 구성됩니다.

구성 테스트

다음 단계를 수행하여 구성을 확인합니다.
  1. AEM Assets 클라우드 인스턴스에 로그인합니다.
  2. 도구 패널에서 배포 > 복제 ​로 이동합니다.
  3. 복제 페이지에서 작성자의 에이전트 ​를 클릭합니다.
    브랜드 포털 테넌트에 대해 만들어진 네 개의 복제 에이전트를 볼 수 있습니다.
    브랜드 포털 테넌트의 복제 에이전트를 찾고 복제 에이전트 URL을 클릭합니다.
    복제 에이전트가 동시에 작동하여 작업 분포를 동일하게 공유하므로 게시 속도가 원래 속도보다 4배 더 빨라집니다. 클라우드 서비스가 구성된 후에는 여러 자산의 병렬 게시를 활성화하기 위해 기본적으로 활성화된 복제 에이전트를 활성화하는 데 추가 구성이 필요하지 않습니다.
  4. To verify the connection between AEM Assets and Brand Portal, click on the Test Connection icon.
    테스트 패키지가 성공적으로 배달된다는 메시지가 나타납니다 .
  5. 네 개의 복제 에이전트 모두에서 테스트 결과를 확인합니다.
    자산(실행 중인 큐)의 복제가 실패할 수 있으므로 복제 에이전트를 비활성화하지 마십시오.
    시간 초과 오류를 방지하도록 네 개의 복제 에이전트가 모두 구성되어 있는지 확인합니다. See troubleshoot issues in parallel publishing to Brand Portal .
이제 다음을 수행할 수 있습니다.
See Brand Portal documentation for more information.

구성 업그레이드

나열된 시퀀스에서 다음 단계를 수행하여 기존 구성을 Adobe 개발자 콘솔로 업그레이드합니다.

실행 중인 작업 확인

수정하기 전에 AEM Assets 작성자 인스턴스에서 게시 작업이 실행되고 있지 않은지 확인합니다. 이러한 경우 4개의 모든 복제 에이전트의 활성 작업 상태를 확인하고 대기열이 유휴 상태인지 확인할 수 있습니다.
  1. AEM Assets 작성자 인스턴스에 로그인합니다.
  2. 도구 패널에서 배포 > 배포 복제 ​로 이동합니다.
  3. 복제 페이지에서 작성자의 에이전트 ​를 클릭합니다.
  4. Brand Portal 임차인의 복제 에이전트를 찾습니다.
    모든 복제 에이전트에 대해 큐가 유휴 상태 ​인지, 활성 상태인 게시 작업이 없는지 확인합니다.

기존 구성 삭제

기존 구성을 삭제하는 동안 다음 체크리스트를 실행해야 합니다.
  • 4개의 복제 에이전트 모두 삭제
  • 브랜드 포털 클라우드 서비스 삭제
  • MAC 사용자 삭제
  1. AEM Assets 작성자 인스턴스에 로그인하고 CRX Lite를 관리자로 엽니다. 기본 URL은 http://localhost:4502/crx/de/index.jsp .
  2. /etc/replications/agents.author 로 이동하고 Brand Portal 임차인의 4개 복제 에이전트를 모두 삭제합니다.
  3. Navigate to /etc/cloudservices/mediaportal and delete the Brand Portal cloud service configuration.
  4. /home/users/mac 로 이동하고 Brand Portal 임차인의 MAC 사용자 ​를 삭제합니다.
이제 AEM 6.5 작성자 인스턴스의 Adobe 개발자 콘솔을 통해 구성을 만들 수 있습니다.