Dela via

Självstudie: Ansluta en webbapp till Azure App Configuration med Service Connector

  • Artikel

Lär dig hur du ansluter en ASP.NET Core-app som körs i Azure App Service till Azure App Configuration med någon av följande metoder:

  • Systemtilldelad hanterad identitet (SMI)
  • Användartilldelad hanterad identitet (UMI)
  • Tjänstens huvudnamn
  • Connection string

I den här självstudien använder du Azure CLI för att utföra följande uppgifter:

  • Ställa in Azure-resurser
  • Skapa en anslutning mellan en webbapp och appkonfiguration
  • Skapa och distribuera din app till Azure App Service

Förutsättningar

Logga in på Azure

Kör az login i Azure CLI för att logga in på Azure.

Ställa in Azure-resurser

Börja med att skapa dina Azure-resurser.

  1. Klona följande exempeldatabas:

    git clone https://github.com/Azure-Samples/serviceconnector-webapp-appconfig-dotnet.git

  2. Distribuera webbappen till Azure

    Följ de här stegen för att skapa en App Service och distribuera exempelappen. Kontrollera att du har rollen Prenumerationsdeltagare eller Ägare.

    Skapa en apptjänst och distribuera exempelappen som använder systemtilldelad hanterad identitet för att interagera med App Config.

    # Change directory to the SMI sample
cd serviceconnector-webapp-appconfig-dotnet\system-managed-identity

# Create a web app

LOCATION='eastus'
RESOURCE_GROUP_NAME='service-connector-tutorial-rg'
APP_SERVICE_NAME='webapp-appconfig-smi'

az webapp up --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME
    Parameter Description Exempel
    Plats Välj en plats nära dig. Använd az account list-locations --output table för att lista platser. eastus
    Namn på resursgrupp Du använder den här resursgruppen för att organisera alla Azure-resurser som behövs för att slutföra den här självstudien. service-connector-tutorial-rg
    Apptjänstens namn Apptjänstnamnet används som namnet på resursen i Azure och för att bilda det fullständigt kvalificerade domännamnet för din app, i form av serverslutpunkten https://<app-service-name>.azurewebsites.com. Det här namnet måste vara unikt för alla Azure och de enda tillåtna tecknen är A-Z,-09 och .- webapp-appconfig-smi

  3. Skapa ett Azure App Configuration Store

    APP_CONFIG_NAME='my-app-config'

az appconfig create -g $RESOURCE_GROUP_NAME -n $APP_CONFIG_NAME --sku Free -l eastus

  4. Importera testkonfigurationsfilen till Azure App Configuration.

    Importera testkonfigurationsfilen till Azure App Configuration med hjälp av en systemtilldelad hanterad identitet.

    1. Cd till mappen ServiceConnectorSample

    2. Importera konfigurationsfilen ./sampleconfigs.json test till App Configuration Store. Om du använder Cloud Shell laddar du upp sampleconfigs.json innan du kör kommandot.

      az appconfig kv import -n $APP_CONFIG_NAME --source file --format json --path ./sampleconfigs.json --separator : --yes

Ansluta webbappen till App Configuration

Skapa en anslutning mellan webbappen och appkonfigurationsarkivet.

Skapa en anslutning mellan webbprogrammet och appkonfigurationsarkivet med hjälp av en systemtilldelad hanterad identitetsautentisering. Den här anslutningen görs via Service Connector.

az webapp connection create appconfig -g $RESOURCE_GROUP_NAME -n $APP_SERVICE_NAME --app-config $APP_CONFIG_NAME --tg $RESOURCE_GROUP_NAME --connection "app_config_smi" --system-identity

system-identity refererar till den systemtilldelade autentiseringstypen för hanterad identitet (SMI). Service Connector stöder också följande autentiseringar: användartilldelad hanterad identitet (UMI), anslutningssträng (hemlighet) och tjänstens huvudnamn.

Verifiera anslutningen

  1. Om du vill kontrollera om anslutningen fungerar går du till webbappen i https://<myWebAppName>.azurewebsites.net/ från webbläsaren. När webbplatsen är igång visas "Hello" (Hej). Din Azure WebApp är ansluten till App Configuration by ServiceConnector now".

Hur det fungerar

Se nedan vad Service Connector hanterar i bakgrunden för varje autentiseringstyp.

Service Connector hanterar anslutningskonfigurationen åt dig:

  • Konfigurera webbappens AZURE_APPCONFIGURATION_ENDPOINT för att låta programmet komma åt den och hämta appkonfigurationsslutpunkten. Få åtkomst till exempelkod.
  • Aktivera webbappens systemtilldelade hanterade autentisering och ge App Configuration en dataläsarroll så att programmet kan autentiseras till appkonfigurationen med hjälp av DefaultAzureCredential från Azure.Identity. Få åtkomst till exempelkod.

Mer information finns i Interna serviceanslutningsprogram.

Test (valfritt)

Du kan också göra följande tester:

  1. Uppdatera värdet för nyckeln SampleApplication:Settings:Messages i App Configuration Store.

    az appconfig kv set -n <myAppConfigStoreName> --key SampleApplication:Settings:Messages --value hello --yes

  2. Gå till din Azure-webbapp genom att gå till https://<myWebAppName>.azurewebsites.net/ och uppdatera sidan. Du ser att meddelandet har uppdaterats till "hello".

Rensa resurser

När du är klar tar du bort dem genom att köra az group delete kommandot om du inte längre ska använda dessa Azure-resurser. Det här kommandot tar bort resursgruppen och alla resurser i den.

az group delete -n <myResourceGroupName> --yes

Nästa steg

Följ självstudierna nedan om du vill veta mer om Service Connector.

Lär dig mer om begrepp för Service Connector