Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
Obě strany předchozí revize Předchozí verze Následující verze | Předchozí verze Následující verze Obě strany příští revize | ||
cs:navody:ltp:start [21.08.2019 13:14] danecek@cesnet.cz |
cs:navody:ltp:start [06.01.2022 14:09] Milan Daneček [Správa uživatelského účtu] |
||
---|---|---|---|
Řádek 79: | Řádek 79: | ||
*/ | */ | ||
- | Pro nahrání archivního balíčku je nezbytné vyplnit jeho název **File name**. Následně můžeme přidat uživatelská metadata **User metadata**, případně můžeme možnost nahrát metada pomocí existujícího jsno souboru. Nakonec vybereme z lokálního disku příslušný zabalený balíček ve formátu *.zip a klikneme na tlačítko **Store**. | + | Pro nahrání archivního balíčku je nezbytné vyplnit jeho název **File name**. Následně můžeme přidat uživatelská metadata **Package metadata**. Zde můžeme využít buď ručního vložení metadat ve fromátu json, případně můžeme nahrát metadata pomocí existujícího json souboru, nebo vyplnit identifikátory zcela ručně. Nakonec vybereme z lokálního disku příslušný zabalený balíček ve formátu *.zip a klikneme na tlačítko **Store**. |
<note warning>Pokud kontroly balíčku po vložení do systému neproběhnou správně, bude balíček označen jako nevalidní a po nějaké době bude automaticky odstraněn. Je tedy zcela zásadní po vkládání balíčku vždy zkontrolovat, že je balíček systémem korektně přijat. To je popsáno v auditních zprávách a ve stručné podobě také jako status balíčku.</note> | <note warning>Pokud kontroly balíčku po vložení do systému neproběhnou správně, bude balíček označen jako nevalidní a po nějaké době bude automaticky odstraněn. Je tedy zcela zásadní po vkládání balíčku vždy zkontrolovat, že je balíček systémem korektně přijat. To je popsáno v auditních zprávách a ve stručné podobě také jako status balíčku.</note> | ||
Řádek 85: | Řádek 85: | ||
{{:cs:navody:ltp:ltp3.png?700|}} | {{:cs:navody:ltp:ltp3.png?700|}} | ||
- | Po kliknutí na tlačítko **Store to LTP** dojde k nahrání archivního balíčku. | + | Po kliknutí na tlačítko **Store to LTP** dojde k nahrání archivního balíčku, o jehož průběhu vás bude informovat progress bar |
{{:cs:navody:ltp:ltp33.png?700|}} | {{:cs:navody:ltp:ltp33.png?700|}} | ||
Řádek 124: | Řádek 124: | ||
{{anchor:user_profile:}} | {{anchor:user_profile:}} | ||
=====Popis funkcí dostupných pomocí API===== | =====Popis funkcí dostupných pomocí API===== | ||
- | Pro přístup přes API rozhraní je nezbytné nejdříve získat přístupový API klíč. Klíč má platnost jeden den. | + | Pro přístup přes API rozhraní je nezbytné nejdříve získat přístupový API klíč. Klíč má omezenou platnost. |
- | Přístupový klíč si můžete zobrazit ve webovém prostředí při kliknutí na tlačítko **User Profile** v levém menu. | + | Přístupový klíč si můžete vygenerovat ve webovém prostředí při kliknutí na tlačítko **User Profile** v levém menu a následně na **Manage Tokens**. |
- | - Přihlásit se přes web na https://ltp.cesnet.cz/ \\ | + | |
- | - Klikněte v levém menu na tlačítko **User Profile** | + | |
- | - Na konci zobrazené stránky si skopírujte API klíč a uložte jej do proměnné | + | |
{{:cs:navody:ltp:ltp8.png?700|}} | {{:cs:navody:ltp:ltp8.png?700|}} | ||
+ | - Přihlásit se přes web na https://ltp.cesnet.cz/ \\ | ||
+ | - Klikněte v levém menu na tlačítko **User Profile** \\ | ||
+ | - Klikněte na talčítko **Manage Tokens** \\ | ||
+ | - Na zobrazené stránce vyplňte název tokenu a klikněte na tlačítko **Save Token** \\ | ||
+ | <note important>Token si prosím zkopírujte na bezpečné místo. Z bezpečnostních důvodů jej nebude možné později znovu zobrazit.</note> | ||
+ | |||
+ | {{:cs:navody:ltp:ltp9.png?700|}} | ||
+ | |||
+ | Pokud provedete obnovení stránky, dojde ke skrytí tokenu. Na zobrazené stránce pak můžete token rovněž revokovat. | ||
+ | |||
+ | {{:cs:navody:ltp:ltp10.png?700|}} | ||
<note tip>Doporučujeme **uložit si přístupový token do proměnné shellu**. Následně můžete v curl-příkazech použít tuto proměnnou.</note> | <note tip>Doporučujeme **uložit si přístupový token do proměnné shellu**. Následně můžete v curl-příkazech použít tuto proměnnou.</note> | ||
Řádek 152: | Řádek 160: | ||
<hidden Příklad odpovědi><code> | <hidden Příklad odpovědi><code> | ||
{ | { | ||
- | "username": "33c5b2a6e2fdasdasdc2ca76ttgfgdfb0b5@einfra.cesnet.cz", | + | "username": "330fh7olkdb0b5@einfra.cesnet.cz", |
- | "email": "jan.student@hogwarts.cz", | + | "email": "jan.student@cuni.cz", |
"first_name": "Jan", | "first_name": "Jan", | ||
"last_name": "Student", | "last_name": "Student", | ||
"groups": [ | "groups": [ | ||
{ | { | ||
- | "name": "hogwarts", | + | "name": "cuni.cz:group:urn:mace:cuni.cz:student", |
- | "permissions": [ 106 ], | + | "permissions": [], |
+ | "is_group_admin": false | ||
+ | }, | ||
+ | { | ||
+ | "name": "cuni.cz:group:urn:mace:cuni.cz:employee", | ||
+ | "permissions": [], | ||
+ | "is_group_admin": false | ||
+ | }, | ||
+ | { | ||
+ | "name": "cuni.cz:group:urn:mace:cuni.cz:researcher", | ||
+ | "permissions": [], | ||
"is_group_admin": false | "is_group_admin": false | ||
} | } | ||
- | ], | + | ] |
- | "token": "d7d6ae316f8cb34ec2561421962a737ce30a95d8" | + | } |
- | }</code></hidden> | + | </code></hidden> |
\\ | \\ | ||
- | **GET User Token** - vrátí hodnotu aktuálního uživatelského tokenu. | + | **GET User Token** - vrátí informace o uživatelských tokenech. |
<hidden Příklad dotazu><code>curl --request GET \ | <hidden Příklad dotazu><code>curl --request GET \ | ||
--url https://ltp.cesnet.cz/api/auth/token/ \ | --url https://ltp.cesnet.cz/api/auth/token/ \ | ||
--header "Authorization: Token ${LTP_TOKEN}" \ | --header "Authorization: Token ${LTP_TOKEN}" \ | ||
--header 'cache-control: no-cache' | jq</code></hidden> | --header 'cache-control: no-cache' | jq</code></hidden> | ||
- | <hidden Příklad odpovědi><code>{ | + | <hidden Příklad odpovědi><code> |
- | "token": "d7d6ae316f8cb34ec2561421962a737ce30a95d8" | + | { |
- | } | + | "expiry": "2022-01-07T00:07:45.581627", |
+ | "app_name": "dokumentace", | ||
+ | "key": "9dsadse6" | ||
+ | } | ||
</code></hidden> | </code></hidden> | ||
\\ | \\ | ||
Řádek 194: | Řádek 215: | ||
//--form content=@// cesta k zabalenému balíčku, který chcete uložit do služby LTP \\ | //--form content=@// cesta k zabalenému balíčku, který chcete uložit do služby LTP \\ | ||
//--form 'user_metadata=// uživatelská metadata pro archivní balíček ve formě dvojic "klíč": "hodnota" \\ | //--form 'user_metadata=// uživatelská metadata pro archivní balíček ve formě dvojic "klíč": "hodnota" \\ | ||
- | //--form group=// plné jméno skupiny, členové dané skupiny budou moci spravovat daný balíček (download, update, ...). Celý název příslušné skupiny lze získat pomocí funkce [[#account_info|GET Account info]] případně skopírovat z webového prostředí z [[#user_profile|uživatelského profilu]]. \\ | + | //--form group=// plné jméno skupiny, členové dané skupiny budou moci spravovat daný balíček (download, update, ...). Celý název příslušné skupiny lze získat pomocí funkce [[#account_info|GET Account info]] případně zkopírovat z webového prostředí z [[#user_profile|uživatelského profilu]]. \\ |
<hidden Příklad dotazu><code>curl --request POST \ | <hidden Příklad dotazu><code>curl --request POST \ |