Konfiguriere x-on-behalf-user-Zugriff, wenn ein technisches Konto Analyzer-API-Operationen für bestimmte Benutzende in derselben Organisation durchführen muss.
Wenn On-Behalf-Zugriff aktiviert ist, kann eine zentrale Anwendung mit Dokumenten und Daten aus Analyzer im Besitz von Anwendenden arbeiten, ohne individuelle Anwender-Authentifizierungstoken zu benötigen.
Was On-Behalf-Zugriff ermöglicht
Ein Technisches Konto kann im Namen eines genehmigten Anwenders handeln, um:
- auf die Dokumente des Anwendenden zuzugreifen.
- extrahierte Werte aus den Dokumenten des Anwendenden abzurufen.
- die Daten des Anwendenden zu durchsuchen.
- Dokumente für den Anwendenden hochzuladen.
- vom Anwendenden konfigurierte Attribute zu extrahieren.
Der Zugriff gilt nur für Anwendende, die explizit für das Technikkonto genehmigt wurden.
Voraussetzungen
Vor der Anfrage für On-Behalf-Zugriff:
- Konfiguriere das Technische Konto für Analyzer-API-Zugriff.
- Führe mindestens einen erfolgreichen Analyzer-API-Aufruf mit dem Technischen Konto durch.
- Stelle sicher, dass jeder Benutzer zur selben Organisation gehört wie das technische Konto.
- Erfasse die exakte E-Mail-Adresse für jeden Anwendenden, der On-Behalf-Zugriff benötigt.
Adobe lehnt On-Behalf-Anfragen für Anwender in einer anderen Organisation ab oder wenn die angegebene E-Mail-Adresse nicht exakt mit dem Konto des Anwenders übereinstimmt.
Technisches Konto identifizieren
Identifiziere das Technikkonto, das das OAuth-Zugriffstoken generiert und API-Anfragen stellt.
So findest du die ID des technischen Kontos:
- Öffne das Projekt in Adobe Developer Console.
- Öffne die OAuth Server-to-Server-Anmeldedaten, die für Analyzer verwendet werden.
- Öffne die Seite, mit der Zugriffstoken generiert werden.
- Finde die ID des Technikkontos.
Die Technische Konto-ID endet auf @techacct.adobe.com.
Überprüfe, ob die ID zu dem Technikkonto gehört, das deine Integration verwendet, bevor du die Allowlist-Anfrage sendest.
Anwendende identifizieren
Erstelle eine Liste der Benutzerinnen und Benutzer, für die das Technikkonto handeln soll.
Für jeden Benutzer:
- Erfasse die exakte E-Mail-Adresse des Adobe-Kontos des Benutzenden.
- Stelle sicher, dass jeder Benutzende zur selben Organisation gehört wie das Technikkonto.
Nur Benutzerinnen und Benutzer, die in der genehmigten Allowlist enthalten sind, können über On-Behalf-Anfragen erreicht werden.
On-Behalf-Zugriff beantragen
Adobe Support verwaltet die Allowlist für jedes Technikkonto.
Der Systemadministrator der Organisation muss eine Support-Anfrage stellen, die Folgendes enthält:
- Die Technical Account ID, die auf @techacct.adobe.com endet.
- Die vollständige Liste der E-Mail-Adressen der Benutzer, die auf die Zulassungsliste gesetzt werden sollen.
- Bestätigung der Genehmigung durch den Systemadministrator der Organisation.
Adobe prüft die Anfrage und konfiguriert die genehmigten Benutzenden für das Technikkonto.
Das technische Konto muss mindestens einen erfolgreichen Analyzer-API-Aufruf abgeschlossen haben, bevor Adobe seine Konfiguration aktualisieren kann.
API-Anfrage im Namen eines Benutzers stellen
Nachdem Adobe die Allowlist genehmigt hat, füge in Anfragen, die im Namen eines genehmigten Benutzers ausgeführt werden sollen, den Header x-on-behalf-user ein.
Setze den Header-Wert auf die genehmigte E-Mail-Adresse des Benutzenden:
x-on-behalf-user: user@example.com
Authentifiziere die Anfrage weiterhin mit dem OAuth Server-to-Server Bearer Token des Technikkontos.
Die Anfrage wird im Kontext des Benutzenden ausgeführt, der durch den x-on-behalf-user-Header angegeben wird.Der Benutzende muss in der genehmigten Allowlist des Technikkontos stehen.
Acrobat im Web ausprobieren
Erstelle und bearbeite PDF-Dokumente und tausche sie online aus.
