ISV-alkalmazáslicenc-kezelés SaaS-ajánlatokhoz

Ha engedélyezte a licenckezelést az SaaS-ajánlatokhoz (jelenleg csak az AppSource-hoz érhető el) a Partnerközpontban, akkor integrálnia kell a usageRights Graph API-val az ügyfelek licenceinek kereséséhez. A usageRights API használatával határozza meg a megoldást hívó ügyfél licencelési állapotát, hogy ennek megfelelően járjon el.

Fontos

Az Azure Active Directory (Azure AD) Graph 2023. június 30-ától elavult. A továbbiakban nem teszünk további befektetéseket az Azure AD Graphban. Az Azure AD Graph API-k nem rendelkeznek SLA-val vagy karbantartási kötelezettségvállalással a biztonsággal kapcsolatos javításokon túl. Az új funkciókba és funkciókba csak a Microsoft Graph-ban lehet befektetni.

Az Azure AD Graphot növekményes lépésekben kivonjuk, hogy elegendő ideje legyen az alkalmazások Microsoft Graph API-kba való migrálására. Egy későbbi időpontban, amikor bejelentjük, letiltjuk az új alkalmazások létrehozását az Azure AD Graph használatával.

További információ: Fontos: Az Azure AD Graph kivonása és a PowerShell-modul elavulása.

usageRights API

API: usageRight erőforrástípus

A usageRights API használata

Meghívhatja a usageRights Graph API-t annak megállapításához, hogy mi az ajánlat előfizetését megvásárló bejelentkezett felhasználó licencének állapota. Az API meghívásához kövesse az alábbi lépéseket:

1. Felhasználó lekérése jogkivonat nevében: lásd : hozzáférés kérése egy felhasználó nevében
2. A Graph meghívása a felhasználó objektumazonosítójának lekéréséhez: lásd a Microsoft Graph API használatát
3. A usageRights API meghívása annak megállapításához, hogy a felhasználó rendelkezik-e licenccel a csomaghoz: lásd a felhasználói usageRights listázását

Feljegyzés

A usageRights meghívásához minimális User.Read engedéllyel kell rendelkeznie. A usageRights API jelenleg bétaverzióban érhető el. A verzió V1-re való frissítése után az ISV-knek bétaverzióról 1-es verzióra kell frissíteniük, ha elérhetőek.

Válaszkódok

200-ás kód választörzsgel:

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('ea201692-eb91-44e0-b82a-9dd4c78ced32')/usageRights",
    "@odata.nextLink": "https://graph.microsoft.com/beta/users/ea201692-eb91-44e0-b82a-9dd4c78ced32/usageRights?$skiptoken=ZXlKamIzTnRiM05FWWxSdmEyVnVJam9pVzN0Y0ltTnZiWEJ2YzJsMFpWUnZhMlZ1WENJNmUxd2lkRzlyWlc1Y0lqcHVkV3hzTEZ3aWNtRnVaMlZjSWpwN1hDSnRhVzVjSWpwY0lqRkdSa1pHUmtaR1JrWkdSa1pHUmtaR1JrWkdSa1pHUmt.......",
    "value": [
        {
            "id": "635991be-b7a3-4dd4-a48c-f1d39732fe94",
            "catalogId": "ID of the Product",
            "serviceIdentifier": "ISV friendly ID of the product, this is same as planID in partner center",
            "state": "active"
        }
    ]
}

API-válasz magyarázata

• Odata.nextLink: Ha a kérés több eredménnyel is rendelkezik, és lapszámozottnak kell lennie, akkor az Odata.nextLink szerepel a válaszban. Ezzel az eredménnyel megjelenítheti az eredményeket, amíg nem jelenik meg több Odata.nextLink érték, amely a válasz végét jelzi.
• serviceIdentifier: Az ügyfél által vásárolt csomag planId azonosítója.
• állapot: A licenc állapota. A usageRights API dokumentációjában az összes lehetséges állapotérték látható. A felhasználónak általában képesnek kell lennie a megoldás futtatására, ha a licenc állapota aktív vagy figyelmeztetés. Bármely más állapot azt jelenti, hogy a felhasználó előfizetése sem jó állapotban van, mert lejárt, fel van függesztve a nem fizetés miatt stb.
• Kód: 200 üres válasz: Ez valószínűleg azért van, mert az ügyfél nem rendelkezik hozzárendelt licenccel.
• 400-es kódú hibás kérés: Ez valószínűleg azért van, mert hiányoznak a mezők, miközben meghívja az API-t, például a Bearer tokent. Ellenőrizze az API-hívás paramétereit.
• Kód: 403 Tiltott: Ez valószínűleg a lejárt vagy jogosulatlan jogkivonat miatt van. Ellenőrizze, hogy a megfelelő Microsoft Entra-alkalmazást használja-e a usageRights Graph API hitelesítéséhez.
• 500-es kódú belső kiszolgálóhiba: Próbálkozzon újra az API-hívással. Ha a hiba továbbra is fennáll, forduljon Microsoft ügyfélszolgálata.

Feljegyzés

Ha az SaaS fulfillment API-hoz használt Microsoft Entra alkalmazást is használja a usageRights API-hoz, győződjön meg arról, hogy az a bérlő, amely alatt az alkalmazás létrejön, vagy a közzétételi bérlő vagy a partnerközpont társított bérlője.

Az alábbi lépésekkel megállapíthatja, hogy a Microsoft Entra App által létrehozott bérlő a partnerközpont beállításának része:

1. Jelentkezzen be a Microsoft Partnerközpontba az SaaS-ajánlat közzétételéhez használt közzétevői fiókkal.
2. A jobb felső sarokban található Beállítások hivatkozás alatt válassza a "Fiókbeállítások", majd a "bérlők" lehetőséget
3. A Microsoft AI Cloud Partner Program-fiókban társított összes bérlő megjelenik.
4. A Microsoft Entra-alkalmazás tulajdonosaként szereplő bérlőnek ezen a listán kell szerepelnie.
5. Ha a bérlő nem szerepel a listában, az "Azure ID társítása" gombbal összekapcsolhatja a bérlőt.