Sebagian atau seluruh informasi di halaman ini mungkin tidak berlaku untuk Cloud de Confiance dari S3NS. Lihat Perbedaan dengan Google Cloud untuk mengetahui detail selengkapnya.
Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.
Halaman ini menjelaskan cara menggunakan library klien untuk mengakses Google API.
Library klien mempermudah akses Cloud de Confiance by S3NS API
menggunakan bahasa yang didukung. Anda dapat menggunakan Cloud de Confiance by S3NS API secara langsung dengan
membuat permintaan mentah ke server, tetapi library klien memberikan penyederhanaan
yang secara signifikan mengurangi jumlah kode yang perlu ditulis. Hal ini
terutama berlaku untuk autentikasi, karena library klien mendukung
Kredensial Default Aplikasi (ADC).
Menggunakan Kredensial Default Aplikasi dengan library klien
Untuk menggunakan Kredensial Default Aplikasi guna mengautentikasi aplikasi, Anda
harus terlebih dahulu menyiapkan ADC untuk
lingkungan tempat aplikasi berjalan. Saat Anda menggunakan library klien untuk membuat klien, library klien akan otomatis memeriksa dan
menggunakan kredensial yang Anda berikan ke ADC untuk melakukanautentikasi ke API
yang digunakan oleh kode Anda. Aplikasi Anda tidak perlu secara eksplisit mengautentikasi
atau mengelola token; persyaratan ini dikelola secara otomatis oleh
library autentikasi.
Contoh kode berikut membuat klien untuk layanan Cloud Storage.
Kode Anda cenderung membutuhkan klien yang berbeda; contoh ini dimaksudkan hanya untuk
menunjukkan cara membuat klien dan menggunakannya tanpa kode untuk mengautentikasi secara
eksplisit.
Sebelum dapat menjalankan contoh berikut, Anda harus menyelesaikan langkah-langkah berikut:
Anda hanya dapat menggunakan kunci API dengan library klien untuk API yang menerima kunci API. Selain itu, kunci API tidak boleh memiliki pembatasan API yang mencegahnya digunakan untuk API.
Untuk mengetahui informasi selengkapnya tentang kunci API yang dibuat dalam mode ekspres, lihat
FAQ mode ekspres Google Cloud.
Saat Anda menggunakan kunci API di aplikasi, pastikan kunci tersebut tetap aman selama penyimpanan dan transmisi. Menampilkan kunci API kepada publik dapat menyebabkan tagihan tidak terduga pada akun Anda. Untuk mengetahui informasi selengkapnya, lihat
Praktik terbaik untuk mengelola kunci API.
Persyaratan keamanan saat menggunakan konfigurasi kredensial dari sumber eksternal
Biasanya, Anda membuat konfigurasi kredensial menggunakan perintah gcloud CLI atau menggunakan konsol Cloud de Confiance . Misalnya, Anda dapat menggunakan
gcloud CLI untuk membuat file ADC lokal atau file konfigurasi
login. Demikian pula, Anda dapat menggunakan konsol Cloud de Confiance untuk membuat dan mendownload
kunci akun layanan.
Namun, untuk beberapa kasus penggunaan, konfigurasi kredensial diberikan kepada Anda oleh entitas eksternal; konfigurasi kredensial ini dimaksudkan untuk digunakan guna melakukan autentikasi ke Google API.
Beberapa jenis konfigurasi kredensial mencakup endpoint dan jalur file, yang digunakan oleh library autentikasi untuk mendapatkan token. Saat menerima konfigurasi
kredensial dari sumber eksternal, Anda harus memvalidasi konfigurasi
sebelum menggunakannya. Jika Anda tidak memvalidasi konfigurasi, pelaku berbahaya
dapat menggunakan kredensial untuk membahayakan sistem dan data Anda.
Memvalidasi konfigurasi kredensial dari sumber eksternal
Cara Anda perlu memvalidasi kredensial eksternal bergantung pada jenis
kredensial yang diterima aplikasi Anda.
Memvalidasi kunci akun layanan
Jika aplikasi Anda hanya menerima kunci akun layanan, gunakan pemuat
kredensial khusus untuk kunci akun layanan, seperti yang ditunjukkan dalam contoh berikut. Pemuat kredensial khusus jenis hanya mengurai kolom yang ada untuk kunci akun layanan, yang tidak mengekspos kerentanan apa pun.
Jika Anda tidak dapat menggunakan pemuat kredensial khusus jenis, validasi kredensial dengan
mengonfirmasi bahwa nilai untuk kolom type adalah service_account. Jika
nilai untuk kolom type adalah nilai lain, jangan gunakan kunci akun layanan.
Tabel berikut mencantumkan kolom yang perlu Anda validasi, jika ada
dalam kredensial Anda. Tidak semua kolom ini ada untuk semua konfigurasi kredensial.
Kolom
Tujuan
Nilai yang diharapkan
service_account_impersonation_url
Library autentikasi menggunakan kolom ini untuk mengakses endpoint guna
membuat token akses untuk akun layanan yang identitasnya ditiru.
Library autentikasi mengirim token eksternal ke endpoint ini untuk
menukarnya dengan
token akses federasi.
https://sts.s3nsapis.fr/v1/token
credential_source.file
Library autentikasi membaca token eksternal dari file di
lokasi yang ditentukan oleh kolom ini dan mengirimkannya ke
endpoint token_url.
Jalur untuk file yang berisi token eksternal. Anda harus
mengenali jalur ini.
credential_source.url
Endpoint yang menampilkan token eksternal. Library autentikasi
mengirim permintaan ke URL ini dan mengirim respons ke
endpoint token_url.
Salah satu item berikut:
Endpoint terkenal yang disediakan oleh penyedia cloud Anda.
Endpoint yang telah Anda siapkan secara eksplisit untuk menyediakan token.
credential_source.executable.command
Jika variabel lingkungan GOOGLE_EXTERNAL_ACCOUNT_ALLOW_EXECUTABLES
ditetapkan ke 1, library autentikasi
akan menjalankan perintah atau file yang dapat dieksekusi ini.
File atau perintah yang dapat dieksekusi yang menampilkan token eksternal.
Anda harus mengenali perintah ini dan memvalidasi bahwa perintah tersebut aman.
credential_source.aws.url
Library autentikasi membuat permintaan ke URL ini untuk mengambil
token keamanan AWS.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2026-08-08 UTC."],[],[]]