Manual:Integrat/Module/Mobile/Instalare server - retea locala

Instalare pe server - retea locala

Aceasta pagina descrie instalarea Integrat.STS Mobile pentru utilizare exclusiv in reteaua locala a clientului. Telefoanele si tabletele trebuie sa fie conectate la o retea Wi-Fi care poate accesa serverul Integrat.STS. Nu sunt necesare un domeniu public, IP public sau redirectionarea porturilor din Internet.

Daca aplicatia trebuie accesata si din afara retelei locale, urmati Instalare pe server - acces din Internet.

Instalarea se efectueaza de administratorul de sistem sau de personal tehnic autorizat.

Cerinte

• server Windows pe care este instalat Integrat.STS;
• drepturi de administrator pe server;
• un port liber pentru serviciul Mobile, de exemplu 5277;
• un IP local stabil pentru server, stabilit static sau rezervat in DHCP;
• pentru instalarea cu Caddy.STS, un IP privat stabil si accesibil dispozitivelor; pentru o configuratie Caddy manuala existenta, poate fi folosit si un nume local rezolvat prin DNS;
• acces din reteaua Wi-Fi a dispozitivelor la portul HTTPS configurat pe server (in mod obisnuit 443);
• posibilitatea instalarii certificatului radacina Caddy pe fiecare dispozitiv utilizat.

La instalare, serverul are nevoie de acces la kiturile descarcate. Functionarea in reteaua locala nu necesita publicarea aplicatiei pe Internet.

Alegerea metodei de publicare HTTPS in LAN

Se poate folosi una dintre cele doua variante:

1. Caddy.STS - utilitarul Soft Team Solutions pentru configurarea HTTPS direct pe o adresa IPv4 privata, cu certificat intern si regula Windows Firewall limitata la retelele CIDR autorizate. Pentru o instalare noua, aceasta este varianta recomandata.
2. Caddy configurat manual - pentru instalatii existente care folosesc un nume local, precum mobile.home.arpa, si un Caddyfile propriu. Caddy.STS nu adopta automat aceste instalatii si nu trebuie pornita "Instalare NOUA" peste ele.

Consultati Caddy.STS, Instalare Caddy.STS si Configurare Caddy.STS.

Varianta recomandata: Caddy.STS cu adresa IPv4 privata

1. Instalati componenta Mobile si verificati raspunsul ei local la http://127.0.0.1:<port API>/test.
2. Descarcati kitul oficial Caddy.STS si verificati semnatura Soft Team Solutions SRL.
3. Instalati kitul de administrare si porniti Diagnostic; aceasta etapa nu instaleaza si nu inlocuieste automat serviciul Caddy.
4. Pentru un server fara alta instalare Caddy incompatibila, alegeti LAN - CA interna, IP-ul privat, portul HTTPS, portul Mobile.Api si ID-ul instantei.
5. Completati Retele LAN (CIDR) cu subretelele autorizate. Nu permiteti accesul din orice retea.
6. Rulati Preview + validate, apoi Instalare NOUA numai dupa verificari si confirmare.
7. Verificati ca serviciul CaddySTS functioneaza si ca regula sa Windows Firewall permite doar retelele LAN configurate.
8. Folositi Export CA publica pentru certificatul radacina public si instalati-l ca certificat de incredere pe dispozitive.

Exemplu de adresa HTTPS pentru aceasta varianta, daca IP-ul configurat este 192.168.0.100 si portul este 443:

https://192.168.0.100

Nu stergeti configuratia, certificatele sau autoritatea de certificare din C:\ProgramData\SoftTeam\CaddySTS\data\. Portul API Mobile nu se publica in Internet.

Varianta alternativa: adresa locala cu DNS si Caddy manual

Pentru instalatiile Caddy gestionate manual, pastrati numele local si configuratia existenta. Urmatoarele instructiuni despre DNS si Caddyfile se aplica numai acestei variante.

Stabilirea adresei locale

Alegeti un nume pentru aplicatie, de exemplu:

mobile.home.arpa

Configurati DNS-ul local al routerului sau al serverului de retea astfel incat numele ales sa indice spre IP-ul local stabil al serverului Integrat.STS. Dispozitivele conectate la Wi-Fi trebuie sa foloseasca un DNS care poate rezolva acest nume.

Exemplu:

mobile.home.arpa -> 192.168.0.100

Numele si IP-ul sunt doar exemple; folositi valorile retelei clientului. Verificati de pe un calculator conectat in aceeasi retea:

nslookup mobile.home.arpa

Raspunsul trebuie sa fie IP-ul local al serverului. Daca reteaua Wi-Fi pentru oaspeti izoleaza dispozitivele de server, folositi o retea Wi-Fi care permite accesul necesar.

Instalarea componentei Mobile

Descarcati kitul Mobile.exe disponibil si in sectiunea Download de pe site-ul Soft Team. Instalati componenta pe serverul Integrat.STS si configurati portul local al serviciului Mobile.

Serviciul Windows creat are forma:

Integrat.STS.Mobile.<port>

Pentru portul 5277, verificati din Command Prompt deschis cu drepturi de administrator:

sc query "Integrat.STS.Mobile.5277"

Serviciul trebuie sa fie in starea RUNNING si sa porneasca automat odata cu serverul.

O instalare noua porneste implicit in modul Fara. In aceasta stare, API-ul Mobile asculta numai pe 127.0.0.1 si nu este disponibil dispozitivelor din reteaua locala.

Pentru utilizarea in LAN, deschideti Integrat.STS -> Setari -> Generale -> Speciale si selectati Mod acces Mobile = Local. Configuratia serviciului se aplica automat; nu este necesara repornirea manuala a serviciului.

Verificarea aplicatiei pe server

Verificati starea API-ului local, inlocuind portul cu cel configurat:

curl http://127.0.0.1:5277/sts-mobile/status

Pentru modul Local, raspunsul trebuie sa indice accessMode cu valoarea Lan si gatewayEnabled cu valoarea false.

Puteti verifica si portul ascultat de serviciu:

netstat -ano | findstr :5277

In modul Local, serviciul trebuie sa accepte conexiuni din retea. Daca API-ul ramane legat numai la 127.0.0.1, verificati ca in Integrat.STS sa fie selectat modul Local.

Daca nu exista raspuns, verificati serviciul Windows, portul si fisierele instalarii. Portul intern 5277 nu trebuie expus in Internet.

Configurarea manuala Caddy pentru HTTPS local

Numai pentru varianta manuala cu nume local. Daca folositi Caddy.STS, urmati procedura anterioara si nu instalati un al doilea serviciu Caddy in paralel.

Descarcati Caddy de pe pagina oficiala in varianta Windows 64-bit si copiati caddy.exe in:

C:\Program Files\Caddy\

Creati fisierul C:\Program Files\Caddy\Caddyfile. Inlocuiti numele si portul din exemplu cu cele alese pentru client:

mobile.home.arpa {
    tls internal
    reverse_proxy 127.0.0.1:5277
}

Directiva tls internal foloseste o autoritate de certificare locala gestionata de Caddy. Aceasta nu necesita un domeniu public sau validare prin Internet, dar fiecare dispozitiv client trebuie sa aiba incredere in certificatul radacina al acestei instalari Caddy.

Verificati configuratia:

"C:\Program Files\Caddy\caddy.exe" validate --config "C:\Program Files\Caddy\Caddyfile"

Configurati Caddy ca serviciu Windows cu pornire automata, folosind contul si procedura de administrare a serviciilor aprobate pentru serverul clientului. Verificati apoi:

sc query Caddy

Serviciul trebuie sa fie in starea RUNNING. Pastrati datele Caddy, inclusiv autoritatea de certificare locala, la actualizari si la copiile de siguranta; inlocuirea acestei autoritati ar impune reinstalarea certificatului radacina pe dispozitive.

Firewall si acces doar din LAN

Pentru instalarea administrata, Caddy.STS configureaza regula aferenta propriului serviciu si o limiteaza la retelele CIDR autorizate. Verificati aceasta regula in Diagnostic; repararea cere confirmare. Pentru instalarea manuala, administratorul trebuie sa configureze separat o regula echivalenta.

Permiteti conexiunile TCP pe portul 443 catre server numai din retelele locale in care se afla dispozitivele autorizate. Verificati ca routerul sa NU redirectioneze portul 443 sau portul intern Mobile din Internet catre server.

Daca sunt folosite VLAN-uri sau retele Wi-Fi separate, administratorul trebuie sa permita accesul dispozitivelor la server pe portul 443 si la DNS-ul local.

Certificatul pe telefoane si tablete

Administratorul instaleaza numai certificatul radacina public al autoritatii locale Caddy pe fiecare dispozitiv care va utiliza Mobile. Pentru Caddy.STS, folositi butonul Export CA publica. Pentru o instalare manuala, fisierul se gaseste in directorul de date al contului sub care ruleaza Caddy, la pki/authorities/local/root.crt. Nu distribuiti cheia privata.

Pe iPhone / iPad, dupa instalarea profilului certificatului, activati si increderea pentru certificatul radacina in setarile dispozitivului. Pe Android, importul si increderea in certificate depind de versiune si de politica dispozitivului. Verificati in browser ca adresa HTTPS se deschide fara avertisment de certificat.

Nu continuati prin ignorarea avertismentului de securitate. Instalarea PWA, functiile de cache si accesul la camera necesita o conexiune HTTPS recunoscuta de browser.

Configurarea accesului Mobile si autorizarea

In Integrat.STS / Utile / Setari / Generale / Speciale, grupa Setari Mobile:

1. Activati Acces local disponibil.
2. Completati Adresa de acces cu URL-ul HTTPS testat pe dispozitiv: IP-ul privat configurat in Caddy.STS sau numele local configurat in Caddy manual.
3. Selectati Acces implicit = Local daca aceasta este metoda de conectare dorita.
4. Salvati si verificati ca telefonul poate accesa URL-ul fara avertisment privind certificatul.

Exemple (alegeti numai adresa care corespunde instalatiei):

https://192.168.0.100
https://mobile.home.arpa

Adresa configurata se foloseste la generarea linkului si a codului QR din Mobile - dispozitive. Dispozitivul trebuie sa aiba acces la server din LAN. Pentru configuratia cu nume local, trebuie sa poata rezolva si DNS-ul corespunzator.

Autorizati dispozitivul din ERP inainte de autentificare. Utilizatorul se conecteaza apoi cu propriul cont Integrat.STS. Consultati manualul Mobile pentru activare si autentificare.

Verificare finala

1. Verificati ca serviciul Integrat.STS.Mobile.<port> si serviciul HTTPS ales (CaddySTS pentru instalarea administrata sau Caddy pentru instalarea manuala) ruleaza si pornesc automat.
2. Verificati in Integrat.STS ca Acces local disponibil este activ si Acces implicit este Local, daca este metoda implicita folosita.
3. Verificati cu /sts-mobile/status ca accessMode este Lan si Gateway este dezactivat.
4. Daca folositi un nume local, verificati rezolvarea lui DNS catre IP-ul serverului, inclusiv de pe dispozitive.
5. Deschideti pe telefon prin Wi-Fi adresa HTTPS configurata (IP sau nume local); certificatul trebuie sa fie acceptat fara avertisment.
6. Verificati autorizarea prin QR sau link si apoi autentificarea.
7. Repetati verificarea dupa repornirea serverului.

Daca aplicatia se deschide pe server, dar nu pe telefon, verificati setarile de acces, conectivitatea Wi-Fi, regulile CIDR, portul HTTPS si instalarea certificatului radacina. Pentru varianta cu nume local, verificati si DNS-ul dispozitivului. In afara retelei locale, aplicatia nu va fi accesibila prin aceasta configuratie.

Actualizare

Pentru actualizare, folositi versiunea curenta a kitului Mobile.exe. Actualizarea pastreaza configuratia existenta. Dupa actualizare, verificati serviciile, modul de acces, accesul HTTPS, certificatul si activarea dispozitivelor. Pastrati configuratia Caddy, datele autoritatii sale locale si, pentru instalarea administrata, datele Caddy.STS. Actualizarea kitului de administrare Caddy.STS se face separat de actualizarea Mobile.

Vezi si

• Mobile
• Comenzi clienti
• Comenzi POS
• Inventariere
• Setari
• Configurare
• Instalare Android
• Instalare iPhone / iPad
• Instalare server - acces din Internet
• Caddy.STS
• Instalare Caddy.STS
• Configurare Caddy.STS
• Depanare Caddy.STS