Share via

Esercitazione: Connessione un'app Web per app Azure configurazione con service Connessione or

  • Articolo

Informazioni su come connettere un'app ASP.NET Core in esecuzione in app Azure Service a app Azure Configuration usando uno dei metodi seguenti:

  • Identità gestita assegnata dal sistema
  • Identità gestita assegnata dall'utente (UMI)
  • Entità servizio
  • Connection string

In questa esercitazione usare l'interfaccia della riga di comando di Azure per completare le attività seguenti:

  • Configurare le risorse di Azure
  • Creare una connessione tra un'app Web e Configurazione app
  • Compilare e distribuire l'app nel servizio app Azure

Prerequisiti

Accedere ad Azure

Eseguire az login nell'interfaccia della riga di comando di Azure per accedere ad Azure.

Configurare le risorse di Azure

Per iniziare, creare le risorse di Azure.

  1. Clonare il repository di esempio seguente:

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

  2. Distribuire l'app Web in Azure

    Seguire questa procedura per creare un servizio app e distribuire l'app di esempio. Assicurarsi di avere il ruolo Collaboratore sottoscrizione o Proprietario.

    Creare un servizio app e distribuire l'app di esempio che usa l'identità gestita assegnata dal sistema per interagire con Configurazione app.

    # 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
    Parametro Descrizione Esempio
    Ufficio Selezionare una località nelle vicinanze. Usare az account list-locations --output table per elencare le posizioni. eastus
    Nome gruppo di risorse Questo gruppo di risorse verrà usato per organizzare tutte le risorse di Azure necessarie per completare questa esercitazione. service-connector-tutorial-rg
    Nome del servizio app Il nome del servizio app viene usato come nome della risorsa in Azure e per formare il nome di dominio completo per l'app, sotto forma di endpoint https://<app-service-name>.azurewebsites.comserver . Questo nome deve essere univoco in tutti Azure e gli unici caratteri consentiti sono A-Z,-09 e .- webapp-appconfig-smi

  3. Creare un archivio di configurazione app Azure

    APP_CONFIG_NAME='my-app-config'

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

  4. Importare il file di configurazione di test in app Azure Configurazione.

    Importare il file di configurazione di test in app Azure Configurazione usando un'identità gestita assegnata dal sistema.

    1. Cd nella cartella ServiceConnectorSample

    2. Importare il file di configurazione di test ./sampleconfigs.json nell'archivio Configurazione app. Se si usa Cloud Shell, caricare sampleconfigs.json prima di eseguire il comando.

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

Connessione l'app Web per Configurazione app

Creare una connessione tra l'applicazione Web e l'archivio Configurazione app.

Creare una connessione tra l'applicazione Web e l'archivio Configurazione app usando un'autenticazione dell'identità gestita assegnata dal sistema. Questa connessione viene eseguita tramite service Connessione or.

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 fa riferimento al tipo di autenticazione SMI (System-Assigned Managed Identity). Service Connessione or supporta anche le autenticazioni seguenti: identità gestita assegnata dall'utente (UMI), stringa di connessione (segreto) e entità servizio.

Convalidare la connessione

  1. Per verificare se la connessione funziona, passare all'app Web dal https://<myWebAppName>.azurewebsites.net/ browser. Una volta che il sito Web è in esecuzione, verrà visualizzato "Hello. L'app Web di Azure è connessa a Configurazione app dal servizio Connessione or".

Funzionamento

Di seguito sono riportati i Connessione or del servizio gestiti in background per ogni tipo di autenticazione.

Service Connessione or gestisce automaticamente la configurazione della connessione:

  • Configurare l'app Web per consentire all'applicazione AZURE_APPCONFIGURATION_ENDPOINT di accedervi e ottenere l'endpoint Configurazione app. Accedere al codice di esempio.
  • Attivare l'autenticazione gestita assegnata dal sistema dell'app Web e concedere Configurazione app un ruolo lettore dati per consentire all'applicazione di eseguire l'autenticazione al Configurazione app usando DefaultAzureCredential da Azure.Identity. Accedere al codice di esempio.

Per altre informazioni, vedere Service Connessione or internals (Elementi interni di Service Connessione or).

Test (facoltativo)

Facoltativamente, eseguire i test seguenti:

  1. Aggiornare il valore della chiave SampleApplication:Settings:Messages nel Configurazione app Store.

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

  2. Passare all'app Web di Azure passando a https://<myWebAppName>.azurewebsites.net/ e aggiornando la pagina. Si noterà che il messaggio viene aggiornato a "hello".

Pulire le risorse

Al termine, se non si useranno più queste risorse di Azure, eliminarle eseguendo il az group delete comando . Questo comando elimina il gruppo di risorse e tutte le risorse al suo interno.

az group delete -n <myResourceGroupName> --yes

Passaggi successivi

Seguire le esercitazioni elencate di seguito per altre informazioni su Service Connessione or.

Informazioni sui concetti di Service Connessione or