🔐 Let's Encrypt Wizard
English ← Zpět do průvodce

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:

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)

  1. Veřejná doména (např. pohoda.firma.cz) v Cloudflare DNS (klidně split-horizon).

  2. Cloudflare API token s právy Zone:DNS:Edit + Zone:Zone:Read jen pro tuto zónu. Do wizardu se nezadává — zeptá se na něj až issue.ps1 na serveru.

  3. 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.

  4. 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 obnovy
    

    install.ps1 vynucuje TLS 1.2 pro stahování a umí připnout konkrétní verzi: .\install.ps1 -Version v2.2.9.1701. Pokud ověření podpisu wacs.exe selže, skript skončí — neobcházej to (viz pasti níže).

  5. 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 cesty C:\admin\pohoda-cert\mserver-cert.pem + C:\admin\pohoda-cert\mserver-key.pem (nebo sloučený mserver.pem pro obojí),
    • Uložit → restart instance.
  6. Ověř zvenčí (příkazy níže) a nech si v kalendáři připomínku z .ics souboru 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:

  1. zkopíruje renewal-hook-mserver.ps1 do C:\Program Files\win-acme\Scripts\renewal-hook-mserver.ps1,
  2. 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:

Starší verze tohoto návodu zmiňovaly skript PohodaMServerRebind.ps1 — ten neexistuje. Správný název je renewal-hook-mserver.ps1 a musí ležet vedle issue.ps1 (jinak issue.ps1 skončí 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)

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