Configureer x-on-behalf-user-toegang wanneer een technisch account Analyzer API-bewerkingen moet uitvoeren voor specifieke gebruikers in dezelfde organisatie.
Wanneer namens-toegang is ingeschakeld, kan een centrale applicatie werken met documenten en gegevens van gebruikers zonder individuele authenticatietokens van gebruikers te vereisen.
Wat namens-toegang mogelijk maakt
Een technisch account kan namens een goedgekeurde gebruiker:
- Toegang krijgen tot de documenten van de gebruiker.
- Geëxtraheerde waarden ophalen uit de documenten van de gebruiker.
- Zoeken in de gegevens van de gebruiker.
- Documenten uploaden voor de gebruiker.
- Attributen extraheren die door de gebruiker zijn geconfigureerd.
Toegang geldt alleen voor gebruikers die expliciet zijn goedgekeurd voor het technische account.
Vereisten
Voordat je toegang namens een ander aanvraagt:
- Configureer het technische account voor Analyzer API-toegang.
- Voer minimaal één succesvolle Analyzer API-aanroep uit met het technische account.
- Zorg ervoor dat elke gebruiker tot dezelfde organisatie behoort als het technische account.
- Verzamel het exacte e-mailadres voor elke gebruiker die toegang namens anderen nodig heeft.
Adobe wijst namens-aanvragen af voor gebruikers in een andere organisatie of wanneer het opgegeven e-mailadres niet exact overeenkomt met het account van de gebruiker.
Technisch account identificeren
Identificeer het technische account dat het OAuth-toegangstoken genereert en de API-aanvragen uitvoert.
Om het technische account-ID te vinden:
- Open het project in Adobe Developer Console.
- Open de OAuth Server-to-Server-aanmeldingsgegevens die worden gebruikt voor Analyzer.
- Open de pagina die wordt gebruikt om een toegangstoken te genereren.
- Zoek het technische account-ID.
Het technische account-ID eindigt op @techacct.adobe.com.
Controleer dat het ID behoort tot het technische account dat je integratie gebruikt voordat je de allowlist-aanvraag indient.
Identificeer de gebruikers
Maak een lijst van de gebruikers voor wie het Technical account moet handelen.
Voor elke gebruiker:
- Verzamel het exacte e-mailadres van het Adobe account van de gebruiker.
- Controleer of de gebruiker tot dezelfde organisatie behoort als het technische account.
Alleen gebruikers die op de goedgekeurde lijst met gewenste personen staan, zijn toegankelijk via namens-verzoeken.
Toegang namens iemand anders aanvragen
Adobe Support beheert de lijst met gewenste personen voor elk Technical account.
De systeembeheerder van de organisatie moet een ondersteuningsverzoek indienen dat het volgende bevat:
- Het technische account-ID dat eindigt op @techacct.adobe.com.
- De volledige lijst van e-mailadressen van gebruikers voor de lijst met gewenste personen.
- Bevestiging van goedkeuring van de systeembeheerder van de organisatie.
Adobe controleert het verzoek en configureert de goedgekeurde gebruikers voor het Technical account.
Het Technical account moet ten minste één succesvolle Analyzer API-aanroep hebben voltooid voordat Adobe de configuratie kan bijwerken.
Doe een API-verzoek namens een gebruiker
Nadat Adobe de lijst van gewenste personen goedkeurt, voeg je de x-on-behalf-user koptekst toe aan verzoeken die namens een goedgekeurde gebruiker moeten worden uitgevoerd.
Stel de headerwaarde in op het goedgekeurde e-mailadres van de gebruiker:
x-on-behalf-user: user@example.com
Blijf het verzoek authenticeren met het OAuth Server-to-Server bearer token van de Technical Account.
Het verzoek wordt uitgevoerd in de context van de gebruiker die wordt geïdentificeerd door de x-on-behalf-user header. De gebruiker moet op de goedgekeurde lijst met gewenste personen van het Technical account staan.
