> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ověřování

> Vyberte pro svou integraci klíč API nebo přihlašovací údaje klienta OAuth a zjistěte, jak každá z možností využívá servisní účet.

**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](/cs/developers/v1/quickstart). 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í

| Položka | Účel | Co vaše integrace odesílá |
| - | - | - |
| **Servisní účet** | Pojmenovává úlohu a určuje strop jejích oprávnění. | Účet identifikuje jeho ID; požadavek však neověřuje. |
| **Klíč API** | Ověřuje přímo jako tento servisní účet s vybranou sadou oprávnění a dobou platnosti. | Tajný klíč pomocí základního ověřování HTTP (HTTP Basic) nebo `Authorization: Bearer <api_key_secret>`. |
| **Klient OAuth** | Ověřuje se u služby tokenů za účelem získání přístupových tokenů s omezeným rozsahem pro tento servisní účet. | Přístupový token pomocí `Authorization: Bearer <access_token>`. |

Pro každou integraci vytvořte jeden [servisní účet](/cs/developers/developer-hub/service-accounts).
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](/cs/developers/v1/quickstart) a poté si přečtěte
[klíče API](/cs/developers/developer-hub/api-keys), 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](/cs/developers/v1/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](/cs/developers/v1/regions) pro vaši organizaci. Změna metody ověřování nemění URL zdroje,
verzi API ani oprávnění, která operace vyžaduje.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.