Quickstart: Azure Spring Apps verbinden met databases en services met Service Connector

Ga aan de slag met Service Connector om uw Azure Spring Apps te verbinden met databases, opslagaccounts en andere Azure-services. Service Connector vereenvoudigt verificatie en configuratie, zodat u verbinding kunt maken met resources met behulp van andere verificatiemethoden voor beheerde identiteiten.

Dit artikel bevat stapsgewijze instructies voor zowel Azure Portal als Azure CLI. Kies de gewenste methode met behulp van de bovenstaande tabbladen.

Notitie

De Basic, Standarden Enterprise--plannen zijn op 17 maart 2025 buiten gebruik gesteld. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Vereisten

• Een Azure-account met een actief abonnement. Maak gratis een Azure-account.
• Een app die is geïmplementeerd in Azure Spring Apps in een regio die wordt ondersteund door Service Connector.
• Een doelresource waarmee Azure Spring Apps kan worden verbonden. Bijvoorbeeld een Azure Key Vault.
• De benodigde machtigingen voor het maken en beheren van serviceverbindingen.

• Een Azure-account met een actief abonnement. Maak gratis een Azure-account.
• Een app die is geïmplementeerd in Azure Spring Apps in een regio die wordt ondersteund door Service Connector.
• Een doelresource waarmee Azure Spring Apps kan worden verbonden. Bijvoorbeeld een Azure Key Vault.
• De benodigde machtigingen voor het maken en beheren van serviceverbindingen.

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container uit te voeren. Voor meer informatie, zie Hoe de Azure CLI in een Docker-container uit te voeren.

  • Als je een lokale installatie gebruikt, meld je dan aan bij de Azure CLI met behulp van de az login opdracht. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Versie 2.37.0 of hoger van de Azure CLI. Als u wilt upgraden naar de nieuwste versie, voert u az upgrade uit. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.
• De Azure Spring Apps-extensie moet zijn geïnstalleerd in de Azure CLI of de Cloud Shell. Voer az extension add --name spring uit om het te installeren.

Eerste installatie

1. Als u Service Connector voor het eerst gebruikt, begint u met de opdracht az provider register om de Service Connector resource provider te registreren.

   az provider register -n Microsoft.ServiceLinker
   

   Aanbeveling

   U kunt controleren of de resourceprovider al is geregistreerd door de opdracht az provider show -n "Microsoft.ServiceLinker" --query registrationStateuit te voeren. Als de uitvoer is Registered, is serviceconnector al geregistreerd.

2. Voer desgewenst de volgende opdracht uit om een lijst met ondersteunde doelservices voor Azure Spring Apps op te halen.

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

   Aanbeveling

   Als de az spring opdracht niet wordt herkend door het systeem, controleert u of u de vereiste extensie hebt geïnstalleerd door uit te voeren az extension add --name spring.

Een serviceverbinding maken

Gebruik ServiceConnector om een beveiligde serviceverbinding te maken tussen uw Azure Spring Apps en Azure Blob Storage. In dit voorbeeld ziet u hoe u verbinding maakt met Blob Storage, maar u kunt hetzelfde proces gebruiken voor andere ondersteunde Azure-services.

1. Selecteer de zoekbalk resources, services en documenten (G +/) boven aan Azure Portal, typ Azure Spring Apps in het filter en selecteer Azure Spring Apps.

   

2. Selecteer de naam van het Azure Spring Apps-exemplaar dat u wilt verbinden met een doelresource.

3. Selecteer onder Instellingen de optie Apps en selecteer de toepassing in de lijst.

   

4. Selecteer Serviceconnector in het servicemenu en selecteer Maken.

5. Selecteer of voer op het tabblad Basis de volgende instellingen in.

   Instelling	Voorbeeld	Beschrijving
   Servicetype	Key Vault	Het type service waarmee u uw app gaat verbinden.
   Verbindingsnaam	keyvault_17d38	De verbindingsnaam waarmee de verbinding tussen uw app en de doelservice wordt geïdentificeerd. Gebruik de verbindingsnaam die is opgegeven door serviceconnector of voer uw eigen verbindingsnaam in.
   Abonnement	mijn abonnement	Het abonnement dat uw doelservice bevat (de service waarmee u verbinding wilt maken). De standaardwaarde is het abonnement dat de app bevat die is geïmplementeerd in Azure Spring Apps.
   Key Vault	my-keyvault-name	De doelsleutelkluis waarmee u verbinding wilt maken. Als u een ander servicetype kiest, selecteert u het bijbehorende doelservice-exemplaar.
   Clienttype	SpringBoot	De toepassingsstack die werkt met de geselecteerde doelservice. Naast SpringBoot en Java worden ook andere stacks ondersteund.

6. Selecteer Volgende: Verificatie om het verificatietype te selecteren. U wordt aangeraden een door het systeem toegewezen beheerde identiteit te gebruiken om verbinding te maken met uw Key Vault.

   

7. Selecteer Volgende: Netwerken om de netwerkconfiguratie te selecteren en firewallregels configureren om toegang tot de doelservice in te schakelen, zodat uw app de Blob Storage kan bereiken.

   

8. Kies Volgende: Controleren + Aanmaken om de opgegeven informatie te controleren. Wacht enkele seconden totdat de serviceconnector de gegevens heeft gevalideerd en selecteer Maken om de serviceverbinding te maken.

Voer de az spring connection create opdracht uit om een toepassing die is geïmplementeerd in Azure Spring Apps te verbinden met een Blob Storage-resource, met een door het systeem toegewezen beheerde identiteit. U kunt deze opdracht op twee verschillende manieren uitvoeren:

• Genereer stap voor stap de nieuwe verbinding.

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

• Genereer de nieuwe verbinding tegelijk. Vervang de tijdelijke aanduidingen door uw eigen gegevens: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>, <app>, , <target-subscription>, , en <target_resource_group><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
  

Aanbeveling

Als u geen Blob Storage-account hebt, voert u az spring connection create storage-blob --new --system-identity uit om er een aan te maken en het te verbinden met uw toepassing die met een beheerde identiteit wordt gehost in Azure Spring Apps.

Verbindingsreeks

Waarschuwing

Microsoft raadt u aan de veiligste verificatiestroom te gebruiken die beschikbaar is. De verificatiestroom die in deze procedure wordt beschreven, vereist een zeer hoge mate van vertrouwen in de toepassing en brengt risico's met zich mee die niet aanwezig zijn in andere stromen. U moet deze stroom alleen gebruiken wanneer andere veiligere stromen, zoals beheerde identiteiten, niet haalbaar zijn.

Voer de az spring connection create opdracht uit om een toepassing die is geïmplementeerd in Azure Spring Apps te verbinden met een Blob Storage-resource, met een verbindingsreeks. U kunt deze opdracht op twee verschillende manieren uitvoeren:

• Genereer stap voor stap de nieuwe verbinding.

  az spring connection create storage-blob --secret
  

• Genereer de nieuwe verbinding tegelijk. Vervang de tijdelijke aanduidingen door uw eigen gegevens: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>, <app>, , <target-subscription><target_resource_group>, <account>, , , <secret-name>en <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>
  

Aanbeveling

Als u geen Blob Storage-account hebt, voert u az spring connection create storage-blob --new --secret uit om er een te maken en het te verbinden met uw toepassing die wordt gehost op Azure Spring Apps met behulp van een verbindingsstring.

Serviceverbindingen weergeven

Azure Spring Apps-verbindingen worden weergegeven onder Instellingen > Serviceconnector.

1. Selecteer > deze optie om de lijst uit te vouwen en toegang te krijgen tot de eigenschappen die vereist zijn voor uw toepassing.

2. Selecteer Valideren om de verbindingsstatus te controleren en selecteer Meer informatie om de details van de verbindingsvalidatie te bekijken.

   

Voer de opdracht uit az spring connection list om alle ingerichte verbindingen van Uw Azure Spring Apps weer te geven.

Vervang de tijdelijke aanduidingen <azure-spring-apps-resource-group>, <azure-spring-apps-resource-name> en <app-name> in de onderstaande opdracht met uw eigen gegevens. U kunt ook de --output table optie verwijderen om meer informatie over uw verbindingen weer te geven.

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

In de uitvoer wordt ook de inrichtingsstatus van uw verbindingen weergegeven.

Verwante inhoud

Raadpleeg de onderstaande handleidingen voor meer informatie over Service Connector en Azure Spring Apps:

• Handleiding: Azure Spring Apps + MySQL
• Handleiding: Azure Spring Apps + Apache Kafka op Confluent Cloud