Quickstart: Een serviceverbinding maken in App Service met de Azure CLI

Artikel
10/16/2024

In deze quickstart worden de stappen beschreven voor het maken van een serviceverbinding in Azure-app Service met de Azure CLI.

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

Vereisten

Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
- Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
- Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor 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 Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.
In deze quickstart wordt ervan uitgegaan dat u al ten minste een App Service hebt die wordt uitgevoerd in Azure. Als u geen App Service hebt, maakt u er een.

Eerste installatie

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
```
Tip

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.
Gebruik desgewenst de opdracht Az webapp connection list-support-types om een lijst met ondersteunde doelservices voor App Service op te halen.
```
az webapp connection list-support-types --output table
```

Belangrijk

Als u beheerde identiteit gebruikt, moet u beschikken over de machtiging voor roltoewijzing van Microsoft Entra. Zonder deze machtiging mislukt het maken van een verbinding. U kunt de eigenaar van uw abonnement vragen om u deze machtiging te verlenen of een toegangssleutel te gebruiken om de verbinding te maken.

Gebruik de Azure CLI az webapp connection command om een serviceverbinding te maken met een Blob Storage met een door het systeem toegewezen beheerde identiteit, met de volgende informatie:

De naam van de resourcegroep die de App Service bevat
De naam van de App Service
De naam van de resourcegroep die het opslagaccount bevat
De naam van het opslagaccount

az webapp connection create storage-blob

Notitie

Als u geen Blob Storage hebt, kunt u uitvoeren az webapp connection create storage-blob --new --system-identity om een nieuwe Blob Storage-resource in te richten en deze rechtstreeks te verbinden met uw App Service-exemplaar.

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.

Gebruik de azure CLI az webapp connection create command om een serviceverbinding te maken met een Azure Blob Storage met een toegangssleutel, met de volgende informatie:

Resourcegroepnaam bronresourceservice: de naam van de resourcegroep van de App Service.
App Service-naam: de naam van uw App Service die verbinding maakt met de doelservice.
Naam van doelserviceresourcegroep: de naam van de resourcegroep van de Blob Storage.
Naam van opslagaccount: de accountnaam van uw Blob Storage.

az webapp connection create storage-blob --secret

Tip

Als u geen Blob Storage hebt, voert u deze uit az webapp connection create storage-blob --new --secret om een nieuwe in te richten en rechtstreeks verbinding te maken met uw App Service-resource.

Verbindingen weergeven

Voer de Azure CLI az webapp connection command uit om verbindingen met uw App Service weer te geven, met de volgende informatie:

De naam van de resourcegroep die de App Service bevat
De naam van de App Service

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Volgende stappen

Volg de onderstaande zelfstudies om uw eigen toepassing te bouwen met Service Connector.

Zelfstudie: WebApp + Storage met Azure CLI

Zelfstudie: WebApp + PostgreSQL met Azure CLI

Delen via