dotVault.Configuration
2026.10.29.140
dotnet add package dotVault.Configuration --version 2026.10.29.140
NuGet\Install-Package dotVault.Configuration -Version 2026.10.29.140
<PackageReference Include="dotVault.Configuration" Version="2026.10.29.140" />
<PackageVersion Include="dotVault.Configuration" Version="2026.10.29.140" />
<PackageReference Include="dotVault.Configuration" />
paket add dotVault.Configuration --version 2026.10.29.140
#r "nuget: dotVault.Configuration, 2026.10.29.140"
#:package dotVault.Configuration@2026.10.29.140
#addin nuget:?package=dotVault.Configuration&version=2026.10.29.140
#tool nuget:?package=dotVault.Configuration&version=2026.10.29.140
dotVault.Configuration
Lokale Entwicklungs-Settings aus dem Secrets-Tresor dotVault: kein Kennwort, kein Connection-String und kein Schlüssel mehr in appsettings.Development.json oder in user-secrets. Die App holt sie beim Start aus dotVault, nur in Development, nur in den Speicher.
Local development settings from the dotVault secrets vault: no password, connection string or key in appsettings.Development.json or user-secrets any more. The app loads them at startup, in Development only, into memory only.
Einbinden
dotnet add package dotVault.Configuration
var builder = WebApplication.CreateBuilder(args);
builder.AddDotVault();
Ohne IHostApplicationBuilder: configurationBuilder.AddDotVault(environmentName).
Im Repository (oder neben der App) liegt .dotvault.json:
{
"server": "https://vault.example.com",
"project": "weboffice",
"environment": "dev",
"folder": "/app"
}
dotvault init weboffice dev /app --server https://vault.example.com legt sie an. Die Datei enthält keinen Wert.
Erster Start
Einmal je Rechner und Server dotvault login <url> mit der CLI: an einem Server, an dem der Rechner noch nie angemeldet war, meldet die App nicht im Browser an, denn die Adresse aus .dotvault.json (oder dem Code) könnte aus einem fremden Repository stammen; die App endet dann mit dem passenden dotvault login. Ist die Sitzung abgelaufen, zeigt die App einen Code und öffnet die Seite /device von dotVault im Browser. Dort mit Benutzername, Kennwort und Authenticator anmelden und zulassen, die App läuft weiter. Die Sitzung teilt sie mit der dotvault-CLI (Windows %LOCALAPPDATA%\dotvault\config.json, sonst ~/.config/dotvault/config.json, bzw. DOTVAULT_CONFIG): wer schon dotvault login gemacht hat, wird nicht noch einmal gefragt. Starten mehrere Apps gleichzeitig, meldet nur die erste an, die anderen warten und übernehmen die Sitzung. Hält die Datei schon eine Anmeldung an einem anderen Server, bleibt die erhalten; die Sitzung für diesen Server liegt dann daneben in config.<server>.json.
Ohne Leserecht
Fehlt das Recht auf den Ordner, öffnet die App die Seite „Zugriff beantragen“ von dotVault, schon ausgefüllt mit Projekt, Umgebung und Ordner; nur die Begründung fehlt noch. Ein Verwalter bekommt eine Mail und genehmigt, die App wartet so lange und startet dann mit den Werten weiter, ohne Neustart.
Without read access the app opens dotVault's prefilled "request access" page, waits until an admin approves and then starts with the values.
Sicherheit
- Lädt nur, wenn die Umgebung
Developmentist, und nie, wennCI,GITHUB_ACTIONS,TF_BUILD,JENKINS_URL,GITLAB_CI,BUILDKITEoderKUBERNETES_SERVICE_HOSTgesetzt ist (DOTVAULT_DISABLE=1schaltet es aus). In Produktion liefert der dotVault-Operator die Werte, nicht dieses Paket. - Nur Umgebungen aus
AllowedEnvironments(Standarddev,development,local);prodlehnt das Paket ab, auch wenn der Zugang lesen dürfte. Was ein Entwickler lesen darf, bestimmen ohnehin die Rechte in dotVault. - Werte kommen verschlüsselt (JWE an einen Schlüssel dieses Prozesses), stehen nur im Speicher und nie in einer Datei oder im Log. Auf der Platte liegt nur die Sitzung: Token und DPoP-Schlüssel, Datei nur für den Benutzer lesbar.
- Die Sitzung ist an den Schlüssel dieses Rechners gebunden, gilt ohne Nutzung 36 Stunden, höchstens 7 Tage; ein wiederverwendetes Erneuerungs-Token sperrt sie (Verdacht auf Diebstahl).
- Jeder Abruf steht im Audit von dotVault, mit Benutzer und Rechner.
Werte und Schlüssel
Alle Werte des Ordners (mit Unterordnern) werden Konfiguration; __ im Schlüssel wird : wie bei Umgebungsvariablen: ConnectionStrings__DB → ConnectionStrings:DB. Ein Name zweimal (in zwei Unterordnern) ist ein Fehler. Ändert jemand einen Wert in dotVault, lädt die App ihn ohne Neustart nach (IOptionsMonitor, IConfiguration mit Reload-Token).
Optionen
builder.AddDotVault(o =>
{
o.Folder = "/phoneserver";
o.Optional = true;
o.Watch = false;
});
| Option | Standard | |
|---|---|---|
ProjectFile |
Suche nach .dotvault.json ab Arbeits- und App-Verzeichnis aufwärts |
|
Server, Project, Environment, Folder |
aus der Projektdatei | |
Recursive |
true |
Unterordner mitladen |
Watch |
true |
Änderungen live übernehmen |
Interactive |
true |
ohne Sitzung im Browser anmelden; false: Fehler mit dotvault login … |
Optional |
false |
ohne Projektdatei, Sitzung oder Recht ohne Werte weiterstarten |
AccessWait |
15 Minuten | ohne Leserecht den Antrag im Browser öffnen und so lange auf die Freigabe warten; TimeSpan.Zero: sofort Fehler mit Link |
AllowedEnvironments |
dev, development, local |
|
Output |
Console.Error |
Hinweise (nie Werte) |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.Configuration (>= 10.0.14)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.14)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2026.10.29.140 | 130 | 10/29/2026 |
| 2026.10.29.139 | 138 | 10/29/2026 |
| 2026.10.29.138 | 104 | 10/29/2026 |
| 2026.10.27.137 | 114 | 10/27/2026 |
| 2026.10.27.135 | 106 | 10/27/2026 |
| 2026.10.27.134 | 104 | 10/27/2026 |
| 2026.10.27.133 | 93 | 10/27/2026 |
| 2026.10.27.132 | 96 | 10/27/2026 |
| 2026.10.27.131 | 92 | 10/27/2026 |
| 2026.10.27.130 | 110 | 10/27/2026 |
| 2026.10.27.128 | 98 | 10/27/2026 |
| 2026.10.27.127 | 100 | 10/27/2026 |
| 2026.10.26.117 | 99 | 10/26/2026 |
| 2026.10.25.110 | 95 | 10/25/2026 |
| 2026.10.25.109 | 98 | 10/25/2026 |
| 2026.10.25.108 | 97 | 10/25/2026 |
| 2026.10.25.107 | 114 | 10/25/2026 |
| 2026.10.25.105 | 101 | 10/25/2026 |
| 2026.10.25.104 | 95 | 10/25/2026 |
| 2026.10.25.103 | 101 | 10/25/2026 |