SHIGOFUMIRC(5) | Návod k igofumi | SHIGOFUMIRC(5) |
JMÉNO¶
shigofumirc - Konfigurační soubor igofumi
POPIS¶
Standardně se nastavení programu shigofumi načítá ze souboru .shigofumirc v domovském adresáři uivatele.
Jedná se o prostý textový soubor s jednoduchou syntaxí: Nastavení je uloeno ve formátu volba = hodnota. Je-li hodnota typu řetězec, musí být vymezena uvozovkami. Pravdivostní hodnotu lze vyjádřit jako "true" nebo nenulové číslo (1) pro souhlas, nebo "false" nebo číslo nula (0) pro zamítnutí. Jednoduché číselné hodnoty se do uvozovek neuzavírají. Komentář začíná znakem mříka (#) a pokračuje a do konce řádku.
Pokud volba přijímá seznam hodnot, syntaxe je tradiční matematický zápis mnoiny: { hodnota1 , hodnota2 }.
PŘEPÍNAČE¶
Následující volby jsou známy. Ne vechny musí být přítomny. Chybějící volby ponesou výchozí hodnotu.
Volby účtu¶
base_url
Např. pro testovací instanci pouijte "https://ws1.czebox.cz/" nebo pro oficiální instanci "https://ws1.mojedatovaschranka.cz/" s platnými závaznými daty při přihlaování bez TLS klientského certifikátu. Jinak při pouití klientského certifikátu nahraďte doménu ws1 doménou ws1c. Nebo při autentizaci jednorázovým heslem nahraďte doménou www. T. j. pro testovací instanci s přihlaováním certifikátem "https://ws1c.czebox.cz/" nebo pro oficiální instanci s přihlaováním jednorázovým heslem "https://www.mojedatovaschranka.cz/".
Nezapomeňte na schéma protokolu na začátku a na lomítko na konci. Výchozí hodnota je lokátor oficiální instance přísluný pro vybraný způsob přihlaování získaný z knihovny libisds.
certificate_format
certificate_path
key_engine
key_format
key_path
key_password
otp_method
otp_code
Je-li pouita metoda HMAC, toto heslo bude vypočteno v zařízení nebo programu, který by měl být ve výlučném drení uivatele.
Je-li pouita časová metoda, bude heslo vytvořeno serverem ISDS a doručeno uivateli postranním kanálem. (V současnosti je tímto kanálem SMS. Protoe doručování je zvláť zpoplatněno, je tvorba časového hesla chráněna rovně běným heslem. Uivatel nejprve odele běné heslo bez jednorázového hesla, potom server doručí jednorázové heslo ve zprávě SMS, a nakonec se uivatel znovu pokusí přihlásit zadáním běného i jednorázového hesla.)
Výchozí hodnota je prázdný řetězec a uivatel bude poádán o zadání jednorázového hesla, a bude třeba. Protoe jednorázové heslo se neustále mění, uloení jeho hodnoty do konfiguračního souboru postrádá smysl. Avak v dávkovém reimu můete zkusit jeho hodnotu přepsat před kadým sputěním shigofumi.
password
username
Volby TLS¶
ca_directory
ca_file
crl_file
verify_server
Síťové volby¶
timeout
Volby protokolování¶
log_facilities
log_file
log_level
Ostatní volby¶
clean_temporary_files
confirm_send
mark_message_read
Stav můete později změnit na přečteno ručně pomocí příkazu read.
Mějte na paměti, e webový portál ISDS označuje zprávy za přečtené automaticky. Vezměte na vědomí, e neexistuje způsob, jak vrátit stav zprávy zpět na nepřečteno.
normalize_mime_type
ISDS nekontroluje typ dokumentu MIME, který mu předává klient. Nanetěstí oficiální klient odesílá neplatné hodnoty (obvykle příponu souboru). Tato volba umoňuje igofumi opravit typ za běhu. Pamatujte, e původní hodnota uloená v ISDS nebo ve zprávě uloené do místního souboru zůstane nezměněna.
open_command
První hodnota je příkaz, dalí hodnoty jsou argumenty příkazu v daném pořadí. Pokud příkaz není absolutní název souboru, bude dohledán podle proměnné prostředí PATH. Pokud hodnota bude obsahovat podřetězec %f, bude nahrazen názvem otevíraného souboru. Pokud hodnota bude obsahovat podřetězec %t, bude nahrazen za typ MIME otevíraného dokumentu. Znak procenta lze vyjádřit posloupností %%.
Výchozí hodnota je {"xdg-open", "%f"}.
overwrite_files
Toto se nevztahuje na soubor protokolu. Jeho nový obsah je vdy připsán na konec.
POZNÁMKA KE KRYPTOGRAFICKÝM KNIHOVNÁM¶
igofumi pouívá libisds, která pouívá knihovnu cURL, která můe v současnosti pouívat tři různé kryptografické knihovny: OpenSSL, GnuTLS a NSS. Kadá knihovna má jinou mnoinu schopností a rozdílnou konfiguraci. Proto přesný význam některých voleb igofumi můe být mírně posunut (např. název certifikátu a klíče klienta). Některé volby nebudou pochopeny vůbec (např. GnuTLS nepodporuje adresář certifikátů).
Současnou kryptografickou knihovnu lze určit z výstupu příkazu shigofumi -V.
SOUBORY¶
~/.shigofumirc
PŘÍKLAD¶
base_url = "https://ws1.czebox.cz/" # Tyto přihlaovací údaje nejsou platné username = 1s79vd password = XY123456 verify_server = true ca_file = /etc/ssl/certs/ca-certificates.crt ca_directory = /etc/ssl/certs crl_file = /etc/ssl/crl log_facilities = {"http", "soap"}
VIZTE Tɶ
AUTOR¶
Petr Písař
28. února 2021 | igofumi |