Memulai

Autentikasi & Kunci API

Pelajari bagaimana Cloudizero mengamankan request melalui otorisasi token Bearer dan cara mengonfigurasi izin akses kunci dengan aman.

Struktur Kunci API

Kunci API Cloudizero mengikuti format prefiks standar:

cz_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Kunci di-hash dengan SHA-256 di basis data Cloudizero, memastikan bahwa bahkan dalam skenario kebocoran data, kunci mentah Anda tidak dapat terbongkar.

Menggunakan Kunci dalam Environment Variables

Selalu simpan Kunci API Anda di environment variables alih-alih menuliskannya langsung ke dalam source code:

.env.local

# .env.local
CLOUDIZERO_API_KEY="cz_live_9f8ab2e4..."
CLOUDIZERO_PROJECT_ID="prj_LXAlEW70v24YSc0y"

Pembatasan Cakupan Kunci & Prinsip Least Privilege

Saat membuat Kunci API di dashboard, Anda dapat memilih di antara mode cakupan:

Semua Proyek (Global): Kunci memiliki izin baca, unggah, dan hapus di seluruh proyek milik akun Anda. Ideal untuk orkestrasi backend sentral.
Proyek Terbatas: Kunci dikunci secara eksklusif hanya untuk proyek yang dipilih. Upaya mengunggah atau melihat file di luar proyek tersebut akan ditolak dengan 403 Forbidden.

Arsitektur Sisi Klien vs Sisi Server

Jangan pernah mengekspos kunci rahasia di browser

Hindari menginisialisasi new Cloudizero({ apiKey: ... }) langsung di komponen frontend React publik menggunakan kunci rahasia Anda. Sebaliknya, hasilkan URL presigned di backend Anda, atau gunakan Server Actions / API route proxy.

auth-request.ts

// Header Permintaan REST Langsung
fetch("https://api.cloudizero.com/api/storage/presign", {
  method: "POST",
  headers: {
    "Authorization": "Bearer cz_live_9f8ab2e4...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ ... })
});