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

Introducción a Service Connector para conectar Azure Spring Apps 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.

Nota:

Los planes Básico, Estándar y Enterprise entraron en un período de retirada el 17 de marzo de 2025. Para más información, consulte el anuncio de retirada de Azure Spring Apps.

Requisitos previos

Una cuenta de Azure con una suscripción activa. Cree una cuenta de Azure de forma gratuita.
Una aplicación implementada para Azure Spring Apps en una región compatible con Service Connector.
Un recurso de destino al que conectar Azure Spring Apps. Por ejemplo, una instancia de Azure Key Vault.
Los permisos necesarios para crear y administrar conexiones de servicio.

Una cuenta de Azure con una suscripción activa. Cree una cuenta de Azure de forma gratuita.
Una aplicación implementada para Azure Spring Apps en una región compatible con Service Connector.
Un recurso de destino al que conectar Azure Spring Apps. Por ejemplo, una instancia de Azure Key Vault.
Los permisos necesarios para crear y administrar conexiones de servicio.

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
- Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.
- En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.
- Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Versión 2.37.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.
La extensión de Azure Spring Apps debe instalarse en la CLI de Azure o cloud Shell. Para instalarlo, ejecute az extension add --name spring.

Configuración inicial

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 se ha registrado.
Opcionalmente, ejecute el siguiente comando para obtener una lista de los servicios de destino admitidos para Azure Spring Apps.
```
az spring connection list-support-types --output table
```
Sugerencia

Si el sistema no reconoce el az spring comando, compruebe que ha instalado la extensión necesaria ejecutando az extension add --name spring.

Creación de una conexión de servicio

Use Service Connector para crear una conexión de servicio segura entre Azure Spring Apps 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.

Seleccione la barra de búsqueda Buscar recursos, servicios y documentos (G +/) en la parte superior de Azure Portal, escriba Azure Spring Apps en el filtro y seleccione Azure Spring Apps.
Seleccione el nombre de la instancia de Azure Spring Apps que quiere conectar a un recurso de destino.
En Configuración, seleccione Aplicaciones y, a continuación, seleccione la aplicación en la lista.
Seleccione Service Connector en el menú del servicio y seleccione Crear.

En la pestaña Aspectos básicos , seleccione o escriba la siguiente configuración. Captura de pantalla de Azure Portal; rellene la información básica para crear una conexión.

Configuración	Ejemplo	Descripción
Tipo de servicio.	Almacén de claves	Tipo de servicio que va a conectar a la aplicación.
Nombre de la conexión	keyvault_17d38	El nombre de conexión que identifica la conexión entre la aplicación y el servicio de destino. Use el nombre de conexión proporcionado por Service Connector o introduzca su propio nombre de conexión.
Suscripción	my-subscription	La suscripción que contiene el servicio de destino (el servicio al que quiere conectarse). El valor predeterminado es la suscripción que contiene la aplicación implementada en Azure Spring Apps.
Almacén de claves	my-keyvault-name	Key Vault de destino al que quiere conectarse. Si elige otro tipo de servicio, seleccione la instancia del servicio de destino correspondiente.
Tipo de cliente	SpringBoot	Pila de aplicaciones que funciona con el servicio de destino seleccionado. Además de SpringBoot y Java, también se admiten otras pilas.

Seleccione Siguiente: Autenticación para seleccionar el tipo de autenticación. Se recomienda usar una identidad administrada asignada por el sistema para conectarse a Key Vault.
Seleccione Siguiente: Redes para seleccionar la configuración de red y Configurar reglas de firewall para habilitar el acceso al servicio de destino, de manera que la aplicación pueda acceder a Blob Storage.
Seleccione Siguiente: Revisar y crear para revisar la información proporcionada. Espere unos segundos para que el conector de servicio valide la información y seleccione Crear para crear la conexión de servicio.

Identidad administrada (recomendada)
Cadena de conexión

Ejecute el az spring connection create comando para conectar una aplicación implementada en Azure Spring Apps a un recurso de Blob Storage, con una identidad administrada asignada por el sistema. Puede ejecutar este comando de dos maneras diferentes:

Genere la nueva conexión paso a paso.

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

Genere la nueva conexión de inmediato. Reemplace los marcadores de posición por su propia información: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource><app>, <target-subscription>, , <target_resource_group>y <account>.

   az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --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 spring connection create storage-blob --new --system-identity para crear una y conectarla a la aplicación hospedada en Azure Spring Apps mediante una identidad administrada.

Advertencia

Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación que se describe en este procedimiento requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

Ejecute el az spring connection create comando para conectar una aplicación implementada en Azure Spring Apps a un recurso de Blob Storage, con cadena de conexión. Puede ejecutar este comando de dos maneras diferentes:

Genere la nueva conexión paso a paso.

az spring connection create storage-blob --secret

Genere la nueva conexión de inmediato. Reemplace los marcadores de posición por su propia información: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>, <app>, <target-subscription>, <target_resource_group>, <account>, <secret-name> y <secret>.

az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
    --secret name=<secret-name> secret=<secret>

Sugerencia

Si no tiene una cuenta de Blob Storage, ejecute az spring connection create storage-blob --new --secret para crear una y conectarla a la aplicación hospedada en Azure Spring Apps mediante una cadena de conexión.

Ver conexiones de servicio

Las conexiones de Azure Spring Apps se muestran en Configuración > Conector de servicio.

Seleccione > para desplegar la lista y acceder a las propiedades requeridas por su aplicación.
Seleccione Validar para realizar la comprobación del estado de la conexión y seleccione Más información para revisar los detalles de validación de la conexión.

Ejecute az spring connection list el comando para enumerar todas las conexiones aprovisionadas de Azure Spring Apps.

Reemplace los marcadores de posición <azure-spring-apps-resource-group>, <azure-spring-apps-resource-name> y <app-name> del siguiente comando por su propia información. También puede quitar la --output table opción para ver más información sobre las conexiones.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-resource-name> --app <app-name> --output table

La salida también muestra el estado de aprovisionamiento de las conexiones.

Consulte las guías siguientes para obtener más información sobre Service Connector y Azure Spring Apps:

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-08-19