ApiCenterProductionVersionPlugin

Ellenőrzi, hogy az alkalmazásban használt API-k a megadott Azure API Center-példányban regisztrált API-k éles verziója-e.

Beépülő modulpéldány definíciója

{
  "name": "ApiCenterProductionVersionPlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "configSection": "apiCenterProductionVersionPlugin"
}

Példa konfigurációra

{
  "apiCenterProductionVersionPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/apicenterproductionversionplugin.schema.json",
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "resourceGroupName": "resource-group-name",
    "serviceName": "apic-instance",
    "workspaceName": "default"
  }
}

Konfigurációs tulajdonságok

Ingatlan	Leírás	Alapértelmezett
resourceGroupName	Annak az erőforráscsoportnak a neve, amelyben az Azure API Center található.	Egyik sem
serviceName	Annak az Azure API Center-példánynak a neve, amellyel a Dev Proxynak ellenőriznie kell, hogy az alkalmazásban használt API-k regisztrálva vannak-e.	Egyik sem
subscriptionId	Annak az Azure-előfizetésnek az azonosítója, ahol az Azure API Center-példány található.	Egyik sem
workspace	A használni kívánt Azure API Center-munkaterület neve.	default

Parancssori beállítások

Egyik sem

Megjegyzések

A ApiCenterProductionVersionPlugin beépülő modul ellenőrzi, hogy az alkalmazásban használt API-k a megadott Azure API Center-példányban regisztrált API-k éles verziója-e. Ha az API-k megfelelnek a nem gyártási verzióknak, a beépülő modul figyelmeztetést jelenít meg.

Az Azure API Centerhez való csatlakozáshoz a beépülő modul Azure-hitelesítő adatokat használ (ebben a sorrendben):

• Környezet
• Számítási feladatok identitása
• Felügyelt identitás
• Visual Studio
• Visual Studio Code
• Azure CLI (Az Azure parancssori felülete)
• Azure PowerShell
• Azure fejlesztői parancssori felület

Ha a beépülő modul nem tud hozzáférési jogkivonatot lekérni az Azure eléréséhez, hibaüzenet jelenik meg, és a Dev Proxy letiltja. Jelentkezzen be az Azure-ba ezen eszközök bármelyikével, és indítsa újra a Dev Proxyt a ApiCenterProductionVersionPlugin beépülő modul használatához.

Ha dev proxyt használ a CI/CD-folyamatokban, környezeti változóként átadhatja a subscriptionId, resourceGroupName, serviceNameés workspaceName tulajdonságait. Környezeti változók használatához az érték nevét egy @kell előre felerősíteni, például:

{
  "apiCenterProductionVersionPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/apicenterproductionversionplugin.schema.json",
    "subscriptionId": "@AZURE_SUBSCRIPTION_ID",
    "resourceGroupName": "@AZURE_RESOURCE_GROUP_NAME",
    "serviceName": "@AZURE_APIC_INSTANCE_NAME",
    "workspaceName": "@AZURE_APIC_WORKSPACE_NAME"
  }
}

Ebben a példában a ApiCenterProductionVersionPlugin beépülő modul a subscriptionId, resourceGroupName, serviceNameés workspaceName tulajdonságokat a AZURE_SUBSCRIPTION_ID, AZURE_RESOURCE_GROUP_NAME, AZURE_APIC_INSTANCE_NAMEés AZURE_APIC_WORKSPACE_NAME környezeti változók értékeihez állítja be.

Következő lépés

Annak ellenőrzése, hogy az alkalmazás éles szintű API-kat használ-e