{"id":19921127,"url":"https://github.com/hossambarakat/awsparameterstore.microsoft.extensions.configuration","last_synced_at":"2025-05-03T06:31:18.205Z","repository":{"id":50053159,"uuid":"129823509","full_name":"hossambarakat/AwsParameterStore.Microsoft.Extensions.Configuration","owner":"hossambarakat","description":"AWS Systems Manager Parameter Store configuration provider implementation for Microsoft.Extensions.Configuration.","archived":false,"fork":false,"pushed_at":"2024-09-03T21:41:14.000Z","size":34,"stargazers_count":4,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-04T23:35:27.235Z","etag":null,"topics":["aspnet-core","aspnetcore","aws","aws-ec2","csharp","dotnet","dotnetcore"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hossambarakat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-17T00:39:39.000Z","updated_at":"2022-10-06T09:26:53.000Z","dependencies_parsed_at":"2023-01-19T11:46:08.400Z","dependency_job_id":null,"html_url":"https://github.com/hossambarakat/AwsParameterStore.Microsoft.Extensions.Configuration","commit_stats":null,"previous_names":["hossambarakat/configuration.awsparameterstore"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossambarakat%2FAwsParameterStore.Microsoft.Extensions.Configuration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossambarakat%2FAwsParameterStore.Microsoft.Extensions.Configuration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossambarakat%2FAwsParameterStore.Microsoft.Extensions.Configuration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossambarakat%2FAwsParameterStore.Microsoft.Extensions.Configuration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hossambarakat","download_url":"https://codeload.github.com/hossambarakat/AwsParameterStore.Microsoft.Extensions.Configuration/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252154738,"owners_count":21702983,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aspnet-core","aspnetcore","aws","aws-ec2","csharp","dotnet","dotnetcore"],"created_at":"2024-11-12T22:06:45.170Z","updated_at":"2025-05-03T06:31:15.410Z","avatar_url":"https://github.com/hossambarakat.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"AwsParameterStore.Microsoft.Extensions.Configuration\n===============\n\n[![Build Status](https://ci.appveyor.com/api/projects/status/loosxok30ptwjeei?svg=true)](https://ci.appveyor.com/project/HossamBarakat/configuration-awsparameterstore)\n\n [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) configuration provider implementation for [Microsoft.Extensions.Configuration](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/index?view=aspnetcore-2.1\u0026tabs=basicconfiguration).\n\n## Getting Started\n\nYou should install AwsParameterStore.Microsoft.Extensions.Configuration with [NuGet](https://www.nuget.org/packages/AwsParameterStore.Microsoft.Extensions.Configuration):\n\n    Install-Package AwsParameterStore.Microsoft.Extensions.Configuration\n\nOr via the .NET Core command line interface:\n\n    dotnet add package AwsParameterStore.Microsoft.Extensions.Configuration\n\nThe provider is added to the `ConfigurationBuilder` using the `AddAwsParameterStore ` extension. The default method accepts one parameter `path` which is the prefix of the parameter store hierarchy.\n\n```csharp\n    configrationBuilder.AddAwsParameterStore(\"/prefix\");\n```\n\n## Hierarchical Parameters Names Mapping\nParameter Store supports parameter hierarchy. The Hierarchical values use \"/\" as a separator such as \"/DeploymentConfig/Prod/FleetHealth\". ASP.NET Core configuration normally uses colon as separator so before adding the values to the configuration we swap the forward slash \"/\" with colon.\n\n## Credentials\nBy default, AWS Access Key ID and AWS Secret Access Key are discovered from environment variables `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` respectively.\n\n## Required Permissions\nAn AWS IAM account with `ssm:GetParametersByPath` permission.\n\n## Reloading secrets\nSecrets are cached until IConfigurationRoot.Reload() is called. Expired, disabled, and updated secrets in the key vault are not respected by the application until Reload is executed.\n\n```csharp\n    Configuration.Reload();\n```\n\n## Additional resources\n- [Configuration in ASP.NET Core](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/index?view=aspnetcore-2.1\u0026tabs=basicconfiguration)\n- [AWS Systems Manager Parameter Store Documentation](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html)\n- [GetParametersByPath API](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParametersByPath.html)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossambarakat%2Fawsparameterstore.microsoft.extensions.configuration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhossambarakat%2Fawsparameterstore.microsoft.extensions.configuration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossambarakat%2Fawsparameterstore.microsoft.extensions.configuration/lists"}