Mengautentikasi ke Cloud Vision API

Menggunakan akun layanan

Menggunakan akun layanan untuk mengautentikasi adalah metode yang lebih disukai. Untuk menggunakan akun layanan guna mengautentikasi ke Vision API:

  1. 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:

  1. Instal gcloud CLI.
  2. 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
    
  3. Dapatkan sebuah token otorisasi menggunakan akun layanan Anda:

    gcloud auth print-access-token
    

    Perintah ini menampilkan nilai token akses.

  4. 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:

  1. Ikuti petunjuk guna membuat kunci API untuk project Google Cloud Console Anda.

  2. 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.