在 Acrobat 中為 Analyzer 設定代理存取權

上次更新時間 2026年10月23日

當技術帳戶需要為相同組織中的特定使用者執行 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 屬於您整合使用的技術帳戶。

識別使用者

建立技術帳戶需要代表的使用者清單。

對於每個使用者:

  1. 收集使用者的確切 Adobe 帳戶電子郵件。
  2. 確認使用者是否與技術帳戶屬於同一個組織。

只有列入核准允許名單的使用者,才能透過代理請求進行存取。

請求代理存取權

Adobe 支援人員負責管理每個技術帳戶的允許清單。

組織的系統管理員必須提交一項支援請求,內容須包含:

  • 結尾為 @techacct.adobe.com 的技術帳戶 ID。
  • 要加入允許清單的使用者電子郵件地址的完整清單。
  • 組織系統管理員的核准確認。

Adobe 會審閱要求並為技術帳戶設定核准的使用者。

技術帳戶必須至少已完成一次成功的 Analyzer API 呼叫,Adobe 才能更新其設定。

代表使用者提出 API 要求

Adobe 核准允許清單後,在應代表已核准使用者執行的要求中加入 x-on-behalf-user 標頭。

將標頭值設定為使用者的已核准電子郵件:

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

繼續使用技術帳戶的 OAuth 伺服器對伺服器 Bearer 權杖驗證請求。

該請求會由 x-on-behalf-user 標頭所識別之使用者的執行環境中執行。使用者必須在技術帳戶的已核准允許清單中。