Memulai

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

Program Deployment Knox (KDP)

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

Langkah 1: daftar ke KDP

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

Langkah 2: minta akses ke Portal API Knox Cloud

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

Langkah 3: mendapatkan kunci akun layanan dan clientIdentifier

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

Langkah 4: buat objek SamsungResellerService

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

Pendaftaran zero-touch

Langkah 1: bergabung ke program pendaftaran zero-touch

  1. Lakukan aktivasi dengan pendaftaran zero-touch.
  2. Karena Library Reseller Android Umum menggunakan Reseller API, Anda perlu meminta akses ke Reseller API dari Platform Google Konsultan Solusi.
  3. 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, terkadang disebut akun robot, adalah Akun Google mewakili aplikasi, bukan pengguna. Karena library pendaftaran memanggil Google API atas nama akun layanan, gunakan Konsol API Google untuk menetapkan akses lebih tinggi.

Membuat project Konsol API

Membuat project dan layanan Konsol API baru adalah praktik yang baik menggunakan akun layanan. Hal ini membuat pengelolaan akses, resource, dan perbaikan kunci yang hilang lebih mudah di masa depan. Mulailah dengan mengikuti langkah-langkah di bawah ini untuk membuat project baru di Konsol API Google:

  1. Buka Konsol API.
  2. Dari daftar proyek, pilih Membuat project.
  3. Masukkan nama yang menjelaskan aplikasi dan pendaftaran zero-touch Anda.
  4. Tentukan project ID atau setujui default.
  5. Klik Buat.

Untuk mengetahui lebih lanjut, baca dokumen Google Cloud Platform Mengelola project di konsol.

Menambahkan kredensial layanan baru

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

  1. Buka halaman Akun layanan. Jika diminta, pilih sebuah project.
  2. 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.
  3. Bagian Izin akun layanan (opsional) yang ditampilkan setelahnya tidak diperlukan. Klik Lanjutkan.
  4. Pada layar Beri pengguna akses ke akun layanan ini, scroll ke bawah ke bagian Buat kunci. Klik Buat kunci.
  5. Di panel samping yang ditampilkan, pilih format untuk kunci Anda: JSON direkomendasikan.
  6. 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.
  7. 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 Anda 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 di kunci JSON yang didownload.

Anda harus menjaga kunci tetap bersifat pribadi, 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 dengan aman menggunakan kunci API.

Langkah 4: mengaktifkan 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:

  1. Klik API & Layanan > Koleksi.
  2. Gunakan kolom penelusuran untuk menemukan Android Device Provisioning Partner API.
  3. Klik Android Device Provisioning Partner API.
  4. Klik Aktifkan.

Setelah penundaan singkat, status API berubah menjadi aktif. Jika Anda tidak melihat Android Device Provisioning Partner API, periksa apakah aktivasi pendaftaran zero-touch. Pastikan Anda menggunakan ID Akun untuk pendaftaran zero-touch dan Konsol API Google. Tanya Google Konsultan Solusi Platform untuk memeriksa apakah Akun Google Anda memiliki akses ke API.

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

  1. Buka portal pendaftaran zero-touch. Anda mungkin perlu login.
  2. Klik Layanan akun.
  3. Klik Tautkan akun layanan.
  4. Tetapkan Alamat email ke alamat akun layanan yang Anda buat.
  5. 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:

  • ID akun layanan dari halaman Akun layanan di Konsol API Google.
  • 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:

  1. Jalankan perintah berikut untuk membuat project baru:

    gradle init --type basic
    mkdir -p src/main/java src/main/resources
    
  2. Salin file service_account_key.json yang Anda download di Langkah 2 ke direktori src/main/resources/ yang Anda buat di atas.

  3. Membuka file build.gradle default dan deklarasikan repositori Maven pusat untuk build Anda:

    repositories {
        mavenCentral()
    }
    
  4. Dalam file yang sama, tambahkan dependensi berikut:

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

Sekarang project Anda seharusnya dapat menggunakan library klien untuk mendaftarkan Android perangkat.


Langkah berikutnya: Operasi umum