Xác thực CLI

Đăng nhập bằng Cloud PKCE gốc và giữ phiên đó tách biệt với thông tin xác thực dịch vụ DDS và API cũ.

Tài liệu này chi tiết việc xác thực và quản lý quyền cho DDS CLI và các dịch vụ Cloud.

Đăng nhập bằng trình duyệt và trao đổi mã token

Khi bạn đăng nhập vào CLI, một cửa sổ trình duyệt an toàn sẽ mở ra. Sau khi hoàn tất xác thực, một lệnh gọi lại cục bộ sẽ nhận mã token. Mã token được lưu trong kho lưu trữ hệ điều hành an toàn.	Đường thông tin xác thực	Thẩm quyền
Digital Design Studio 2.0.2 Windows	Đăng nhập bằng trình duyệt cho các tính năng cục bộ được bảo vệ; chỉnh sửa và lưu cũng hoạt động mà không cần đăng nhập	Không có giấy phép thiết bị My PC. Đăng nhập Free hỗ trợ các tính năng cục bộ đã ghi trong tài liệu; Cloud và AI kiểm tra các quyền riêng biệt.
`alti` `ide` `cloud`	PKCE trong trình duyệt và phiên CLI riêng	Định danh tài khoản và quyền tổ chức/dự án được máy chủ kiểm tra
Máy khách hành động/tác vụ khách hàng	`ALTI_TOKEN` và `ALTI_ORG_ID`	Thông tin xác thực và phạm vi được trình cho API đã chọn
`alti` `ide` `service`	Origin dịch vụ đã cấu hình và `ALTI_STUDIO_SERVICE_SECRET`	Hợp đồng cấp phép hiện có của dịch vụ cũ

Không phiên CLI nào cấp giấy phép desktop. Không nhập tệp phiên desktop, cookie trình duyệt hay header dịch vụ nội bộ vào yêu cầu Cloud native.

Đăng nhập Cloud native

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

Login in URL cấp phép cho quy trình PKCE trong trình duyệt. Mặc định dùng https://api.altifigence.com và thư mục phiên riêng tại ~/.local/state/altifigence/cloud-cli. Dùng --session-dir nhất quán để chọn phiên khác. Login cũng chấp nhận --org và --wait-seconds có giới hạn; lệnh tiếp theo dùng thời hạn yêu cầu riêng.

Dùng whoami để biết định danh máy chủ thay vì suy ra từ token đã lưu. Refresh và logout thao tác trên phiên native này. ID tổ chức/dự án trong lệnh tìm kiếm và terminal Cloud xác định phạm vi yêu cầu nhưng không thể cấp quyền truy cập. Các thao tác có kiểu ide cloud run giữ kiểm tra quyền máy chủ và yêu cầu --allow-source-upload khi hợp đồng của chúng mang nguồn được tải lên.

CLI kết nối qua các đường API native tường minh. Quy trình đăng nhập không cam kết mọi thao tác Cloud được bật cho mọi tổ chức.

Biến môi trường CLI đọc

Máy khách hành động khách hàng và tác vụ Cloud cũ giữ các cài đặt sau:

Biến	Tác dụng
`ALTI_TOKEN`	Thông tin xác thực bearer bắt buộc; thiếu hoặc rỗng bị từ chối
`ALTI_ORG_ID`	Phạm vi tổ chức bắt buộc
`ALTI_API_BASE`	API base, mặc định `https://api.altifigence.com`
`ALTI_BYO`	`1`, `true`, hoặc `yes` chọn loại principal tự cung cấp
`ALTI_ALLOW_SOURCE_UPLOAD`	Đồng ý tường minh cho hành động MCP khách hàng có nguồn; thiếu nghĩa là từ chối

Chỉ đặt endpoint ghi đè tới dịch vụ bạn kiểm soát hoặc endpoint được cung cấp rõ ràng cho tài khoản của bạn. Origin thay đổi có thể gửi thông tin xác thực tương ứng tới host khác.

Lệnh HTTP DDS cũ thay vào đó dùng --endpoint hoặc ALTI_STUDIO_ENDPOINT và cài đặt môi trường bí mật dịch vụ hiện có. Chúng không dùng lại đăng nhập Cloud native hay tự tạo quy trình xác thực cho dịch vụ đó.

Trạng thái cấu hình không phải xác thực

alti auth status chỉ kiểm tra cấu hình môi trường cũ. Giá trị serverVerification của nó vẫn là not_performed; không tương đương alti ide cloud whoami.

Các lệnh cấp cao nhất cũ alti login và alti whoami vẫn thoát với mã 4 kèm AUTH_FLOW_UNAVAILABLE và IDENTITY_NOT_VERIFIED. Lệnh cấp cao nhất alti logout không thể xóa giá trị kế thừa từ tiến trình cha. Xóa hoặc xoay vòng giá trị ở nguồn; dùng ide cloud logout cho phiên native.

Xử lý bí mật

Giữ thông tin xác thực CI trong kho bí mật CI và chỉ đưa vào bước cần chúng.
Giữ thư mục phiên riêng cho chủ sở hữu; không thêm vào quản lý mã nguồn, cache dùng chung giữa người dùng hay hiện vật công khai.
Không ghi log token, bí mật dịch vụ, cookie trình duyệt hay toàn bộ môi trường.
Tắt shell tracing quanh lệnh có thông tin xác thực và xoay vòng mọi giá trị có thể đã vào log.

Truy cập API từ xa

Dùng Các lệnh tác vụ và Cloud có kiểu cho backend đã chọn. Xác thực máy khách và đăng nhập thành công không thay quyền phía máy chủ hay chứng minh tác vụ được yêu cầu đã hoàn tất.

Xác minh và khôi phục phiên native

alti ide cloud login
alti ide cloud whoami

Chạy dưới cùng người dùng Linux thông thường sẽ dùng CLI. Hoàn tất quy trình trình duyệt và yêu cầu phản hồi whoami thành công trước thao tác workspace. Nếu dùng --session-dir thay thế, dùng nó cho login và các lần gọi sau; thư mục khác là phiên đã lưu khác.

Nếu phiên hết hạn, dùng quy trình refresh/đăng nhập native. Nếu định danh thành công nhưng dự án bị từ chối, kiểm tra thành viên tổ chức và quyền dự án. Không sao chép thông tin xác thực từ desktop hay đổi origin API để lách từ chối đó. Để khôi phục tài khoản, dùng Bảo mật tài khoản.