Configurez l’accès x-on-behalf-user lorsqu’un compte technique doit effectuer des opérations de l’API Analyzer pour des utilisateurs spécifiques dans la même organisation.
Lorsque l’accès au nom d’autrui est activé, une application centrale peut travailler avec les documents et les données Analyzer appartenant aux utilisateurs sans nécessiter de jetons d’authentification utilisateur individuels.
Ce que permet l’accès au nom d’autrui
Un compte technique peut agir au nom d’un utilisateur approuvé pour :
- Accéder aux documents de l’utilisateur.
- Récupérer les valeurs extraites des documents de l’utilisateur.
- Effectuer des recherches dans les données de l’utilisateur.
- Charger des documents pour l’utilisateur.
- Extraire les attributs configurés par l’utilisateur.
L’accès s’applique uniquement aux utilisateurs explicitement approuvés pour le compte technique.
Configuration requise
Avant de demander l’accès au nom d’autrui :
- Configurez le compte technique pour activer l’accès à l’API Analyzer.
- Effectuez au moins un appel API Analyzer réussi en utilisant le compte technique.
- Assurez-vous que chaque utilisateur appartient à la même organisation que le compte technique.
- Collectez l’adresse e-mail exacte de chaque utilisateur qui nécessite un accès au nom d’autrui.
Adobe rejette les demandes au nom d’autrui pour les utilisateurs d’une autre organisation ou lorsque l’adresse e-mail fournie ne correspond pas exactement au compte de l’utilisateur.
Identifier le compte technique
Identifiez le compte technique qui génère le jeton d’accès OAuth et effectue les demandes API.
Pour trouver l’identifiant du compte technique :
- Ouvrez le projet dans Adobe Developer Console.
- Ouvrez les informations d’identification OAuth de serveur à serveur utilisées pour Analyzer.
- Ouvrez la page utilisée pour générer un jeton d’accès.
- Localisez l’identifiant du compte technique.
L’identifiant du compte technique se termine par @techacct.adobe.com.
Vérifiez que l’identifiant appartient au compte technique que votre intégration utilise avant d’envoyer la demande de liste autorisée.
Identifier les utilisateurs
Créez une liste des utilisateurs au nom desquels le compte technique doit agir.
Pour chaque utilisateur :
- Collectez l’adresse e-mail exacte du compte Adobe de l’utilisateur.
- Vérifiez que l’utilisateur appartient à la même organisation que le compte technique.
Seuls les utilisateurs inclus dans la liste autorisée approuvée sont accessibles via les demandes au nom d’autrui.
Demander un accès au nom d’autrui
L’assistance Adobe gère la liste autorisée pour chaque compte technique.
L’administrateur système de l’organisation doit envoyer une demande d’assistance qui inclut :
- L’identifiant de compte technique se terminant par @techacct.adobe.com.
- La liste complète des adresses e-mail des utilisateurs à placer sur la liste autorisée.
- La confirmation d’approbation de l’administrateur système de l’organisation.
Adobe révise la demande et configure les utilisateurs approuvés pour le compte technique.
Le compte technique doit avoir effectué au moins un appel à l’API Analyzer réussi avant qu’Adobe puisse mettre à jour sa configuration.
Effectuer une requête API au nom d’un utilisateur
Après qu’Adobe approuve la liste autorisée, incluez l’en-tête x-on-behalf-user dans les demandes qui doivent s’exécuter au nom d’un utilisateur approuvé.
Définissez la valeur de l’en-tête sur l’adresse e-mail approuvée de l’utilisateur :
x-on-behalf-user: user@example.com
Continuez à authentifier la requête avec le jeton porteur OAuth serveur à serveur du compte technique.
La demande s’exécute dans le contexte de l’utilisateur identifié par l’en-tête x-on-behalf-user. L’utilisateur doit être sur la liste autorisée approuvée du compte technique.
Essayez Acrobat sur le Web
Créez, modifiez et partagez des fichiers PDF en ligne.
