Menyiapkan akses API di Pusat Mitra
Berlaku untuk: | Pusat Mitra Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud for US Government
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 Anda, 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 Anda 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 lakukan 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 sandbox 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 Berencana menggunakan SDK Pusat Mitra.
Menyiapkan akun Anda
Bagian ini menjelaskan cara menyiapkan akun Mitra utama dan akun sandbox integrasi untuk SDK Pusat Mitra.
Membuat sandbox integrasi
Masuk ke Dasbor Mitra dengan akun admin global (akun Mitra utama Anda.)
Dari menu Pengaturan (ikon gigi), pilih Pengaturan akun.
Pilih tab 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 sandbox integrasi telah disiapkan.
Masukkan informasi kontak untuk akun admin kotak pasir integrasi. Lalu, pilih Buat akun. Tunggu beberapa menit hingga pesan konfirmasi bahwa akun telah dibuat.
Setelah Anda melihat pesan konfirmasi, keluar dari Dasbor Mitra.
Masuk kembali dengan akun admin sandbox integrasi baru Anda. Pastikan untuk menggunakan format username@domain untuk kredensial Anda bersama dengan kata sandi yang Anda tentukan.
Pilih Siapkan Akun di atas Tugas Saat Ini 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 Dasbor Mitra menggunakan akun admin global.
Dari menu Pengaturan (ikon gigi), pilih Pengaturan akun.
Pada halaman Pengaturan akun , pilih 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 sandbox 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 Azure AD.
| Nama Item | Lokasi item |
|---|---|
| ID Aplikasi / ID Klien | Dari menu Pengaturan (ikon gigi), pilih Pengaturan akun. Pada halaman Pengaturan akun , pilih Manajemen Aplikasi. ID Aplikasi/ID Klien terdaftar sebagai ID Aplikasi terdaftar. |
| Kunci | Jika Anda membuat aplikasi web di bagian Aktifkan akses API, ini adalah kunci yang Anda simpan di langkah 5. |
| Domain | Domain untuk sandbox 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 Azure AD. Token keamanan ini didasarkan pada aplikasi, kunci, dan domain Pusat Mitra Anda (bukan aplikasi, kunci, dan domain kotak pasir integrasi Anda).
Ikuti langkah-langkah dalam autentikasi Pusat Mitra untuk mendapatkan token keamanan Azure AD menggunakan kredensial Pusat Mitra utama Anda. (Anda sebelumnya mengikuti langkah-langkah ini untuk mendapatkan token keamanan Azure AD untuk sandbox integrasi Anda.)
Ganti token keamanan integrasi dalam kode Anda dengan token keamanan baru untuk akun Mitra utama Anda.