Zwei Beobachtungen aus der laufenden Integration. 1. Der Installer schrieb Geheimnisse weltlesbar SetupWriter benutzte File.WriteAllText ohne Rechteanpassung - unter Linux also die Standardmaske und damit ueblicherweise 644. In genau dieser Datei stehen Lizenzschluessel und Anwendungstoken; jeder Benutzer des Systems konnte sie lesen. Der Lizenz-Cache in StateStore wird aus demselben Grund seit jeher auf 600 gesetzt - der Installer zog nicht nach. Enthaelt ein Ziel mindestens einen geheimen Wert, wird die Datei jetzt auf den eigenen Benutzer beschraenkt. Als geheim gilt type=secret UND source=provision: ein so geholtes Token traegt oft den Typ "string", ist aber genauso schutzbeduerftig. Unter Windows bleibt es beim Profil-ACL. 2. Zielnamen koennen plattformabhaengig unterschiedlich sein %APPDATA%\MeineAnwendung gegen $XDG_CONFIG_HOME/meineanwendung - eine setup.json kannte nur eine Schreibweise. Die kleingeschriebene Form allein traegt, weil NTFS die Schreibweise ignoriert, aber nur solange das Dateisystem tatsaechlich unempfindlich ist; auf APFS mit Beachtung der Schreibweise oder bei groesseren Unterschieden entstuende ein zweites, leeres Verzeichnis neben dem, aus dem die Anwendung liest. Ziele haben deshalb optional fileWindows, fileLinux und fileMacOS; ohne Angabe gilt weiterhin file. Die Dokumentation haelt ausserdem fest, dass der Installer bewusst Klartext schreibt und die Anwendung selbst entscheidet, ob und wie sie ihn danach schuetzt - und dass eine Entschluesselung, die Klartext durchreicht, deshalb kein Altlast-Zweig mehr ist, sondern ein aktiv genutzter Pfad. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
81 lines
3.3 KiB
JSON
81 lines
3.3 KiB
JSON
{
|
|
"_comment": "Vorlage fuer setup.json. Gehoert ins Wurzelverzeichnis des Publish-Ordners, damit sie im Paket neben der manifest.json landet. Der Installer liest sie nach dem Entpacken und fragt genau die Werte ab, die er nicht selbst ermitteln kann.",
|
|
|
|
"schema": 1,
|
|
"displayName": "Beispielanwendung",
|
|
"description": "Fuer den Betrieb werden eine Datenbank und ein Zugang zum Kursdatenanbieter benoetigt.",
|
|
|
|
"_targets_comment": "Wohin geschrieben wird. 'location' bestimmt den Bezugspunkt: install (Vorgabe, Installationsverzeichnis), config (%APPDATA% bzw. $XDG_CONFIG_HOME), data, home. In 'file' sind ${VAR} und %VAR% erlaubt, ein absoluter Pfad wird unveraendert benutzt. format ist 'json' oder 'env'. Ueber 'id' lassen sich einzelne Felder gezielt einer Datei zuordnen; ohne Angabe schreibt ein Feld in das erste Ziel.",
|
|
"_platform_comment": "Heisst der Ordner je nach Plattform anders, hilft meist die kleingeschriebene Form allein: sie trifft unter Linux exakt und unter Windows auch, weil NTFS die Schreibweise ignoriert. Auf case-sensitiven Dateisystemen oder bei groesseren Unterschieden gibt es fileWindows, fileLinux und fileMacOS.",
|
|
"targets": [
|
|
{ "id": "app", "file": "appsettings.json", "location": "install", "format": "json" },
|
|
{
|
|
"id": "user",
|
|
"file": "beispielanwendung/Settings.json",
|
|
"fileWindows": "Beispielanwendung/Settings.json",
|
|
"location": "config",
|
|
"format": "json"
|
|
},
|
|
{ "id": "env", "file": ".env", "location": "install", "format": "env" }
|
|
],
|
|
|
|
"_fields_comment": "source steuert, ob gefragt wird: 'ask' (Vorgabe) fragt nach, 'detect:...' leitet ab, 'provision' laesst ein Token ausstellen. Ist der Wert in der Zieldatei bereits gesetzt und kein Platzhalter, wird er uebernommen und nicht erneut erfragt.",
|
|
"fields": [
|
|
{
|
|
"key": "ConnectionStrings:Main",
|
|
"label": "Datenbankverbindung",
|
|
"help": "Beispiel: Server=localhost;Database=beispiel;User Id=app;Password=...;",
|
|
"type": "secret",
|
|
"required": true
|
|
},
|
|
{
|
|
"key": "Marktdaten:ApiKey",
|
|
"label": "API-Schluessel des Kursdatenanbieters",
|
|
"type": "secret",
|
|
"required": true,
|
|
"validate": "^[A-Za-z0-9_-]{20,}$",
|
|
"validationMessage": "Der Schluessel besteht aus mindestens 20 Zeichen ohne Leerzeichen."
|
|
},
|
|
{
|
|
"key": "Deploymentcenter:BaseUrl",
|
|
"label": "Deploymentcenter",
|
|
"type": "url",
|
|
"source": "detect:baseurl"
|
|
},
|
|
{
|
|
"key": "Deploymentcenter:Token",
|
|
"label": "Token dieser Installation",
|
|
"source": "provision",
|
|
"scopes": ["watchdog:ping", "bugtracker:report"]
|
|
},
|
|
{
|
|
"key": "Watchdog:Source",
|
|
"label": "Name im Monitoring",
|
|
"source": "detect:hostname"
|
|
},
|
|
{
|
|
"key": "Watchdog:IntervalSeconds",
|
|
"label": "Heartbeat-Intervall in Sekunden",
|
|
"type": "int",
|
|
"default": "60",
|
|
"required": false
|
|
},
|
|
{
|
|
"key": "Features:BetaAktiv",
|
|
"label": "Beta-Funktionen einschalten",
|
|
"type": "bool",
|
|
"default": "false",
|
|
"required": false
|
|
},
|
|
{
|
|
"key": "LOGLEVEL",
|
|
"label": "Protokollierungsstufe",
|
|
"target": "env",
|
|
"type": "enum",
|
|
"options": ["Debug", "Information", "Warning", "Error"],
|
|
"default": "Information",
|
|
"required": false
|
|
}
|
|
]
|
|
}
|