https://github.com/scottaddie/ondotnetconfiguration
A sample ASP.NET Core 5.0 Blazor Server app to accompany the On .NET episodes
https://github.com/scottaddie/ondotnetconfiguration
aspnetcore azure-app-configuration azure-app-service azure-identity azure-key-vault azure-signalr-service dotnet
Last synced: about 1 month ago
JSON representation
A sample ASP.NET Core 5.0 Blazor Server app to accompany the On .NET episodes
- Host: GitHub
- URL: https://github.com/scottaddie/ondotnetconfiguration
- Owner: scottaddie
- License: mit
- Created: 2021-02-02T19:04:15.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-05-15T00:53:39.000Z (about 4 years ago)
- Last Synced: 2025-03-30T23:12:50.330Z (2 months ago)
- Topics: aspnetcore, azure-app-configuration, azure-app-service, azure-identity, azure-key-vault, azure-signalr-service, dotnet
- Language: C#
- Homepage:
- Size: 270 KB
- Stars: 18
- Watchers: 2
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OnDotNetConfiguration
A sample ASP.NET Core 5.0 Blazor Server app to accompany [Secretless apps with .NET and Azure Key Vault](https://channel9.msdn.com/Shows/On-NET/Secretless-apps-with-NET-and-Azure-Key-Vault).
## Prerequisites
- Yahoo Finance API key from [RapidAPI](https://rapidapi.com/apidojo/api/yahoo-finance1/pricing)
- [.NET SDK 5.0](https://dotnet.microsoft.com/download/dotnet/5.0) or later
- [Azure subscription](https://azure.microsoft.com/free/dotnet/)
## 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 `` with your API key. Save the file.
```json
{
"StockOptions": {
"ApiKey": ""
}
}
```
- If not using Visual Studio, replace `` in the following command with your API key. Run the command from the directory containing the *BlazorServerConfiguration.csproj* file.
```bash
dotnet user-secrets set "StockOptions:ApiKey" ""
```
### Azure resources
To run the project in Azure, complete the following steps:
1. Deploy the app to Azure App Service.
1. Provision an Azure SignalR Service instance with a **Service Mode** of **Default**.
1. Provision an Azure Key Vault instance.
1. 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=;Version=1.0;`.|
|`StockOptions--ApiKey` |The API key obtained from RapidAPI.|
1. Apply the following changes in App Service:
1. In **Settings** > **Identity**, enable a System-assigned managed identity via the **Status** toggle button.
1. In **Settings** > **Configuration** > **General settings**:
1. In the **Stack settings** section:
1. Select **.NET** from the **Stack** drop-down list.
1. Select **.NET 5** from the **.NET version** drop-down list.
1. In the **Platform settings** section, select **On** for the **Web sockets** and **ARR affinity** radio buttons.
1. 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
- [Safe storage of app secrets in development in ASP.NET Core](https://docs.microsoft.com/aspnet/core/security/app-secrets)
- [Azure Key Vault's official docs](https://docs.microsoft.com/azure/key-vault/general)
- [Azure Key Vault configuration provider in ASP.NET Core](https://docs.microsoft.com/aspnet/core/security/key-vault-configuration)
- [Tutorial: Use a managed identity to connect Key Vault to an Azure web app in .NET](https://docs.microsoft.com/azure/key-vault/general/tutorial-net-create-vault-azure-web-app)