Compartir a través de

Inicio rápido: Conexión de Azure App Service a bases de datos y servicios con Service Connector

Introducción a Service Connector para conectar Azure App Service a bases de datos, cuentas de almacenamiento y otros servicios de Azure. Service Connector simplifica la autenticación y la configuración, lo que le permite conectarse a recursos mediante identidades administradas otros métodos de autenticación.

En este artículo se proporcionan instrucciones paso a paso para Azure Portal y la CLI de Azure. Elija su método preferido con las pestañas anteriores.

Requisitos previos

  • Este inicio rápido requiere la versión 2.30.0 o posterior de la CLI de Azure. Para actualizar a la versión más reciente, ejecute az upgrade. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.

Configuración inicial

  1. Si usa Service Connector por primera vez, empiece ejecutando el comando az provider register para registrar el proveedor de recursos de Service Connector.

    az provider register -n Microsoft.ServiceLinker

    Sugerencia

    Puede comprobar si el proveedor de recursos ya se ha registrado ejecutando el comando az provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la salida es Registered, Service Connector ya está registrado.

  2. Opcionalmente, use el comando az webapp connection list-support-types de la CLI de Azure para obtener una lista de los servicios de destino admitidos para App Service.

    az webapp connection list-support-types --output table

Creación de una conexión de servicio en App Service

Use Service Connector para crear una conexión de servicio entre Azure App Service y Azure Blob Storage. En este ejemplo se muestra cómo conectarse a Blob Storage, pero puede usar el mismo proceso para otros servicios de Azure compatibles.

  1. Seleccione la barra de búsqueda Buscar recursos, servicios y documentos (G +/) en la parte superior de Azure Portal, escriba App Services y seleccione App Services.

    Captura de pantalla de Azure Portal con la opción App Services seleccionada.

  2. Seleccione el recurso de App Service que quiere conectarse a un recurso de destino.

  3. Seleccione SettingsService Connector (>) en el menú del servicio. Seleccione Crear.

    Captura de pantalla de Azure Portal, con la opción Service Connector seleccionada para crear una conexión nueva.

  4. En la pestaña Aspectos básicos , seleccione o escriba la siguiente configuración.

    Configuración Ejemplo Descripción
    Tipo de servicio. Storage: blob El tipo de servicio de destino. Si no cuenta con un almacenamiento de Microsoft Blob Storage, puede crear uno o usar otro tipo de servicio.
    Nombre de la conexión my_connection El nombre de conexión que identifica la conexión entre App Service y el servicio de destino. Use el nombre de conexión proporcionado por Service Connector o elija su propio nombre de conexión.
    Suscripción Mi suscripción La suscripción en la que se encuentra el servicio de destino (es decir, el servicio al que desea conectarse). El valor predeterminado es la suscripción para este recurso de App Service.
    Cuenta de almacenamiento my_storage_account La cuenta de almacenamiento de destino a la que desea conectarse. Las instancias de servicio de destino entre las que elegir varían según el tipo de servicio seleccionado.
    Tipo de cliente La misma pila de aplicación de esta instancia de App Service El valor predeterminado procede de la pila en tiempo de ejecución de App Service. Seleccione la pila de aplicaciones que se encuentra en esta instancia de App Service.

  5. Seleccione Siguiente: Autenticación para elegir un método de autenticación.

    La identidad administrada asignada por el sistema es la opción de autenticación recomendada. Seleccione Identidad administrada asignada por el sistema para conectarse a través de una identidad generada en Microsoft Entra ID y vinculada al ciclo de vida de la instancia de servicio.

  6. Seleccione Siguiente: Redes para configurar el acceso de red al servicio de destino y seleccione Configurar reglas de firewall para habilitar el acceso al servicio de destino.

  7. Seleccione Siguiente: Revisar y crear para revisar la información proporcionada. Después, seleccione Crear para crear la conexión de servicio. Esta operación puede tardar un minuto en completarse.

Ejecute el comando az webapp connection create para crear una conexión de servicio desde App Service a Blob Storage con una identidad administrada asignada por el sistema. Puede ejecutar este comando de dos maneras:

  • Genere la nueva conexión paso a paso:

    az webapp connection create storage-blob --system-identity

  • Genere la nueva conexión a la vez. Reemplace los marcadores de posición por su propia información: <source-subscription>, <source_resource_group>, <webapp>, <target-subscription>, <target_resource_group>y <account>.

    az webapp connection create storage-blob \
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.Web/sites/<webapp> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Sugerencia

Si no tiene una cuenta de Blob Storage, ejecute az webapp connection create storage-blob --new --system-identity para crear una y conectarla a App Service mediante una identidad administrada.

Visualización de conexiones de App Service

  1. Una vez creada correctamente la conexión, la página Conector de servicio muestra las conexiones existentes de App Service.

  2. Haga clic en el botón > para expandir la lista y ver las variables de entorno que necesita el código de la aplicación. Seleccione Valor oculto para ver el valor oculto.

    Captura de Azure Portal, visualización de los detalles de la conexión.

  3. Seleccione Validar para comprobar la conexión. Seleccione Más información para ver los detalles de validación de conexión en el panel de la derecha.

    Captura de pantalla de Azure Portal, validación de la conexión.

Visualización de conexiones de App Service

Ejecute el comando az webapp connection de la CLI de Azure para enumerar las conexiones a App Service y proporcione la siguiente información:

  • Nombre del grupo de recursos que contiene App Service
  • Nombre de App Service
az webapp connection list --resource-group "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Contenido relacionado

Siga los tutoriales siguientes para empezar a compilar su propia aplicación con Service Connector.

  • Last updated on