Dokumen ini menjelaskan cara mengautentikasi dan menyiapkan akses API dalam workstation. Untuk mengetahui informasi umum tentang autentikasi Google Cloud, lihat ringkasan autentikasi.
Melakukan autentikasi sebagai pengguna dengan Google Cloud CLI
Setelah meluncurkan Cloud Workstations, Anda dapat mengakses layanan Google Cloud dan API menggunakan akun pengguna melalui CLI gcloud
.
- Buka terminal di workstation Anda. Cara Anda membuka jendela terminal bergantung pada IDE yang Anda gunakan. Misalnya, jika Anda menggunakan editor dasar Cloud Workstations, buka terminal dengan memilih Terminal > New Terminal, atau dengan menekan Control+Shift+`.
- Autentikasi dengan perintah berikut:
gcloud auth login --no-launch-browser
- Ikuti petunjuk yang diberikan oleh perintah untuk melakukan autentikasi ke Google Cloud.
- Tentukan project ID Google Cloud Anda dengan perintah berikut:
gcloud config set project PROJECT_ID
-
Aktifkan Kredensial Default Aplikasi agar Anda dapat memanggil layanan Google Cloud.
gcloud auth application-default login
- Kredensial CLI
gcloud
Anda kini disimpan dan tersedia saat Anda menggunakan workstation Anda di sesi mendatang.
Memberikan permintaan HTTP ke workstation
Untuk memberikan permintaan HTTP ke workstation, Anda memerlukan token akses untuk akun yang memiliki peran Cloud Workstations User di workstation tersebut:
- Buat token akses menggunakan metode API generateAccessToken.
- Tambahkan header HTTP bernama
Authorization
dengan nilaiBearer $TOKEN
.
Menghubungkan ke workstation di browser
Membuka URL workstation di browser akan otomatis mengautentikasi melalui pengalihan ke server workstation, dan mengambil token akses yang dibuat oleh metode API generateAccessToken. Tindakan ini akan mengalihkan kembali ke workstation Anda dan menetapkan cookie autentikasi yang valid untuk sesi workstation Anda saat ini.
Untuk melewati pengalihan ini, gunakan parameter URL
_workstationAccessToken
:
- Buat token akses menggunakan metode API generateAccessToken.
- Buka URL workstation Anda di browser dan tambahkan parameter URL
dengan format berikut:
_workstationAccessToken=TOKEN
.
Tindakan ini akan menetapkan cookie autentikasi di browser Anda yang mengizinkan akses untuk sesi workstation Anda saat ini. Melewati pengalihan dapat berguna saat akses ke server workstation diblokir oleh kebijakan jaringan, atau saat menggunakan iframe untuk menampilkan workstation di situs lain.
Meniru identitas akun layanan
Jika kebijakan keamanan organisasi Anda mencegah akun pengguna memiliki izin yang diperlukan, Anda juga dapat meniru identitas akun layanan menggunakan properti
impersonate_service_account
CLI gcloud
.
-
Untuk memastikan akun utama memiliki izin yang diperlukan untuk meniru akun layanan, minta administrator untuk memberikan Peran IAM Pembuat Token Akun Layanan (
roles/iam.serviceAccountTokenCreator
) kepada akun utama di akun layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.Peran yang telah ditetapkan ini berisi izin
iam.serviceAccounts.getAccessToken
, yang diperlukan untuk meniru akun layanan.Administrator Anda mungkin juga dapat memberi akun utama izin ini dengan peran khusus atau peran bawaan lainnya.
- Buka terminal di workstation Anda atau buka terminal yang sudah terbuka.
- Untuk menetapkan properti
impersonate_service_account
, masukkan perintah CLIgcloud
berikut:gcloud config set auth/impersonate_service_account=SERVICE_ACCT_EMAIL
- Kredensial CLI
gcloud
Anda kini disimpan dan tersedia saat Anda menggunakan workstation Anda di sesi mendatang.
Untuk mengetahui informasi selengkapnya, lihat Menggunakan peniruan akun layanan.
Langkah selanjutnya
- Pelajari dukungan SSH lebih lanjut.
- Lihat daftar parameter konfigurasi workstation.
- Kontrol akses dengan Identity and Access Management dan Cloud Workstations