Konfigurer x-on-behalf-user-adgang, når en teknisk konto skal udføre Analyzer API-handlinger for bestemte brugere i samme organisation.
Når on-behalf-adgang er aktiveret, kan en central app arbejde med brugerejet Analyzer-dokumenter og data uden at kræve individuelle brugergodkendelsestokens.
Hvad on-behalf-adgang gør muligt
En teknisk konto kan handle på vegne af en godkendt bruger for at:
- Få adgang til brugerens dokumenter.
- Hente udtrukne værdier fra brugerens dokumenter.
- Søge i brugerens data.
- Uploade dokumenter for brugeren.
- Udtrække attributter konfigureret af brugeren.
Adgang gælder kun for brugere, der er eksplicit godkendt til den tekniske konto.
Krav
Før du anmoder om on-behalf-adgang:
- Konfigurer den tekniske konto til Analyzer API-adgang.
- Foretag mindst ét vellykket Analyzer API-kald ved hjælp af den tekniske konto.
- Sørg for at hver bruger tilhører samme organisation som den tekniske konto.
- Indsaml den nøjagtige e-mailadresse for hver bruger, der kræver adgang på vegne af andre.
Adobe afviser on-behalf-anmodninger for brugere i en anden organisation, eller når den angivne e-mailadresse ikke matcher brugerens konto nøjagtigt.
Identificer den tekniske konto
Identificer den tekniske konto, der genererer OAuth-adgangstokenet og foretager API-anmodningerne.
Sådan finder du dens tekniske konto-id:
- Åbn projektet i Adobe Developer Console.
- Åbn OAuth Server-to-Server-legitimationsoplysningerne, der bruges til Analyzer.
- Åbn siden, der bruges til at generere et adgangstoken.
- Find det tekniske konto-id.
Det tekniske konto-id slutter på @techacct.adobe.com.
Bekræft at id'et tilhører den tekniske konto, som din integration bruger, før du indsender tilladelseslisteanmodningen.
Identificer brugerne
Opret en liste over de brugere, som den tekniske konto skal handle på vegne af.
For hver bruger:
- Indsaml brugerens nøjagtige e-mailadresse til Adobe-kontoen.
- Kontroller, at brugeren tilhører samme organisation som den tekniske konto.
Kun brugere, der er opført på den godkendte tilladelsesliste, kan tilgås gennem anmodninger på vegne af andre.
Anmod om adgang på vegne af andre
Adobe Support administrerer tilladelseslisten for hver teknisk konto.
Organisationens systemadministrator skal indsende en supportanmodning, der omfatter:
- Det tekniske konto-ID, der ender på @techacct.adobe.com.
- Den komplette liste over bruger-e-mailadresser, der skal opføres på tilladelseslisten.
- Bekræftelse af godkendelse fra organisationens systemadministrator.
Adobe gennemgår anmodningen og konfigurerer de godkendte brugere til den tekniske konto.
Den tekniske konto skal have gennemført mindst ét vellykket Analyzer API-kald, før Adobe kan opdatere dens konfiguration.
Lav en API-anmodning på vegne af en bruger
Efter Adobe godkender tilladelseslisten, skal du inkludere headeren x-on-behalf-user i anmodninger, der skal køre på vegne af en godkendt bruger.
Indstil headerværdien til brugerens godkendte e-mailadresse:
x-on-behalf-user: user@example.com
Fortsæt med at godkende anmodningen med den tekniske kontos OAuth Server-to-Server bearer token.
Anmodningen køres i konteksten af den bruger, der er identificeret af x-on-behalf-user header. Brugeren skal være på den tekniske kontos godkendte tilladelsesliste.
