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 uses AI technology to translate content into your preferred language. AI translations can contain errors.
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 Cloud de Confiance konsol. Misalnya, Anda dapat menggunakan gcloud CLI untuk membuat file ADC lokal atau file konfigurasi login. Demikian pula, Anda dapat menggunakan Cloud de Confiance konsol untuk membuat dan mendownload
kunci akun layanan.
Namun, untuk beberapa kasus penggunaan, konfigurasi kredensial diberikan kepada Anda oleh entity 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 Anda menerima konfigurasi kredensial dari sumber eksternal, Anda harus memvalidasi konfigurasi tersebut sebelum menggunakannya. Jika Anda tidak memvalidasi konfigurasi, pelaku kejahatan 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 lainnya, jangan gunakan kunci akun layanan.
Library autentikasi mengirimkan token eksternal ke endpoint ini untuk
menukarnya dengan
token akses gabungan.
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
token_url endpoint.
Jalur untuk file yang berisi token eksternal. Anda harus
mengenali jalur ini.
credential_source.url
Endpoint yang menampilkan token eksternal. Library autentikasi
mengirimkan permintaan ke URL ini dan mengirimkan respons ke
token_url endpoint.
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 mengeluarkan 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-06-01 UTC."],[],[]]