Quickstart: Azure Container Apps verbinden met databases en services met Service Connector (preview)

Ga aan de slag met Service Connector om uw Azure Container 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 beheerde identiteiten of andere verificatiemethoden.

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

Belangrijk

Ondersteuning voor Service Connector (preview) in Azure Container Apps eindigt op 30 maart 2026. Na die datum zijn nieuwe serviceverbindingen met serviceconnector (preview) niet beschikbaar via een interface. Zie RETIREMENT: Service Connector (preview) in Azure Container Apps voor meer informatie.

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Een toepassing die is geïmplementeerd in Container Apps in een regio die wordt ondersteund door Service Connector.
Een doelresource om uw Container Apps te verbinden met, zoals een Blob Storage-account.
De benodigde machtigingen voor het maken en beheren van serviceverbindingen.

Een Azure-account met een actief abonnement. Gratis een account maken
Een toepassing die is geïmplementeerd in Container Apps in een regio die wordt ondersteund door Service Connector.
Een doelresource om uw Container Apps te verbinden met, zoals een Blob Storage-account.
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.

Voor deze quickstart is versie 2.30.0 of hoger van de Azure CLI vereist. Als u wilt upgraden naar de nieuwste versie, voert u uit . Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

Uw omgeving instellen

Als u serviceconnector voor het eerst gebruikt, start u met de opdracht az provider register om de serviceconnectorresourceprovider 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.
Voer desgewenst de opdracht az containerapp connection list-support-types uit om een lijst met ondersteunde doelservices voor Container Apps op te halen.
```
az containerapp connection list-support-types --output table
```

Een serviceverbinding maken (preview)

Gebruik serviceconnector om een serviceverbinding te maken tussen uw Azure Container 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.

Selecteer de zoekbalk resources, services en documenten (G +/) boven aan de Azure-portal, typ Container Apps in het filter en selecteer Container Apps.
Selecteer de naam van de Container Apps-resource die u wilt verbinden met een doelresource.
Selecteer Service Connector (preview) in de linker zijbalk van de inhoudsopgave. Selecteer vervolgens Maken.

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

Instelling	Voorbeeld	Beschrijving
Container	my-container-app	De container in uw container-app.
Servicetype	Opslag - Blob	Het type service dat u wilt verbinden met uw container-app.
Abonnement	mijn abonnement	Het abonnement met de service waarmee u verbinding wilt maken. De standaardwaarde is het abonnement dat deze container-app bevat.
Verbindingsnaam	storageblob_700ae	De verbindingsnaam waarmee de verbinding tussen uw container-app en de doelservice wordt geïdentificeerd. Gebruik de verbindingsnaam die is opgegeven door Service Connector of kies uw eigen verbindingsnaam.
Opslagaccount	my-storage-account	Het doelopslagaccount waarmee u verbinding wilt maken. Als u een ander servicetype kiest, selecteert u het bijbehorende doelservice-exemplaar.
Clienttype	.NET	De toepassingsstack die werkt met de doelservice die u hebt geselecteerd. De standaardwaarde is Geen, waarmee een lijst met configuraties wordt gegenereerd. Als u de app-stack of client-SDK in de geselecteerde app-SDK kent, selecteert u dezelfde app-stack voor het clienttype.

Selecteer Volgende: Verificatie om een verificatiemethode te kiezen: door het systeem toegewezen beheerde identiteit (SMI), door de gebruiker toegewezen beheerde identiteit (UMI), verbindingsreeks of service-principal.
Selecteer Door het systeem toegewezen beheerde identiteit om verbinding te maken via een identiteit die automatisch wordt gegenereerd in Microsoft Entra-id en is gekoppeld aan de levenscyclus van het service-exemplaar. Dit is de aanbevolen verificatieoptie.
Selecteer door de gebruiker toegewezen beheerde identiteit om te verifiëren via een zelfstandige identiteit die is toegewezen aan een of meer exemplaren van een Azure-service. Selecteer een abonnement dat een door de gebruiker toegewezen beheerde identiteit bevat en selecteer vervolgens de identiteit.

Als u nog geen door de gebruiker toegewezen beheerde identiteit hebt, maakt u er een:
1. Open het Azure-platform op een nieuw tabblad en zoek naar beheerde identiteiten.
2. Selecteer Beheerde identiteiten en selecteer Maken.
3. Voer een abonnement, resourcegroep, regio en instantienaam in.
4. Selecteer Beoordelen en maken en vervolgens Maken
5. Zodra uw beheerde identiteit is geïmplementeerd, gaat u terug naar het tabblad Serviceconnector, selecteert u Vorige en vervolgens Volgende om de gegevens van het formulier te vernieuwen. Selecteer onder Door de gebruiker toegewezen beheerde identiteit de identiteit die u hebt gemaakt.
Zie Een door de gebruiker toegewezen beheerde identiteit maken voor meer informatie.
1. Selecteer Service-principal om een service-principal te gebruiken die het toegangsbeleid en de machtigingen voor de gebruiker/toepassing in Microsoft Entra ID definieert.
2. Selecteer een service-principal in de lijst en voer een geheim in
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.

Selecteer Verbindingsreeks om een of meerdere sleutel-waardeparen met pure geheimen of tokens te genereren of te configureren.
Selecteer Volgende: Netwerken om de netwerkconfiguratie te selecteren en firewallregels configureren om toegang tot de doelservice in te schakelen , zodat uw container-app toegang heeft tot Blob Storage.
Selecteer Volgende: Controleren + Maken om de opgegeven informatie te controleren. Het uitvoeren van de laatste validatie duurt enkele seconden.
Selecteer Maken om de serviceverbinding te maken. Het kan tot een minuut duren voordat de bewerking is voltooid.

Beheerde identiteit (aanbevolen)
Verbindingsreeks

Voer de az containerapp connection create opdracht uit om een serviceverbinding te maken vanuit Container Apps naar een Blob Storage 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 containerapp connection create storage-blob --system-identity

Genereer de nieuwe verbinding tegelijk. Vervang de tijdelijke aanduidingen door uw eigen gegevens: <source-subscription>, <source_resource_group>, <app>, <target-subscription>, , en <target_resource_group><account>.

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<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 deze uit az containerapp connection create storage-blob --new --system-identity om er een te maken en deze te verbinden met uw container-app met behulp van een beheerde identiteit.

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 containerapp connection create opdracht uit om een serviceverbinding te maken van Container Apps naar een Blob Storage met een verbindingsreeks. U kunt deze opdracht op twee verschillende manieren uitvoeren:

Genereer stap voor stap de nieuwe verbinding.

az containerapp connection create storage-blob --secret

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<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 deze uit az containerapp connection create storage-blob --new --secret om er een te maken en deze te verbinden met uw container-app met behulp van een beheerde identiteit.

Serviceverbindingen weergeven

Container Apps-verbindingen worden weergegeven onder Instellingen > Service Connector (preview). Selecteer > deze optie om de lijst uit te vouwen en de eigenschappen weer te geven die vereist zijn voor uw toepassing.
Selecteer uw verbinding en valideer vervolgens om serviceconnector te vragen om uw verbinding te controleren.
Selecteer Meer informatie om de details van de verbindingsvalidatie te bekijken.

Voer de opdracht az containerapp connection list uit om alle ingerichte verbindingen van uw container-app weer te geven. Vervang de tijdelijke aanduidingen <container-app-resource-group> en <container-app-name> door de onderstaande opdracht door uw eigen gegevens. U kunt ook de --output table optie verwijderen om meer informatie over uw verbindingen weer te geven.

az containerapp connection list --resource-group "<container-app-resource-group>" --name "<container-app-name>" --output table

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

Raadpleeg de volgende handleidingen voor meer informatie over Service Connector:

Feedback

Is deze pagina nuttig?

Last updated on 2025-09-19