Skonfiguruj dostęp x-on-behalf-user, gdy konto techniczne musi wykonywać operacje interfejsu API programu Analyzer dla określonych użytkowników w tej samej organizacji.
Gdy dostęp w imieniu jest włączony, centralna aplikacja może pracować z dokumentami i danymi Analizatora należącymi do użytkowników bez konieczności stosowania indywidualnych tokenów uwierzytelniania użytkowników.
Co umożliwia dostęp w imieniu
Konto techniczne może działać w imieniu zatwierdzonego użytkownika w celu:
- Uzyskaj dostęp do dokumentów użytkownika.
- Pobierz wyodrębnione wartości z dokumentów użytkownika.
- Przeszukaj dane użytkownika.
- Przesłania dokumentów dla użytkownika.
- Wyodrębnienia atrybutów skonfigurowanych przez użytkownika.
Dostęp dotyczy tylko użytkowników wyraźnie zatwierdzonych dla konta technicznego.
Wymagania
Przed złożeniem żądania dostępu w imieniu:
- Skonfiguruj konto techniczne w celu uzyskania dostępu do interfejsu API programu Analyzer.
- Wykonaj co najmniej jedno udane wywołanie interfejsu API programu Analyzer przy użyciu konta technicznego.
- Upewnij się, że każdy użytkownik należy do tej samej organizacji co konto techniczne.
- Zbierz dokładny adres e-mail dla każdego użytkownika, który wymaga dostępu w imieniu.
Adobe odrzuca żądania w imieniu użytkowników z innej organizacji lub gdy podany adres e-mail nie jest dokładnie zgodny z kontem użytkownika.
Zidentyfikuj konto techniczne
Zidentyfikuj konto techniczne, które generuje token dostępu OAuth i wykonuje żądania interfejsu API.
Aby znaleźć identyfikator konta technicznego:
- Otwórz projekt w programie Adobe Developer Console.
- Otwórz dane uwierzytelniające OAuth Server-to-Server używane w programie Analyzer.
- Otwórz stronę używaną do generowania tokena dostępu.
- Znajdź identyfikator konta technicznego.
Identyfikator konta technicznego kończy się na @techacct.adobe.com.
Sprawdź, czy identyfikator należy do konta technicznego używanego przez integrację, przed przesłaniem żądania dodania do listy zezwoleń.
Identyfikuj użytkowników
Utwórz listę użytkowników, w imieniu których konto techniczne ma działać.
Dla każdego użytkownika:
- Zbierz dokładny adres e-mail konta Adobe użytkownika.
- Sprawdź, czy użytkownik należy do tej samej organizacji co konto Technical Account.
Tylko użytkownicy umieszczeni na zatwierdzonej liście zezwoleń mogą być objęci żądaniami wykonywanymi w ich imieniu.
Żądanie dostępu w imieniu
Pomoc techniczna Adobe zarządza listą zezwoleń dla każdego konta technicznego.
Administrator systemu organizacji musi złożyć żądanie pomocy technicznej, które obejmuje:
- Identyfikator konta Technical Account kończący się na @techacct.adobe.com.
- Pełna lista adresów e-mail użytkowników do umieszczenia na liście zezwoleń.
- Potwierdzenie zatwierdzenia od administratora systemu organizacji.
Adobe przegląda żądanie i konfiguruje zatwierdzonych użytkowników dla konta Technical Account.
Konto Technical Account musi wykonać co najmniej jedno pomyślne wywołanie interfejsu API Analyzer, zanim Adobe będzie mogło zaktualizować swoją konfigurację.
Wykonaj żądanie API w imieniu użytkownika
Po zatwierdzeniu listy zezwoleń przez Adobe uwzględnij nagłówek x-on-behalf-user w żądaniach, które powinny być uruchamiane w imieniu zatwierdzonego użytkownika.
Ustaw wartość nagłówka na zatwierdzony adres e-mail użytkownika:
x-on-behalf-user: user@example.com
Kontynuuj uwierzytelnianie żądania za pomocą tokena bearer OAuth Server-to-Server konta Technical Account.
Żądanie jest uruchamiane w kontekście użytkownika identyfikowanego przez nagłówek x-on-behalf-user.Użytkownik musi znajdować się na zatwierdzonej liście zezwoleń konta Technical Account.
Wypróbuj program Acrobat w Internecie
Tworzenie, edytowanie i udostępnianie plików PDF w Internecie.
