/OnDotNetConfiguration

A sample ASP.NET Core 5.0 Blazor Server app to accompany the On .NET episodes

Primary LanguageC#MIT LicenseMIT

OnDotNetConfiguration

A sample ASP.NET Core 5.0 Blazor Server app to accompany Secretless apps with .NET and Azure Key Vault.

Prerequisites

Setup

Local development machine

Before running the project on your machine, store the API key using one of the following approaches:

  • If using Visual Studio, right-click the BlazorServerConfiguration project in Solution Explorer and select Manage User Secrets. Add the following snippet to the secrets.json file, replacing <API_KEY> with your API key. Save the file.

     {
 	"StockOptions": {
 	"ApiKey": "<API_KEY>"
 	}
 }

  • If not using Visual Studio, replace <API_KEY> in the following command with your API key. Run the command from the directory containing the BlazorServerConfiguration.csproj file.

     dotnet user-secrets set "StockOptions:ApiKey" "<API_KEY>"

Azure resources

To run the project in Azure, complete the following steps:

  1. Deploy the app to Azure App Service.

  2. Provision an Azure SignalR Service instance with a Service Mode of Default.

  3. Provision an Azure Key Vault instance.

  4. In the Key Vault instance, navigate to Settings > Secrets. Create the following secrets by selecting Generate/Import.

    Name Value
    Azure--SignalR--ConnectionString The primary or secondary SignalR Service connection string found at Settings > Keys. For example, Endpoint=https://blazorserverconfigsignalr.service.signalr.net;AccessKey=<ACCESS_KEY>;Version=1.0;.
    StockOptions--ApiKey The API key obtained from RapidAPI.

  5. Apply the following changes in App Service:

    1. In Settings > Identity, enable a System-assigned managed identity via the Status toggle button.
    2. In Settings > Configuration > General settings:
      1. In the Stack settings section:
        1. Select .NET from the Stack drop-down list.
        2. Select .NET 5 from the .NET version drop-down list.
      2. In the Platform settings section, select On for the Web sockets and ARR affinity radio buttons.
    3. In Settings > Configuration > Application settings, select New application setting. Create a new environment variable named KEYVAULT_ENDPOINT whose value is the Key Vault resource's URI (e.g., https://blazorserverconfigvault.vault.azure.net/).

Related resources