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.