Untuk mengetahui informasi tentang cara kerja ADC, termasuk tempat dimana kredensial ditemukan, lihat Cara kerja Kredensial Default Aplikasi.
Kredensial pengguna tidak berfungsi
Jika permintaan API Anda menampilkan pesan error tentang kredensial pengguna yang tidak didukung oleh API ini, API tidak diaktifkan dalam project atau tidak ada project kuota yang ditetapkan, tinjau informasi berikut.
Ada dua jenis API Google Cloud :
API berbasis resourcemenggunakan project terkait dengan resource yang diakses untuk penagihan dan kuota.
API berbasis klien, yang menggunakan project terkait dengan klien yang mengakses resource untuk penagihan dan kuota.
Ketika Anda memberikan kredensial pengguna untuk mengautentikasi ke API berbasis klien, Anda harus menentukan project yang akan digunakan untuk penagihan dan kuota. Project ini disebut project kuota.
Ada sejumlah cara untuk menentukan project kuota, termasuk opsi berikut:
Perbarui file ADC Anda untuk menggunakan project yang berbeda sebagai project kuota:
gcloud auth application-default set-quota-project YOUR_PROJECT
Jika menggunakan gcloud CLI untuk memanggil API, Anda dapat menetapkan project kuota di konfigurasi gcloud CLI:
gcloud config set billing/quota_project YOUR_PROJECT
Jika Anda memanggil REST atau RPC API secara langsung, gunakan
x-goog-user-projectheader HTTP untuk menentukan project kuota di setiap permintaan. Untuk mengetahui detailnya, lihat Menetapkan project kuota dengan permintaan REST.
Anda harus memiliki serviceusage.services.use izin IAM
agar project dapat menetapkannya sebagai project penagihan. Izin serviceusage.services.use disertakan dalam peran IAM Service Usage Consumer. Jika Anda tidak memiliki izin serviceusage.services.use
untuk project apa pun, hubungi administrator keamanan atau pemilik project
yang dapat memberi Anda peran Service Usage Consumer dalam project tersebut.
Untuk mengetahui informasi lebih lanjut tentang project kuota, lihat Ringkasan project kuota. Untuk mengetahui informasi tentang cara tambahan dalam menetapkan project kuota, lihat Menetapkan project kuota.
Kredensial salah
Jika kredensial Anda tampaknya tidak memberikan akses yang Anda harapkan atau tidak ditemukan, periksa hal berikut:
Jika menggunakan gcloud CLI untuk mengakses Google Cloud di lingkungan lokal, pastikan Anda memahami kredensial yang Anda gunakan. Saat menggunakan gcloud CLI, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI dengan menggunakan perintah
gcloud auth login. Anda tidak menggunakan kredensial yang diberikan kepada ADC. Untuk mengetahui informasi selengkapnya tentang kedua set kredensial ini, lihat konfigurasi autentikasi gcloud CLI dan konfigurasi ADC.Pastikan variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALSditetapkan hanya jika Anda menggunakan kunci akun layanan atau file JSON lainnya untuk ADC. Kredensial yang ditunjukkan oleh variabel lingkungan lebih diutamakan daripada kredensial lainnya, termasuk untuk Workload Identity Federation untuk GKE.Pastikan akun utama yang membuat permintaan memiliki peran IAM yang diperlukan. Jika Anda menggunakan kredensial pengguna, peran tersebut harus diberikan ke alamat email yang terkait dengan akun pengguna. Jika Anda menggunakan akun layanan, akun layanan tersebut harus memiliki peran yang diperlukan.
Jika Anda memberikan kunci API bersama permintaan API, kunci API akan lebih diutamakan daripada ADC di lokasi mana pun. Jika Anda telah menetapkan
GOOGLE_APPLICATION_CREDENTIALSvariabel lingkungan dan menggunakan kunci API, API mungkin menampilkan peringatan yang memberitahukan bahwa kredensial yang Anda berikan ke ADC diabaikan. Untuk menghentikan peringatan, batalkanGOOGLE_APPLICATION_CREDENTIALSvariabel lingkungan.
Cakupan autentikasi tidak memadai
Jika permintaan API Anda menampilkan Request had insufficient authentication scopes
dengan alasan ACCESS_TOKEN_SCOPE_INSUFFICIENT, token akses Anda tidak
menyertakan cakupan yang diperlukan API. Memberikan peran IAM tidak akan memperbaiki error ini.
Untuk mengatasi error, lakukan tindakan berikut:
Identifikasi API dari kolom
servicedanmethoddalam detail error.Temukan cakupan yang diperlukan API dalam referensi API metode atau di Cakupan OAuth 2.0 untuk Google API. Sebagian besar API Google Cloud menerima cakupan
https://www.googleapis.com/auth/cloud-platform. Google Workspace API memerlukan cakupannya sendiri.Periksa cakupan yang dimiliki token Anda. Dari lingkungan tempat error terjadi, jalankan perintah berikut dan tinjau kolom
scope:curl "https://oauth2.googleapis.com/tokeninfo?access_token=$(gcloud auth application-default print-access-token)"
Tambahkan cakupan yang tidak ada ke tempat kredensial Anda mendapatkan cakupannya:
Compute Engine: Memperbarui cakupan akses VM. Untuk mengetahui informasi selengkapnya, lihat Cakupan akses dan Melampirkan akun layanan dan memperbarui cakupan akses.
GKE: Buat node pool dengan cakupan akses yang diperlukan, atau gunakan Workload Identity Federation for GKE untuk workload Anda. Untuk informasi selengkapnya, lihat Cakupan akses default dan Melakukan autentikasi ke API Google Cloud dari workload GKE.
Kode Anda: Tambahkan cakupan ke cakupan yang Anda minta saat membuat kredensial. Untuk cakupan yang diperlukan setiap API, lihat Cakupan OAuth 2.0 untuk Google API.
Delegasi tingkat domain: Izinkan cakupan yang diperlukan untuk client ID akun layanan di konsol Admin Google Workspace, lalu minta cakupan tersebut dalam kode Anda saat membuat kredensial. Untuk mengetahui informasi selengkapnya, lihat Mendelegasikan otoritas tingkat domain ke akun layanan dan Mengontrol akses API dengan delegasi tingkat domain.
Jenis kredensial tidak dikenal
Jika permintaan API Anda menampilkan error yang menyertakan Error creating credential
from JSON. Unrecognized credential type, pastikan Anda menggunakan kredensial yang valid. File ID klien tidak didukung untuk memberikan kredensial bagi ADC.
Error yang ditampilkan untuk kredensial lokal dari peniruan akun layanan
Kredensial dari file ADC lokal yang dibuat menggunakan peniruan akun layanan tidak didukung oleh semua library autentikasi. Jika panggilan Anda menampilkan error yang mirip dengan Neither metadata server or valid service
account credentials are found, Anda tidak dapat menggunakan kredensial lokal yang ditiru untuk tugas ini.
Untuk menghindari error ini, buat file ADC dari kredensial pengguna Anda atau jalankan kode Anda di lingkungan yang memiliki server metadata yang tersedia (seperti Compute Engine).
Project tidak dikenal 764086051850 digunakan untuk permintaan
Project 764086051850 adalah project yang digunakan oleh gcloud CLI. Jika Anda melihat error autentikasi yang merujuk ke project ini, berarti Anda mencoba menggunakan API berbasis klien dan belum menetapkan project serta project kuota untuk konfigurasi Anda.
Untuk mengetahui informasi selengkapnya, lihat Kredensial pengguna tidak berfungsi.
Akses diblokir saat menggunakan cakupan
Saat Anda mencoba membuat file ADC lokal, dan error yang mirip dengan This app
is blocked atau Access blocked: Authorization Error ditampilkan, Anda mungkin mencoba menggunakan cakupan yang tidak didukung oleh perintah penyiapan ADC default. Biasanya, masalah ini disebabkan oleh penambahan cakupan untuk aplikasi di luar Google Cloud, seperti Google Drive.
Secara default, token akses yang dihasilkan dari file ADC lokal yang dibuat dengan kredensial pengguna
mencakup
cakupan seluruh cloud https://www.googleapis.com/auth/cloud-platform.
Untuk menentukan cakupan secara eksplisit, gunakan
flag --scopes
dengan perintah gcloud auth application-default login.
Untuk menambahkan cakupan bagi layanan di luar Google Cloud, seperti Google Drive, Anda dapat melakukan salah satu hal berikut:
-
Autentikasi OAuth:
Buat client ID OAuth.
Berikan client ID ke perintah
gcloud auth application-default loginmenggunakan flag--client-id-file, dan tentukan cakupan Anda dengan flag--scopes. -
Autentikasi akun layanan: Buat akun layanan.
Tiru akun layanan dengan memberikan alamat emailnya ke perintah
gcloud auth application-default logindengan flag--impersonate-service-account, dan tentukan cakupan Anda dengan flag--scopes.