Sdílet prostřednictvím

Správa licencí pro aplikace ISV pro nabídky SaaS

  • Článek

Pokud jste povolili správu licencí pro nabídky SaaS (aktuálně dostupné jenom pro AppSource) v Partnerském centru, musíte se integrovat s rozhraním usageRights Graph API, abyste mohli vyhledat licence zákazníků. Pomocí rozhraní usageRights API určíte stav licencování zákazníka, který volá vaše řešení, abyste mohli odpovídajícím způsobem jednat.

Důležitý

Azure Active Directory (Azure AD) Graph je od 30. června 2023 zastaralý. V budoucnu už nebudeme dále investovat do Azure AD Graphu. Rozhraní Azure AD Graph API nemají žádné závazky týkající se SLA nebo údržby nad rámec oprav souvisejících se zabezpečením. Investice do nových funkcí a funkcí budou provedeny pouze v Microsoft Graphu.

Azure AD Graph vyřadíme v přírůstkových krocích, abyste měli dostatek času na migraci aplikací do rozhraní Microsoft Graph API. Později, kdy budeme oznamovat, zablokujeme vytváření nových aplikací pomocí Azure AD Graphu.

Další informace najdete v tématu Důležité: Vyřazení azure AD Graphu a vyřazení modulu PowerShellu.

Práva k použití API

rozhraní API: typ prostředku právo na užívání

Jak používat rozhraní USAGERights API

Můžete volat usageRights Graph API a zjistit, jaký je stav licence přihlášeného uživatele, který zakoupil předplatné vaší nabídky. Pokud chcete volat rozhraní API, postupujte takto:

  1. Získání tokenu jménem uživatele: viz ohledně získání přístupu jménem uživatele
  2. Zavolejte Graph pro získání ID objektu uživatele pomocí rozhraní Microsoft Graph API: viz
  3. Volání rozhraní API pro "usageRights" k určení, zda má uživatel licenci k plánu: viz seznam uživatelských "usageRights"

Poznámka

Abyste mohli volat usageRights, musíte mít minimální oprávnění User.Read. Rozhraní API usageRights je aktuálně ve verzi beta. Po aktualizaci verze na verzi V1 by nezávislí výrobci softwaru měli upgradovat z beta verze na verzi V1, pokud jsou k dispozici.

Kódy odpovědí

Kód 200 s textem odpovědi:

{
    "@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"
        }
    ]
}

Vysvětlení odpovědi rozhraní API

  • Odata.nextLink: Pokud váš požadavek obsahuje více výsledků a musí být stránkovaný, Odata.nextLink je v odpovědi. Tuto možnost můžete použít ke stránkování výsledků, dokud se nezobrazí žádné další hodnoty Odata.nextLink, které označují konec odpovědi.
  • serviceIdentifier: planId plánu, který zákazník zakoupil.
  • stav: Stav licence. Všechny možné hodnoty stavu můžete zobrazit v dokumentaci k rozhraní API usageRights. Obvykle by měl být uživatel schopen spustit řešení, pokud je stav licence aktivní nebo upozornění. Jakýkoli jiný stav znamená, že předplatné uživatele není v dobrém stavu, protože vypršela jeho platnost, je pozastaveno za neplacení atd.
  • Kód 200 s prázdnou odpovědí: Je pravděpodobné, že zákazník nemá přiřazenou licenci.
  • Kód 400 Chybný požadavek: Pravděpodobně kvůli chybějícím polím při volání API, jako je Bearer token. Zkontrolujte parametry volání API.
  • Kód 403 Zakázáno: Pravděpodobně je to kvůli vypršení platnosti nebo neoprávněnému tokenu. Ověřte, že používáte správnou aplikaci Microsoft Entra k ověření rozhraní usageRights Graph API.
  • Kód 500 – Vnitřní chyba serveru: zopakujte volání rozhraní API. Pokud chyba přetrvává, obraťte se na podporu Microsoftu.

Poznámka

Pokud se aplikace Microsoft Entra, kterou používáte pro rozhraní API pro plnění SaaS, používá také pro rozhraní API pro práva na použití, ujistěte se, že nájemce, pod kterým je aplikace přidána, je buď publikující nájemce, nebo přidružený nájemce v centru partnerů.

Pomocí následujícího postupu určete tenanta, pod kterým je aplikace Microsoft Entra vytvořená v rámci nastavení Partnerského centra:

  1. Přihlaste se k Partnerskému centru Microsoftu pomocí účtu vydavatele, který se používá k publikování nabídky SaaS.
  2. V pravém horním rohu obrazovky klikněte na odkaz Nastavení a vyberte Nastavení účtu, poté Nájemci.
  3. Zobrazí se všechny tenanty přidružené k účtu programu Microsoft AI Cloud Partner Program.
  4. Tenant, který je vlastníkem aplikace Microsoft Entra, by měl být v tomto seznamu.
  5. Pokud tenant není v seznamu, můžete k propojení tenanta použít tlačítko Přidružit ID Azure.