AWS Systems Manager (SSM) Parameter Store In .NET 3.1 Web API

Step 9

Add Amazon.Extensions.Configuration.SystemsManager NuGet package.

Step 10

Create a static class with the name "ConfigurationExtensions".

Consider the namespaces.

using Amazon;
using Amazon.Extensions.NETCore.Setup;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using System;
using System.Diagnostics.CodeAnalysis;
using System.IO;

Open ConfigurationExtensions.cs file and add the following code snippet as shown below. As you already created a custom class and added an extension method in IWebHostBuilder. We can call it directly in program.cs.

using Amazon;
using Amazon.Extensions.NETCore.Setup;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using System;
using System.Diagnostics.CodeAnalysis;
using System.IO;

namespace AWSParametersStoreNETAPIDemo
{
    public static class ConfigurationExtensions
    {
        public static IConfiguration AppSetting { get; }
        static ConfigurationExtensions()
        {
            AppSetting = new ConfigurationBuilder()
                    .SetBasePath(Directory.GetCurrentDirectory())
                    .AddJsonFile("appsettings.json")
                    .Build();
        }

        public static IWebHostBuilder UseDefaultSettings(this IWebHostBuilder builder)
        {
            var environmentName = "dev"; // AppSetting["ASPNETCORE_ENVIRONMENT"];
            builder.UseEnvironment(environmentName).ConfigureAppConfiguration((a, b) => a.ConfigureAppConfiguration(b));
            return builder;
        }
        public static IConfigurationBuilder UseDefaultSettingsConfigBuilder(this IConfigurationBuilder builder)
        {
            var environmentName = Environment.GetEnvironmentVariable("Development");
            builder.AddSystemsManager(source =>
            {
                source.AwsOptions = new AWSOptions()
                {
                    Region = RegionEndpoint.USEast1
                };
                source.Optional = true;
                source.Path = "wms_dev";
            });
            return builder;
        }
        
        private static void ConfigureAppConfiguration(this WebHostBuilderContext hostingContext, IConfigurationBuilder builder)
        {
            if (!hostingContext.HostingEnvironment.IsDevelopment())
            {
                builder.AddSystemsManager(configureSource =>
                {
                    var env = hostingContext.HostingEnvironment;
                    configureSource.Optional = true;
                    // Parameter Store prefix to pull configuration data from.
                    configureSource.Path = $"/{env.EnvironmentName}/{"wms"}/";

                    // Reload configuration data every 15 minutes.
                    configureSource.ReloadAfter = TimeSpan.FromMinutes(15);
                });
            }
        }
    }
}

Step 11

Open Program.cs file and add the following code snippet as shown below.

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

namespace AWSParametersStoreNETAPIDemo
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseDefaultSettings()
                    .UseStartup<Startup>();
                });
    }
}

NOTE

The parameter name ("/dev/myapp") and RegionEndPoint should be coming from Environment variables (Region = RegionEndpoint.GetBySystemName("us-west-2")), or it should be dynamic instead of hard-code values in a production environment.

Step 12

Open ValuesController.cs file and replace the code with the following as shown below.

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using System.Collections.Generic;
namespace AWSParametersStoreNETAPIDemo.Controllers {
    public class ValuesController: ControllerBase {
        private readonly IConfiguration _configuration;
        public ValuesController(IConfiguration configuration) {
            _configuration = configuration;
        }
        public IEnumerable < string > Get() {
            // Grab the value from SSM parmeters and use it through out the project using IConfiguration
            var connectionString = _configuration.GetValue < string > ("ConnectionString");
            var BucketName = _configuration.GetValue < string > ("BucketName");
            var EC2Name = _configuration.GetValue < string > ("EC2Name");
            return new string[] {
                connectionString,
                BucketName,
                EC2Name
            };
        }
    }
}

Task 3. Testing

In this task, you will see how to test the API to retrieve the values from the Parameter store.

Hit F5 to run the API locally, and Swagger will be displayed. Expand /api/values and click Try it out. Click Execute to get the response as shown below.

Task 4. Clean up resources

Delete all the resources to ensure you're not charged for any services you aren't using.

Summary

This article describes how to access all the parameters from AWS Systems Manager (SSM) Parameter store in .NET 3.1 Web API.