Dokumentasi Sistem Autentikasi PaaS CLI

Sistem autentikasi pada PaaS CLI menggunakan pendekatan Hybrid. Sistem ini dirancang agar tetap interaktif dan mudah digunakan oleh developer (manusia) di lokal, namun sangat aman dan efisien saat dieksekusi secara otomatis oleh mesin (OpenClaw, CI/CD, atau skrip otomatisasi).

1. Konsep Utama (Manusia vs Mesin)

Untuk mendukung fleksibilitas, PaaS CLI mendeteksi metode autentikasi secara otomatis berdasarkan urutan prioritas eksekusi.

| Tipe Pengguna | Sifat Eksekusi | Metode Kredensial | Lokasi Penyimpanan | | :--- | :--- | :--- | :--- | | Mesin / CI/CD | Stateless (Tidak menyimpan sesi) | API Key (paas_xxx...) | Environment Variable | | Developer / Manusia | Stateful (Login satu kali) | JWT (Email & Password) | File Lokal (~/.paas-cli/config.json) |

2. Panduan Integrasi Mesin (OpenClaw / Infisical)

Mesin otomatisasi tidak memiliki kapabilitas untuk mengetikkan email dan password secara interaktif. Oleh karena itu, otorisasi mesin menggunakan API Key yang disuntikkan melalui Environment Variables.

Langkah 1: Generate API Key

Lakukan request untuk membuat API Key melalui endpoint backend PaaS:

• Endpoint: POST https://paas.hcm-lab.id/api/api-keys
• Header: Authorization: Bearer <JWT_TOKEN_ADMIN>
• Body:

  {
    "name": "OpenClaw Worker 1"
  }
  

Langkah 2: Simpan Token di Infisical

Agar API Key tidak tertulis langsung (hardcoded) di dalam skrip atau kode sumber OpenClaw, kita akan menyimpannya dengan aman di Infisical. Buka dashboard web Infisical Anda.

1. Pilih Project dan masuk ke Environment yang sesuai (misalnya prod atau staging).
2. Tambahkan Secret baru dengan nama kunci PAAS_API_KEY.
3. Masukkan key mentah (paas_efb6...) yang Anda dapatkan dari Langkah 1 ke dalam kolom nilai (value).
4. Klik simpan untuk mengamankan perubahan tersebut.

Langkah 3: Eksekusi CLI Melalui Infisical

Pastikan server atau worker OpenClaw Anda sudah terinstal Infisical CLI dan sudah terautentikasi ke project Infisical yang benar. Untuk menjalankan perintah PaaS CLI, Anda hanya perlu menambahkan awalan infisical run.

Gunakan format perintah berikut di dalam skrip otomatisasi Anda:

  Bash
  infisical run --env prod -- paas app:list