OAuth 서버 간 인증

OAuth 서버 간 인증을 사용하면 사용자 상호 작용 없이 AEM Forms Communications API에 대한 토큰 기반의 보안 액세스를 수행할 수 있습니다. OAuth 서버 간 인증은 Adobe Developer Console에서 지원됩니다.

사전 요구 사항

시작하기 전에 다음 전제 조건이 충족되는지 확인하십시오.

OAuth 서버 간 인증을 사용하여 액세스 토큰을 생성하는 방법

아래 단계에 따라 Adobe Developer 콘솔에서 액세스 토큰을 생성하고 OAuth 서버 간 인증을 통해 첫 번째 API 호출을 수행하십시오.

​1. Adobe Developer Console 프로젝트 설정

  1. Adobe Developer Console​(으)로 이동

  2. Adobe ID으로 로그인

  3. 새 프로젝트 만들기 또는 기존 프로젝트로 이동

새 프로젝트를 만들려면
  1. 빠른 시작 섹션에서 새 프로젝트 만들기​를 클릭하세요.

  2. 기본 이름으로 새 프로젝트가 만들어집니다.

    ADC 프로젝트 만들기

  3. 오른쪽 상단 모서리에서 프로젝트 편집​을 클릭합니다.

    프로젝트 편집

  4. 의미 있는 이름(예: "formsproject") 제공

  5. 저장 클릭

    프로젝트 이름 편집

기존 프로젝트로 이동
  1. Adobe Developer Console에서 모든 프로젝트 클릭

    프로젝트 검색

  2. 프로젝트를 찾은 다음 를 클릭하여 엽니다.

    프로젝트 찾기

​2. Forms API 추가

원하는 작업을 기반으로 Forms API를 추가합니다.

  • AEM Forms Communications API: 문서(PDF 및 관련 형식)를 생성, 변환, 결합 또는 보호해야 할 때 사용합니다.
  • 적응형 Forms 런타임 API - 런타임 시 적응형 Forms을 렌더링, 제출 또는 처리해야 할 때 사용합니다.
AEM Forms Communications API용
  1. API 추가 클릭

    API 추가

  2. Forms 통신 API 선택

    1. API 추가 대화 상자에서 Experience Cloud(으)로 필터링합니다.

    2. "Forms 통신 API" 선택

      Forms 통신 API 추가

    3. 다음 클릭

    4. OAuth 서버 간 인증 방법 선택

      인증 방법 선택

적응형 Forms 런타임 API용
  1. API 추가 클릭

    API 추가

  2. AEM Forms 배달 및 런타임 API 선택

    1. API 추가 대화 상자에서 Experience Cloud(으)로 필터링합니다.

    2. "AEM Forms 배달 및 런타임 API" 선택
      Forms 통신 API 추가

    3. 다음 클릭

    4. OAuth 서버 간 인증 방법을 선택하십시오.
      인증 방법 선택

프로젝트에 추가 > API​를 클릭하여 API 및 인증 방법을 기존 프로젝트에 추가할 수도 있습니다.
기존 프로젝트에 API 추가

​3. 제품 프로필 추가

제품 프로필은 AEM 리소스에 액세스할 수 있는 자격 증명에 대한 권한(또는 인증)을 제공합니다.

  1. AEM 인스턴스 URL()과 일치하는​제품 프로필https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com을 선택하십시오.

    • 서비스 유형 - AEM 인스턴스와 연결된 서비스 또는 권한을 지정합니다.

    • 환경 유형 - 환경이 Author 또는 Publish 서비스용인지 지정합니다.

    • 프로그램 XXX - Cloud Manager 프로그램 ID를 식별합니다

    • 환경 XXX - 해당 프로그램 내의 특정 환경 ID를 식별합니다.

    note note
    NOTE
    제품 프로필은 특정 AEM 인스턴스(프로그램 + 환경)에 연결되어 있습니다. 항상 인스턴스 URL과 일치하는 프로필을 선택합니다.
  2. 구성된 API 저장​을 클릭합니다. API 및 제품 프로필이 프로젝트에 추가됩니다

    프로젝트 구성 선택

​4. 자격 증명 생성 및 저장

  1. Adobe Developer Console에서 프로젝트로 이동

  2. OAuth 서버 간 자격 증명을 클릭합니다.

  3. 자격 증명 세부 정보 섹션 보기

    자격 증명 보기

API 자격 증명 기록

    API Credentials:
    ================
    Client ID: <your_client_id>
    Client Secret: <your_client_secret>
    Technical Account ID: <tech_account_id>
    Organization ID: <org_id>
    Scopes: AdobeID,openid,read_organizations

​5. 액세스 토큰 생성

Access 토큰을 수동 또는 프로그래밍 방식으로 생성합니다.

테스트용

Adobe Developer Console에서 액세스 토큰을 수동으로 생성합니다.

  1. 프로젝트로 이동

    1. Adobe Developer Console에서 프로젝트를 엽니다.
    2. OAuth 서버 간 클릭
  2. 액세스 토큰 생성

    1. 프로젝트의 API 섹션에서 "액세스 토큰 생성" 단추를 클릭합니다.
    2. 생성된 액세스 토큰 복사

    액세스 토큰 생성

    note note
    NOTE
    액세스 토큰은 24시간 동안만 유효합니다.
프로덕션용

Adobe IMS API를 사용하여 프로그래밍 방식으로 토큰 생성:

필요한 자격 증명:

  • 클라이언트 ID
  • 클라이언트 비밀
  • 범위(일반적으로 openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

토큰 끝점:

code language-none
https://ims-na1.adobelogin.com/ims/token/v3

샘플 요청(curl):

code language-bash
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<YOUR_CLIENT_ID>' \
-d 'client_secret=<YOUR_CLIENT_SECRET>' \
-d 'scope=AdobeID,openid,read_organizations'

응답:

code language-json
    {
    "access_token": "eyJhbGciOiJSUz...",
    "token_type": "bearer",
    "expires_in": 86399
    }

이제 생성된 액세스 토큰을 사용하여 개발, 스테이지 또는 프로덕션 환경에 대한 API를 호출할 수 있습니다.

우수 사례: 개발, 스테이징 및 프로덕션을 위한 자격 증명 관리

  • 개발, 스테이징 및 프로덕션에 항상 별도의 자격 증명을 사용하십시오.

  • 각 자격 증명을 올바른 AEM 환경 URL에 매핑합니다.

  • 비밀을 안전하게 저장하고 소스 제어에 커밋하지 마십시오.

  • 토큰은 24시간 동안만 유효하므로 액세스 토큰 유효성을 추적합니다.

다음 단계

동기 Forms Communication API용 환경을 설정하는 방법에 대해 알아보려면 AEM Forms as a Cloud Service Communications 동기 처리를 참조하십시오.

관련 문서

동기식(온디맨드) 및 비동기식(일괄 처리) Forms Communications API에 대한 환경을 설정하는 방법에 대해 알아봅니다.

동기 API

AEM Forms Communications API - 동기

문서를 즉시 생성하거나 처리하는 동기식(온디맨드) Forms Communications API용 환경을 설정하는 방법에 대해 알아봅니다.

자세히 알아보기

비동기 API

AEM Forms Communications API - 비동기(일괄 처리)

예약된 방식으로 여러 문서를 생성하거나 처리하는 비동기(일괄 처리) Forms Communications API에 대한 환경을 설정하는 방법에 대해 알아봅니다.

자세히 알아보기

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab