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 nepracujeme do Azure AD Graphu žádné další investice. Rozhraní Azure AD Graph API nemají žádné závazky sla ani ú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.

usageRights API

Rozhraní API: typ prostředku usageRight

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 získání přístupu jménem uživatele
  2. Volání Graphu pro získání ID objektu uživatele: Viz použití rozhraní Microsoft Graph API
  3. Volání rozhraní API usageRights k určení, že uživatel má licenci k plánu: viz seznam uživatelských údajů 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 má váš požadavek několik výsledků a musí být stránkován, 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. Uživatel by měl být obvykle 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: Důvodem je pravděpodobně chybějící pole při volání rozhraní API, jako je nosný token. Zkontrolujte parametry volání rozhraní 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: Opakujte volání rozhraní API. Pokud chyba přetrvává, obraťte se na podpora Microsoftu.

Poznámka:

Pokud se aplikace Microsoft Entra, kterou používáte pro rozhraní API pro plnění SaaS, používá také pro rozhraní USAGERights API, ujistěte se, že tenantem, pod kterým je vytvořena přidaná aplikace, je tenant publikování nebo přidružený tenant v Partnerském centru.

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 odkazu na nastavení vyberte Nastavení účtu a pak tenanti.
  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.