Menyiapkan akses API di Pusat Mitra

Artikel
11/27/2023

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Artikel ini menjelaskan akun yang perlu Anda kembangkan terhadap SDK Pusat Mitra. Artikel ini juga menjelaskan cara membuat akun sandbox integrasi dan menguji di sandbox integrasi.

Catatan

Untuk mendapatkan akses ke API, penyewa Anda harus menjadi penyewa CSP dan Anda harus menjadi penyedia tidak langsung atau mitra tagihan Langsung.

Definisi akun

Untuk membantu Anda mengintegrasikan dan menguji integrasi API, Pusat Mitra mendukung dua jenis akun:

Akun Mitra Utama

Akun ini adalah tempat Anda membuat pesanan nyata untuk pelanggan nyata. Jika Anda membuat perubahan atau transaksi saat masuk ke akun utama, dengan menggunakan SDK Pusat Mitra atau UI Dasbor Mitra, mereka akan diperlakukan sebagai pesanan resmi untuk pelanggan nyata. Mereka akan tercermin dalam faktur Anda, dan perusahaan Anda bertanggung jawab untuk membayarnya.

Akun kotak pasir integrasi

Akun ini untuk menguji kode Anda dan integrasinya dengan API Pusat Mitra sebelum Anda menyebarkannya secara luas. Perubahan dan transaksi yang Anda buat saat masuk ke akun kotak pasir integrasi akan muncul di faktur Anda, namun, Anda tidak perlu membayar jumlah faktur. Faktur pdf akan memiliki penafian sebagai "JANGAN BAYAR. INI ADALAH FAKTUR KOTAK PASIR DAN TIDAK ADA TINDAKAN YANG DIPERLUKAN."

Akun kotak pasir integrasi dan akun utama bertindak secara independen, dan tidak berbagi akun admin, akun pengguna, pelanggan, pesanan, langganan, atau data lainnya.

Sandbox integrasi mendukung transaksi dengan sejumlah pelanggan, pesanan, langganan, lisensi, dll.

Berdasarkan kebijakan, akun sandbox integrasi hanya untuk tujuan pengujian integrasi.

Secara default, tidak ada akun sandbox integrasi. Anda harus membuatnya sendiri jika Anda berencana untuk menggunakan SDK Pusat Mitra.

Menyiapkan akun Anda

Bagian ini menjelaskan cara menyiapkan akun Mitra utama dan akun kotak pasir integrasi untuk SDK Pusat Mitra.

Membuat kotak pasir integrasi

Masuk ke Pusat Mitra dengan akun admin Global dan pilih Pengaturan (perlengkapan).

Catatan

Membuat Sandbox mengharuskan Admin Global mitra masuk ke Pusat Mitra dengan alias domain onmicrosoft.com mereka (misalnya, alias@domain.onmicrosoft.com). Pembuatan kotak pasir akan gagal jika pengguna masuk dengan domain kustom mereka.
Pilih Pengaturan akun, lalu Kotak pasir integrasi.

Catatan

Jika Anda tidak melihat opsi Kotak pasir Integrasi, Anda mungkin tidak memiliki akun admin global. Anda juga mungkin menggunakan akun sandbox integrasi dan kotak pasir integrasi telah disiapkan.
Masukkan informasi kontak untuk akun admin kotak pasir integrasi. Lalu, pilih Buat akun. Tunggu beberapa menit untuk pesan konfirmasi bahwa akun telah dibuat.
Setelah Anda melihat pesan konfirmasi, keluar dari Dasbor Mitra.
Masuk kembali dengan akun admin kotak pasir integrasi baru Anda. Pastikan untuk menggunakan format username@domain untuk kredensial Anda bersama dengan kata sandi yang Anda tentukan.
Pilih Siapkan akun di halaman Kotak Pasir Integrasi untuk menyelesaikan penyiapan akun kotak pasir.

Mengaktifkan akses API

Setelah akun anda disiapkan, anda harus mengaktifkan akses API sebelum dapat menggunakan SDK Pusat Mitra dengan sandbox integrasi. Anda perlu mengaktifkan akses ke API secara terpisah untuk akun Partner utama dan akun sandbox integrasi Anda.

Masuk ke Pusat Mitra dengan akun admin Global dan pilih Pengaturan (perlengkapan).
Pilih Pengaturan akun, lalu Manajemen aplikasi.
Jika Anda belum memiliki aplikasi yang sudah ada, tambahkan aplikasi web baru. Jika Anda memiliki aplikasi web yang sudah ada, pilih tombol Tambahkan kunci .
Salin informasi pendaftaran aplikasi, terutama Kunci jika Anda membuat aplikasi web, dan menyimpannya di tempat yang aman.
Keluar dari Dasbor Mitra.
Masuk kembali dengan akun sandbox integrasi Anda. Ulangi langkah 2-5 untuk mengaktifkan akses API di kotak pasir integrasi.

Menulis dan menguji kode

Anda dapat menulis kode dan kode pengujian di kotak pasir integrasi. Anda memerlukan informasi berikut untuk menyiapkan autentikasi Pusat Mitra dengan ID Microsoft Entra.

Nama Item	Lokasi item
ID Aplikasi / ID Klien	Dari Pengaturan (gigi), pilih Pengaturan akun, lalu Manajemen Aplikasi. ID Aplikasi/ID Klien terdaftar sebagai ID Aplikasi terdaftar.
Tombol	Jika Anda membuat aplikasi web di bagian Aktifkan akses API, ini adalah kunci yang Anda simpan di langkah 5.
Domain	Domain untuk kotak pasir integrasi.

Jalankan kode yang diuji

Untuk menggunakan solusi Anda dengan data pelanggan nyata, Anda harus mengubah dari kredensial kotak pasir integrasi Anda ke kredensial akun Mitra utama Anda.

Saat Anda siap menggunakan kode yang diuji di akun Mitra utama, Anda harus mendapatkan token keamanan Microsoft Entra. Token keamanan ini didasarkan pada aplikasi, kunci, dan domain Pusat Mitra Anda (bukan aplikasi kotak pasir integrasi, kunci, dan domain Anda).

Ikuti langkah-langkah dalam autentikasi Pusat Mitra untuk mendapatkan token keamanan Microsoft Entra menggunakan kredensial Pusat Mitra utama Anda. (Sebelumnya Anda mengikuti langkah-langkah ini untuk mendapatkan token keamanan Microsoft Entra untuk sandbox integrasi Anda.)
Ganti token keamanan integrasi dalam kode Anda dengan token keamanan baru untuk akun Mitra utama Anda.

Bagikan melalui