Halaman ini diterjemahkan oleh Cloud Translation API.

Mulai

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

Program Deployment Knox (KDP)

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

Langkah 1: mendaftar ke KDP

Kunjungi Samsung Knox untuk Reseller untuk mendaftar ke KDP.
Buat akun Samsung dan daftar untuk 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 Knox Cloud API Portal.

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 agar dapat menggunakan library umum.

Pendaftaran zero-touch

Langkah 1: bergabung dengan program pendaftaran zero-touch

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

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

Langkah 2: buat akun layanan

Akun layanan, 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 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 Create a project.
Masukkan nama yang mendeskripsikan aplikasi dan pendaftaran zero-touch Anda.
Tentukan ID project atau terima default.
Klik Create.

Untuk mencari tahu selengkapnya, baca dokumen Google Cloud Platform Mengelola project di konsol.

Tambahkan kredensial layanan baru

Untuk menambahkan kredensial dan akun layanan baru ke project Anda, ikuti langkah-langkah di bawah ini 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 muncul, pilih format untuk kunci Anda: JSON direkomendasikan.
Klik Create. 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 buat agar tetap berguna. Anda memerlukannya nanti saat menautkan akun layanan ke organisasi Anda.

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 di file kunci JSON yang Anda download.

Anda harus menjaga kunci tetap pribadi, jadi jangan sertakan dalam kode sumber software. 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. Pengaktifan 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 di Konsol API Anda:

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

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

Langkah 5: tautkan akun layanan

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

Buka portal zero-touch. Anda mungkin harus 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 dibuat, salin alamat tersebut dari salah satu tempat berikut:

ID akun layanan dari halaman Akun layanan di Konsol API Google.
Kolom properti client_email di file kunci JSON.

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

Menambahkan Library Android Reseller 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 sekarang dapat menggunakan library klien untuk mendaftarkan perangkat Android.

Langkah berikutnya: Operasi umum