Autentikasi CLI

Masuk dengan Cloud PKCE bawaan dan bedakan sesi tersebut dari kredensial layanan DDS dan API lama.

Dokumen ini merinci autentikasi dan manajemen izin untuk DDS CLI dan layanan Cloud.

Masuk melalui browser dan pertukaran token

Saat Anda masuk ke CLI, jendela browser yang aman akan terbuka. Setelah menyelesaikan autentikasi, callback lokal menerima token. Token disimpan di penyimpanan sistem operasi yang aman.	Jalur kredensial	Kewenangan
Digital Design Studio 2.0.2 Windows	Masuk melalui browser untuk fitur lokal yang dilindungi; pengeditan dan penyimpanan juga berfungsi tanpa masuk	Tidak ada lisensi perangkat My PC. Masuk Free mendukung fitur lokal yang didokumentasikan; Cloud dan AI memeriksa izin terpisah.
`alti` `ide` `cloud`	PKCE browser dan sesi CLI privat	Identitas akun dan izin organisasi/proyek diperiksa server
Klien aksi/tugas pelanggan	`ALTI_TOKEN` dan `ALTI_ORG_ID`	Kredensial dan lingkup yang diberikan kepada API terpilih
`alti` `ide` `service`	Origin layanan yang dikonfigurasi dan `ALTI_STUDIO_SERVICE_SECRET`	Kontrak otorisasi yang sudah ada pada layanan lama

Tidak ada sesi CLI yang memberikan lisensi desktop. Jangan mengimpor file sesi desktop, cookie browser, atau header layanan internal ke permintaan Cloud native.

Masuk Cloud Native

alti ide cloud login
alti ide cloud whoami
alti ide cloud refresh
alti ide cloud logout

Login mencetak URL otorisasi untuk alur PKCE browser. Default-nya adalah https://api.altifigence.com dan direktori sesi privat di ~/.local/state/altifigence/cloud-cli. Gunakan --session-dir secara konsisten untuk memilih sesi lain. Login juga menerima --org dan --wait-seconds yang dibatasi; perintah selanjutnya memakai tenggat permintaan sendiri.

Gunakan whoami untuk memperoleh identitas server alih-alih menyimpulkannya dari token tersimpan. Refresh dan logout bekerja pada sesi native ini. ID organisasi/proyek pada perintah pencarian dan terminal Cloud membatasi lingkup permintaan tetapi tidak dapat memberikan akses. Operasi bertipe ide cloud run mempertahankan pemeriksaan izin server dan memerlukan --allow-source-upload ketika kontraknya memuat sumber yang diunggah.

CLI terhubung melalui rute API native eksplisitnya. Alur masuk tidak menjanjikan bahwa setiap operasi Cloud diaktifkan untuk setiap organisasi.

Variabel Lingkungan yang Dibaca CLI

Klien aksi pelanggan lama dan tugas Cloud mempertahankan pengaturan berikut:

Variabel	Efek
`ALTI_TOKEN`	Kredensial bearer wajib; nilai yang hilang atau kosong ditolak
`ALTI_ORG_ID`	Lingkup organisasi wajib
`ALTI_API_BASE`	Basis API, default `https://api.altifigence.com`
`ALTI_BYO`	`1`, `true`, atau `yes` memilih jenis principal yang Anda sediakan sendiri
`ALTI_ALLOW_SOURCE_UPLOAD`	Persetujuan untuk aksi MCP pelanggan yang memuat sumber; jika tidak ada, ditolak

Tetapkan penggantian endpoint hanya ke layanan yang Anda kendalikan atau endpoint yang secara eksplisit diberikan untuk akun Anda. Origin yang diubah dapat mengirim kredensial terkait ke host berbeda.

Perintah HTTP DDS lama justru memakai --endpoint atau ALTI_STUDIO_ENDPOINT dan pengaturan lingkungan rahasia layanan yang sudah ada. Perintah ini tidak memakai kembali login Cloud native atau menciptakan alur autentikasi untuk layanan tersebut.

Status Konfigurasi Bukan Autentikasi

alti auth status hanya memeriksa konfigurasi lingkungan lama. Nilai serverVerification tetap not_performed; ini tidak setara dengan alti ide cloud whoami.

Perintah tingkat teratas lama alti login dan alti whoami tetap keluar dengan kode 4 dengan AUTH_FLOW_UNAVAILABLE dan IDENTITY_NOT_VERIFIED. Perintah tingkat teratas alti logout tidak dapat menghapus nilai yang diwarisi dari proses induk. Hapus atau rotasi nilai itu di sumbernya; gunakan ide cloud logout untuk sesi native.

Penanganan Rahasia

Simpan kredensial CI dalam penyimpanan rahasia CI dan injeksikan hanya ke langkah yang memerlukannya.
Jaga direktori sesi tetap privat bagi pemiliknya; jangan masukkan ke kontrol sumber, cache yang dibagikan antar pengguna, atau artefak yang dipublikasikan.
Jangan mencatat token, rahasia layanan, cookie browser, atau seluruh lingkungan.
Nonaktifkan pelacakan shell di sekitar perintah berkredensial dan rotasi nilai apa pun yang mungkin masuk ke log.

Akses API Jarak Jauh

Gunakan Perintah Tugas dan Cloud bertipe untuk backend yang Anda pilih. Validasi klien dan login berhasil tidak menggantikan izin sisi server atau membuktikan tugas yang diminta telah selesai.

Memverifikasi dan memulihkan sesi native

alti ide cloud login
alti ide cloud whoami

Jalankan sebagai pengguna Linux biasa yang sama yang akan memakai CLI. Selesaikan alur browser dan wajibkan respons whoami yang berhasil sebelum operasi workspace. Jika Anda memakai --session-dir alternatif, gunakan untuk login dan panggilan selanjutnya; direktori berbeda berarti sesi tersimpan berbeda.

Jika sesi kedaluwarsa, gunakan alur refresh/masuk native. Jika identitas berhasil tetapi proyek ditolak, periksa keanggotaan organisasi dan izin proyek. Jangan menyalin kredensial desktop atau mengubah origin API untuk mengatasi penolakan tersebut. Untuk pemulihan akun, gunakan Keamanan akun.