Skip to main content
K používání Public API nepotřebujete OAuth. Pro privátní integraci na straně serveru začněte klíčem API s omezeným rozsahem oprávnění a postupujte podle rychlého začátku. Přihlašovací údaje klienta OAuth zvolte v případě, že vaše bezpečnostní politika vyžaduje krátkodobé přístupové tokeny nebo že vaše integrační platforma tento postup již podporuje. Obě možnosti využívají servisní účet. Servisní účet je identita integrace, nikoli třetí metoda ověřování.

​
Jak jednotlivé části do sebe zapadají

Pro každou integraci vytvořte jeden servisní účet. Pro tento účet zvolte klíč API nebo klienta OAuth; u jednotlivých požadavků API nepotřebujete obě metody. Žádné z přihlašovacích údajů nemohou překročit aktuální oprávnění účtu. Rychlý začátek používá základní ověřování (Basic). U klíčů API je podporována také hlavička Bearer; použití této hlavičky neznamená, že potřebujete klienta OAuth.

​
Pro jednoduchou integraci zvolte klíč API

Klíč API použijte pro vlastní plánované úlohy, skripty pro reporting, datové pipeline nebo jiné backendové služby, pokud tajný klíč uložený ve vašem správci tajných klíčů splňuje vaše bezpečnostní požadavky.
  • Odesílejte ověřené požadavky přímo; není nutná výměna tokenů.
  • Vyberte pouze oprávnění, která úloha potřebuje, a nastavte dobu platnosti.
  • Klíč obměňujte pomocí jeho období překrytí, nebo jej v případě úniku okamžitě zrušte.
Integrace s klíčem API klienta OAuth nepotřebuje. Začněte rychlým začátkem a poté si přečtěte klíče API, kde najdete informace o vytváření a obměně.

​
Pro krátkodobé přístupové tokeny zvolte OAuth

Přihlašovací údaje klienta OAuth použijte pro důvěrnou backendovou službu, pokud vaše organizace vyžaduje přístupové tokeny s omezenou platností nebo pokud integrační nástroj očekává typ oprávnění client_credentials.
  1. Vytvořte pro servisní účet klienta OAuth s omezeným rozsahem oprávnění.
  2. Ověřte klienta u koncového bodu tokenů ve vašem regionu pomocí metody ověřování klienta, která byla uvedena při nastavení.
  3. Získaný přístupový token odesílejte spolu s požadavky API. Nový token získejte dříve, než platnost aktuálního tokenu vyprší.
OAuth přidává do vaší integrace získávání tokenů a správu jejich expirace. Tajný klíč klienta je stále nutné bezpečně ukládat a obměňovat; krátkodobé tokeny tuto odpovědnost neodstraňují. Přihlašovací údaje klienta (client credentials) nepoužívají obnovovací tokeny: pro získání nového přístupového tokenu klienta ověřte znovu. Přístup OAuth musí být pro vaši organizaci povolen. Pokud povolen není, použijte klíč API nebo se ohledně svých požadavků obraťte na podporu Living Security. Informace o vytváření klientů, jednorázových tajných klíčích, zrušení a obnovení najdete v části Přihlašovací údaje klienta OAuth.

​
Uchovávejte přihlašovací údaje na backendu

Klíče API servisních účtů a tajné klíče klientů OAuth patří do úložiště tajných klíčů na straně serveru. Neukládejte je do kódu prohlížeče, mobilních aplikací, správy zdrojového kódu ani do protokolů. Přihlašovací údaje servisního účtu jednají jako úloha; nepřihlašují osobu ani neposkytují postup pro souhlas zákazníka. U obou metod používejte regionální hostitele API pro vaši organizaci. Změna metody ověřování nemění URL zdroje, verzi API ani oprávnění, která operace vyžaduje.