Compartir a través de

Tutorial: Conexión de una aplicación web a Azure App Configuration con conector de servicio

Obtenga información sobre cómo conectar una aplicación de ASP.NET Core que se ejecuta en Azure App Service, a Azure App Configuration, mediante uno de los métodos siguientes:

  • Identidad administrada asignada por el sistema (SMI)
  • Identidad administrada asignada por el usuario (UMI)
  • Entidad de servicio
  • Cadena de conexión

En este tutorial, se usa la CLI de Azure para completar las tareas siguientes:

  • Configuración de los recursos de Azure
  • Creación de una conexión entre una aplicación web y App Configuration
  • Compilación e implementación de la aplicación en Azure App Service

Prerequisites

Inicio de sesión en Azure

Ejecute az login en la CLI de Azure para iniciar sesión en Azure.

Configuración de los recursos de Azure

Empiece por crear los recursos de Azure.

  1. Clone el siguiente repositorio de ejemplo:

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

  2. Implemente la aplicación web en Azure.

    Siga estos pasos para crear una instancia de App Service e implementar la aplicación de ejemplo. Asegúrese de que tiene el rol Colaborador o Propietario de la suscripción.

    Cree un servicio de aplicaciones e implemente la aplicación de ejemplo que usa la identidad administrada asignada por el sistema para interactuar con 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 Example
    Location Elija una ubicación cercana a usted. Use az account list-locations --output table para enumerar ubicaciones. eastus
    Definición de un nombre de grupo de recursos Use este grupo de recursos para organizar todos los recursos de Azure necesarios para completar este tutorial. service-connector-tutorial-rg
    Nombre de App Service El nombre del servicio de aplicaciones se usa como nombre del recurso en Azure y para formar el nombre de dominio completo de la aplicación, en forma del punto de conexión del servidor. Los caracteres permitidos son A-Z, 0-9 y -. Azure anexa una cadena aleatoria para que el punto de conexión del servidor sea único en todas las instancias de Azure. webapp-appconfig-smi

  3. Cree un almacén de Azure App Configuration.

    APP_CONFIG_NAME='my-app-config'

az appconfig create --resource-group $RESOURCE_GROUP_NAME --name $APP_CONFIG_NAME --sku Free --location eastus

  4. Importe el archivo de configuración de prueba en Azure App Configuration.

    Importe el archivo de configuración de prueba en Azure App Configuration mediante una identidad administrada asignada por el sistema.

    1. Cambie los directorios a la carpeta ServiceConnectorSample.

    2. Importe el archivo de configuración de prueba ./sampleconfigs.json en el almacén de App Configuration. Si usa Cloud Shell, cargue sampleconfigs.json antes de ejecutar el comando.

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

Conexión de la aplicación web a App Configuration

Cree una conexión entre la aplicación web y el almacén de App Configuration.

Cree una conexión entre la aplicación web y el almacén de App Configuration, mediante una autenticación de identidad administrada asignada por el sistema. Esta conexión se realiza mediante el conector de servicio.

az webapp connection create appconfig --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME --app-config $APP_CONFIG_NAME --tg $RESOURCE_GROUP_NAME --connection "app_config_smi" --system-identity

system-identity hace referencia al tipo de autenticación de identidad administrada asignada por el sistema (SMI). Service Connector también admite las siguientes autenticaciones: identidad administrada asignada por el usuario (UMI), cadena de conexión (secreto) y entidad de servicio.

Validación de la conexión

Para comprobar si la conexión funciona, vaya a la aplicación web. La manera más fácil de llegar a la aplicación web es abrirla en Azure Portal. En la página Información general , seleccione el dominio predeterminado. Una vez que el sitio web esté en marcha, verá que aparece: Hola. Azure WebApp está conectado a App Configuration por ServiceConnector ahora.

Funcionamiento

Descubra lo que Service Connector administra en segundo plano para cada tipo de autenticación.

El conector de servicio administra la configuración de conexión de forma automática:

  • Configure el valor AZURE_APPCONFIGURATION_ENDPOINT de la aplicación web para permitir que acceda a él y obtenga el punto de conexión de App Configuration. Obtener acceso al código de ejemplo.
  • Active la autenticación administrada asignada por el sistema de la aplicación web y conceda a App Configuration un rol lector de datos para permitir que la aplicación se autentique en App Configuration mediante DefaultAzureCredential de Azure Identity. Obtener acceso al código de ejemplo.

Para más información, consulte Información interna de Service Connector.

Prueba (opcional)

Opcionalmente, realice las pruebas siguientes:

  1. Actualice el valor de la clave SampleApplication:Settings:Messages en el almacén de App Configuration.

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

  2. Vaya a la aplicación web de Azure, como se ha descrito anteriormente y actualice la página. Verá que el mensaje se actualiza a: hello.

Limpieza de recursos

Una vez que haya terminado, si ya no va a usar estos recursos de Azure, elimínelos mediante la ejecución del az group delete comando . Este comando elimina el grupo de recursos y todos los recursos que contiene.

az group delete --name <myResourceGroupName> --yes

Paso siguiente

Más información sobre los conceptos de Service Connector

  • Last updated on