Configura l'accesso x-on-behalf-user quando un Account tecnico deve eseguire operazioni API Analyzer per utenti specifici nella stessa organizzazione.
Quando l'accesso per conto dell'utente è abilitato, un'applicazione centrale può utilizzare documenti e dati di Analyzer di proprietà dell'utente senza richiedere token di autenticazione dei singoli utenti.
Cosa consente l'accesso per conto terzi
Un Account tecnico può agire per conto di un utente approvato per:
- Accedere ai documenti dell'utente.
- Recuperare i valori estratti dai documenti dell'utente.
- Cercare nei dati dell'utente.
- Caricare documenti per l'utente.
- Estrarre attributi configurati dall'utente.
L'accesso si applica solo agli utenti esplicitamente approvati per l'Account tecnico.
Requisiti
Prima di richiedere l'accesso per conto terzi:
- Configura l'account tecnico per l'accesso all'API Analyzer.
- Effettua almeno una chiamata API Analyzer riuscita utilizzando l'account tecnico.
- Assicurati che ogni utente appartenga alla stessa organizzazione dell'account tecnico.
- Raccogli l'indirizzo e-mail esatto per ogni utente che richiede l'accesso per conto terzi.
Adobe rifiuta le richieste per conto di utenti in un'altra organizzazione o quando l'indirizzo e-mail fornito non corrisponde esattamente all'account dell'utente.
Identifica l'Account tecnico
Identifica l'account tecnico che genera il token di accesso OAuth ed effettua le richieste API.
Per trovare l'ID dell'account tecnico:
- Apri il progetto in Adobe Developer Console.
- Apri le credenziali OAuth Server-to-Server utilizzate per Analyzer.
- Apri la pagina utilizzata per generare un token di accesso.
- Individua l'ID account tecnico.
L'ID account tecnico termina con @techacct.adobe.com.
Verifica che l'ID appartenga all'Account tecnico utilizzato dalla tua integrazione prima di inviare la richiesta per inserire nell'elenco Consentiti.
Identifica gli utenti
Crea un elenco degli utenti per i quali l'account tecnico deve agire per conto terzi.
Per ogni utente:
- Raccogli l'indirizzo e-mail esatto dell'account Adobe dell'utente.
- Verifica che l'Utente appartenga alla stessa organizzazione dell'account tecnico.
Solo gli utenti {1}inseriti nell'elenco Consentiti{2} approvato possono essere consultati tramite richieste per conto terzi.
Richiedi accesso per conto terzi
Il supporto Adobe gestisce l'{1}elenco Consentiti{2} per ogni account tecnico.
L'amministratore di sistema dell'organizzazione deve inviare una richiesta di supporto che includa:
- L'ID dell'account tecnico che termina con @techacct.adobe.com.
- L'elenco completo degli indirizzi e-mail degli utenti da {1}inserire nell'elenco Consentiti{2}.
- Conferma di approvazione da parte dell'amministratore di sistema dell'organizzazione.
Adobe esamina la richiesta e configura gli utenti approvati per l'account tecnico.
L'account tecnico deve aver completato almeno una chiamata API Analyzer riuscita prima che Adobe possa aggiornare la configurazione.
Effettua una richiesta API per conto di un Utente
Dopo che Adobe approva l'elenco Consentiti, includi l'intestazione {1}x-on-behalf-user{2} nelle richieste che devono essere eseguite per conto di un Utente approvato.
Imposta il valore dell'intestazione sull'indirizzo e-mail approvato dell'Utente:
x-on-behalf-user: user@example.com
Continua ad autenticare la richiesta con il bearer token OAuth Server-to-Server dell'account tecnico.
La richiesta viene eseguita nel contesto dell'Utente identificato dall'intestazione x-on-behalf-user. L'Utente deve essere nell'{1}elenco Consentiti{2} approvato dell'account tecnico.
