Azure-ügyfélhasználat-hozzárendelés
Az ügyfélhasználat-hozzárendelés az Azure-erőforrásokból származó használatot társítja a partnerként használt IP-cím üzembe helyezése során létrehozott ügyfél-előfizetésekben. Ezeknek a társításoknak a belső Microsoft-rendszerekben való kialakítása nagyobb belső láthatóságot biztosít a szoftvert futtató Azure-lábnyom számára. A kereskedelmi piactéren elérhető Azure-alkalmazás ajánlatok nyomon követésével igazodhat a Microsoft értékesítési csapataihoz, és kreditet szerezhet a Microsoft-partnerprogramokhoz. Az ügyfélhasználat-hozzárendelés nem alkalmazható a kereskedelmi piactéren található Azure-beli virtuális gépekre vonatkozó ajánlatokra. A marketplace-közzétevőnek semmit sem kell tennie a virtuálisgép-ajánlatokhoz, hogy az Azure-használat nyomon követhető legyen a végfelhasználói előfizetésekben.
Az ügyfélhasználat-hozzárendelés három üzembe helyezési lehetőséget támogat:
- Azure Resource Manager-sablonok (az Azure-alkalmazások közös alapjai, amelyet a kereskedelmi piactéren "megoldássablonoknak" vagy "felügyelt alkalmazásoknak" is neveznek): a partnerek Resource Manager-sablonokat hoznak létre az Azure-megoldások infrastruktúrájának és konfigurációjának meghatározásához. A Resource Manager-sablonokkal az ügyfelek konzisztens és megismételhető állapotban helyezhetik üzembe a megoldás erőforrásait.
- Azure Resource Manager API-k: a partnerek meghívhatják a Resource Manager API-kat Resource Manager-sablon üzembe helyezéséhez vagy azure-szolgáltatások közvetlen kiépítéséhez.
- Terraform: a partnerek a Terraform használatával üzembe helyezhetnek egy Resource Manager-sablont, vagy közvetlenül üzembe helyezhetik az Azure-szolgáltatásokat.
A cikk későbbi részében a másodlagos használati eseteket a kereskedelmi piactéren kívüli ügyfélhasználat-hozzárendeléssel kapcsolatban találja.
Fontos
Az ügyfélhasználat-hozzárendelés nem a rendszer integrátorainak, felügyelt szolgáltatóknak vagy elsősorban az Azure-erőforrások üzembe helyezésére és felügyeletére tervezett eszközök munkájának nyomon követésére szolgál.
Az ügyfélhasználat-hozzárendelés az új üzemelő példányokhoz tartozik, és nem támogatja a már üzembe helyezett erőforrások nyomon követését.
- Nem minden Azure-szolgáltatás kompatibilis az ügyfélhasználat-hozzárendeléssel. Az Azure Kubernetes Services (AKS), a virtuálisgép-méretezési csoportok és az Azure Batch ismert problémákat tapasztal, amelyek a használat aluljelentését okozzák.
- Az ügyfélhasználat-hozzárendelési Azure-használati adatok külsőleg nem lesznek megosztva a partnerekkel.
Kereskedelmi piactéri Azure-alkalmazások
Az Azure-használat nyomon követése a kereskedelmi piactéren közzétett Azure-alkalmazásokból nagyrészt automatikus. Amikor feltölt egy Resource Manager-sablont a piactéri Azure-alkalmazás csomagjának technikai konfigurációja részeként, a Partnerközpont hozzáad egy, az Azure Resource Manager által olvasható nyomkövetési azonosítót.
Feljegyzés
Annak érdekében, hogy az alkalmazás használata pontosan legyen hozzárendelve a rendszereinkben:
- Ha a Microsoft.Resources/deployment erőforrástípusban definiálja a nyomkövetési azonosítót egy változóval, cserélje le a változót a partnerközpontban látható nyomkövetési azonosítóra a terv Műszaki konfiguráció lapján (lásd alább a GUID hozzáadása Resource Manager-sablonhoz ).
- Ha a Resource Manager-sablon a Microsoft.Resources/deployment típusú erőforrásokat használja az ügyfélhasználat hozzárendelésétől eltérő célokra, a Microsoft nem fog tudni ügyfélhasználat-hozzárendelés-nyomkövetési azonosítót hozzáadni az Ön nevében. Adjon hozzá egy új, Microsoft.Resources/deployment típusú erőforrást, és adja hozzá a Partnerközpontban látható nyomkövetési azonosítót a terv Műszaki konfigurációs lapján (lásd alább a GUID hozzáadása Resource Manager-sablonhoz ).
Ha Azure Resource Manager API-kat használ, az alábbi utasításoknak megfelelően hozzá kell adnia a nyomkövetési azonosítóját, hogy átadhassa azt az Azure Resource Managernek, miközben a kód erőforrásokat helyez üzembe. Ez az azonosító látható a Partnerközpontban a Azure-alkalmazás csomag Műszaki konfiguráció lapján.
Feljegyzés
A meglévő Azure-alkalmazások esetében az egyszeri migrálás 2021 márciusában kezdődött, hogy az egyes csomagok technikai konfigurációjában frissítse a nyomkövetési azonosítókat. Az ajánlatok korábbi üzembe helyezéséből származó használat továbbra is nyomon követhető marad a Microsoft-rendszerekben.
Az ajánlatok frissítésekor már nem kell hozzáadnia a Microsoft.Resources/deployments erőforrástípust a fő sablonfájlban.
Egyéb használati esetek
Az ügyfélhasználat-hozzárendelés használatával nyomon követheti a kereskedelmi piactéren nem elérhető megoldások Azure-beli használatát. Ezek a megoldások általában a gyorsútmutató-adattárban, a privát GitHub-adattárakban találhatók, vagy olyan 1:1 ügyfélkapcsolatokból származnak, amelyek tartós IP-címet hoznak létre (például üzembe helyezhető és méretezhető alkalmazás).
Több manuális lépésre van szükség:
- Hozzon létre egy vagy több grafikus felhasználói azonosítót nyomkövetési azonosítóként.
- Regisztrálja ezeket a GRAFIKUS GUID-ket a Partnerközpontban.
- Adja hozzá a regisztrált GRAFIKUS GUID-ket az Azure-alkalmazáshoz és/vagy a felhasználói ügynök sztringjeihez.
GRAFIKUS GUID-k létrehozása
A Partnerközpont által az Ön nevében a kereskedelmi piactéren az Azure-alkalmazások számára létrehozott nyomkövetési azonosítókkal ellentétben az Ügyfélhasználat-hozzárendelés egyéb felhasználási módjaihoz létre kell hoznia egy GUID azonosítót, amelyet követési azonosítóként használ. A GUID egy 32 hexadecimális számjegyet tartalmazó egyedi referenciaazonosító. A nyomon követés GUID-jeinek létrehozásához GUID-generátort kell használnia, például a PowerShell-lel:
[guid]::NewGuid()
Minden termékhez és terjesztési csatornához egyedi GUID azonosítót kell létrehoznia. Ha nem szeretné, hogy a jelentés fel legyen osztva, egyetlen GUID-azonosítót használhat a termék több terjesztési csatornáján. A jelentéskészítés a PartnerID és a GUID alapján történik.
Grafikus felhasználói felületi azonosítók regisztrálása
A GRAFIKUS GUID-ket ezután regisztrálni kell a Partnerközpontban, hogy partnerként társíthatók legyenek Önhöz:
Jelentkezzen be a Partnerközpontba.
Válassza a Beállítások (fogaskerék ikon) lehetőséget a jobb felső sarokban, majd a Fiókbeállítások lehetőséget.
Válassza a Szervezeti profil>azonosítóinak>hozzáadása követési GUID-azonosítót.
A GUID mezőbe írja be a nyomkövetési GUID-t. Írja be csak a GUID azonosítót az
pid-
előtag nélkül. A Leírás mezőbe írja be a megoldás nevét vagy leírását.Ha több GUID-t szeretne regisztrálni, válassza ismét a Nyomkövetési GUID hozzáadása lehetőséget. További mezők jelennek meg a lapon.
Válassza a Mentés lehetőséget.
GUID hozzáadása Resource Manager-sablonhoz
Ha a regisztrált GUID-t hozzá szeretné adni egy Resource Manager-sablonhoz, módosítsa a fő sablonfájlt:
Nyissa meg a Resource Manager-sablont.
Adjon hozzá egy új, Microsoft.Resources/deployment típusú erőforrást a fő sablonfájlban. Az erőforrásnak csak a mainTemplate.json vagy azuredeploy.json fájlban kell lennie, beágyazott vagy csatolt sablonokban nem.
Adja meg a GUID értéket az
pid-
előtag után az erőforrás neveként. Ha például a GUID-cím eb7927c8-dd66-43e1-b0cf-c346a422063, az erőforrás neve pid-eb7927c8-dd66-43e1-b0cf-c346a422063 lesz. Példa:
{ // add this resource to the resources section in the mainTemplate.json
"apiVersion": "2020-06-01",
"name": "pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", // use your generated GUID here
"type": "Microsoft.Resources/deployments",
"properties": {
"mode": "Incremental",
"template": {
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": []
}
}
} // remove all comments from the file when complete
Ellenőrizze a sablon hibáit.
Tegye közzé újra a sablont a megfelelő adattárakban.
Ellenőrizze a GUID sikerességét a sablon üzembe helyezésében.
Tipp.
A Resource Manager-sablonok létrehozásával és közzétételével kapcsolatos további információkért tekintse meg az első Resource Manager-sablon létrehozását és üzembe helyezését.
A GUID azonosítóval nyomon követett üzemelő példányok ellenőrzése
Miután módosította a sablont, és futtatott egy teszttelepítést, az alábbi PowerShell-szkripttel kérje le az üzembe helyezett és címkézett erőforrásokat.
A szkripttel ellenőrizheti, hogy a GUID sikeresen fel van-e véve a Resource Manager-sablonba. A szkript nem vonatkozik a Resource Manager API-ra vagy a Terraform-környezetekre.
Bejelentkezés az Azure-ba. Válassza ki azt az előfizetést, amelynek üzembe helyezését ellenőrizni szeretné a szkript futtatása előtt. Futtassa a szkriptet az üzembe helyezés előfizetési környezetében.
Az üzemelő példány GUID azonosítója (alább "deploymentName") és resourceGroupName neve kötelező paraméterek.
Az eredeti Verify-DeploymentGuid szkriptet a GitHubon szerezheti be.
Param(
[string][Parameter(Mandatory=$true)]$deploymentName, # the full name of the deployment, e.g. pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
[string][Parameter(Mandatory=$true)]$resourceGroupName
)
# Get the correlationId of the named deployment
$correlationId = (Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -Name "$deploymentName").correlationId
# Find all deployments with that correlationId
$deployments = Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName | Where-Object{$_.correlationId -eq $correlationId}
# Find all deploymentOperations in all deployments with that correlationId as PowerShell doesn't surface outputResources on the deployment or correlationId on the deploymentOperation
foreach ($deployment in $deployments){
# Get deploymentOperations by deploymentName
# then the resourceIds for each resource
($deployment | Get-AzResourceGroupDeploymentOperation | Where-Object{$_.targetResource -notlike "*Microsoft.Resources/deployments*"}).TargetResource
}
Ügyfelek értesítése
A partnereknek tájékoztatniuk kell ügyfeleiket az ügyfélhasználat-hozzárendelést használó üzembe helyezésekről. Az alábbi példák olyan tartalmakat tartalmaznak, amelyekkel értesítheti ügyfeleit ezekről az üzemelő példányokról. A példákban cserélje le a PARTNERt <> a vállalat nevére. A partnereknek gondoskodniuk kell arról, hogy az értesítés megfeleljen az adatvédelmi és gyűjtési szabályzataiknak, beleértve az ügyfelek nyomon követéséből kizárandó lehetőségeket is.
Értesítés a Resource Manager-sablon üzembe helyezéséről
A sablon üzembe helyezésekor a Microsoft azonosíthatja a PARTNER> szoftver telepítését <az üzembe helyezett Azure-erőforrásokkal. A Microsoft korrelálhatja ezeket az erőforrásokat a szoftver támogatásához. A Microsoft azért gyűjti ezeket az információkat, hogy a lehető legjobb élményt nyújtsa termékeikhez, és hogy működjön vállalkozása. Az adatokat a Microsoft adatvédelmi szabályzatai gyűjtik és szabályozzák, amelyek a következő helyen https://www.microsoft.com/trustcentertalálhatók: .
Értesítés SDK- vagy API-üzemelő példányokról
A PARTNER szoftver telepítésekor <a Microsoft azonosítani tudja a PARTNER> szoftver telepítését <az üzembe helyezett Azure-erőforrásokkal.> A Microsoft korrelálhatja ezeket az erőforrásokat a szoftver támogatásához. A Microsoft azért gyűjti ezeket az információkat, hogy a lehető legjobb élményt nyújtsa termékeikhez, és hogy működjön vállalkozása. Az adatokat a Microsoft adatvédelmi szabályzatai gyűjtik és szabályozzák, amelyek a következő helyen https://www.microsoft.com/trustcentertalálhatók: .
Resource Manager API-k használata
Bizonyos esetekben közvetlenül a Resource Manager REST API-kkal indíthat hívásokat az Azure-szolgáltatások üzembe helyezéséhez. Azure-támogatás több SDK-t is engedélyez a hívások engedélyezéséhez. Használhatja az egyik SDK-t, vagy közvetlenül meghívhatja a REST API-kat az erőforrások üzembe helyezéséhez.
Az ügyfélhasználat-hozzárendelés engedélyezéséhez az API-hívások tervezésekor adja meg a nyomkövetési azonosítót a felhasználói ügynök fejlécében a kérelemben. Formázza a sztringet az pid-
előtaggal. Példák:
//Commercial Marketplace Azure app
pid-contoso-myoffer-partnercenter //copy the tracking ID exactly as it appears in Partner Center
//Other use cases
pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4 //enter your GUID after "pid-"
Fontos
Ha Resource Manager API-kat használ egy Azure-alkalmazással a kereskedelmi piactéren, használja a Partnerközpontban megadott nyomkövetési azonosítót. NE használjon GUID azonosítót.
A különböző SDK-k eltérően használják a Resource Manager API-kat, és bizonyos különbségeket igényelnek a kódban. Az alábbi példák a GUID-t használó, nem kereskedelmi piactéri megközelítést használják, és a népszerűbb Azure SDK-k széles körét fedik le.
Példa: Python SDK
Python esetén használja a konfigurációs attribútumot. Az attribútumot csak UserAgenthez lehet hozzáadni. Példa:
client = azure.mgmt.servicebus.ServiceBusManagementClient(**parameters)
client.config.add_user_agent("pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4")
Fontos
Adja hozzá az attribútumot minden ügyfélhez. Nincs globális statikus konfiguráció. Előfordulhat, hogy megjelöl egy ügyfél-előállítót, hogy minden ügyfél nyomon legyen követve. További információkért tekintse meg ezt az ügyfél-előállítói mintát a GitHubon.
Példa: .NET SDK
A .NET esetében mindenképpen állítsa be a felhasználói ügynököt. A Microsoft.Azure.Management.Fluent kódtár használatával állítsa be a felhasználói ügynököt a következő kóddal (például C#-ban):
var azure = Microsoft.Azure.Management.Fluent.Azure
.Configure()
// Add your pid in the user agent header
.WithUserAgent("pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", String.Empty)
.Authenticate(/* Credentials created via Microsoft.Azure.Management.ResourceManager.Fluent.SdkContext.AzureCredentialsFactory */)
.WithSubscription("<subscription ID>");
Fontos
2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.
A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.
Példa: Azure PowerShell
Ha erőforrásokat helyez üzembe az Azure PowerShellen keresztül, fűzze hozzá a GUID azonosítót az alábbi módszerrel:
[Microsoft.Azure.Common.Authentication.AzureSession]::ClientFactory.AddUserAgent("pid-eb7927c8-dd66-43e1-b0cf-c346a422063")
Feljegyzés
Javasoljuk, hogy az Azure Az PowerShell modult használja az Azure-ral való interakcióhoz. Az első lépésekhez tekintse meg az Azure PowerShell telepítését ismertető szakaszt. Az Az PowerShell-modulra történő migrálás részleteiről lásd: Az Azure PowerShell migrálása az AzureRM modulból az Az modulba.
Példa: Azure CLI
Amikor az Azure CLI-vel hozzáfűzi a GUID-t, állítsa be a AZURE_HTTP_USER_AGENT környezeti változót egy szkript hatókörébe. A rendszerhéj hatóköréhez globálisan is beállíthatja a változót:
export AZURE_HTTP_USER_AGENT='pid-eb7927c8-dd66-43e1-b0cf-c346a422063'
További információ: Azure SDK for Go.
A Terraform használata
A Terraform támogatása az Azure Provider 1.21.0-s kiadásán keresztül érhető el: https://github.com/terraform-providers/terraform-provider-azurerm/blob/master/CHANGELOG.md#1210-january-11-2019. Ez minden olyan partnerre vonatkozik, aki a Terraformon keresztül telepíti a megoldást, valamint az Azure Provider által üzembe helyezett és mért összes erőforrásra (1.21.0-s vagy újabb verzió).
Az Azure-szolgáltató a Terraformhoz hozzáadott egy új, partner_id nevű opcionális mezőt a megoldáshoz használt nyomkövetési GUID megadásához. A mező értéke a ARM_PARTNER_ID környezeti változóból is származhat.
provider "azurerm" {
subscription_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
……
# new stuff for ISV attribution
partner_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}
Fontos
Ha a Terraformot egy Azure-alkalmazással használja a kereskedelmi piactéren, használja a Partnerközpontban megadott teljes nyomkövetési azonosítót. NE használjon GUID azonosítót.
Támogatás kérése
További információ a kereskedelmi piactér támogatási lehetőségeiről a Partnerközpont kereskedelmi piactér programjának támogatásában.
Technikai konzultációs kérelem beküldése
- Látogasson el a Partner Technical Services webhelyre.
- Válassza a felhőinfrastruktúra és a felügyelet lehetőséget a műszaki folyamat megtekintéséhez.
- Válassza a Központi telepítési szolgáltatások>kérés elküldése lehetőséget.
- Jelentkezzen be az MSA (Microsoft AI Cloud Partner Program fiók) vagy a Microsoft Entra-azonosító (partner irányítópult-fiók) használatával.
- Töltse ki/tekintse át a megnyíló űrlap kapcsolattartási adatait. Előfordulhat, hogy a konzultáció részletei előre fel vannak töltve, vagy lehetnek legördülő lehetőségek.
- Adja meg a probléma címét és részletes leírását.
- Válassza a Küldés lehetőséget.
Tekintse meg a részletes utasításokat képernyőképekkel a Technical Presales és a Deployment Services használatával kapcsolatban.
A Microsoft partner technikai tanácsadója felveszi Önnel a kapcsolatot, hogy beállítson egy hívást az igényeinek megfelelően.
GYIK
A nyomkövetési azonosító hozzáadása után módosítható?
A kereskedelmi piactéren lévő Azure-alkalmazások azonosítóinak nyomon követését a Partnerközpont automatikusan felügyeli. Az ügyfél azonban letöltheti a sablont, és módosíthatja vagy eltávolíthatja a nyomkövetési azonosítót. A partnereknek proaktív módon le kell írniuk a nyomkövetési azonosító szerepét az ügyfeleiknek az eltávolítás vagy a szerkesztés megakadályozása érdekében. A nyomkövetési azonosító módosítása csak az új üzemelő példányokat és erőforrásokat érinti, a meglévőket nem.
Nyomon követhetem a Nem Microsoft-adattárból, például a GitHubról üzembe helyezett sablonokat?
Igen, amíg a nyomkövetési azonosító jelen van a sablon üzembe helyezésekor, a rendszer nyomon követi a használatot. A közzétevő és a nem Microsoft-adattárból üzembe helyezett sablon közötti társítás fenntartásához először töltse le a közzétett sablon egy példányát (amely tartalmazza a nyomkövetési azonosítót) az ajánlat kereskedelmi piactéri listájáról az Azure Portalon. Tegye közzé ezt a verziót a GitHubon vagy más, nem Microsoft-adattárban.
Ha a sablon nem szerepel a kereskedelmi piactéren, és regisztrált GUID-t tartalmaz, győződjön meg arról, hogy a GUID megtalálható a GitHubon vagy más, nem Microsoft-adattárban közzétett verzióban.
A Microsoft megosztja az ügyfélhasználati hozzárendelés adatait a partnerekkel?
Szám A Microsoft nem osztja meg az Ügyfélhasználat-hozzárendelésen keresztül nyomon követett Azure-használati adatokat külsőleg a partnerekkel.
Fogadják az ügyfelek az Ügyfélhasználat-hozzárendelés jelentését?
Szám Az ügyfelek az Azure Portalon nyomon követhetik az összes erőforrás vagy erőforráscsoport használatát. Az ügyfelek nem látják az ügyfélhasználat-hozzárendelés nyomon követésének azonosítója alapján lebontott használatot.
Az ügyfélhasználat-hozzárendelés hasonló a digitális rekordpartnerhez (DPOR) vagy a partneri rendszergazdai hivatkozáshoz (PAL)?
Az ügyfélhasználat-hozzárendelés egy olyan mechanizmus, amellyel az Azure-használat társítható egy partner megismételhető, üzembe helyezhető IP-címével – így az üzembe helyezéskor létrejön a társítás. A DPOR és a PAL célja, hogy egy tanácsadó (Systems Integrator) vagy felügyeleti (felügyelt szolgáltató) partnert társítson az ügyfél releváns Azure-lábnyomához arra az időre, amíg a partner kapcsolatba lép az ügyféllel.