OAuth-åtkomst måste vara aktiverad för er organisation. Er konfiguration tillhandahåller
den regionala tokenslutpunkten, utfärdaren, målgruppen och autentiseringsmetoden för klienten.
Om ni behöver dessa inställningar eller inte kan komma åt klienthanteringen, kontakta
Living Securitys support.
Innan du börjar
- Skapa ett tjänstkonto med endast de behörigheter som integrationen behöver.
- Använd en hanteringsuppgift med
service_account:manageoch varje behörighet som ni vill bevilja den nya klienten. Målkontot måste också ha dessa behörigheter. En klient kan inte utöka något av kontonas behörighet. - Välj organisationens region. API-uppgifter och OAuth-åtkomsttoken hör hemma på motsvarande regionala API-värd.
- Förvara klienthemligheten och tokenen i er serverbaserade hemlighetslagring. Placera dem aldrig i webbläsarkod, mobilappar, källkodshantering eller förfrågningsloggar.
Skapa en klient
POST /v1/oauth_clients kräver service_account_id, en icke-tom lista med explicita
scopes och en Idempotency-Key. Jokertecken accepteras inte. En klient stöder
upp till 100 scopes med en sammanlagd längd på högst 4 096 tecken. Varje tjänstkonto
kan ha högst 20 klienter eller olösta skapande-/rensningsoperationer.
Återkallelse nekar API-åtkomst omedelbart. En klient eller ett osäkert skapande hos leverantören
räknas fortsatt mot gränsen tills fjärrrensningen har bekräftats.
En övergiven reservation eller ett skapande som bevisligen misslyckades innan arbetet hos leverantören
påbörjades kan på ett säkert sätt frigöra sin plats. Dess återförsöksnyckel tillhör fortfarande det ursprungliga
försöket; återhämta det kvittot innan ni avgör om en ersättare ska skapas.
Välj en återförsöksnyckel för detta skapandeförsök och spara den innan förfrågan
skickas. Använd 1–255 synliga ASCII-tecken, utan blanksteg. Återanvänd den med samma
konto, scopes, hanteringsprincipal, region och API-version efter ett förlorat
svar. Att rotera hanteringsuppgiften under samma tjänstkonto
skapar ingen ny återförsöksidentitet.
Installera Pythons requests-paket. Läs in följande miljövärden via
er vanliga hantering av hemligheter och konfiguration:
Python
201 och innehåller en oauth_client-resurs
med id, service_account_id, client_id, scopes, status, created_at och
client_secret. Svaren är markerade Cache-Control: no-store.
ididentifierar plattformsresursen. Spara det för hämtning och återkallelse.client_ididentifierar klienten vid tokenutbyte. Det är inte plattformsresursens ID. Det kan varanullmedan skapandet väntar.client_secretreturneras endast till den förfrågan som slutför skapandet. Varje upprepad skapandeförfrågan returnerarnull, även ett omförsök efter ett förlorat lyckat svar. Hämtning returnerar aldrig någon hemlighet.
Återhämta efter ett förlorat eller avbrutet svar
Upprepa samma skapandeförfrågan med den sparade återförsöksnyckeln för att återhämta ett resurskvitto. Kvittot återspeglar aktuellt tillstånd, så en återkallad klient förblir återkallad. Den här operationen använder inte det allmänna avtalet om återuppspelning av cachade svar i 24 timmar och returnerar inte någotIdempotent-Replayed-huvud.
Se fel för förfrågnings-ID:n och information om återhämtning.
Skicka aldrig en klienthemlighet eller en åtkomsttoken med en supportförfrågan.
Granska och återkalla
Använd er hanteringsuppgift och plattformsresursensid:
Återkallelse blockerar efterföljande API-förfrågningar för klienten, inklusive förfrågningar med
redan utfärdade token. Den avbryter inte arbete som API:t redan har godtagit.
Fjärrrensningen av uppgifter kan slutföras senare. Det är säkert att upprepa återkallelsen och
ingen återförsöksnyckel behövs. Fortsätt använda hanteringsuppgiften om klienten
som återkallas själv är en API-anropare.

