So installieren Sie den Datendienst ohne Fenster

Für eine Softwareverteilung, eine wiederholbare Einrichtung oder einen Server ohne Oberfläche installieren Sie das Paket mit seinen Eigenschaften auf der Befehlszeile. Dieselben Eigenschaften nimmt das Installationsprogramm mit /quiet.

Das Paket sammelt nur die Wahl und ruft das Programm selbst auf (setup-host): Datenordner, Rechte, Hauptschlüssel, Konfigurationsdatei, Zertifikat, Firewall-Regel. Personen, Schlüssel und Kennwörter legt eine Installation nie an; den ersten Administrator legt danach init-admin an. Alle Eigenschaften mit Vorgaben stehen in der Referenz Installationspaket.

1. Installieren Sie als Administrator, etwa eigenständig mit HTTPS und Zugang nur aus den Firmennetzen:

   msiexec /i Wkl.Data.Gateway-1.0.0.msi /qn /l*v install.log GW_CERTIFICATE=daten.example.com GW_NETWORKS=10.0.0.0/8

   Auch aus dem Internet erreichbar, Verwaltung von außen nur mit zweitem Faktor:

   msiexec /i Wkl.Data.Gateway-1.0.0.msi /qn GW_CERTIFICATE=daten.example.com GW_ACCESS=internet GW_NETWORKS=10.0.0.0/8 GW_ADMIN_OUTSIDE=totp

2. Prüfen Sie den Rückgabewert: 0 heißt eingerichtet. Bei jedem anderen rollt das Paket zurück; die Meldung von setup-host steht im Protokoll (/l*v).
3. Legen Sie den ersten Administrator an (Startmenü Ersten Administrator anlegen oder Wkl.Data.Gateway init-admin --name "…"); siehe So legen Sie den ersten Administrator an.

Ergebnis: Der Windows-Dienst läuft unter NT SERVICE\Wkl.Data.Gateway, antwortet auf /health/live, und die Firewall-Regel lässt nur die genannten Netze zu.

• Lizenzbedingungen: Ohne Fenster zeigt die Installation die Lizenzbedingungen nicht an. Wer unbeaufsichtigt installiert, stimmt ihnen damit zu; lesen Sie sie vorher in LICENSE.md (verbindlich, Englisch) oder in den Übersetzungen LICENSE.de.md und LICENSE.sl.md, die im Programmordner liegen.
• Ändern: msiexec /i … GW_RECONFIGURE=1 <neue Eigenschaften> an einem installierten Dienst führt setup-host erneut aus und startet den Dienst neu. Die Wahl merkt sich das Paket unter HKLM\SOFTWARE\Wkl\Data Gateway\Setup; eine Angabe auf der Befehlszeile gewinnt. Ein geänderter Zugang (GW_ACCESS, GW_NETWORKS, GW_ADMIN_OUTSIDE) ändert die Firewall-Regel, nicht aber die Anmelderegeln eines bestehenden Verwaltungsspeichers; das Protokoll enthält dazu einen Hinweis. Prüfen Sie die Regeln mit Wkl.Data.Gateway list-sign-in-rules.
• Aktualisieren: Eine neue Fassung behält die Wahl und sichert den Speicher vor dem ersten Start nach <DATAFOLDER>\sicherungen; ohne Sicherung keine Aktualisierung.
• Entfernen: msiexec /x … GW_REMOVE_DATA=1 löscht auch den Datenordner mit Hauptschlüssel und Verwaltungsspeicher, unwiderruflich: Ohne Sicherung beider sind Datenquellen, Personen, persönliche Schlüssel und zweite Faktoren verloren, und eine spätere Neuinstallation beginnt leer. Zum Schutz vor einem falsch angegebenen Ordner löscht das Paket ihn nur, wenn er als Datenordner erkennbar ist, also einen Hauptschlüssel oder einen Speicher enthält. Ohne die Eigenschaft bleibt der Ordner stehen.
• Kein Geheimnis auf der Befehlszeile: Der Hauptschlüssel entsteht als Datei im Datenordner und wird nie ausgegeben; keine Eigenschaft nimmt ein Kennwort.

• Installationspaket (Referenz)
• So installieren Sie den Datendienst – mit Oberfläche
• Befehle: setup-host