diff options
author | vnugent <public@vaughnnugent.com> | 2024-03-09 14:52:04 -0500 |
---|---|---|
committer | vnugent <public@vaughnnugent.com> | 2024-03-09 14:52:04 -0500 |
commit | bdf7c1bc36dbcc9f66f5caa344602817f888c49d (patch) | |
tree | d0a041e7545712e2a0e33aca362dee93b19973b5 /lib/VNLib.Plugins.Extensions.Loading/src/Secrets/IHCVaultClient.cs | |
parent | 5d8614d205b7bdca56684a3cc5a08db90e3804b6 (diff) |
Squashed commit of the following:
commit 7a263bf54b7967ddeb9f6b662339ec1c74546ce8
Author: vnugent <public@vaughnnugent.com>
Date: Sat Mar 9 14:19:31 2024 -0500
refactor: Overhaul secret loading. Remove VaultSharp as a dep
commit 766e179d110db4f955fffce55f2b0ad41c139179
Author: vnugent <public@vaughnnugent.com>
Date: Wed Mar 6 21:35:35 2024 -0500
refactor: changed how service constructors are invoked, moved routing
Diffstat (limited to 'lib/VNLib.Plugins.Extensions.Loading/src/Secrets/IHCVaultClient.cs')
-rw-r--r-- | lib/VNLib.Plugins.Extensions.Loading/src/Secrets/IHCVaultClient.cs | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/lib/VNLib.Plugins.Extensions.Loading/src/Secrets/IHCVaultClient.cs b/lib/VNLib.Plugins.Extensions.Loading/src/Secrets/IHCVaultClient.cs new file mode 100644 index 0000000..aab2541 --- /dev/null +++ b/lib/VNLib.Plugins.Extensions.Loading/src/Secrets/IHCVaultClient.cs @@ -0,0 +1,64 @@ +/* +* Copyright (c) 2024 Vaughn Nugent +* +* Library: VNLib +* Package: VNLib.Plugins.Extensions.Loading +* File: IHCVaultClient.cs +* +* IHCVaultClient.cs is part of VNLib.Plugins.Extensions.Loading which is +* part of the larger VNLib collection of libraries and utilities. +* +* VNLib.Plugins.Extensions.Loading is free software: you can redistribute it and/or modify +* it under the terms of the GNU Affero General Public License as +* published by the Free Software Foundation, either version 3 of the +* License, or (at your option) any later version. +* +* VNLib.Plugins.Extensions.Loading is distributed in the hope that it will be useful, +* but WITHOUT ANY WARRANTY; without even the implied warranty of +* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +* GNU Affero General Public License for more details. +* +* You should have received a copy of the GNU Affero General Public License +* along with this program. If not, see https://www.gnu.org/licenses/. +*/ + +using System; +using System.Net.Http; +using System.Threading.Tasks; + +namespace VNLib.Plugins.Extensions.Loading +{ + /// <summary> + /// A Hashicorp Vault client for reading secrets from a vault server + /// </summary> + public interface IHCVaultClient + { + /// <summary> + /// Reads a single KeyValue secret from the vault server asyncrhonously and returns the result + /// or null if the secret does not exist + /// </summary> + /// <param name="path">The path to the item within the store</param> + /// <param name="mountPoint">The vault mount points</param> + /// <param name="secretName">The name of the secret within the property array to retrieve</param> + /// <returns>The secret wrapper if found, null otherwise</returns> + /// <exception cref="ArgumentException"></exception> + /// <exception cref="ArgumentNullException"></exception> + /// <exception cref="HCVaultException"></exception> + /// <exception cref="HttpRequestException"></exception> + Task<ISecretResult?> ReadSecretAsync(string path, string mountPoint, string secretName); + + /// <summary> + /// Reads a single KeyValue secret from the vault server syncrhonously and returns the result + /// or null if the secret does not exist + /// </summary> + /// <param name="path">The path to the item within the store</param> + /// <param name="mountPoint">The vault mount points</param> + /// <param name="secretName">The name of the secret within the property array to retrieve</param> + /// <returns>The secret wrapper if found, null otherwise</returns> + /// <exception cref="ArgumentException"></exception> + /// <exception cref="ArgumentNullException"></exception> + /// <exception cref="HCVaultException"></exception> + /// <exception cref="HttpRequestException"></exception> + ISecretResult? ReadSecret(string path, string mountPoint, string secretName); + } +} |