DGates.AwsSecretsManager.Examples

Example applications demonstrating integration of the DGates.AwsSecretsManager library into .NET Framework 4.8 apps.

NuGet

dotnet add package DGates.AwsSecretsManager

Install-Package DGates.AwsSecretsManager

Package page: https://www.nuget.org/packages/DGates.AwsSecretsManager

Examples

ConsoleExample

Minimal wiring demo — reads a typed secret from LocalStack, demonstrates cache invalidation, force refresh, and cache hit logging.

MvcExample

ASP.NET MVC app using SecretsManagerServiceFactory for DI. Search a city to see live weather data from OpenWeatherMap, with the API key retrieved from AWS Secrets Manager — a "how this worked" panel shows the secret name, retrieved URL, and source (AWS Secrets Manager, LocalStack, or a local JSON fallback) for the fetch that just happened.

Platform note: MvcExample targets classic ASP.NET MVC 5 (System.Web.Mvc), which requires IIS/IIS Express to host. It builds on any platform with the .NET SDK, but only runs on Windows (Visual Studio or IIS Express). See docs/LOCAL_DEV.md for a Docker-free fallback.

Local Development

See docs/LOCAL_DEV.md for prerequisites and setup steps.

Quick start:

docker-compose up

Then run ConsoleExample from Visual Studio or the dotnet CLI, or run MvcExample via IIS Express/Visual Studio (Windows only — see the platform note above).

No Docker available? See Running examples without Docker for a JSON-file fallback.

Library

• Library repo: https://github.com/dgates82/DGates.AwsSecretsManager
• Examples repo: https://github.com/dgates82/DGates.AwsSecretsManager.Examples

License

MIT