AWSSecretsManager.Provider 1.3.7-preview.18

AWSSecretsManager.Provider

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, 9, 10, and 11 (plus netstandard2.0)
• ✅ Converted to use System.Text.Json only
• ✅ Refactored structure for better modern SDK usage
• ✅ Comprehensive logging, batch fetch, and polling/reload support
• ✅ Published as a new NuGet package: AWSSecretsManager.Provider

🔧 Quick Start

dotnet add package AWSSecretsManager.Provider

using AWSSecretsManager.Provider;
using Microsoft.Extensions.Configuration;

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. See Authentication & Security for details.

📖 Documentation

The full documentation site covers installation, every configuration option, secret-to-key mapping rules, batch fetch and polling, authentication/IAM, LocalStack, troubleshooting, and the complete API reference:

👉 layeredcraft.github.io/aws-secrets-manager-provider

🤖 AI Coding Agent Skill

This repo ships a downloadable Agent Skill that teaches AI coding agents to use this package correctly:

npx skills add LayeredCraft/aws-secrets-manager-provider

See docs/agent-skill.md or the skill source at skills/aws-secrets-manager-provider/.

📚 Samples

The repository includes comprehensive samples demonstrating different usage patterns:

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

To preview the documentation site locally:

uv sync
uv run mkdocs serve

🙌 Acknowledgments

This project is based on the excellent work by Renato Golia and inspired by the broader .NET and AWS developer community.

📄 License

This project is licensed under the MIT License.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

<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 />_{<b>Nick Cipollina</b>}</a><br /><a href="https://github.com/LayeredCraft/aws-secrets-manager-provider/commits?author=ncipollina" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/ransagy"><img src="https://avatars.githubusercontent.com/u/6785058?v=4?s=100" width="100px;" alt="Ran Sagy"/><br />_{<b>Ran Sagy</b>}</a><br /><a href="https://github.com/LayeredCraft/aws-secrets-manager-provider/commits?author=ransagy" title="Code">💻</a></td> </tr> </tbody> </table>

This project follows the all-contributors specification. Contributions of any kind welcome!