API klíče
API klíč umožní skriptu nebo jinému nástroji volat API nimapu bez přihlášení. Klíč patří jednomu uživateli a chová se přesně jako on: má stejnou roli, takže může číst a měnit to, co uživatel může číst a měnit ve webovém rozhraní.
Vytvoření klíče
Sekce “Vytvoření klíče”- Otevřete svůj účet z uživatelského menu.
- V sekci API klíče pojmenujte klíč podle toho, co ho používá, třeba
Ansible. - Vyberte, kdy vyprší, nebo nechte Nikdy.
- Zvolte Vytvořit klíč.
Celý klíč se zobrazí jen jednou, hned po vytvoření. Tehdy si ho zkopírujte a uložte na bezpečné místo, třeba do správce hesel nebo do úložiště tajemství vašeho nástroje. nimap si drží jen hash klíče a znovu ho ukázat neumí. Když klíč ztratíte, zrušte ho a vytvořte nový.
Použití klíče
Sekce “Použití klíče”Klíč posílejte v hlavičce Authorization u každého požadavku:
curl -H "Authorization: Bearer nimap_…" https://nimap.example.com/api/devicesPožadavek s neznámým, zrušeným nebo prošlým klíčem skončí chybou 401, i když je ve stejném prohlížeči někdo přihlášený.
Co klíč neumí
Sekce “Co klíč neumí”Aby uniklý klíč nemohl převzít účet, některé věci vyžadují přihlášení do webového rozhraní a s klíčem skončí chybou 403:
- vytvoření, výpis a zrušení API klíčů,
- změna hesla,
- změna uživatelského jména nebo e-mailu,
- správa uživatelů, a to ani s klíčem administrátora.
Změna role a zrušení klíče
Sekce “Změna role a zrušení klíče”Klíč má vždy aktuální roli uživatele. Když vám administrátor změní roli, vaše klíče ji dostanou okamžitě. Když je váš účet smazán, jeho klíče přestanou fungovat.
Klíč zrušíte tak, že otevřete svůj účet a u klíče zvolíte Zrušit. Vše, co klíč ještě používá, okamžitě přestane fungovat. Seznam ukazuje i to, kdy byl každý klíč naposledy použit, takže snadno najdete klíče, které už nic nepoužívá.