Halaman ini diterjemahkan oleh Cloud Translation API.

Memulai

Sebelum menggunakan Library Reseller Android Umum, reseller harus bergabung dengan Program Deployment Knox dan pendaftaran zero-touch Android Samsung.

Knox Deployment Program (KDP)

Ikuti langkah-langkah di bawah untuk bergabung dengan KDP dan mengambil detail yang diperlukan untuk mulai menggunakan library reseller.

Langkah 1: daftar ke KDP

Buka Samsung Knox untuk Reseller untuk mendaftar ke KDP.
Buat akun Samsung dan daftar ke akun Samsung Knox sebagai reseller.
Setelah akun reseller Anda disetujui, login ke portal KDP untuk menemukan resellerId Anda.

Langkah 2: minta akses ke Portal Knox Cloud API

Kirim permintaan ke Samsung untuk mendapatkan akses ke Portal Knox Cloud API.
Login ke Portal Knox Cloud API.

Langkah 3: dapatkan kunci akun layanan dan `clientIdentifier`

Download file JSON pasangan kunci dari portal Knox Cloud API dan simpan di tempat yang aman.
Buat clientIdentifier unik Anda dari portal Knox Cloud API.

Langkah 4: buat objek `SamsungResellerService`

Gunakan jalur file JSON, clientIdentifier, resellerId untuk membuat objek SamsungResellerService guna menggunakan library umum.

Pendaftaran zero-touch

Langkah 1: bergabunglah dengan program pendaftaran zero-touch

Lakukan aktivasi dengan pendaftaran zero-touch.
Karena Library Reseller Android Umum menggunakan Reseller API, Anda perlu meminta akses ke Reseller API dari Konsultan Solusi Platform Google Anda.
Minta akses ke portal zero-touch.

Dengan Akun Google yang sama yang Anda gunakan untuk mengakses portal, ikuti petunjuk lainnya untuk membuat akun layanan dan mengaktifkan Reseller API.

Langkah 2: buat akun layanan

Akun layanan, yang terkadang disebut akun robot, adalah Akun Google yang mewakili aplikasi, bukan pengguna. Karena library pendaftaran memanggil Google API atas nama akun layanan, gunakan Konsol API Google untuk menyiapkan akses.

Membuat project Konsol API

Sebaiknya buat project dan akun layanan Konsol API baru. Hal ini akan mempermudah pengelolaan akses, pengelolaan resource, dan perbaikan kunci yang hilang di masa mendatang. Mulailah dengan mengikuti langkah-langkah di bawah ini untuk membuat project baru di Konsol API Google:

Buka Konsol API.
Dari daftar project, pilih Buat project.
Masukkan nama yang menjelaskan aplikasi dan pendaftaran zero-touch Anda.
Tentukan project ID atau terima default.
Klik Buat.

Untuk mengetahui informasi selengkapnya, baca dokumen Google Cloud Platform Mengelola project di konsol.

Menambahkan kredensial layanan baru

Untuk menambahkan kredensial baru dan akun layanan ke project, ikuti langkah-langkah di bawah di Konsol API.

Buka halaman Akun layanan. Jika diminta, pilih sebuah project.
Klik Buat Akun Layanan, masukkan nama dan deskripsi untuk akun layanan. Anda dapat menggunakan ID akun layanan default, atau memilih ID yang berbeda dan unik. Setelah selesai, klik Buat.
Bagian Izin akun layanan (opsional) yang ditampilkan setelahnya tidak diperlukan. Klik Lanjutkan.
Pada layar Beri pengguna akses ke akun layanan ini, scroll ke bawah ke bagian Buat kunci. Klik Buat kunci.
Di panel samping yang ditampilkan, pilih format untuk kunci Anda: JSON direkomendasikan.
Klik Buat. Pasangan kunci umum/pribadi baru Anda dibuat dan didownload ke komputer, dan berfungsi sebagai satu-satunya salinan dari kunci ini. Untuk informasi cara menyimpannya dengan aman, lihat Mengelola kunci akun layanan.
Klik Tutup pada dialog Kunci pribadi disimpan ke komputer Anda, lalu klik Selesai untuk kembali ke tabel akun layanan.

Salin alamat email akun layanan dan simpan. Anda memerlukannya nanti saat menautkan akun layanan ke organisasi.

Langkah 3: simpan file kunci JSON

Konsol API membuat pasangan kunci pribadi baru yang digunakan untuk mengautentikasi panggilan API yang dilakukan menggunakan akun layanan Anda. Kunci pribadi ada dalam file kunci JSON yang Anda download.

Anda harus menjaga kerahasiaan kunci, jadi jangan sertakan kunci dalam kode sumber software Anda. Jika kehilangan file kunci, Anda harus membuat pasangan kunci baru.

Untuk mempelajari lebih lanjut cara menyimpan file kunci dengan aman, baca Praktik terbaik untuk menggunakan kunci API dengan aman.

Langkah 4: aktifkan API

Sebelum library dapat menggunakan Reseller API, Anda harus mengaktifkannya. Mengaktifkan API akan mengaitkannya dengan project Konsol API saat ini dan menambahkan halaman pemantauan di konsol Anda.

Untuk mengaktifkan Reseller API, ikuti langkah-langkah di bawah ini di Konsol API:

Klik APIs & Services > Library.
Gunakan kolom penelusuran untuk menemukan Android Device Provisioning Partner API.
Klik Android Device Provisioning Partner API.
Klik Aktifkan.

Setelah penundaan singkat, status API berubah menjadi aktif. Jika Anda tidak melihat Android Device Provisioning Partner API, pastikan organisasi Anda telah diaktifkan untuk pendaftaran zero-touch. Pastikan Anda menggunakan Akun Google yang sama untuk pendaftaran zero-touch dan Konsol API Google. Minta Konsultan Solusi Platform Google Anda untuk memeriksa apakah Akun Google Anda memiliki akses ke API atau tidak.

Langkah 5: tautkan akun layanan

Menautkan akun layanan dengan akun pendaftaran zero-touch organisasi Anda akan mengizinkan akun layanan untuk melakukan panggilan API atas nama organisasi Anda. Ikuti langkah-langkah di bawah untuk menautkan akun layanan Anda:

Buka portal pendaftaran zero-touch. Anda mungkin perlu login.
Klik Akun layanan.
Klik Tautkan akun layanan.
Tetapkan Alamat email ke alamat akun layanan yang Anda buat.
Klik Tautkan akun layanan untuk menggunakan akun layanan dengan akun pendaftaran zero-touch Anda.

Jika Anda tidak dapat menemukan alamat email akun layanan yang Anda buat, salin dari salah satu tempat berikut:

Service account ID dari halaman Service accounts di Google API Console.
Kolom properti client_email dalam file kunci JSON.

Anda kini dapat menggunakan akun layanan dengan library pendaftaran untuk membuat objek ResellerService.

Menambahkan Library Reseller Android Umum ke project Gradle

Library ini tersedia sebagai repositori Maven. Ikuti langkah-langkah berikut untuk menambahkan library ke project Gradle baru:

Jalankan perintah berikut untuk membuat project baru:

gradle init --type basic
mkdir -p src/main/java src/main/resources

Salin file service_account_key.json yang Anda download di Langkah 2 ke direktori src/main/resources/ yang Anda buat di atas.
Buka file build.gradle default dan deklarasikan repositori Maven pusat untuk build Anda:
```
repositories {
    mavenCentral()
}
```

Dalam file yang sama, tambahkan dependensi berikut:

dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

Project Anda kini dapat menggunakan library klien untuk mendaftarkan perangkat Android.

Langkah berikutnya: Operasi umum