Manual:Caddy/Configurare: Diferență între versiuni
Avir (discuție | contribuții) Creat o pagină goală |
Documentare initiala Caddy.STS 0.4.3: moduri HTTPS, configurare, firewall si certificate. |
||
| Linia 1: | Linia 1: | ||
<!-- REGULA EDITORIALA: Manualul se redacteaza fara diacritice. --> | |||
= Caddy.STS - Configurare = | |||
'''Versiune documentata: Caddy.STS Setup 0.4.3.''' | |||
Caddy.STS pregateste un reverse proxy HTTPS pentru Integrat.STS Mobile.Api. Operatiile care modifica instalarea sunt explicite; '''Preview + validate''' nu modifica fisierele active. | |||
== Campuri == | |||
* '''Tip certificat''' - modul '''LAN - CA interna''' sau '''Public - Let's Encrypt shortlived'''. | |||
* '''IP HTTPS''' - adresa IPv4 folosita pentru acces. | |||
* '''Port API local''' - portul Mobile.Api, accesat de Caddy la <code>127.0.0.1</code> (de exemplu 5277). | |||
* '''Port HTTPS''' - portul de acces al dispozitivelor. In modul public, este obligatoriu portul '''443'''. | |||
* '''ID instanta''' - nume unic de 3-40 caractere: litere, cifre, minus sau underscore. | |||
* '''Retele LAN (CIDR)''' - subretelele autorizate sa acceseze serviciul in modul LAN. | |||
* '''caddy.exe''' - executabilul Caddy folosit pentru validare si instalare. | |||
* '''SHA256 caddy.exe''' - amprenta executabilului verificat. | |||
Porturile API si HTTPS nu pot fi identice. | |||
== Acces public HTTPS == | |||
Modul '''Public - Let's Encrypt shortlived''' este destinat adreselor IPv4 publice, cu certificat public si port HTTPS '''443'''. | |||
* Confirmati ca traficul catre portul 443 ajunge la server. | |||
* Verificati regulile Windows Firewall, routerul, NAT si firewallul furnizorului. | |||
* Verificati certificatul din browser si posibilitatea de acces dintr-o alta retea. | |||
* Monitorizati valabilitatea certificatului. O verificare reusita la instalare nu garanteaza reinnoirea lui ulterioara. | |||
'''Nu publicati portul Mobile.Api in Internet.''' Caddy comunica local cu backendul <code>127.0.0.1:<port API></code>. | |||
== Acces LAN cu certificat intern == | |||
Modul '''LAN - CA interna''' foloseste un IPv4 privat si certificate generate de autoritatea locala Caddy. | |||
# Introduceti IP-ul privat al serverului. | |||
# Configurati portul HTTPS, portul API si ID-ul instantei. | |||
# Introduceti subretelele permise, de exemplu <code>192.168.1.0/24</code>. | |||
# Rulati '''Preview + validate'''. | |||
# Dupa instalarea serviciului nou, folositi '''Export CA publica'''. | |||
# Instalati certificatul radacina public al CA pe dispozitive si verificati increderea in browser. | |||
Aplicatia exporta doar certificatul public <code>root.crt</code>, nu cheia privata. Nu permiteti acces LAN din orice retea in locul CIDR-urilor autorizate. | |||
== Butoanele aplicatiei == | |||
=== Diagnostic === | |||
Inventariaza serviciile si procesele Caddy, porturile, backendul Mobile.Api, certificatele si regula proprie Windows Firewall. Pentru o instalare administrata identificata cu certitudine, poate propune repararea regulii firewall cu dialog '''Da / Nu'''. '''Nu''' este alegerea implicita. | |||
=== Preview + validate === | |||
Genereaza o configuratie temporara si verifica sintaxa. Nu modifica instalatia activa sau certificatele. | |||
=== Instalare NOUA === | |||
Instaleaza un serviciu CaddySTS nou doar dupa verificarile de siguranta si confirmarea operatorului. Nu adopta alte instalatii Caddy. | |||
=== Adauga LAN === | |||
Adauga o configuratie LAN numai unei instalari compatibile administrate de Caddy.STS. Operatia necesita confirmare si poate reporni serviciul. | |||
=== Export CA publica === | |||
Permite salvarea certificatului public al autoritatii locale si afiseaza amprenta acestuia. | |||
== Firewall si protectii == | |||
Caddy.STS modifica numai regulile Windows Firewall aferente instalarii proprii, cand identitatea acesteia poate fi stabilita. Regula publica permite accesul la portul HTTPS configurat, iar regula LAN este restransa la subretelele CIDR autorizate. Nu sunt modificate automat alte servicii Caddy sau regulile acestora. | |||
== Configurare in ERP == | |||
Adresa de acces Mobile trebuie corelata cu optiunile din '''Integrat.STS / Utile / Setari / Generale / Speciale'''. Autorizarea dispozitivelor se face separat prin '''Mobile - dispozitive'''. | |||
== Vezi si == | |||
* [[Manual:Caddy|Caddy.STS]] | |||
* [[Manual:Caddy/Instalare|Instalare]] | |||
* [[Manual:Caddy/Depanare|Depanare]] | |||
* [[Manual:Integrat/Module/Mobile/Configurare|Configurare Mobile]] | |||
Versiunea de la data 29 octombrie 2026 09:50
Caddy.STS - Configurare
Versiune documentata: Caddy.STS Setup 0.4.3.
Caddy.STS pregateste un reverse proxy HTTPS pentru Integrat.STS Mobile.Api. Operatiile care modifica instalarea sunt explicite; Preview + validate nu modifica fisierele active.
Campuri
- Tip certificat - modul LAN - CA interna sau Public - Let's Encrypt shortlived.
- IP HTTPS - adresa IPv4 folosita pentru acces.
- Port API local - portul Mobile.Api, accesat de Caddy la
127.0.0.1(de exemplu 5277). - Port HTTPS - portul de acces al dispozitivelor. In modul public, este obligatoriu portul 443.
- ID instanta - nume unic de 3-40 caractere: litere, cifre, minus sau underscore.
- Retele LAN (CIDR) - subretelele autorizate sa acceseze serviciul in modul LAN.
- caddy.exe - executabilul Caddy folosit pentru validare si instalare.
- SHA256 caddy.exe - amprenta executabilului verificat.
Porturile API si HTTPS nu pot fi identice.
Acces public HTTPS
Modul Public - Let's Encrypt shortlived este destinat adreselor IPv4 publice, cu certificat public si port HTTPS 443.
- Confirmati ca traficul catre portul 443 ajunge la server.
- Verificati regulile Windows Firewall, routerul, NAT si firewallul furnizorului.
- Verificati certificatul din browser si posibilitatea de acces dintr-o alta retea.
- Monitorizati valabilitatea certificatului. O verificare reusita la instalare nu garanteaza reinnoirea lui ulterioara.
Nu publicati portul Mobile.Api in Internet. Caddy comunica local cu backendul 127.0.0.1:<port API>.
Acces LAN cu certificat intern
Modul LAN - CA interna foloseste un IPv4 privat si certificate generate de autoritatea locala Caddy.
- Introduceti IP-ul privat al serverului.
- Configurati portul HTTPS, portul API si ID-ul instantei.
- Introduceti subretelele permise, de exemplu
192.168.1.0/24. - Rulati Preview + validate.
- Dupa instalarea serviciului nou, folositi Export CA publica.
- Instalati certificatul radacina public al CA pe dispozitive si verificati increderea in browser.
Aplicatia exporta doar certificatul public root.crt, nu cheia privata. Nu permiteti acces LAN din orice retea in locul CIDR-urilor autorizate.
Butoanele aplicatiei
Diagnostic
Inventariaza serviciile si procesele Caddy, porturile, backendul Mobile.Api, certificatele si regula proprie Windows Firewall. Pentru o instalare administrata identificata cu certitudine, poate propune repararea regulii firewall cu dialog Da / Nu. Nu este alegerea implicita.
Preview + validate
Genereaza o configuratie temporara si verifica sintaxa. Nu modifica instalatia activa sau certificatele.
Instalare NOUA
Instaleaza un serviciu CaddySTS nou doar dupa verificarile de siguranta si confirmarea operatorului. Nu adopta alte instalatii Caddy.
Adauga LAN
Adauga o configuratie LAN numai unei instalari compatibile administrate de Caddy.STS. Operatia necesita confirmare si poate reporni serviciul.
Export CA publica
Permite salvarea certificatului public al autoritatii locale si afiseaza amprenta acestuia.
Firewall si protectii
Caddy.STS modifica numai regulile Windows Firewall aferente instalarii proprii, cand identitatea acesteia poate fi stabilita. Regula publica permite accesul la portul HTTPS configurat, iar regula LAN este restransa la subretelele CIDR autorizate. Nu sunt modificate automat alte servicii Caddy sau regulile acestora.
Configurare in ERP
Adresa de acces Mobile trebuie corelata cu optiunile din Integrat.STS / Utile / Setari / Generale / Speciale. Autorizarea dispozitivelor se face separat prin Mobile - dispozitive.