AWSSSM.Provider
1.4.0-preview.22
dotnet add package AWSSSM.Provider --version 1.4.0-preview.22
NuGet\Install-Package AWSSSM.Provider -Version 1.4.0-preview.22
<PackageReference Include="AWSSSM.Provider" Version="1.4.0-preview.22" />
<PackageVersion Include="AWSSSM.Provider" Version="1.4.0-preview.22" />
<PackageReference Include="AWSSSM.Provider" />
paket add AWSSSM.Provider --version 1.4.0-preview.22
#r "nuget: AWSSSM.Provider, 1.4.0-preview.22"
#:package AWSSSM.Provider@1.4.0-preview.22
#addin nuget:?package=AWSSSM.Provider&version=1.4.0-preview.22&prerelease
#tool nuget:?package=AWSSSM.Provider&version=1.4.0-preview.22&prerelease
AWSSSM.Provider
An AWS SSM Parameter Store-backed configuration provider for Microsoft.Extensions.Configuration, from the LayeredCraft/aws-secrets-manager-provider project.
It loads parameters under a hierarchy path from AWS SSM Parameter Store and maps them to configuration keys, with optional background polling for changes.
Looking for AWS Secrets Manager instead? Use the sibling package
AWSSecretsManager.Provider.
✨ Features
- ✅ Targeted to .NET 8, 9, 10, and 11 (plus
netstandard2.0) - ✅ Official Native AOT support on
net8.0and later - ✅ Hierarchical parameter loading via
GetParametersByPath(recursive by default) - ✅ Automatic JSON flattening of
StringandSecureStringparameter values - ✅ Optional background polling for parameter changes
- ✅ Comprehensive structured logging
- ✅ Parameter filtering and custom key generation
- ✅ Familiar API:
AddSsmParametersmirrorsAddSecretsManageroverloads (plain /ILogger<TProvider>/ILoggerFactory)
🔧 Quick Start
dotnet add package AWSSSM.Provider
using AWSSSM.Provider;
using Microsoft.Extensions.Configuration;
var builder = new ConfigurationBuilder();
builder.AddSsmParameters(configurator: options => options.Path = "/MyApp");
var config = builder.Build();
Console.WriteLine("Db Host: " + config["Db:Host"]);
A parameter /MyApp/Db/Host maps to the configuration key Db:Host. Your application must have AWS credentials available through the default AWS SDK mechanisms.
🔒 Important
Recursive defaults to true and Path is a hierarchy prefix. Setting Path = "/" loads every parameter in the account/region that the caller's IAM policy permits — keep the path narrow and the IAM permissions scoped. See the SSM Parameter Store docs for key-mapping rules, filtering, polling, and LocalStack/Floci examples.
📖 Documentation
👉 layeredcraft.github.io/aws-secrets-manager-provider
📄 License
This project is licensed under the MIT License.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net11.0 is compatible. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- AWSSDK.Core (>= 4.0.102.3)
- AWSSDK.SimpleSystemsManagement (>= 4.0.103.7)
- LayeredCraft.StructuredLogging (>= 1.2.4)
- Microsoft.Extensions.Configuration (>= 8.0.0 && < 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3 && < 9.0.0)
- System.Text.Json (>= 8.0.6 && < 9.0.0)
-
net10.0
- AWSSDK.Core (>= 4.0.102.3)
- AWSSDK.SimpleSystemsManagement (>= 4.0.103.7)
- LayeredCraft.StructuredLogging (>= 1.2.4)
- Microsoft.Extensions.Configuration (>= 10.0.10 && < 11.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.10 && < 11.0.0)
-
net11.0
- AWSSDK.Core (>= 4.0.102.3)
- AWSSDK.SimpleSystemsManagement (>= 4.0.103.7)
- LayeredCraft.StructuredLogging (>= 1.2.4)
- Microsoft.Extensions.Configuration (>= 11.0.0-preview.6.26359.118 && < 12.0.0-a)
-
net8.0
- AWSSDK.Core (>= 4.0.102.3)
- AWSSDK.SimpleSystemsManagement (>= 4.0.103.7)
- LayeredCraft.StructuredLogging (>= 1.2.4)
- Microsoft.Extensions.Configuration (>= 8.0.0 && < 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3 && < 9.0.0)
-
net9.0
- AWSSDK.Core (>= 4.0.102.3)
- AWSSDK.SimpleSystemsManagement (>= 4.0.103.7)
- LayeredCraft.StructuredLogging (>= 1.2.4)
- Microsoft.Extensions.Configuration (>= 9.0.18 && < 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.18 && < 10.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.4.0-preview.22 | 37 | 9/10/2026 |
| 1.4.0-preview.21 | 35 | 9/10/2026 |
| 1.4.0-preview.20 | 41 | 9/9/2026 |
| 1.4.0-preview.19 | 42 | 9/8/2026 |