Keamanan credential ​

Aturan dasar ​

  • Jangan menaruh token di command argument, repository, Markdown, screenshot, atau log.
  • Gunakan secret manager CI untuk CLOUDFLARE_API_TOKEN dan CLOUDFLARE_ACCOUNT_ID.
  • Buat token Cloudflare dengan scope dan account sekecil mungkin.
  • Pisahkan profile personal, kerja, dan automation.
  • Hapus environment variable sementara setelah digunakan.
  • Rotasi token segera bila pernah tampil di output, history, commit, atau percakapan.

Credential data produk (TinyFish Quality Booster) ​

Kunci API TINYFISH_API_KEY diperoleh melalui portal resmi TinyFish AI (tinyfish.ai). Kredensial ini dipakai CuanAff sebagai mesin riset semantik cerdas bertenaga TinyFish Search & Fetch untuk mencari, membaca halaman toko resmi pabrikan, menyalin spesifikasi teknis verbatim (zero-hallucination), menyaring jebakan DP/aksesoris, dan mengunduh foto resmi HD saat menjalankan perintah kurasi seperti catalog:discover dan product:add.

Panduan aktivasi dan pengelolaan aman: ​

  1. Aktivasi 1-Klik via CLI (Sangat Direkomendasikan):

    bash
    php cuanaff tinyfish set <key>

    Sistem akan menyimpan API key secara aman ke credential store native sistem operasi (Keyring di Linux, Keychain di macOS, Credential Manager di Windows) atau file private berizin 0600 tanpa pernah tersimpan di repositori publik.

  2. Periksa Status Konfigurasi (Bebas Kebocoran):

    bash
    php cuanaff tinyfish status

    Perintah ini memverifikasi apakah TinyFish aktif dan siap digunakan tanpa pernah membocorkan atau mencetak nilai key ke layar terminal.

  3. Cabut Kunci Kapan Saja:

    bash
    php cuanaff tinyfish remove

  4. Alternatif Berkas .env: Anda juga dapat menetapkan environment variable secara lokal:

    bash
    TINYFISH_API_KEY=kunci_api_tinyfish_anda

Aturan keamanan data: ​

  • Key hanya dibaca dari environment/keystore saat aplikasi berjalan. Jangan menaruhnya di file repository, site.yaml, niche, fixture, screenshot, atau log publik.
  • CuanAff tidak pernah mencetak key. Redaksi otomatis ([REDACTED]) diterapkan pada setiap keluaran log dan error tracing.
  • Key 100% Opsional ($0 Modal Pemula): Mengikuti prinsip Progressive Disclosure, CuanAff tetap berjalan 100% normal tanpa kewajiban API key TinyFish. Anda dapat memulai tanpa biaya sepeser pun ($0 modal). Jika key tidak disetel, CuanAff otomatis memakai kurasi manual satuan (product:add), prompt bantuan asisten AI lokal, atau data katalog bawaan tanpa menimbulkan eror sistem.
  • Putuskan akses sementara: Tetapkan TINYFISH_ENABLED=false bila perlu menonaktifkan riset live tanpa menghapus key yang tersimpan.
  • Rotasi key: Segera cabut dan perbarui key di dasbor portal resmi tinyfish.ai bila terindikasi bocor atau terekspos, lalu perbarui di komputer lokal via php cuanaff tinyfish set <key_baru>.

Tempat penyimpanan ​

Pada desktop, Cuanaff memilih penyimpanan native OS. Pada Linux headless tanpa Secret Service, fallback adalah file credential private 0600. Metadata non-secret seperti nama profile dan account ID disimpan di konfigurasi per-user.

Anda dapat melihat backend yang dipakai tanpa menampilkan token:

bash
php cuanaff auth list --json

Periksa field credential_store. Jangan menyalin file credential ke repository atau artifact build.

CI yang bersih ​

Berikan secret hanya kepada job deploy, bukan seluruh workflow. Hindari shell tracing (set -x) dan jangan mencetak environment. Setelah job selesai, runner ephemeral seharusnya dibuang.

Untuk validasi non-deploy, jangan inject token jika command tidak memerlukannya.