Snabbstart: Ansluta Azure Spring Apps till databaser och tjänster med Service Connector

2025-08-19

Kom igång med Service Connector för att ansluta dina Azure Spring Apps till databaser, lagringskonton och andra Azure-tjänster. Service Connector förenklar autentisering och konfiguration så att du kan ansluta till resurser med hjälp av hanterade identiteter, andra autentiseringsmetoder.

Den här artikeln innehåller stegvisa instruktioner för både Azure-portalen och Azure CLI. Välj önskad metod med hjälp av flikarna ovan.

Kommentar

Planerna Basic, Standardoch Enterprise gick in i en pensionsperiod den 17 mars 2025. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa ett Azure-konto kostnadsfritt.
En app som distribueras till Azure Spring Apps i en region som stöds av Service Connector.
En målresurs att ansluta Azure Spring Apps till. Till exempel ett Azure Key Vault.
Nödvändiga behörigheter för att skapa och hantera tjänstanslutningar.

Ett Azure-konto med en aktiv prenumeration. Skapa ett Azure-konto kostnadsfritt.
En app som distribueras till Azure Spring Apps i en region som stöds av Service Connector.
En målresurs att ansluta Azure Spring Apps till. Till exempel ett Azure Key Vault.
Nödvändiga behörigheter för att skapa och hantera tjänstanslutningar.

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör Azure CLI i en Docker-container.
- Om du använder en lokal installation, logga in på Azure CLI genom att använda kommandot az login. För att avsluta autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.
- När du blir uppmanad, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.
- Kör az version för att ta reda på versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Version 2.37.0 eller senare av Azure CLI. Om du vill uppgradera till den senaste versionen kör du az upgrade. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.
Azure Spring Apps-tillägget måste installeras i Azure CLI eller Cloud Shell. Installera det genom att köra az extension add --name spring.

Inledande installation

Om du använder Service Connector för första gången börjar du med att köra kommandot az provider register för att registrera resursprovidern för Service Connector.
```
az provider register -n Microsoft.ServiceLinker
```
Tips/Råd

Du kan kontrollera om resursprovidern redan har registrerats genom att köra kommandot az provider show -n "Microsoft.ServiceLinker" --query registrationState. Om utdata är Registeredhar Service Connector redan registrerats.
Du kan också köra följande kommando för att hämta en lista över måltjänster som stöds för Azure Spring Apps.
```
az spring connection list-support-types --output table
```
Tips/Råd

az spring Om kommandot inte känns igen av systemet kontrollerar du att du har installerat det nödvändiga tillägget genom att köra az extension add --name spring.

Skapa en tjänstanslutning

Använd Service Connector för att skapa en säker tjänstanslutning mellan dina Azure Spring Apps och Azure Blob Storage. Det här exemplet visar hur du ansluter till Blob Storage, men du kan använda samma process för andra Azure-tjänster som stöds.

Välj sökfältet Sök efter resurser, tjänster och dokument (G +/) överst i Azure-portalen, skriv Azure Spring Apps i filtret och välj Azure Spring Apps.
Välj namnet på den Azure Spring Apps-instans som du vill ansluta till en målresurs.
Under Inställningar väljer du Appar och väljer programmet i listan.
Välj Tjänstanslutning på tjänstmenyn och välj Skapa.

På fliken Grundläggande inställningar väljer eller anger du följande inställningar. Skärmbild av Azure Portal, fyll i grundläggande information för att skapa en anslutning.

Inställning	Exempel	beskrivning
Typ av tjänst	密钥保管��	Vilken typ av tjänst du ska ansluta din app till.
Anslutningens namn	keyvault_17d38	Anslutningsnamnet som identifierar anslutningen mellan din app och måltjänsten. Använd anslutningsnamnet som tillhandahålls av Service Connector eller ange ditt eget anslutningsnamn.
Abonnemang	my-subscription	Den prenumeration som innehåller måltjänsten (den tjänst som du vill ansluta till). Standardvärdet är den prenumeration som innehåller appen som distribuerats till Azure Spring Apps.
Nyckelvalv	my-keyvault-name	Det nyckelvalv du vill ansluta till. Om du väljer en annan tjänsttyp väljer du motsvarande måltjänstinstans.
Klienttyp	SpringBoot	Programstacken som fungerar med den valda måltjänsten. Förutom SpringBoot och Java stöds även andra staplar.

Välj Nästa: Autentisering för att välja autentiseringstyp. Vi rekommenderar att du använder en systemtilldelad hanterad identitet för att ansluta till ditt Key Vault.
Välj Nästa: Nätverk för att välja nätverkskonfiguration och välj Konfigurera brandväggsregler för att aktivera åtkomst till måltjänsten så att din app kan nå Blob Storage.
Välj Nästa: Granska + Skapa för att granska den angivna informationen. Vänta några sekunder tills Service Connector verifierar informationen och välj Skapa för att skapa tjänstanslutningen.

Hanterad identitet (rekommenderas)
Anslutningssträng

az spring connection create Kör kommandot för att ansluta ett program som distribuerats till Azure Spring Apps till en Blob Storage-resurs med en systemtilldelad hanterad identitet. Du kan köra det här kommandot på två olika sätt:

Generera den nya anslutningen steg för steg.

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

Generera den nya anslutningen samtidigt. Ersätt platshållarna med din egen information: , , , , , och <source-subscription><source_resource_group>. <azure-spring-apps-resource><app><target-subscription><target_resource_group><account>

   az containerapp 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

Tips/Råd

Om du inte har något Blob Storage-konto kör az spring connection create storage-blob --new --system-identity du för att skapa ett och ansluta det till ditt program som finns i Azure Spring Apps med hjälp av en hanterad identitet.

Varning

Microsoft rekommenderar att du använder det säkraste tillgängliga autentiseringsflödet. Det autentiseringsflöde som beskrivs i den här proceduren kräver mycket stort förtroende för programmet och medför risker som inte finns i andra flöden. Du bör bara använda det här flödet när andra säkrare flöden, till exempel hanterade identiteter, inte är livskraftiga.

az spring connection create Kör kommandot för att ansluta ett program som distribuerats till Azure Spring Apps till en Blob Storage-resurs med anslutningssträng. Du kan köra det här kommandot på två olika sätt:

Generera den nya anslutningen steg för steg.

az spring connection create storage-blob --secret

Generera den nya anslutningen samtidigt. Ersätt platshållarna med din egen information: , , , , , , <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>och <app>. <target-subscription><target_resource_group><account><secret-name><secret>

az containerapp 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>

Tips/Råd

Om du inte har något Blob Storage-konto kör az spring connection create storage-blob --new --secret du för att skapa ett och anslut det till ditt program som finns i Azure Spring Apps med hjälp av en anslutningssträng.

Visa tjänstanslutningar

Azure Spring Apps-anslutningar visas under Inställningar > Tjänstanslutning.

Välj > för att expandera listan och få åtkomst till de egenskaper som krävs av ditt program.
Välj Verifiera för att kontrollera anslutningsstatusen och välj Läs mer om du vill granska information om anslutningsverifiering.

Kör az spring connection list kommandot för att visa alla dina Azure Spring Apps-etablerade anslutningar.

Ersätt platshållarna <azure-spring-apps-resource-group>, <azure-spring-apps-resource-name>och <app-name> från kommandot nedan med din egen information. Du kan också ta bort --output table alternativet för att visa mer information om dina anslutningar.

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

Utdata visar även etableringstillståndet för dina anslutningar.

Mer information om Service Connector och Azure Spring Apps finns i guiderna nedan:

Feedback

Var den här sidan till hjälp?