Klient OTE - API

Program Klient OTE - API slouží k automatické komunikace se systémem CS OTE prostřednictvím webových služeb SOAP.

1. Aplikaci vybalit ze zipu.
Ideální je připravit pro ni adresář mimo adresáře spravované operačním systémem.
Instalace pod Program files nebo dokonce Windows není nejlepší volba.

2. Připravit kliče a certifikáty
Jsou očekávaný ve formátu PEM, navrhované umístěni v podadresáři cert.
Mohou být uloženy odděleně nebo k sobě patrici entity mohou být v jednom souboru, kde je pak třeba dodržet pořadí: privátní klíč, certifikát s odpovídajícím veřejným klíčem, připadne další certifikáty vytvářející řetězec důvěry (intermediate certifikáty, kořenový samopodepsaný certifikát).
Převod různých formátu lze udělat např. pomoci openssl (instalace Win64OpenSSL_Light-1_1_1j.exe).
Převod PKCS12 (ve windows často přípona .pfx) na PEM:

• openssl pkcs12 -in my.pfx -out my.pem -clcerts [-nodes]

Pokud se šifruje priv. klíč a bude v hesle použita diakritika, je potřeba užít kódovaní utf-8.
V případě openssl ve windows to lze zařídit nastavením proměnné před spuštěním openssl:

• set OPENSSL_WIN32_UTF8=1

3. Před prvním použitím je nutné spustit:

• soap_client –init

Pak projit soap_client.ini a nastavit konfiguraci.

4. Pro zvýšeni bezpečnosti je možné použít šifrovaný privátní klíč a heslo k němu uložit do aplikace, aby se nikde nevyskytovalo v odkryte podobě:

• soap_client –savesignpass

5. Další nápověda:

• soap_client –help

Klient OTE (SOAP klient) 0.1 ——————————————————————————
-h -? –help Zobrazení této napovědy.
-i –init Po instalaci pro vytvoření ini souboru a struktury adresářů.
-s –send Předá zprávy z xmlout OTE a přesune je do xmlsent, případné

                odpovědi uloží do xmlin. Problemové odpovědi nechá v xmlerr.\\

-r –receive Přijeme zprávy z front na OTE, uloží je do xmlin,

                problemové odpovědi nechá v xmlerr.\\

-w –password Heslo pro dešifrovaní jakéhokoliv privátniho klíče.
–signpass Heslo pro dešifrovaní podepisovacího privátniho klíče.
–authpass Heslo pro dešifrovaní autentizačního privátniho klíče.
-f –file Vstupní soubor nebo jejich seznam oddělený ',' bez mezer,

                zadává se bez cesty, default: všechny soubory v xmlout.\\

-A –saveauthpass Uloží heslo k podpisovému klíči v zašifrované podobě.
-S –savesignpass Uloží heslo k autentizačnímu klíči v zašifrované podobě.

soap_client {-h|-?|–help}
soap_client {-i|–init}
soap_client {-s|–send} [{-w|–password=} heslo] [{-f|–file=} soubor]
soap_client {-r|–receive} [{-w|–password=} heslo]
aoap_client [{-A|–saveauthpass}] [{-S|–savesignpass}]

Operace -s a -r stejně jako -A a -S je možné provést v rámci jednoho spuštění.
Konfigurace v souboru soap_client.ini.