Adobe Developer Console 프로젝트 설정 configure-adc-project

AEM 콘텐츠 AI 서비스 API를 호출하려면 Adobe Developer Console(ADC) 프로젝트에서 발급한 자격 증명이 필요합니다. 이 페이지에서는 프로젝트 생성, 인증 방법 선택 및 모든 API 요청에 포함된 자격 증명 생성에 대해 안내합니다.

시작하려면 Adobe Developer Console로 이동하십시오.

사전 요구 사항 prerequisites

시작하기 전에 다음 사항을 확인하십시오.

  • 조직의 Adobe Developer Console에 액세스할 권한이 있는지.
  • Adobe Admin Console​의 AEM 콘텐츠 AI 서비스 제품 프로필에 개발자​로 추가되어 있는지. 이 역할이 없으면 AEM 콘텐츠 AI 서비스 API 카드가 비활성 상태로 나타나고 서버 간 인증 옵션이 숨겨집니다.
  • 선택할 제품 프로필의 프로그램 및 환경 번호를 알고 있는지(예: AEM User - publish - Program 12345 - Environment 67890).
  • 프로그램의 Admin Console에서 시스템 관리자 역할을 갖고 있습니다. 이 역할을 사용하여 제품 프로필을 관리하고 환경에 사용자를 할당할 수 있습니다.

인증 방법 선택 choose-auth

AEM 콘텐츠 AI 서비스는 두 가지 인증 방법을 지원합니다. 통합에 일치하는 항목 선택:

메서드
적합한 대상
서버 간
사용자 상호 작용 없이 API를 호출하는 백엔드 서비스 단기 액세스 토큰을 반환합니다.
API 키
API를 직접 호출하는 클라이언트측 또는 브라우저 기반 통합. 허용된 도메인에 대한 범위가 지정된 장기 키를 반환합니다.

서버 간 인증 s2s-auth

  1. API 및 서비스​를 선택한 다음​ API ​를 선택합니다.

    API 및 서비스를 표시하는 Developer Console

  2. AEM 콘텐츠 AI 서비스​별로 필터링한 다음 프로젝트 만들기​를 선택하여 새 프로젝트를 시작하거나, 기존 프로젝트에 서비스를 추가하는 경우 API 추가​를 선택합니다.

    note
    NOTE
    API 카드가 비활성화되고 "라이선스 필요" 메시지가 나타나면 AEM as a Cloud Service 환경이 현대화되지 않을 수 있습니다. AEM as a Cloud Service 환경 현대화를 참조하십시오.
  3. API 구성 대화 상자에서 서버 간 인증을 선택합니다.

    서버 간 옵션이 선택된 API 대화 상자 구성

    note tip
    TIP
    서버 간 옵션을 사용할 수 없는 경우에는 통합을 설정하는 사용자가 제품 프로필에 개발자로 추가되지 않습니다. 서버 간 인증 활성화를 참조하십시오.
  4. 필요한 경우 자격 증명의 이름을 변경합니다. 다음​을 선택합니다.

    다음을 선택하기 전에 새 서버 간 자격 증명의 이름을 바꾸는 Adobe Developer Console 단계

  5. AEM 사용자 - 게시 - 프로그램 XXX - 환경 XXX 및/또는 AEM 사용자 - 작성자 - 프로그램 XXX - 환경 XXX 제품 프로필을 선택한 다음 저장​을 선택합니다.

    대상 프로그램 및 환경에 대한 AEM 사용자 게시 및 작성자 프로필을 보여주는 제품 프로필 선택기

  6. API 및 인증 구성을 검토합니다.

    선택한 API, 인증 유형 및 자격 증명 이름을 요약한 검토 화면

    자격 증명에 대해 할당된 제품 프로필을 보여주는 검토 화면 상세

액세스 토큰 생성 generate-token

  1. ADC 프로젝트에서 자격 증명​으 이동하여 액세스 토큰 생성​을 선택합니다.

    액세스 토큰 생성 버튼이 강조 표시된 자격 증명 페이지

  2. 모든 API 요청의 Authorization 헤더에 토큰 포함:

    code language-http
    Authorization: Bearer YOUR_ACCESS_TOKEN
    
    note warning
    WARNING
    토큰을 안전하게 저장합니다. 토큰은 만료되며 주기적으로 다시 생성해야 합니다.

API 키 인증 api-key-auth

  1. AEM 콘텐츠 AI 서비스 API를 프로젝트에 추가할 때 인증 유형 선택 대화 상자에서 API 키​를 선택합니다.

    API 키 인증 유형 선택

  2. API 키 자격 증명을 확인합니다.

    API 키 자격 증명 추가

  3. 키를 사용할 수 있는 원본을 제한하려면 허용된 도메인을 구성합니다.

    허용 도메인 구성

  4. API 키(클라이언트 ID)가 연결된 자격 증명 아래에 나타납니다. 복사​를 선택합니다.

    연결된 자격 증명에서 API 키 복사

  5. 모든 API 요청에 키 포함:

    code language-http
    x-api-key: YOUR_API_KEY
    

    이제 프로젝트가 준비되었습니다. AEM 콘텐츠 AI 서비스에 대한 모든 요청에 키를 사용합니다.

다음 단계 next-steps

recommendation-more-help
experience-manager-content-ai-help-content-ai