Namestitveni paket (referenca)
Datoteke, lastnosti in vedenje namestitvenega paketa za Windows. Uporabo namestitvenega programa opisuje navodilo Namestitev podatkovnega prehoda, namestitev brez oken pa navodilo Nenadzorovana namestitev.
Sintaksa
msiexec /i Wkl.Data.Gateway-<različica>.msi [LASTNOST=vrednost]… /qn Wkl.Data.Gateway-Setup-<različica>.exe [LASTNOST=vrednost]… /quiet
Parametri
V sistemu Windows prehod kot storitev nastavi namestitveni paket. Pri gradnji nastaneta dve datoteki iste različice:
| Datoteka | Vsebina |
|---|---|
Wkl.Data.Gateway-<različica>.msi | Paket (installer/Wkl.Data.Gateway.wxs, WiX 7): program (samostojno objavljen, brez izvajalnega okolja .NET na strežniku), storitev Windows, meni Start, win-acme. Ima preprosta lastna pogovorna okna za neposreden zagon; brez oken ga upravljate s spodnjimi lastnostmi |
Wkl.Data.Gateway-Setup-<različica>.exe | Namestitveni program (installer/Bundle.wxs, WiX Burn) okoli istega paketa z lastnim vmesnikom (installer/Setup, WPF na .NET Framework 4.6.2, ki ga Windows vsebuje od Windows 10 različice 1607 in Windows Server 2016, glejte Microsoft: .NET Framework versions and dependencies): preverjanje računalnika, izbira potrdila iz shrambe, Let's Encrypt, povzetek z enakovrednim ukaznim nizom, na koncu preverjanje delovanja. Spreminjanje, popravilo, posodabljanje, odstranitev |
Postopki prijave po namestitvi. appsettings.Production.json nastavi AuthMode na
PersonalKey, Windows: osebni ključi in račun Windows. Ključe storitve (ApiKey) in prijavo SQL
Server (SqlLogin) vklopite v appsettings.Local.json v programski mapi, ne v
appsettings.Production.json, ki jo namestitveni program pri „Ändern“ (spremeni) znova zapiše. Tam
navedite celoten seznam, na primer "Gateway": { "Security": { "AuthMode": "PersonalKey, Windows, SqlLogin" } };
vrednost nadomesti vrednost namestitve, ne dopolni je.
Delitev nalog. Paket le zbere izbire, nastavitev pa izvede program: setup-host nastavi podatkovno
mapo in pravice (skrbniki, sistem, račun storitve), glavni ključ (32 naključnih bajtov, kot datoteka,
nikoli izpisan), konfiguracijsko datoteko appsettings.Production.json (brez gesel in ključev, le
sklici), potrdilo skupaj s pravico branja računa storitve na njegovem ključu, pravilo požarnega zidu,
postkvantno izmenjavo ključev in vir dogodkov; setup-remove odstrani pravilo požarnega zidu in
konfiguracijo, z --remove-data tudi podatkovno mapo. Tako logika ostane v kodi C# prehoda in ne
v skriptih paketa, nobeno geslo ali ključ pa se ne prenese prek lastnosti paketa, ki bi bila zapisana v
namestitvenem dnevniku. Oseb, ključev in gesel
namestitev nikoli ne ustvari; prvega skrbnika ustvari init-admin zunaj namestitve (meni Start
„Ersten Administrator anlegen“ (Ustvari prvega skrbnika), zadnja stran namestitvenega programa).
Ukaza setup-host in setup-remove opisuje referenca Ukazi.
Lastnosti paketa (vse neobvezne; ista imena sprejme namestitveni program z /quiet):
| Lastnost | Privzeto | Pomen |
|---|---|---|
INSTALLFOLDER | %ProgramFiles%\Wkl\Data Gateway\ | Programska mapa |
DATAFOLDER | %ProgramData%\Wkl.Data.Gateway | Shramba, glavni ključ (geheim\hauptschluessel.key), varnostne kopije |
GW_SERVICE_ACCOUNT | NT SERVICE\Wkl.Data.Gateway | Račun storitve: navidezni račun ali skupinsko upravljani račun storitve (DOMÄNE\name$); račun z geslom ni predviden |
GW_MODE | standalone | standalone: prehod sam govori HTTPS; iis: samo 127.0.0.1, pred njim IIS (zaupanja vreden posrednik 127.0.0.1/::1, predloga iis\web.config) |
GW_PORT | 8434 | Nešifriran HTTP, samo na 127.0.0.1: razvoj, preizkusi, preverjanje delovanja, IIS pred prehodom. Nikoli za delovne postaje |
GW_HTTPS_PORT | 8433 | HTTPS na vsakem naslovu (samostojno s potrdilom), po zgledu vrat 1433 SQL Serverja |
GW_CERTIFICATE | – | Ime potrdila v LocalMachine\My; prazno: samo HTTP na tem računalniku |
GW_SELFSIGNED | 0 | 1: ustvari samopodpisano potrdilo, če ga ni (eno leto, samo za preizkuse) |
GW_ACCESS | internal | internet: pravila prijave za izvore zunaj GW_NETWORKS (skrbništvo po GW_ADMIN_OUTSIDE, prijava z računom Windows in SQL Server z 2FA, ključ storitve zavrnjen) |
GW_NETWORKS | 10.0.0.0/8,172.16.0.0/12,192.168.0.0/16 | Omrežja podjetja; pri internal tudi dovoljeni viri pravila požarnega zidu |
GW_ADMIN_OUTSIDE | deny | totp: skrbništvo od zunaj z 2FA (dvostopenjskim preverjanjem identitete) |
GW_FIREWALL | 1 | dohodno pravilo Wkl.Data.Gateway HTTPS za vrata HTTPS (pri iis 443) |
GW_INSTALLATION_NAME | Datendienst (<ime-računalnika>) | Ime, pod katerim aplikacija Authenticator prikaže vnos za 2FA (Gateway:Store:TotpIssuer); največ 64 znakov, brez dvopičja in narekovajev. Nastavitev skrbništva installation_name ima prednost |
GW_SQL_SERVER | – | SQL Server, na katerem račun storitve potrebuje prijavo (kot v nizu povezave, na primer .\SQLEXPRESS): setup-host zapiše skript dienstkonto-anmeldung.sql v podatkovno mapo. Prazno: brez skripta. Samo pri prvi namestitvi; paket si vrednosti ne zapomni |
GW_SQL_DATABASES | – | Podatkovne zbirke, ločene z vejico, v katerih skript ustvari uporabnika za račun storitve |
GW_SQL_ROLES | readwrite | Vloge novega uporabnika: readwrite (db_datareader, db_datawriter), read (db_datareader) ali none |
GW_PQ | 0 | 1: Enable-TlsEccCurve X25519_MLKEM768 -Position 0 za ves računalnik; pri odstranitvi se ne razveljavi |
GW_RECONFIGURE | – | 1 na nameščenem prehodu: „Ändern“ (Spremeni) – ponovno setup-host, ponovni zagon prehoda |
GW_REMOVE_DATA | – | 1 pri odstranitvi: izbriši tudi podatkovno mapo (samo, če vsebuje glavni ključ ali shrambo) |
Paket si izbire zapomni pod HKLM\SOFTWARE\Wkl\Data Gateway\Setup; „Ändern“ in posodobitev izhajata
iz njih, vrednost v ukazni vrstici ima prednost. Posodobitev odstrani staro različico (podatkovna mapa
ostane), na novo zapiše konfiguracijo in pred prvim zagonom nove različice varnostno kopira shrambo z
backup-store --to-folder <DATAFOLDER>\sicherungen; če varnostna kopija ne uspe, se posodobitev ne
izvede. Pri odstranitvi ostanejo potrdila, postkvantna nastavitev Windows ter nastavitve win-acme;
načrtovano opravilo win-acme setup-remove izbriše le, če zaganja priloženi win-acme\wacs.exe.
Paketi za prenos. Skript za gradnjo po izbiri vključi dodatne namestitvene pakete, na primer paket gonilnika ODBC:
pwsh tools\build-installer.ps1 -Version 1.0.0 -Downloads <pot>\Wkl.Data.OData.Odbc-<različica>.msi
Paket prehoda jih namesti v mapo downloads v programski mapi, privzeto vrednost
Gateway:Downloads:Path; prehod jih tam ponuja pod GET /download/ (glejte
HTTP: specifikacija vmesnika). Brez -Downloads
paket ne namesti nobenega paketa; mapa je tedaj v vaši pristojnosti in vanjo lahko odložite lastne
pakete. Ker prehod te datoteke ponuja brez prijave, sodi tja le podpisan paket brez gesel in ključev:
brez podatkov o povezavi in brez ključev.
Let's Encrypt. Paket prinaša win-acme v2.2.9.1701 (Apache 2.0) z razširitvami za Cloudflare,
Azure DNS, Amazon Route 53 in Hetzner. Projekt ne objavlja kontrolnih vsot in wacs.exe podpisuje le
z lastnim potrdilom; skript za gradnjo zato zabeleži vrednosti SHA-256 prvega prenosa in pri vsaki
drugačni datoteki prekine. Zertifikat-LetsEncrypt.cmd [http|cloudflare|azure|route53|hetzner] v
programski mapi naroči potrdilo za ime iz GW_CERTIFICATE, ga shrani v LocalMachine\My in računu
storitve dodeli pravico branja ključa (--acl-read); win-acme podaljšuje prek svojega načrtovanega
opravila na enak način. Pogoj je javno razrešljivo ime: za http dosegljivo iz interneta na vratih
80, sicer cona pri enem od navedenih ponudnikov DNS.
Kateri win-acme naroča, prej odloči Wkl.Data.Gateway acme-client. Če načrtovano opravilo
win-acme renew (…) zaganja drug, obstoječi wacs.exe, naroča in obnavlja ta; njegovo opravilo in
njegov settings.json ostaneta nespremenjena. Potrebna je različica 2.2.9 ali novejša (različica
datoteke wacs.exe), sicer se acme-client konča z vrnjeno vrednostjo 1 in navede različico, naročilo
pa se ne začne. Brez takega opravila ali če njegov program manjka, naroči priloženi win-acme in ustvari
svoje opravilo.
Proizvajalec in pravna obvestila
Proizvajalec podatkovnega prehoda je EMSR DATA, D.O.O. (naslov in kontakt sta v pregledu). Namestitev vsebuje te podatke:
| Kje | Kaj |
|---|---|
| „Programi in funkcije“ | založnik EMSR DATA, D.O.O., kontakt, spletno mesto https://wvds.it |
Lastnosti datotek lastnih programov in knjižnic izdelka (Wkl.*) | podjetje EMSR DATA, D.O.O., avtorske pravice © EMSR DATA, D.O.O. All rights reserved., obvestilo o blagovnih znamkah |
| Mapa programa | THIRD-PARTY-NOTICES.txt (komponente tretjih oseb in njihove licence), THIRD-PARTY-NOTICES.dotnet.txt in THIRD-PARTY-NOTICES.aspnetcore.txt (komponente tretjih oseb v priloženih izvajalnih okoljih .NET), LICENSE.md (licenčni pogoji družbe EMSR DATA; zavezujoča je angleška različica), SECURITY.md (prijava ranljivosti, podprte različice) in MANUFACTURER.md (podatki o proizvajalcu, konec podpore), vse tri tudi v nemščini (.de.md) in slovenščini (.sl.md) |
| Podpis | Namestitveni program, paket ter vsi lastni programi in knjižnice izdelka v dobavi so podpisani s potrdilom družbe EMSR DATA, D.O.O. in imajo časovni žig. Knjižnice tretjih oseb ostanejo takšne, kot jih dobavi njihov založnik |
Različice do 1.0.7 kot založnika navajajo „The White Knight Labs“. Posodobitev jih kljub temu prepozna; vnos v „Programi in funkcije“ nato navaja novega založnika.