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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="dotVault.Configuration" Version="2026.10.29.140" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="dotVault.Configuration" Version="2026.10.29.140" />
                    
Directory.Packages.props
<PackageReference Include="dotVault.Configuration" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add dotVault.Configuration --version 2026.10.29.140
                    
#r "nuget: dotVault.Configuration, 2026.10.29.140"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package dotVault.Configuration@2026.10.29.140
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=dotVault.Configuration&version=2026.10.29.140
                    
Install as a Cake Addin
#tool nuget:?package=dotVault.Configuration&version=2026.10.29.140
                    
Install as a Cake Tool

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 Development ist, und nie, wenn CI, GITHUB_ACTIONS, TF_BUILD, JENKINS_URL, GITLAB_CI, BUILDKITE oder KUBERNETES_SERVICE_HOST gesetzt ist (DOTVAULT_DISABLE=1 schaltet es aus). In Produktion liefert der dotVault-Operator die Werte, nicht dieses Paket.
  • Nur Umgebungen aus AllowedEnvironments (Standard dev, development, local); prod lehnt 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed