Acrobat에서 Analyzer용 대리 액세스 구성

마지막 업데이트 날짜 2026년 10월 28일

기술 계정이 동일한 조직의 특정 사용자를 위해 Analyzer API 작업을 수행해야 할 때 x-on-behalf-user 액세스를 구성하세요.

대리 액세스가 활성화되면 중앙 애플리케이션이 개별 사용자 인증 토큰 없이도 사용자 소유의 Analyzer 문서와 데이터로 작업할 수 있습니다.

대리 액세스로 할 수 있는 기능

기술 계정은 승인된 사용자를 대신하여 다음 작업을 수행할 수 있습니다:

  • 사용자의 문서에 액세스합니다.
  • 사용자의 문서에서 추출된 값을 검색합니다.
  • 사용자의 데이터를 검색합니다.
  • 사용자를 위해 문서를 업로드합니다.
  • 사용자가 구성한 속성을 추출합니다.

액세스는 기술 계정에 대해 명시적으로 승인된 사용자에게만 적용됩니다.

요구 사항

대리 액세스를 요청하기 전에:

  • Analyzer API 액세스를 위한 기술 계정을 구성하세요.
  • 기술 계정을 사용하여 Analyzer API 호출을 최소 한 번 성공적으로 수행하세요.
  • 각 사용자가 기술 계정과 동일한 조직에 속하는지 확인하세요.
  • 대리 액세스가 필요한 각 사용자의 정확한 이메일 주소를 수집하세요.

Adobe는 다른 조직의 사용자에 대한 대리 요청이나 제공된 이메일 주소가 사용자의 계정과 정확히 일치하지 않는 경우 요청을 거부합니다.

기술 계정 식별

OAuth 액세스 토큰을 생성하고 API 요청을 수행하는 기술 계정을 식별하세요.

기술 계정 ID를 찾으려면:

  1. Adobe Developer Console에서 프로젝트를 여세요.
  2. Analyzer에 사용된 OAuth Server-to-Server 자격 증명을 여세요.
  3. 액세스 토큰을 생성하는 데 사용된 페이지를 여세요.
  4. 기술 계정 ID를 찾습니다.

기술 계정 ID는 @techacct.adobe.com로 끝납니다.

허용 목록 요청을 제출하기 전에 해당 ID가 통합에서 사용하는 기술 계정에 속하는지 확인하세요.

사용자 식별하기

Technical Account가 대신 작업해야 할 사용자 목록을 만드세요.

각 사용자에 대해:

  1. 사용자의 정확한 Adobe 계정 이메일 주소를 수집하세요.
  2. 사용자가 Technical Account와 동일한 조직에 속해 있는지 확인하세요.

승인된 허용 목록에 포함된 사용자만 대리 요청을 통해 액세스할 수 있습니다.

대리 액세스 요청

Adobe 지원에서 각 Technical Account의 허용 목록을 관리합니다.

조직의 시스템 관리자는 다음 내용이 포함된 지원 요청을 제출해야 합니다:

  • @techacct.adobe.com으로 끝나는 Technical Account ID.
  • 허용 목록에 추가할 사용자 이메일 주소의 전체 목록.
  • 조직 시스템 관리자의 승인 확인.

Adobe에서 요청을 검토하고 Technical Account에 대해 승인된 사용자를 설정합니다.

Adobe에서 설정을 업데이트하기 전에 Technical Account에서 최소 한 번의 성공적인 Analyzer API 호출을 완료해야 합니다.

사용자를 대신하여 API 요청하기

Adobe에서 허용 목록을 승인한 후, 승인된 사용자를 대신하여 실행해야 하는 요청에 x-on-behalf-user 헤더를 포함하세요.

헤더 값을 사용자의 승인된 이메일 주소로 설정하세요:

x-on-behalf-user: user@example.com

Technical Account의 OAuth Server-to-Server bearer 토큰으로 요청을 계속 인증하세요.

요청은 x-on-behalf-user 헤더로 식별된 사용자의 컨텍스트에서 실행됩니다. 사용자는 Technical Account의 승인된 허용 목록에 있어야 합니다.