Sebaiknya gunakan akun layanan untuk autentikasi saat Anda berintegrasi dengan Google Spectrum Access System (SAS) Portal API.
Menyiapkan akun layanan
Untuk menggunakan akun layanan untuk autentikasi, selesaikan langkah-langkah berikut:
- Membuat akun layanan
Buat kunci akun layanan dan pilih JSON sebagai jenis kunci Anda.
Setelah Anda menyelesaikan langkah ini, kunci akun layanan Anda akan didownload ke lokasi default browser.
Berikan peran Project Owner ke akun layanan.
Mendapatkan token pemilik
Anda harus memberikan autentikasi akun layanan sebagai token pembawa. Jika
Anda memanggil SAS Portal API secara langsung, misalnya dengan membuat permintaan
HTTP dengan curl
, Anda akan meneruskan autentikasi sebagai token pembawa di
header Authorization
.
Untuk mendapatkan token pembawa dengan akun layanan Anda, ikuti langkah-langkah berikut:
Menginstal Google Cloud CLI.
Di gcloud CLI, lakukan autentikasi ke akun layanan Anda:
gcloud auth activate-service-account --key-file ${KEY_FILE}
Ganti
${KEY_FILE}
dengan jalur ke file kunci akun layanan Anda.Gunakan akun layanan Anda untuk mendapatkan token otorisasi:
gcloud auth print-access-token
Perintah ini menampilkan nilai token akses.
Saat Anda menggunakan API, teruskan nilai token sebagai token pembawa di header
Authorization
. Contoh kode berikut menunjukkan cara meneruskan nilai token sebagai token pembawa:curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/customers"
Ganti kode berikut:
${CLIENT_PROJECT}
: ID project Google Cloud tempat Anda membuat permintaan${TOKEN}
: token otorisasi
Langkah selanjutnya
- Untuk mendapatkan ringkasan SAS Portal API, lihat Ringkasan Google SAS Portal API.
- Untuk informasi tentang setiap API, lihat halaman API Pelanggan dan Pengelola Perangkat.
- Untuk contoh cara menggunakan API, lihat contoh kode API.
- Untuk dokumentasi referensi, lihat API dan referensi.