Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
Obě strany předchozí revizePředchozí verze | Následující verzeObě strany příští revize | ||
navody:vps:api [2022/01/26 10:17] – Postupy instalace rozděleny do podstránek Aither | navody:vps:api [2024/01/02 18:20] – Aktualizace autentizace aither | ||
---|---|---|---|
Řádek 26: | Řádek 26: | ||
* JavaScript - https:// | * JavaScript - https:// | ||
* Go - https:// | * Go - https:// | ||
- | * Webové rozhraní z HaveAPI - https:// | + | * Webové rozhraní z HaveAPI - https:// |
- | * Souborový systém založený na FUSE - https:// | + | * Souborový systém založený na FUSE - https:// |
Ukázka použití je vždy v '' | Ukázka použití je vždy v '' | ||
Řádek 38: | Řádek 38: | ||
===== Autentizace ===== | ===== Autentizace ===== | ||
- | Lze využívat dvě autentizační metody. Tou první a jednodušší z nich je HTTP | + | API podporuje dva způsoby autentizace: |
- | basic. S každým požadavkem na API se musí zaslat jméno a heslo. Je to dobrá | + | |
- | volba pro jednorázové akce, pokud je ale potřeba API volat vícekrát nebo | + | |
- | automatizovaně, | + | |
- | Druhou metodou je autentizace přes tokeny. | + | * [[# |
- | požádá o vytvoření tokenu, k tomu potřebuje jméno, heslo a připadně i TOTP. | + | * [[#tokeny|Pomocí tokenů]] |
+ | |||
+ | Konkrétní ukázky autentizace pro podporované programovací jazyky a CLI najdete | ||
+ | v [[https:// | ||
+ | |||
+ | ==== HTTP Basic ==== | ||
+ | S každým požadavkem na API se musí zaslat jméno a heslo v HTTP hlavičče " | ||
+ | Je to dobrá volba pro jednorázové akce, pokud je ale potřeba API volat vícekrát nebo | ||
+ | automatizovaně, | ||
+ | nelze použít, pokud máte aktivované dvoufaktorové ověřování. | ||
+ | |||
+ | ==== Tokeny ==== | ||
+ | Klient nejprve | ||
Jakmile klient dostane token, může jméno a heslo zapomenout a dále se autentizuje | Jakmile klient dostane token, může jméno a heslo zapomenout a dále se autentizuje | ||
získaným tokenem. | získaným tokenem. | ||
Řádek 50: | Řádek 59: | ||
Tokeny mohou být několika typů s různě dlouhou životností: | Tokeny mohou být několika typů s různě dlouhou životností: | ||
- | * fixed - platnost tokenu je pevně dána | + | * //fixed// - platnost tokenu je pevně dána |
- | * renewable_manual - platnost tokenu lze manuálně prodloužit | + | * //renewable_manual// - platnost tokenu lze manuálně prodloužit |
- | * renewable_auto - platnost tokenu je prodloužena při každém požadavku | + | * //renewable_auto// - platnost tokenu je prodloužena při každém požadavku |
- | * permament - token je platný napořád, resp. dokud není smazán | + | * //permament// - token je platný napořád, resp. dokud není smazán |
Typ tokenu a časový interval, o který se prodlužuje, | Typ tokenu a časový interval, o který se prodlužuje, |