AWSSecretsManager.Provider — nugetz
LayeredCraft/ AWSSecretsManager.Provider v1.1.9.25 .NET 8.0 .NET 9.0 .NET 10.0 .NET Std2.0
An AWS Secrets Manager-backed configuration provider for .NET applications using Microsoft.Extensions.Configuration.
Get Started dotnet CLI PackageReference Package Manager
$ dotnet add package AWSSecretsManager.ProviderReadme AWSSecretsManager.Provider
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<!-- ALL-CONTRIBUTORS-BADGE:END -->
This is a modern, community-maintained fork of Kralizek/AWSSecretsManagerConfigurationExtensions , originally developed by Renato Golia.
It provides a configuration provider for Microsoft.Extensions.Configuration that loads secrets from AWS Secrets Manager .
🚀 What's New in This Fork
✅ Targeted to .NET 8 and .NET 9
✅ Converted to use
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ncipollina"><img src="https://avatars.githubusercontent.com/u/1405469?v=4?s=100" width="100px;" alt="Nick Cipollina"/><br /><sub><b>Nick Cipollina</b></sub></a><br /><a href="https://github.com/LayeredCraft/aws-secrets-manager-provider/commits?author=ncipollina" title="Code">💻</a></td>
</tr>
</tbody>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
System.Text.Json
✅ Refactored structure for better modern SDK usage
✅ NEW : Comprehensive logging support with ILogger integration
🔧 Usage
ASP.NET Core Example public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureAppConfiguration((context, config) =>
{
config.AddSecretsManager(); // 👈 AWS Secrets Manager integration
})
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup<Startup>();
});
}
Console App Example static void Main(string[] args)
{
var builder = new ConfigurationBuilder();
builder.AddSecretsManager();
var config = builder.Build();
Console.WriteLine("Secret: " + config["MySecret"]);
}
Your application must have AWS credentials available through the default AWS SDK mechanisms. Learn more here:AWS SDK Credential Config
📋 Logging Support The provider includes comprehensive logging support for better observability:
// Using ILoggerFactory (recommended)
using var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());
builder.Configuration.AddSecretsManager(
loggerFactory,
configurator: options => options.PollingInterval = TimeSpan.FromMinutes(5));
// Using explicit ILogger
var logger = loggerFactory.CreateLogger<SecretsManagerConfigurationProvider>();
builder.Configuration.AddSecretsManager(
logger,
configurator: options => options.PollingInterval = TimeSpan.FromMinutes(5));
Information : Key operations (loading, reloading, polling status)Debug : Batch processing details and secret countsTrace : Individual secret processing and change detectionWarning : Polling errors and missing secrets (when ignored)Error : Failed operations with full context [Information] Loading secrets from AWS Secrets Manager
[Debug] Fetching 15 secrets in 1 batches
[Information] Successfully loaded 47 configuration keys in 1,234ms
[Information] Starting secret polling with interval 00:05:00
🔒 Configuration Options This provider supports several customization options, including:
Credentials : Pass your own credentials if needed.Region : Customize the AWS region.Filtering : Control which secrets are loaded via filters or explicit allow lists.Key generation : Customize how configuration keys are named.Version stage : Set version stages for secrets.Logging : Full logging support with ILogger integration for observability.LocalStack support : Override ServiceUrl for local testing.
📚 Samples The repository includes comprehensive samples demonstrating different usage patterns:
Sample Description Key Features Sample1 Basic Usage Default credentials, default region, all secrets Sample2 Region Configuration Custom AWS region specification Sample3 Credential Profiles Using named AWS credential profiles Sample4 Secret Filtering Loading specific secrets by ARN allowlist Sample5 Custom Key Generation Transforming configuration key names (e.g., uppercase) Sample6 Custom Client Factory Advanced AWS client configuration Sample7 Advanced Logging Comprehensive logging, polling, and monitoring SampleWeb ASP.NET Core Web application integration with endpoints
Each sample includes a detailed README with usage examples, prerequisites, and explanations. See the complete samples overview for setup instructions and learning progression.
📦 Installation dotnet add package AWSSecretsManager.Provider
✅ Building Locally This repo is built with the standard .NET SDK:
dotnet build
dotnet test
🙌 Acknowledgments This project is based on the excellent work by Renato Golia and inspired by the broader .NET and AWS developer community.
📄 License
Contributors ✨ Thanks goes to these wonderful people (emoji key ):
This project follows the all-contributors specification. Contributions of any kind welcome!
Compatibility .NET 8.0
.NET 9.0
.NET 10.0
.NET Std2.0
Versions 1.1.9.25 Latest
Feb 11, 2026 Other versions (16) 
