Přístup OAuth musí být pro vaši organizaci povolen. Součástí vašeho nastavení jsou
regionální koncový bod tokenů, vydavatel (issuer), cílová skupina (audience) a metoda ověřování klienta.
Pokud tato nastavení potřebujete nebo nemáte přístup ke správě klientů, obraťte se na
podporu Living Security.
Než začnete
- Vytvořte servisní účet pouze s oprávněními, která integrace potřebuje.
- Použijte přihlašovací údaje pro správu s oprávněním
service_account:managea s každým oprávněním, které chcete novému klientovi udělit. Cílový účet musí tato oprávnění mít také. Klient nemůže rozšířit pravomoci žádného z obou účtů. - Vyberte region své organizace. Přihlašovací údaje API a přístupové tokeny OAuth patří na odpovídající regionální hostitel API.
- Tajný klíč klienta a tokeny uchovávejte v úložišti tajných údajů na straně serveru. Nikdy je nevkládejte do kódu prohlížeče, mobilních aplikací, správy zdrojového kódu ani do protokolů požadavků.
Vytvoření klienta
POST /v1/oauth_clients vyžaduje service_account_id, neprázdný seznam explicitních
scopes a Idempotency-Key. Zástupné znaky (wildcards) nejsou povoleny. Klient podporuje
až 100 oborů (scopes) s celkovou délkou nejvýše 4 096 znaků. Každý servisní
účet může mít nejvýše 20 klientů nebo nevyřešených operací vytvoření či vyčištění.
Odvolání okamžitě zamezí přístupu k API. Klient nebo nejistě provedené vytvoření u poskytovatele
se do limitu počítá i nadále, dokud není potvrzeno vzdálené vyčištění.
Opuštěná rezervace nebo vytvoření, u něhož je prokázáno, že selhalo dříve, než práce u poskytovatele
začala, může svůj slot bezpečně uvolnit. Jeho klíč pro opakování však stále patří původnímu
pokusu; než se rozhodnete, zda vytvořit náhradu, obnovte tuto potvrzenku.
Pro tento pokus o vytvoření zvolte jeden klíč pro opakování a uložte jej před odesláním
požadavku. Použijte 1–255 viditelných znaků ASCII bez mezer. Použijte jej znovu se
stejným účtem, obory, principálem správy, regionem a verzí API po ztrátě
odpovědi. Rotace přihlašovacích údajů pro správu v rámci stejného servisního účtu
nevytváří novou identitu opakování.
Nainstalujte balíček requests pro Python. Následující hodnoty prostředí načtěte pomocí
svého běžného řešení pro správu tajných údajů a konfigurace:
Python
201 a obsahují prostředek oauth_client
s poli id, service_account_id, client_id, scopes, status, created_at a
client_secret. Odpovědi jsou označeny Cache-Control: no-store.
ididentifikuje prostředek platformy. Uložte jej pro načtení a odvolání.client_ididentifikuje klienta při výměně tokenu. Nejde o ID prostředku platformy. Během čekajícího vytvoření může mít hodnotunull.client_secretje vrácen pouze požadavku, který vytvoření dokončí. Každý opakovaný požadavek na vytvoření vracínull, včetně opakování po ztracené odpovědi o úspěchu. Načtení tajný klíč nikdy nevrací.
Obnova po ztracené nebo přerušené odpovědi
Zopakujte stejný požadavek na vytvoření s uloženým klíčem pro opakování, abyste obnovili potvrzenku prostředku. Potvrzenka odráží aktuální stav, takže odvolaný klient zůstává odvolaný. Tato operace nepoužívá obecný model opakování z mezipaměti s platností 24 hodin a nevrací hlavičkuIdempotent-Replayed.
ID požadavků a podrobnosti o obnově najdete v části chyby.
Tajný klíč klienta ani přístupový token nikdy neposílejte spolu s požadavkem na podporu.
Kontrola a odvolání
Použijte své přihlašovací údaje pro správu aid prostředku platformy:
Odvolání blokuje následné požadavky API tohoto klienta, včetně požadavků s již
vydanými tokeny. Neruší práci, kterou API již přijalo.
Vzdálené vyčištění přihlašovacích údajů může skončit později. Opakované odvolání je bezpečné
a nevyžaduje klíč pro opakování. Pokud je odvolávaný klient sám volajícím API, používejte dále
přihlašovací údaje pro správu.

