Definice JWT - záložka Detail

Záložka zobrazí detailní informace o aktuální Definici JWT ze záložky Seznam. Nastavení definice určuje způsob přihlášení aplikace, podobu vydávaných tokenů a pravidla přihlašovací relace. Vydané tokeny lze zobrazit v agendě Přehled vydaných tokenů API. Použití definice při přihlášení s MFA popisuje kapitola Vícefaktorové ověření ve Web API.

V horní části záložky Detail může být variantně zobrazen některý z Panelů definovatelných údajů detailu pro tuto agendu. Zobrazení panelu závisí na nastavení v menu Nastavení.

Hlavní údaje

Aplikace - v levé části detailu se nastavují údaje aplikace a pravidla přihlašovací relace:

Název Popis
Účel

Určuje, zda definice vydává tokeny aplikacím, nebo slouží k ověřování tokenů vydaných externím poskytovatelem.

  • Vydávání tokenů aplikacím - systém pomocí definice přihlašuje uživatele a vydává vlastní tokeny.
  • Ověřování externích tokenů - systém přijímá tokeny vydané externím poskytovatelem identity.
Kód aplikace Jedinečný kód definice. Při přihlášení se používá jako parametr client_id a rozlišuje se velikost písmen. Po uložení definice jej nelze změnit.
Druh aplikace

Určuje druh klientské aplikace. Ručně se zakládá vlastní integrace nebo externí vydavatel tokenů. Definice systémových aplikací zakládá aktualizace databáze.

Doplňkové aplikace systému ABRA - tento druh je určen pro přihlašování aplikací a doplňků ABRA, například doplňku účetních výkazů pro MS Excel. Příslušnou definici JWT zakládá aktualizace databáze. Kód ani druh aplikace u této definice nelze změnit a další definici tohoto druhu nelze ručně založit. Jde o systémový záznam.

Název aplikace Uživatelsky srozumitelný název aplikace. Přihlašovací brána jej zobrazuje uživateli při potvrzení přihlášení.
Adresa popisu klienta Adresa dokumentu s popisem klientské aplikace. Lze ji použít u klientů, kteří se identifikují adresou dokumentu metadat místo pevného kódu aplikace. Dokument může obsahovat mimo jiné název aplikace a povolené návratové adresy.
Aktivní Určuje, zda lze definici používat. Neaktivní definice nevydává ani neověřuje tokeny. Pokud nechcete používat systémovou definici, kterou nelze smazat, vypněte tuto volbu.
Typ aplikace
  • Veřejná aplikace (bez tajemství, s PKCE) - aplikace, ve které nelze bezpečně uložit tajemství, například aplikace v prohlížeči, v mobilním zařízení nebo v počítači uživatele.
  • Důvěrná aplikace (s tajemstvím) - serverová aplikace, která dokáže své tajemství bezpečně uchovat.
Tajemství aplikace Tajemství důvěrné aplikace používané k jejímu ověření. Veřejná aplikace se tajemstvím neprokazuje.
Dovolit introspekci tokenů Povoluje aplikaci zjišťovat stav a obsah tokenů prostřednictvím endpointu pro introspekci. Důvěrná aplikace se při introspekci prokazuje svým kódem a tajemstvím.
Nosič Bearer token Povoluje vydání tokenu, který klient posílá v hlavičce Authorization: Bearer. Bez této volby nelze prostřednictvím definice směnit autorizační kód ani obnovovací token na endpointu /oauth/token.
Nosič cookie relace Povoluje přihlášení pomocí zabezpečené cookie relace. Token relace je vždy neprůhledný a skript stránky jej nemůže přečíst.
Odhlásit po nečinnosti (minuty) Určuje, po kolika minutách bez požadavku skončí cookie relace. Každý požadavek s cookie začátek této doby posune. Nastavení se nevztahuje na tokeny Bearer.
Nejdelší trvání relace (minuty) Určuje nejdelší dobu přihlášení od jeho vzniku. Obnova tokenů tuto dobu neprodlouží. Po jejím uplynutí se musí uživatel znovu přihlásit a případně zadat také jednorázový ověřovací kód.
Jedna relace na uživatele Umožní uživateli používat nad touto definicí pouze jednu přihlašovací relaci. Nové přihlášení může po potvrzení uživatelem předchozí relaci nahradit. Přihlášení prostřednictvím jiné definice tím není omezeno.
Dovolit konzultantský režim Povoluje prostřednictvím definice přihlášení s konzultantskými údaji.
Návratové adresy Seznam adres, na které smí přihlašovací brána po dokončení přihlášení vrátit prohlížeč uživatele. Adresa předaná parametrem redirect_uri musí odpovídat některé z registrovaných adres. Pokud se aplikace představuje dokumentem v položce Adresa popisu klienta, mohou se návratové adresy načíst z tohoto dokumentu.

Token - v pravé části detailu se nastavují údaje vydavatele a vlastnosti tokenů:

Název Popis
Vydavatel Identifikátor vydavatele tokenu, který se ukládá do položky iss. U externího vydavatele se podle něj kontroluje původ přijatého tokenu.
Další příjemce tokenu / Audience externích tokenů U vydávaných tokenů lze uvést dalšího příjemce, pro kterého je token určen. U externích tokenů jde o povinný identifikátor, pod kterým systém vystupuje u externího vydavatele.
Položka s e-mailem Název položky externího tokenu, ze které se při přihlášení získá e-mail uživatele.
Algoritmus Algoritmus používaný k podpisu nebo ověření tokenů. Symetrické algoritmy používají sdílené tajemství, asymetrické algoritmy dvojici soukromého a veřejného klíče.
Soukromý klíč Soukromý klíč nebo sdílené tajemství používané k podepisování tokenů. Chraňte jej před zpřístupněním neoprávněným osobám.
Veřejný klíč Veřejný klíč používaný k ověření podpisu tokenu vytvořeného asymetrickým algoritmem.
Platnost přístupového tokenu (minuty) Určuje dobu platnosti přístupového tokenu. Jeho platnost nemůže přesáhnout konec přihlašovací relace.
Neprůhledný přístupový token Zapne vydávání náhodných neprůhledných přístupových tokenů, jejichž platnost a obsah se ověřují proti evidenci serveru. Bez této volby se vydává token ve formátu JWT.
Vydávat obnovovací token Určuje, zda klient obdrží také obnovovací token, pomocí kterého může získat nový přístupový token bez opětovného zadání přihlašovacích údajů.
Platnost obnovovacího tokenu (minuty) Určuje dobu platnosti obnovovacího tokenu. Platnost je současně omezena nejdelším trváním relace.
Neprůhledný obnovovací token Zapne vydávání jednorázových neprůhledných obnovovacích tokenů. Při každé obnově se token nahradí novým. Veřejná aplikace musí používat neprůhledný obnovovací token.

Subzáložka Formuláře

Subzáložka je k dispozici pouze, je-li v menu Nastavení aktuálně zatržena volba pro zobrazení uživatelských formulářů. Pravidla pro její použití jsou popsána v kapitole Záložka Formuláře - obecně.

Funkce v této záložce:

Název Kl. Doplňující popis:
Generovat klíč - Vygeneruje klíč odpovídající zvolenému algoritmu. U symetrického algoritmu vytvoří náhodné sdílené tajemství a vloží je do pole Soukromý klíč. U asymetrického algoritmu vytvoří dvojici soukromého a veřejného klíče a vloží je do odpovídajících polí. Funkce je dostupná při editaci definice.
Zneplatnit tokeny - Zneplatní dosud platné tokeny API vydané prostřednictvím aktuální definice, a to neprůhledné tokeny i tokeny ve formátu JWT. Podrobný popis viz funkce Zneplatnit tokeny na záložce Seznam.

Opravy:

Možnost opravy jednotlivých položek závisí na účelu a druhu definice a na zvoleném způsobu přihlášení.

Zobrazení seznamu v Detailu

V některé části této záložky může být zobrazen seznam záznamů ze záložky Seznam.

Funkce k záložce Detail:

Podmnožina funkcí ze záložky Seznam. V editačním režimu platí zásady pro editaci záznamů v číselnících.