OAuth-adgang skal være aktiveret for din organisation. Din opsætning angiver
det regionale tokenendepunkt, udstederen, målgruppen (audience) og klientgodkendelsesmetoden.
Hvis du har brug for disse indstillinger, eller hvis du ikke kan få adgang til klientadministration, skal du kontakte
Living Security Support.
Inden du begynder
- Opret en servicekonto med kun de tilladelser, som integrationen har brug for.
- Brug en administrationslegitimation med
service_account:manageog hver tilladelse, du vil give til den nye klient. Målkontoen skal også have disse tilladelser. En klient kan ikke udvide nogen af kontoenes beføjelser. - Vælg organisationens region. API-legitimationsoplysninger og OAuth-adgangstokens hører til på den tilsvarende regionale API-vært.
- Opbevar klienthemmeligheden og tokens i din serverside-hemmelighedslagring. Placer dem aldrig i browserkode, mobilapplikationer, kildekodestyring eller anmodningslogfiler.
Opret en klient
POST /v1/oauth_clients kræver service_account_id, en ikke-tom liste med eksplicitte
scopes og en Idempotency-Key. Jokertegn accepteres ikke. En klient understøtter
op til 100 scopes med en samlet længde på højst 4.096 tegn. Hver serviceserviceskonto
kan højst have 20 klienter eller uafklarede oprettelses-/oprydningsoperationer.
Tilbagekaldelse afviser straks API-adgang. En klient eller en usikker oprettelse hos udbyderen
tæller fortsat med i grænsen, indtil den eksterne oprydning er bekræftet.
En opgivet reservation eller en oprettelse, der beviseligt mislykkedes, før udbyderens arbejde
begyndte, kan frigive sin plads sikkert. Dens genforsøgsnøgle tilhører stadig det oprindelige
forsøg; genopret den pågældende kvittering, før du beslutter, om du vil oprette en erstatning.
Vælg én genforsøgsnøgle til dette oprettelsesforsøg, og gem den før du sender
anmodningen. Brug 1–255 synlige ASCII-tegn uden mellemrum. Genbrug den med den
samme konto, de samme scopes, den samme administrationsprincipal, region og API-version efter et tabt
svar. Rotation af administrationslegitimationen under den samme serviceskonto
opretter ikke en ny genforsøgsidentitet.
Installer Pythons requests-pakke. Indlæs følgende miljøværdier via
din normale håndtering af hemmeligheder og konfiguration:
Python
201 og indeholder en oauth_client-ressource
med id, service_account_id, client_id, scopes, status, created_at og
client_secret. Svar er markeret Cache-Control: no-store.
ididentificerer platformressourcen. Gem den til hentning og tilbagekaldelse.client_ididentificerer klienten under tokenudveksling. Det er ikke platformressourcens ID. Den kan værenull, mens oprettelsen afventer.client_secretreturneres kun til den anmodning, der gennemfører oprettelsen. Hver gentaget oprettelsesanmodning returnerernull, også et genforsøg efter et tabt succesrespons. Hentning returnerer aldrig en hemmelighed.
Genopret efter et tabt eller afbrudt svar
Gentag den samme oprettelsesanmodning med den gemte genforsøgsnøgle for at genoprette en ressourcekvittering. Kvitteringen afspejler den aktuelle tilstand, så en tilbagekaldt klient forbliver tilbagekaldt. Denne operation bruger ikke den generelle kontrakt om genafspilning af cachede svar i 24 timer og returnerer ikke enIdempotent-Replayed-header.
Se fejl for anmodnings-ID’er og oplysninger om genoprettelse.
Send aldrig en klienthemmelighed eller et adgangstoken sammen med en supportanmodning.
Undersøg og tilbagekald
Brug din administrationslegitimation og platformressourcensid:
Tilbagekaldelse blokerer efterfølgende API-anmodninger for klienten, herunder anmodninger med
allerede udstedte tokens. Den annullerer ikke arbejde, som API’en allerede har accepteret.
Ekstern oprydning af legitimationsoplysninger kan gennemføres senere. Det er sikkert at gentage tilbagekaldelsen,
og den kræver ingen genforsøgsnøgle. Fortsæt med at bruge administrationslegitimationen, hvis den klient,
der tilbagekaldes, selv er en API-kalder.

