Konfigurera x-on-behalf-user-åtkomst när ett tekniskt konto behöver utföra Analyzer API-åtgärder för specifika användare i samma organisation.
När åtkomst för ställföreträdare är aktiverad kan en central applikation arbeta med användares Analyzer-dokument och data utan att kräva individuella autentiseringstokens för användare.
Vad åtkomst för ställföreträdare möjliggör
Ett tekniskt konto kan agera för en godkänd användares räkning för att:
- Få åtkomst till användarens dokument.
- Hämta extraherade värden från användarens dokument.
- Söka i användarens data.
- Ladda upp dokument för användaren.
- Extrahera attribut som konfigurerats av användaren.
Åtkomst gäller endast för användare som uttryckligen godkänts för det tekniska kontot.
Krav
Innan du begär åtkomst för ställföreträdare:
- Konfigurera det tekniska kontot för Analyzer API-åtkomst.
- Gör minst ett framgångsrikt Analyzer API-anrop med det tekniska kontot.
- Säkerställ att varje användare tillhör samma organisation som det tekniska kontot.
- Samla in den exakta e-postadressen för varje användare som behöver åtkomst för ställföreträdare.
Adobe avvisar förfrågningar för ställföreträdare för användare i en annan organisation eller när den angivna e-postadressen inte exakt matchar användarens konto.
Identifiera det tekniska kontot
Identifiera det tekniska kontot som genererar OAuth-åtkomsttoken och gör API-förfrågningarna.
För att hitta dess tekniska konto-ID:
- Öppna projektet i Adobe Developer Console.
- Öppna OAuth Server-to-Server-autentiseringsuppgiften som används för Analyzer.
- Öppna sidan som används för att generera en åtkomsttoken.
- Leta upp det tekniska konto-ID:t.
Det tekniska konto-ID:t slutar med @techacct.adobe.com.
Verifiera att ID:t tillhör det tekniska konto som din integration använder innan du skickar tillåtelselistförfrågan.
Identifiera användarna
Skapa en lista över de användare som det tekniska kontot behöver agera på uppdrag av.
För varje användare:
- Samla in användarens exakta e-postadress för Adobe-kontot.
- Verifiera att användaren tillhör samma organisation som det tekniska kontot.
Endast användare som ingår i den godkända tillåtslistan kan nås genom förfrågningar på uppdrag av andra.
Begär åtkomst på uppdrag av andra
Adobe Support hanterar tillåtelselistan för varje tekniskt konto.
Organisationens systemadministratör måste skicka en supportförfrågan som innehåller:
- Det tekniska konto-ID:t som slutar på @techacct.adobe.com.
- Den fullständiga listan över användarnas e-postadresser som ska läggas till i tillåtelselistan.
- Bekräftelse av godkännande från organisationens systemadministratör.
Adobe granskar förfrågan och konfigurerar de godkända användarna för det tekniska kontot.
Det tekniska kontot måste ha genomfört minst ett framgångsrikt Analyzer API-anrop innan Adobe kan uppdatera dess konfiguration.
Gör en API-förfrågan på uppdrag av en användare
Efter att Adobe har godkänt tillåtslistan ska du inkludera huvudet x-on-behalf-user i förfrågningar som ska köras på uppdrag av en godkänd användare.
Ställ in huvudvärdet till användarens godkända e-postadress:
x-on-behalf-user: user@example.com
Fortsätt att autentisera förfrågan med det tekniska kontots OAuth Server-to-Server bearer token.
Förfrågan körs i kontexten för användaren som identifieras av huvudet x-on-behalf-user.Användaren måste finnas på det tekniska kontots godkända tillåtslista.
