Trezor

Trezor bezpečně uchovává hesla, API klíče, certifikáty a páry klíčů, které potřebují výpočty a smart eventy. Hodnoty jsou v databázi šifrované a v šablonách se na ně odkazujete jen názvem, takže se tajné údaje nikde nezobrazují. Trezor je dostupný administrátorům. Otevřete ho v Administrace › Trezor.

Č.PrvekK čemu slouží
1Tajné klíčeZáložka se seznamem tajných klíčů (hesla, tokeny, API klíče).
2CertifikátyZáložka s nahranými certifikáty a vygenerovanými páry klíčů. Superadministrátor zde vidí navíc záložku Externí zdroje.
3Vytvořit tajný klíčOtevře okno pro nový tajný klíč. Tlačítko je jen na záložce Tajné klíče.
4ZavřítVrátí vás do menu Administrace.
5Filtr sloupcePole pod názvem sloupce filtruje seznam. Na obrázku je seznam filtrovaný podle názvu.
6PopisVolitelný popis, k čemu klíč slouží.
7VložilAdministrátor, který klíč vytvořil nebo naposledy změnil jeho hodnotu.
8VloženoDatum vytvoření klíče.
9Akce řádkuNabídka Zobrazit, Upravit a Smazat. Zobrazí se jen u klíčů, které jste vytvořili vy. Superadministrátor ji má u všech klíčů.
10Uložit filtr, Zrušit filtryObjeví se, jakmile filtrujete. Filtr si můžete uložit nebo všechny filtry zrušit.
11FiltrOvládání tabulky: filtr, AI filtr a zobrazení na celou obrazovku.
12ExportSpodní lišta tabulky: počet záznamů, nastavení zobrazení a sloupců a export seznamu.
Kdo smí s klíčem pracovat
Seznam tajných klíčů a certifikátů vidí všichni administrátoři. Hodnotu klíče však může zobrazit, změnit nebo klíč smazat jen ten, kdo ho do trezoru vložil, a superadministrátor. Každé zobrazení hodnoty TAS zapíše do logu.

Tajné klíče

Vytvoření tajného klíče

  1. Na záložce Tajné klíče klepněte na Vytvořit tajný klíč.
  2. Vyplňte název, hodnotu a případně popis.
  3. Klepněte na Vytvořit.
Č.PoleK čemu slouží
1NázevPovinné. Pod tímto názvem se na klíč odkazujete ve výpočtech a smart eventech. Nesmí se shodovat s názvem klíče z externích zdrojů.
2HodnotaPovinné. Tajná hodnota, například heslo nebo API klíč. Při psaní je skrytá, ikonou oka ji můžete na chvíli zobrazit.
3PopisVolitelné. K čemu klíč slouží, aby se v něm vyznali i ostatní administrátoři.
4VytvořitUloží klíč do trezoru. Hodnota se uloží šifrovaně.
5ZavřítZavře okno bez uložení.
Stejný název přepíše existující klíč
Pokud v trezoru už existuje tajný klíč se stejným názvem, TAS nevytvoří nový. Přepíše hodnotu existujícího klíče a jako autora uvede vás. Před vytvořením si proto seznam vyfiltrujte podle názvu.

Akce u tajného klíče

Nabídku otevřete ikonou tří teček na konci řádku.

AkceK čemu slouží
ZobrazitOtevře okno s názvem, hodnotou a popisem klíče.
UpravitOtevře okno pro změnu hodnoty klíče.
SmazatPo potvrzení klíč z trezoru odstraní.

Zobrazení hodnoty

V okně Zobrazit tajný klíč je hodnota skrytá. Ikonou oka ji zobrazíte, tlačítkem vedle pole ji zkopírujete do schránky. Okno nic neukládá, zavřete ho křížkem.

Změna hodnoty

V okně Upravit tajný klíč lze měnit jen hodnotu. Název a popis jsou jen pro čtení. Původní hodnota se nezobrazí, pole Hodnota je prázdné a povinné. Zadejte novou hodnotu a klepněte na Uložit. Výpočty a smart eventy, které klíč používají, začnou novou hodnotu používat hned, nic dalšího měnit nemusíte.

Pokud potřebujete změnit název nebo popis, vytvořte nový klíč a starý smažte.

Smazání tajného klíče

Po volbě Smazat TAS zobrazí potvrzení „Opravdu chcete smazat položku trezoru…“. Klíč, který se ještě používá, smazat nejde. TAS zkontroluje výpočty úkolů ve všech šablonách a parametry smart eventů. Pokud klíč někde najde, smazání odmítne se zprávou, že je tajný klíč stále používán. Nejprve odstraňte všechny odkazy na klíč a pak ho smažte.

Použití klíčů v šablonách

Na klíč se odkazujete jeho názvem, hodnotu do šablony nikdy nepíšete.

KdeZápisCo se stane
Výpočet úkoluvault.get('Supplier portal API key')Vrátí odkaz na klíč, ne samotnou hodnotu. Odkaz nejde vypsat ani uložit do proměnné. Použijete ho jen ve funkcích, které ho umí přijmout, například při nastavení hlavičky HTTP požadavku nebo hesla k FTP.
Parametry smart eventu{{vault:Supplier portal API key}}TAS zástupný text nahradí hodnotou klíče až při spuštění smart eventu.

Oba zápisy fungují pro tajné klíče, certifikáty i klíče z externích zdrojů.

Certifikáty

Záložka Certifikáty obsahuje nahrané certifikáty a páry klíčů vygenerované v trezoru. Vidí ji všichni administrátoři.

Č.PrvekK čemu slouží
1Vygenerovat pár klíčůVytvoří v trezoru nový pár privátního a veřejného klíče.
2Nahrát certifikátNahraje soubor s certifikátem.
3Platnost odZačátek platnosti certifikátu. TAS ho přečte ze souboru.
4Platnost doKonec platnosti certifikátu. Podle něj poznáte certifikáty, které je potřeba obnovit.

Dalšími sloupci jsou Název, Popis a Vložil. V nabídce řádku jsou akce Zobrazit a Smazat. Stejně jako u tajných klíčů je vidí jen ten, kdo položku vložil, a superadministrátor. Certifikát se nedá upravit. Novou verzi nahrajte pod stejným názvem.

Nahrání certifikátu

  1. Klepněte na Nahrát certifikát.
  2. Tlačítkem Vybrat soubor vyberte soubor s příponou .pem, .cer, .crt nebo .der.
  3. Zkontrolujte název. TAS ho předvyplní podle názvu souboru bez přípony.
  4. Případně doplňte popis a klepněte na Nahrát.
PoleK čemu slouží
Vybrat souborVýběr souboru s certifikátem X.509 ve formátu PEM nebo DER. Vedle tlačítka je název vybraného souboru. Bez souboru TAS ohlásí, že není vybrán žádný certifikát.
NázevPovinné. Název, pod kterým se na certifikát odkazujete. Pokud certifikát se stejným názvem už existuje, TAS ho nahradí novým.
PopisVolitelné. TAS k popisu automaticky připojí vydavatele a subjekt certifikátu.

Pokud soubor neobsahuje platný certifikát X.509, TAS ho odmítne a certifikát neuloží.

Vygenerování páru klíčů

Pár klíčů se hodí pro integrace, které pracují s podpisem nebo šifrováním. Privátní klíč zůstane v trezoru, veřejný klíč předáte druhé straně.

  1. Klepněte na Vygenerovat pár klíčů.
  2. Zadejte název a zvolte algoritmus a formát.
  3. Klepněte na Vygenerovat pár klíčů.
PoleK čemu slouží
NázevPovinné. Základ názvu obou klíčů. TAS uloží privátní klíč s příponou .private a veřejný s příponou .public, například signing.private a signing.public. Pokud některý z těchto názvů už existuje, generování skončí chybou.
AlgoritmusRSA (výchozí) nebo ECDSA.
FormátPEM (výchozí) nebo JWK.

Po vygenerování okno zůstane otevřené a ukáže názvy obou uložených klíčů a hodnotu veřejného klíče s tlačítkem pro kopírování. Privátní klíč se v okně nezobrazí. Okno zavřete tlačítkem Zavřít. Oba klíče pak najdete v seznamu certifikátů.

Externí zdroje

Záložku Externí zdroje vidí jen superadministrátor. Obsahuje tajné klíče, které nejsou uložené v databázi, ale nastavuje je správce serveru v proměnných prostředí ve tvaru TAS_SECRET_<NÁZEV>. Název klíče je část za předponou. V seznamu je jen název, hodnotu superadministrátor zobrazí akcí Zobrazit. Klíče z externích zdrojů se v TAS nedají vytvořit, změnit ani smazat. Ve výpočtech a smart eventech se používají stejně jako ostatní klíče.

Bez superadministrátora
Na snímcích je administrátorka bez role superadministrátora, proto záložka Externí zdroje chybí.

Související: Přístup k API, Autentizace, Smart eventy, Výpočty.

DMS atributy
Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)