Jika berencana menggunakan library klien atau alat pengembangan pihak ketiga yang mendukung Kredensial Default Aplikasi (ADC) di lingkungan pengembangan lokal, Anda harus mengonfigurasi ADC di lingkungan lokal. Untuk informasi selengkapnya, lihat Menyiapkan Kredensial Default Aplikasi untuk lingkungan pengembangan lokal.
Cara Anda melakukan autentikasi dan menggunakan gcloud CLI bergantung pada tempat Anda menjalankan alat tersebut:
Lingkungan lokal
Untuk sebagian besar kasus penggunaan, Anda dapat menggunakan kredensial pengguna untuk login ke gcloud CLI, tetapi Anda juga dapat menggunakan akun layanan.
Saat Anda login ke gcloud CLI di lingkungan lokal, alat ini menempatkan akses dan token refresh di direktori beranda Anda. Setiap pengguna yang memiliki akses ke sistem file Anda dapat menggunakan kredensial tersebut. Untuk informasi lebih lanjut, lihat Memitigasi token OAuth yang disusupi untuk Google Cloud CLI.
Tabel berikut menjelaskan opsi untuk login ke gcloud CLI dan pengaruhnya terhadap kredensial yang digunakan oleh fitur untuk mengautentikasi dan memberi otorisasi ke Google API.
| Jenis kredensial | Perintah autentikasi | Catatan | Informasi selengkapnya |
|---|---|---|---|
| Kredensial pengguna |
Salah satu dari berikut ini:
|
Gcloud CLI menggunakan kredensial pengguna Anda untuk autentikasi dan otorisasi untuk semua Google API. Untuk menggunakan akun layanan untuk otorisasi ke Google API, gunakanpeniruan akun layanan. |
|
|
Workforce Identity Federation memungkinkan pengguna yang dikelola oleh penyedia identitas selain Google mengakses resource. Google Cloud | ||
| Akun layanan |
gcloud auth login --cred-file=WORKLOAD_IDENTITY_FEDERATION_CREDENTIAL_FILE
|
Workload Identity Federation memungkinkan beban kerja yang berjalan di luar Google Cloud mengakses Google Cloud resource. | Mengautentikasi workload |
gcloud auth login --cred-file=SERVICE_ACCT_KEY
|
Metode ini tidak direkomendasikan, karena menggunakan kunci akun layanan akan meningkatkan risiko. Untuk menggunakan akun layanan untuk otorisasi ke Google API, login ke gcloud CLI dengan kredensial pengguna Anda, lalu gunakan peniruan identitas akun layanan. |
Cloud Shell
Saat menggunakan Cloud Shell, Anda tidak perlu login ke gcloud CLI, tetapi Anda perlu melakukan otorisasi penggunaan akun sebelum menggunakan alat pengembangan apa pun dari Cloud Shell. Setelah melakukannya, gcloud CLI menggunakan kredensial pengguna Anda untuk mengakses Google API.
Untuk informasi selengkapnya, lihat Memberikan otorisasi dengan Cloud Shell.
Google Cloud resource komputasi
Saat menggunakan gcloud CLI pada Google Cloud resource komputasi seperti virtual machine Compute Engine, Anda tidak perlu melakukan inisialisasi atau login ke gcloud CLI, karena gcloud CLI mendapatkan informasi konfigurasi dan kredensialnya dari resource komputasi hosting dengan menggunakan server metadata.
| Jenis kredensial | Perintah autentikasi | Catatan | Informasi selengkapnya |
|---|---|---|---|
| Akun layanan | Tidak berlaku | Gcloud CLI menggunakan akun layanan yang terpasang ke resource komputasi untuk autentikasi dan otorisasi bagi semua Google API. | Menyiapkan ADC untuk resource dengan akun layanan terlampir |
Konfigurasi autentikasi gcloud CLI dan konfigurasi ADC
Saat login ke gcloud CLI, Anda menggunakan
perintah gcloud auth login untuk mengautentikasi principal ke gcloud CLI.
gcloud CLI menggunakan akun utama tersebut untuk autentikasi dan otorisasi guna mengelola Google Cloud resource dan layanan. Ini adalah konfigurasi autentikasi gcloud CLI Anda.
Saat menggunakan gcloud CLI untuk mengonfigurasi ADC, Anda menggunakan
perintah gcloud auth application-default login. Perintah
ini menggunakan prinsipal yang Anda berikan untuk mengonfigurasi ADC bagi
lingkungan lokal Anda. Ini adalah konfigurasi ADC Anda.
Konfigurasi autentikasi gcloud CLI Anda berbeda dengan konfigurasi ADC Anda. Mereka dapat menggunakan prinsipal yang sama atau prinsipal yang berbeda. gcloud CLI tidak menggunakan ADC untuk mengakses resource. Google Cloud
Tabel berikut menunjukkan kedua perintah beserta fungsinya:
| Perintah | Deskripsi |
|---|---|
gcloud auth login
|
Menerima kredensial yang digunakan untuk mengautentikasi dan mengizinkan akses ke layanan Google Cloud . |
gcloud auth application-default login
|
Membuat file ADC lokal berdasarkan kredensial yang Anda berikan ke perintah. |
Biasanya, Anda menggunakan akun yang sama untuk login ke gcloud CLI dan mengonfigurasi ADC, tetapi Anda dapat menggunakan akun yang berbeda jika diperlukan.
Langkah berikutnya
- Pelajari lebih lanjut cara ADC menemukan kredensial.
- Mengautentikasi untuk menggunakan Library Klien Cloud.
- Jelajahi metode autentikasi.