Vault
VaultData descarga y descifra con una contraseña un JSON de secretos y expone cada clave con Read, sin credenciales en el código.
VaultData (namespace Dinaup.Vault) lee tus secretos de un JSON cifrado publicado en una URL. En el entorno solo quedan la URL y la contraseña; el resto se descifra en memoria.
Antes de empezar
- Paquete
Dinaupinstalado. Ver SDK .NET. - Un vault publicado: la URL del blob cifrado y su contraseña. El SDK solo lo lee; generarlo y publicarlo es aparte.
Conectar Dinaup desde el vault
using Dinaup;
using Dinaup.Vault;
var vault = new VaultData("VAULT_URL", "VAULT_PASSWORD"); // nombres de variables de entorno, o los valores
vault.Initialize();
var client = await DinaupClientC.ConnectAsync(
endPoint: vault.Read("dinaup.endpoint"),
publicKey: vault.Read("dinaup.publickey"),
secretKey: vault.Read("dinaup.secretkey")
);El constructor busca cada nombre en las variables de entorno de máquina, proceso y usuario; si no lo encuentra, usa el texto tal cual. Initialize() descarga el blob, lo descifra y deja el JSON en Parameters, un diccionario sin distinción de mayúsculas. Read(key) devuelve el valor o cadena vacía.
DinaupExternalAppSettings(vault) lee del mismo vault las claves DINAUP_APPID y DINAUP_APPTOKEN de una app externa. Ver Apps multi-tenant.
Todos los miembros
| Miembro | Qué hace |
|---|---|
New(url o variable, contraseña o variable) | Resuelve la URL y la contraseña, sin descargar todavía. |
New(args) | Para apps de consola: toma como configuración el primer argumento que termine en .json y exista. |
New() | Vacío; después fija ConfigurationFilePath o llama a Initialize(url, pass). |
Initialize() | Descarga y descifra. Sin URL ni contraseña, lee ConfigurationFilePath: un JSON con endpoint (empieza por http) y pass. |
Initialize(url, pass) | Descarga y descifra con valores explícitos. |
Read(key) | El valor de la clave o cadena vacía. |
Parameters | El diccionario completo. |
ConfigurationFilePath | Ruta del JSON local con endpoint y pass. |
EnableEnvironmentVariableForConsole(nombre) | En consola, pide la ruta del JSON por terminal y la guarda en esa variable de entorno de usuario si no estaba. |
HealthCheck() | Descarga y descifra, y devuelve true si trae al menos una clave. Registra el fallo en el log. |
Un fallo de descarga, de descifrado o de JSON (o que falte la URL o la contraseña) lanza InvalidOperationException con la causa. Captúrala al arrancar y para el proceso: sin secretos, la app no debe seguir.
Los secretos que Dinaup guarda por ti (claves API, credenciales de integraciones) están en Vault en tu cuenta.