JMÉNO¶

shigofumi - klient ISDS

PŘEHLED¶

shigofumi [-c SOUBOR]

shigofumi [-c SOUBOR] -e PŘÍKAZY

shigofumi -V

POPIS¶

igofumi je ISDS klient postavený na knihovně libisds. Klient umí přistupovat k ISDS, zpracovat místní zprávu a doručenku a odeslat soubor k autorizované konverzi.

igofumi je program ovládaný z příkazového řádku. Po sputění lze příkazem help získat seznam vestavěných příkazů. Podrobnosti o vybraném PŘÍKAZU získáte pomocí help PŘÍKAZ. Mějte na paměti, e seznam příkazů se mění s kontextem. Pro úpravu příkazového řádku lze pouít obvyklé zkratky knihovny readline (například doplňování tabulátorem).

Během přenosu dat přes Internet se aktualizuje ukazatel postupu. Uivatel můe aktuální síťovou operaci přeruit vysláním signálu SIGINT (obvykle Ctrl+C).

PŘEPÍNAČE¶

-c SOUBOR

Pouije konfigurační SOUBOR místo výchozího.

-e PŘÍKAZY

Spustí shigofumi v dávkovém reimu: kadý příkaz vykoná a pak skoční.

Příkazy se oddělují novým řádkem (\n nebo \r). Pokud kterýkoliv příkaz sele, následující příkazy nebudou vykonány a shigofumi okamitě skončí s nenulovým návratovým kódem. Pokud vechny příkazy uspějí, shigofumi vrátí kód nula.

Příklad 1. Autorizovaná konverze ze shellu

$ shigofumi -e 'convert /etc/passwd'

Tento příkaz odele soubor /etc/passwd k autorizované konverzi. Ačkoliv je příkaz syntakticky správně, sele protoe obyčejné textové soubory není konvertovat dovoleno. Vdy ve svých skriptech kontrolujte návratový kód.

-V

Zobrazí verzi programu a podrobnosti o slinkovaných knihovnách a skončí.

JAZYK PŘÍKAZŮ IGOFUMI¶

Jazyk je přímočarý. Kadý příkaz je jedno slovo (na velikosti písmen záleí) následované (prázdnou) posloupností argumentů. Příkaz a argumenty se oddělují jedním nebo více bílými znaky. Potřebujete-li vloit mezeru do argumentu, pouijte zpětné lomítko (\) jako escapovací znak. Jestlie potřebujete zapsat zpětné lomítko, opět jej escapujte zpětným lomítkem. Rovně uzavření do uvozovek je podporováno v podobě dvojitých uvozovek ("). Bílý znak a znak roury nebudou do uzavírací uvozovky fungovat jako oddělovač. Zpětné lomítko se mezi uvozovkami stále chová jako metaznak a lze jej pouít pro zapsání dvojitých uvozovek dovnitř řetězce vymezeného uvozovkami.

Seznam argumentů lze předčasně zakončit znakem roura (|). V takovém případě bude zbytek řádku povaován za příkaz shellu a výstup předcházejícího příkazu shigofumi bude předán na standardní vstup tomuto shellovému příkazu.

Je-li argument druhu název souboru, můete pouít znak vlnky (~) jako zkratku pro domovský adresář uivatele. Domovský adresář bude odvozen z proměnné prostředí HOME.

Názvy příkazů, názvy souborů a identifikátory zpráv je moné doplňovat stiskem doplňující klávesy (záleí na nastavení readline, obvykle se jedná o Tab). Názvy jsou expandovány pouze po příkazech, které daný typ argumentu očekává.

Mnoina dostupných příkazů se mění podle kontextu. Např. je-li načtena zpráva, příkazy pro operace se zprávou jako uloení do souboru se stanou dostupnými. Rovně význam tého příkazu se můe změnit. Např. příkaz show vypisuje seznam příchozích zpráv, je-li takový seznam načten. Je-li načtena zpráva, vypíe onu zprávu. Seznam právě dostupných příkazů lze získat příkazem help.

Nápověda syntaxe příkazu se zobrazí po zavolání příkazu s neplatným přepínačem nebo po příkazu help s prvním argumentem rovným příkazu, jeho nápověda vás zajímá. Přepínač -h je rezervovaný jako neplatný přepínač a vdy zobrazí nápovědu, jak příkaz pouít.

ISDS¶

ISDS (Informační systém datových schránek) je definován českým zákonem o ISDS (300/2008 Sb.)[1] a navazujícími dokumenty. Podrobnosti o současné implementaci jsou popsány v Provozním řádu, který lze stáhnout z oddílu Dokumenty ke staení Informačního portálu ISDS[2].

Systém je navren pro doručování zpráv mezi veřejnou mocí (vláda, soudy atd.) a ostatními subjekty (firmy, osoby, dalí vládní nebo obecní úřady) spolehlivým a prokazatelným způsobem.

igofumi implementuje následující operace ISDS: Přihláení se jménem a heslem, přihláení se jménem a heslem a jednorázovým heslem, přihláení se jménem a/nebo heslem a/nebo certifikátem X.509, vypsání seznamu příchozích a odchozích zpráv, přijetí komerční zprávy, získání příchozí a odchozí zprávy, explicitní označení zprávy jako přečtené, ověření otisku zprávy, získání otisku zprávy uloeného v ISDS, ověření původnosti zprávy, získání údajů o doručení, získání jména odesílatele zprávy, odeslání zprávy jednomu nebo více příjemcům, hledání schránky podle libovolného kritéria, hledání schránky podle výskytu slov, získání stavu schránky, změnu hesla uivatele, získání času vyprení platnosti hesla uivatele, získání podrobností o uivatelově schránce, vypsání uivatelů schránky, získání archivu se seznamem vech schránek, přepodepsání zprávy nebo údajů o doručení, získání údajů o kreditu pro rozesílání komerčních zpráv.

Navíc igofumi umí uloit zprávu a údaje o doručení do místního souboru a později je znovu načíst. Program umí uloit do místního souboru kadý dokument.

AUTORIZOVANÁ KONVERZE¶

Česká správa nabízí převod dokumentu z digitální do analogové podoby a obráceně současně se zachováním právní závaznosti. Toto se provádí na kontaktním místě Czech POINTu (obvykle na vládním, obecním nebo potovním úřadě). Podrobnosti lze získat na webových stránkách Czech POINTu[3].

igofumi umoňuje odeslat digitální dokument (místní soubor nebo dokument doručený skrze ISDS zprávu) na autorizovanou konverzi do úloitě Czech POINTu. Pokud úloitě dokument přijme, vrátí identifikátor dokumentu, který je uivatel povinen sdělit úředníkovi na kontaktním místě, kde si uivatel přeje vyzvednout analogovou kopii dokumentu.

Prosím, vezměte na vědomí, e úloitě skladuje zaslané dokumenty jen po omezenou dobu. Staré dokumentu (nyní 30 dnů) jsou automaticky mazány. Rovně pamatujte, e zkonvertovat lze pouze PDF dokumenty opatřené platným digitálním podpisem.