Menggunakan akun layanan
Menggunakan akun layanan untuk mengautentikasi adalah metode yang lebih disukai. Untuk menggunakan akun layanan guna mengautentikasi ke Vision API:
- Ikuti petunjuk untuk membuat akun layanan. Pilih JSON sebagai jenis kunci Anda.
Setelah selesai, kunci akun layanan Anda akan didownload ke lokasi default browser.
Selanjutnya, tentukan apakah Anda akan memberikan autentikasi akun layanan sebagai token pemilik atau menggunakan kredensial default aplikasi.
Token pemilik
Jika Anda memanggil Vision API secara langsung, misalnya dengan membuat permintaan HTTP dengan cURL, Anda harus meneruskan autentikasi sebagai token pemilik di header Authorization
. Cara mendapatkan token pemilik menggunakan akun layanan Anda:
- Instal gcloud CLI.
Autentikasi akun layanan Anda, dengan mengganti
KEY_FILE
di bawah dengan jalur ke file kunci akun layanan Anda:gcloud auth activate-service-account --key-file KEY_FILE
Dapatkan sebuah token otorisasi menggunakan akun layanan Anda:
gcloud auth print-access-token
Perintah ini menampilkan nilai token akses.
Saat memanggil API, dapatkan token otorisasi menggunakan akun layanan Anda di header
Authorization
:curl -s -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json" \ "https://vision.googleapis.com/v1/images:annotate" -d @request.json
Kredensial default aplikasi
Jika Anda menggunakan library klien untuk memanggil Vision API, gunakan Kredensial Default Aplikasi (ADC).
Layanan yang menggunakan ADC mencari kredensial dalam variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS
. Kecuali jika Anda secara khusus ingin ADC menggunakan kredensial lain (misalnya, kredensial pengguna), sebaiknya tetapkan variabel lingkungan ini agar mengarah ke file kunci akun layanan Anda.
export GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_KEY_FILE
Ganti PATH_TO_KEY_FILE
dengan jalur ke file akun layanan JSON Anda.
GOOGLE_APPLICATION_CREDENTIALS
harus ditulis apa adanya (bukan placeholder dalam contoh di atas).
Menggunakan kunci API
Anda dapat menggunakan kunci API konsol Google Cloud untuk mengautentikasi ke Vision API.
Untuk melakukannya:
Ikuti petunjuk guna membuat kunci API untuk project Google Cloud Console Anda.
Saat membuat permintaan Vision API, teruskan kunci Anda sebagai nilai parameter
key
. Contoh:POST https://vision.googleapis.com/v1/images:annotate?key=YOUR_API_KEY
Pastikan untuk membaca Praktik terbaik untuk menggunakan kunci API dengan aman guna mencegah penggunaan kunci API secara tidak sah.