當技術帳戶需要為相同組織中的特定使用者執行 Analyzer API 操作時,請設定 x-on-behalf-user 存取權。
啟用代理存取權後,中央應用程式可處理使用者擁有的 Analyzer 文件和資料,無需個別使用者驗證權杖。
代理存取權的功能
技術帳戶可代表已核准的使用者:
- 存取使用者的文件。
- 從使用者的文件中檢索擷取的值。
- 搜尋使用者的資料。
- 為使用者上傳文件。
- 擷取使用者設定的屬性。
存取權僅適用於明確核准技術帳戶的使用者。
軟硬體要求
在請求代理存取權之前:
- 為 Analyzer API 存取權設定技術帳戶。
- 使用技術帳戶至少成功進行一次 Analyzer API 呼叫。
- 確保每位使用者都屬於與技術帳戶相同的組織。
- 為每位需要代理存取權的使用者收集正確的電子郵件地址。
Adobe 會拒絕代表其他組織的使用者提出的請求,或是當提供的電子郵件地址與該使用者的帳戶不完全相符時,亦會拒絕該請求。
識別技術帳戶
識別產生 OAuth 存取權杖並提出 API 請求的技術帳戶。
尋找其技術帳戶 ID:
- 在 Adobe Developer Console 中開啟專案。
- 開啟用於 Analyzer 的 OAuth Server-to-Server 認證。
- 開啟用於生成存取權杖的頁面。
- 找出技術帳戶 ID。
技術帳戶 ID 結尾為@techacct.adobe.com。
在提交加入允許清單請求之前,請確認 ID 屬於您整合使用的技術帳戶。
識別使用者
建立技術帳戶需要代表的使用者清單。
對於每個使用者:
- 收集使用者的確切 Adobe 帳戶電子郵件。
- 確認使用者是否與技術帳戶屬於同一個組織。
只有列入核准允許名單的使用者,才能透過代理請求進行存取。
請求代理存取權
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 標頭所識別之使用者的執行環境中執行。使用者必須在技術帳戶的已核准允許清單中。