Let's Encrypt pro Pohoda mServer (Stormware)
Návod, jak zabezpečit HTTPS komunikaci se Stormware Pohoda mServerem certifikátem od Let's Encrypt — včetně automatické obnovy, bez ručního překlikávání každé tři měsíce.
Jak mServer pracuje s HTTPS
Pohoda mServer je HTTP server zabudovaný přímo v pohoda.exe. Pro HTTPS existují dvě cesty:
- Windows http.sys (stejný stack jako IIS) — certifikát se neuvádí cestou k souboru, ale thumbprintem z úložiště
LocalMachine\My; vazba na port se dělá přesnetsh http add sslcert. V GUI Pohody (Databáze → POHODA mServer → záložka HTTPS) pak vybíráš ze seznamu certifikátů, které už v úložišti jsou. - PEM soubory — některé verze mServeru chtějí certifikát a privátní klíč jako soubory
.pem(v dialogu HTTPS zadáváš cestu k certifikátu a klíči).
Wizard proto v kroku 3 (Server) nabízí pro mServer dva režimy.
Dva režimy: store vs pem
| store (doporučeno) | pem | |
|---|---|---|
| Kde certifikát je | jen ve Windows Certificate Store (LocalMachine\My) |
v úložišti a navíc jako soubory v C:\admin\pohoda-cert |
| Privátní klíč na disku | ne — zůstává v úložišti, neexportovatelný | ano (mserver-key.pem, mserver.pem) |
| Vazba na port | netsh http add sslcert podle thumbprintu (deploy-mserver.ps1) |
v Pohodě zadáš cesty k PEM souborům |
| Po obnově | hook přepne binding na nový thumbprint | hook znovu vyexportuje PEM soubory |
PrivateKeyExportable ve win-acme settings.json |
vypnuto | zapnuto (jen v tomto režimu) |
| Kdy zvolit | vždy, když tvá verze mServeru umí vybrat certifikát z úložiště | jen když mServer musí číst soubory |
Pravidlo: začni režimem store. pem jen tehdy, když mServer soubory skutečně vyžaduje — každý privátní klíč na disku je věc navíc, kterou musíš hlídat.
Kdy ti Let's Encrypt pomůže (a kdy ne)
| Tvoje situace | Co s tím |
|---|---|
mServer má veřejnou doménu (např. pohoda.firma.cz) a port 80 dostupný z internetu |
✅ HTTP-01 standalone funguje |
| Veřejná doména, ale port 80 zavřený (firewall/NAT) | ✅ DNS-01 (Cloudflare nebo manuální) |
mServer je jen v LAN/VPN, používáš pohoda.firma.local nebo IP adresu |
❌ Let's Encrypt nepodepíše. Buď: a) přiděl veřejnou doménu a použij DNS-01, b) postav si vlastní interní CA (mkcert, step-ca) |
Doména pohoda.firma.cz ukazuje na interní IP (split-horizon DNS) |
✅ DNS-01 funguje — Let's Encrypt ověří přes DNS TXT, na server fyzicky nemusí dosáhnout |
Pozn.: Pokud používáš jen vnitřní IP/jméno, doporučená cesta je split-horizon DNS — registruj pohoda.firma.cz jako veřejný A záznam ukazující na privátní IP. Pro DNS-01 validaci to stačí a fyzicky se k mServeru zvenčí nikdo nedostane.
Postup (DNS-01 přes Cloudflare — doporučená cesta)
Veřejná doména (např.
pohoda.firma.cz) v Cloudflare DNS (klidně split-horizon).Cloudflare API token s právy
Zone:DNS:Edit+Zone:Zone:Readjen pro tuto zónu. Do wizardu se nezadává — zeptá se na něj ažissue.ps1na serveru.Ve wizardu: krok 3 → OS Windows Server, webserver Pohoda mServer, port mServeru, režim
store/pem; krok 4 → DNS-01 Cloudflare (volitelně zapni „Nejdřív nanečisto" — první běh půjde proti staging serveru s--test); krok 6 → stáhni ZIP.Na serveru, PowerShell jako Administrator, ve složce s rozbalenými skripty:
Unblock-File .\*.ps1 # soubory stažené z internetu jsou blokované .\install.ps1 # stáhne win-acme + Cloudflare plugin ze stejného release, # ověří Authenticode podpis wacs.exe, upraví settings.json .\issue.ps1 # zeptá se na CF token, vystaví cert do LocalMachine\My, # nakopíruje a zaregistruje renewal hook .\deploy-mserver.ps1 # režim store: netsh binding portu na thumbprint .\export-pem.ps1 # režim pem: PEM soubory do C:\admin\pohoda-cert .\verify.ps1 # kontrola certifikátu na portu + Scheduled Tasku obnovyinstall.ps1vynucuje TLS 1.2 pro stahování a umí připnout konkrétní verzi:.\install.ps1 -Version v2.2.9.1701. Pokud ověření podpisuwacs.exeselže, skript skončí — neobcházej to (viz pasti níže).V Pohodě: Databáze → POHODA mServer → instance → Upravit → záložka HTTPS:
store: vyber certifikát ze seznamu (poznáš ho podle thumbprintu, který skript vypsal),pem: zadej cestyC:\admin\pohoda-cert\mserver-cert.pem+C:\admin\pohoda-cert\mserver-key.pem(nebo sloučenýmserver.pempro obojí),- Uložit → restart instance.
Ověř zvenčí (příkazy níže) a nech si v kalendáři připomínku z
.icssouboru v ZIPu.
Obnova (renewal hook)
Let's Encrypt certifikát platí 90 dní. win-acme si vytvoří Scheduled Task (win-acme renew (acme-v02.api.letsencrypt.org)), který obnovuje zhruba po 60 dnech. Po obnově se změní thumbprint — bez dalšího kroku by http.sys dál držel starý certifikát a PEM soubory by zastaraly.
Proto issue.ps1:
- zkopíruje
renewal-hook-mserver.ps1doC:\Program Files\win-acme\Scripts\renewal-hook-mserver.ps1, - zaregistruje ho ve win-acme přes
--installation script --script … --scriptparameters "-NewCertThumbprint '{CertThumbprint}' …".
win-acme hook spustí při prvním vystavení i po každé obnově. Hook:
store: smaže starýnetshbinding a přidá nový s aktuálním thumbprintem (certstorename=MY),pem: znovu vyexportujemserver-cert.pem(fullchain),mserver-key.pemamserver.pemdoC:\admin\pohoda-cert— ACL adresáře se zamkne dřív, než se cokoli zapíše,- volitelně restartuje instanci mServeru (
pohoda.exe /http stop|start "Instance") — řádky na konci hooku stačí odkomentovat.
Starší verze tohoto návodu zmiňovaly skript
PohodaMServerRebind.ps1— ten neexistuje. Správný název jerenewal-hook-mserver.ps1a musí ležet vedleissue.ps1(jinakissue.ps1skončí chybou dřív, než vytvoří renewal s nefunkčním hookem).
Zkouška: .\renew-test.ps1 (wacs.exe --renew --test) a & 'C:\Program Files\win-acme\wacs.exe' --list — u renewalu musí být vidět installation script.
C:\admin\pohoda-cert a přístupová práva (režim pem)
export-pem.ps1i hook adresář vytvoří a nejdřív mu nastaví ACL jen proSYSTEMaAdministrators(icacls … /inheritance:r /grant:r "SYSTEM:(OI)(CI)F" "Administrators:(OI)(CI)F"), teprve potom zapisují PEM soubory. Klíč tak není ani na okamžik čitelný pro ostatní účty.mServer typicky běží pod
SYSTEM(služba) nebo pod účtem přihlášeného administrátora — pak není co řešit.Pokud mServer běží pod vlastním servisním účtem, přidej mu čtení:
icacls C:\admin\pohoda-cert /grant "DOMENA\pohoda-svc:(OI)(CI)(R)"Pokud by účet po obnově o přístup přišel (hook práva nastavuje znovu), přidej stejný řádek na konec
C:\Program Files\win-acme\Scripts\renewal-hook-mserver.ps1.mserver-cert.pemobsahuje fullchain (leaf + intermediate, bez root CA) — bez intermediate by většina klientů certifikát odmítla.
Certifikáty v úložišti se nemažou automaticky
issue.ps1 už z LocalMachine\My nic neodstraňuje. Po každém vystavení/obnově tam přibude nový certifikát; deploy-mserver.ps1, export-pem.ps1 i hook si vždy vyberou nejnovější certifikát Let's Encrypt pro danou doménu (v režimu pem navíc jen takový, který má exportovatelný klíč). Staré certifikáty nevadí, jen zabírají místo — úklid je na tobě:
# Nejdřív se podívej, co by se smazalo
Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.Issuer -like "*Let's Encrypt*" -and $_.NotAfter -lt (Get-Date) } |
Format-Table Thumbprint, Subject, NotAfter
# …a teprve pak (jen expirované)
Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.Issuer -like "*Let's Encrypt*" -and $_.NotAfter -lt (Get-Date) } |
Remove-Item
Přechod store → pem po vystavení: klíč stávajícího certifikátu není exportovatelný. Vygeneruj skripty znovu v režimu pem, spusť install.ps1 (zapne PrivateKeyExportable) a issue.ps1; pak export-pem.ps1 použije nejnovější certifikát s exportovatelným klíčem. Kdyby win-acme sáhl po certifikátu z cache a export dál padal, vynuť nové vystavení: & 'C:\Program Files\win-acme\wacs.exe' --renew --force (pozor na rate limity).
Ověření
# Certifikáty Let's Encrypt v LocalMachine\My (musí mít HasPrivateKey = True)
Get-ChildItem Cert:\LocalMachine\My | Where-Object { $_.Issuer -like "*Let's Encrypt*" } |
Format-Table Thumbprint, Subject, NotAfter, HasPrivateKey
# Aktuální SSL binding portu (režim store) — Certificate Hash = thumbprint nového certu
netsh http show sslcert ipport=0.0.0.0:444
# Port je otevřený a odpovídá
Test-NetConnection pohoda.firma.cz -Port 444
Invoke-WebRequest -Uri "https://pohoda.firma.cz:444/" -UseBasicParsing | Select-Object StatusCode
# Řetězec: musí vypsat 2+ certifikáty (leaf + intermediate); openssl je např. v Git for Windows
'' | openssl s_client -connect pohoda.firma.cz:444 -servername pohoda.firma.cz -showcerts
# Obnova
& 'C:\Program Files\win-acme\wacs.exe' --list
Get-ScheduledTask -TaskName 'win-acme*' | Get-ScheduledTaskInfo |
Format-List TaskName, LastRunTime, LastTaskResult, NextRunTime
# Z příkazové řádky Pohody
& 'C:\Program Files\STORMWARE\POHODA\Pohoda.exe' /http list
& 'C:\Program Files\STORMWARE\POHODA\Pohoda.exe' /http start "NazevInstance"
Ze ZIPu to všechno najednou udělá verify.ps1. Obecné postupy (openssl, curl, SSL Labs, rate limity, CAA…) jsou v řešení problémů.
Známé pasti
- Cert v
CurrentUser\MymístoLocalMachine\My—netshani Pohoda ho nenajdou. Skripty ukládají do Local Machine; při ručním importu to pohlídej. - Cert bez privátního klíče →
netsherror 1312 („A specified logon session does not exist"). ZkontrolujHasPrivateKey(výše); pokud jeFalse, spusť znovuissue.ps1. - „Cannot export non-exportable private key" (
export-pem.ps1) — certifikát vznikl v režimustore(nebo starším nastavením).PrivateKeyExportablese zapíná jen v režimupem→ viz přechodstore → pemvýše. - ECDSA klíč —
export-pem.ps1umí jen RSA (PKCS#1). Nech ve win-acme výchozí RSA klíč, pokud používáš režimpem. - Port už používá jiná aplikace (typicky IIS na
:443) — vyber pro mServer jiný port (444, 8443) v záložce HTTPS i ve wizardu.netsh http show sslcertukáže, kdo port drží. - Firewall — port mServeru nikdo nepustí dovnitř:
New-NetFirewallRule -DisplayName "Pohoda mServer HTTPS" -Direction Inbound -LocalPort 444 -Protocol TCP -Action Allow - PowerShell odmítá spustit stažené skripty —
Unblock-File .\*.ps1a případněSet-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass. install.ps1hlásí neplatný Authenticode podpiswacs.exe— stažený archiv je poškozený nebo ho něco po cestě upravilo (proxy s TLS inspekcí, antivir). Neobcházej to; stáhni release ručně z github.com/win-acme/win-acme/releases a ověřGet-AuthenticodeSignature .\wacs.exe.- Cloudflare plugin nesedí s verzí
wacs.exe(„Unable to find validation plugin cloudflare" / chyba načtení assembly) — plugin musí být ze stejného release jakowacs.exe.install.ps1to zajistí; po ruční aktualizaci win-acme spusťinstall.ps1znovu (příp. s-Version). - Hook není zaregistrovaný (starší instalace) —
wacs.exe --listnezobrazuje installation script → spusťissue.ps1znovu (renewal se přepíše). - PEM bez intermediate certifikátu (fullchain) — klienti bez AIA fetching cert odmítnou.
openssl s_client … -showcertsvýše musí ukázat aspoň 2 certifikáty. - mServer běží pod vlastním servisním účtem — chybí mu čtení
C:\admin\pohoda-cert, viz sekce o právech výše. - Rate limity Let's Encrypt při opakovaných pokusech — nejdřív „Nanečisto" (
--test), pak naostro. Detaily v řešení problémů.