Manajemen lisensi aplikasi ISV untuk penawaran SaaS

Artikel
06/14/2024

Jika Anda mengaktifkan manajemen lisensi untuk penawaran SaaS Anda (saat ini hanya tersedia untuk AppSource) di Pusat Mitra, maka Anda harus berintegrasi dengan usageRights Graph API untuk mencari lisensi pelanggan. Anda menggunakan usageRights API untuk menentukan status lisensi pelanggan yang memanggil solusi Anda sehingga Anda dapat bertindak sesuai.

Penting

Grafik Azure Active Directory (Azure AD) tidak digunakan lagi per 30 Juni 2023. Ke depannya, kami tidak melakukan investasi lebih lanjut di Azure AD Graph. API Azure AD Graph tidak memiliki komitmen SLA atau pemeliharaan di luar perbaikan terkait keamanan. Investasi dalam fitur dan fungsionalitas baru hanya akan dilakukan di Microsoft Graph.

Kami akan menghentikan Azure AD Graph dalam langkah-langkah bertahap sehingga Anda memiliki waktu yang cukup untuk memigrasikan aplikasi Anda ke MICROSOFT Graph API. Di kemudian hari yang akan kami umumkan, kami akan memblokir pembuatan aplikasi baru apa pun menggunakan Azure AD Graph.

Untuk mempelajari selengkapnya, lihat Penting: Penghentian Azure AD Graph dan Penghentian Modul Powershell.

usageRights API

API: jenis sumber daya usageRight

Cara menggunakan usageRights API

Anda dapat memanggil usageRights Graph API untuk menentukan status lisensi untuk pengguna yang masuk yang membeli langganan penawaran Anda. Untuk memanggil API, ikuti langkah-langkah berikut:

Mendapatkan pengguna Atas Nama Token: lihat mendapatkan akses atas nama pengguna
Memanggil Graph untuk mendapatkan ID objek pengguna: lihat menggunakan Microsoft Graph API
Memanggil usageRights API untuk menentukan pengguna memiliki Lisensi ke paket: lihat mencantumkan penggunaan penggunaRights

Catatan

Anda harus memiliki izin User.Read minimum untuk memanggil usageRights. USAGERights API saat ini dalam versi beta. Setelah versi diperbarui ke V1, ISV harus ditingkatkan dari versi beta ke V1 jika tersedia.

Kode Respons

Kode 200 dengan isi respons:

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

Respons API dijelaskan

Odata.nextLink: Jika permintaan Anda memiliki beberapa hasil dan perlu di-paged, Odata.nextLink berada dalam respons. Anda dapat menggunakan ini untuk halaman hasil sampai tidak ada lagi nilai Odata.nextLink yang muncul, yang menunjukkan akhir respons.
serviceIdentifier: PlanId dari paket yang dibeli pelanggan.
status: Status lisensi. Anda dapat melihat semua nilai status yang mungkin dalam dokumentasi USAGERights API. Biasanya, pengguna harus dapat menjalankan solusi Anda jika status lisensi aktif atau peringatan. Status lain berarti langganan pengguna tidak dalam kondisi baik karena kedaluwarsa, ditangguhkan untuk tidak dibayar, dll.
Kode 200 dengan respons kosong: Ini kemungkinan karena pelanggan tidak memiliki lisensi yang ditetapkan.
Kode 400 Permintaan buruk: Ini kemungkinan karena bidang yang hilang saat memanggil API seperti token Pembawa. Periksa parameter panggilan API Anda.
Kode 403 Terlarang: Ini kemungkinan karena token kedaluwarsa atau tidak sah. Verifikasi bahwa Anda menggunakan Aplikasi Microsoft Entra yang tepat untuk mengautentikasi USAGERights Graph API.
Kesalahan server internal Kode 500: Coba lagi panggilan API. Jika kesalahan berlanjut, hubungi Dukungan Microsoft.

Catatan

Jika aplikasi Microsoft Entra yang Anda gunakan untuk API pemenuhan SaaS juga digunakan untuk usageRights API, pastikan bahwa penyewa tempat aplikasi add dibuat adalah penyewa penerbitan ATAU penyewa terkait di pusat mitra.

Gunakan langkah-langkah berikut untuk menentukan penyewa tempat Aplikasi Microsoft Entra dibuat adalah bagian dari penyiapan pusat mitra:

Masuk ke Pusat Mitra Microsoft dengan akun penerbit yang digunakan untuk menerbitkan penawaran SaaS.
Di bawah tautan pengaturan di sudut atas kanan, pilih "Pengaturan akun" lalu "penyewa"
Anda dapat melihat semua penyewa yang terkait di akun Program Mitra Microsoft AI Cloud.
Penyewa yang merupakan pemilik Aplikasi Microsoft Entra harus ada dalam daftar ini.
Jika penyewa tidak ada dalam daftar, Anda dapat menggunakan tombol "Kaitkan ID Azure" untuk menautkan penyewa.

Bagikan melalui