Az OAuth-hozzáférést engedélyezni kell a szervezete számára. A beállítás során Ön megkapja
a regionális token végpontot, a kibocsátót (issuer), a célközönséget (audience) és a kliens-hitelesítési módszert.
Ha szüksége van ezekre a beállításokra, vagy nem fér hozzá a kliensek kezeléséhez, forduljon
a Living Security ügyfélszolgálatához.
Előkészületek
- Hozzon létre egy szolgáltatásfiókot, amely csak az integrációhoz szükséges jogosultságokkal rendelkezik.
- Használjon olyan felügyeleti hitelesítő adatot, amely rendelkezik ezzel:
service_account:manage, valamint minden olyan jogosultsággal, amelyet az új kliensnek meg kíván adni. A célfióknak szintén rendelkeznie kell ezekkel a jogosultságokkal. A kliens nem bővítheti egyik fiók jogosultságát sem. - Válassza ki a szervezet régióját. Az API hitelesítő adatokat és az OAuth hozzáférési tokeneket a megfelelő regionális API-hoszton kell használni.
- A kliens titkos kulcsát és a tokeneket a szerveroldali titoktárolóban őrizze. Soha ne helyezze őket böngészőkódba, mobilalkalmazásokba, verziókezelőbe vagy kérésnaplókba.
Kliens létrehozása
POST /v1/oauth_clients megköveteli ezt: service_account_id, továbbá explicit
scopes nem üres listáját és egy Idempotency-Key értéket. Helyettesítő karakterek nem fogadhatók el. Egy kliens legfeljebb
100 hatókört támogat, legfeljebb 4096 karakter együttes hosszúságban. Egy szolgáltatásfiókhoz legfeljebb 20 kliens
vagy nem lezárt létrehozási/takarítási művelet tartozhat.
A visszavonás azonnal megtagadja az API-hozzáférést. A kliens vagy a szolgáltatónál végrehajtott bizonytalan
létrehozás mindaddig beleszámít a korlátba, amíg a távoli takarítás meg nem erősödik.
Egy elhagyott foglalás, illetve egy olyan létrehozás, amelyről bizonyítható, hogy a szolgáltatói munka megkezdése előtt
meghiúsult, biztonságosan felszabadíthatja a helyét. Az újrapróbálkozási kulcs ettől még az eredeti
kísérlethez tartozik; a csere létrehozásáról való döntés előtt állítsa helyre az adott visszaigazolást.
Válasszon egy újrapróbálkozási kulcsot ehhez a létrehozási kísérlethez, és a kérés elküldése előtt
tárolja tartósan. Használjon 1–255 látható ASCII-karaktert, szóközök nélkül. Egy elveszett válasz után használja
újra ugyanazzal a fiókkal, hatókörökkel, felügyeleti principallal, régióval és API-verzióval. A felügyeleti hitelesítő adat
cseréje ugyanazon szolgáltatásfiók alatt nem hoz létre új újrapróbálkozási azonosítót.
Telepítse a Python requests csomagját. Töltse be a következő környezeti értékeket
a szokásos titok- és konfigurációkezelő rendszerén keresztül:
Python
201 formátumot használnak, és tartalmaznak egy oauth_client erőforrást
a következőkkel: id, service_account_id, client_id, scopes, status, created_at és
client_secret. A válaszok megjelölése: Cache-Control: no-store.
idazonosítja a platformerőforrást. Mentse el a lekérdezéshez és a visszavonáshoz.client_idazonosítja a klienst a token-kicserélés során. Nem azonos a platformerőforrás azonosítójával. Értékenulllehet, amíg a létrehozás függőben van.client_secretcsak a létrehozást befejező kérésre érkezik vissza. Minden ismételt létrehozási kérésnullértéket ad vissza, beleértve az elveszett sikeres válasz utáni újrapróbálkozást is. A lekérdezés soha nem ad vissza titkos kulcsot.
Elveszett vagy megszakadt válasz utáni helyreállítás
Az erőforrás-visszaigazolás helyreállításához ismételje meg ugyanazt a létrehozási kérést a mentett újrapróbálkozási kulccsal. A visszaigazolás az aktuális állapotot tükrözi, ezért a visszavont kliens visszavont marad. Ez a művelet nem használja az általános, 24 órás gyorsítótárazott válasz-visszajátszási szabályt, és nem ad visszaIdempotent-Replayed fejlécet.
A kérésazonosítókkal és a helyreállítási részletekkel kapcsolatban lásd a hibákat.
Soha ne küldjön kliens titkos kulcsot vagy hozzáférési tokent támogatási kéréssel együtt.
Lekérdezés és visszavonás
Használja a felügyeleti hitelesítő adatát és a platformerőforrásid azonosítóját:
A visszavonás letiltja a kliens további API-kéréseit, beleértve a már kiállított tokenekkel küldött
kéréseket is. Nem szakítja meg az API által már elfogadott munkát.
A távoli hitelesítőadat-takarítás később is befejeződhet. A visszavonás ismétlése biztonságos, és
nem igényel újrapróbálkozási kulcsot. Ha a visszavonandó kliens maga is API-hívó, továbbra is a felügyeleti hitelesítő adatot használja.

