CLI 인증 — Altifigence Documentation

네이티브 Cloud PKCE로 로그인하고 해당 세션을 레거시 API 및 DDS 서비스 자격 증명과 구분하세요.

개요

사용하는 명령에 맞는 자격 증명 경로를 선택하세요. 네이티브 Cloud 로그인, 레거시 고객 액션 자격 증명, 운영자가 설정한 DDS HTTP 서비스는 별도 계약입니다. 로컬 XLS와 네이티브 워크스페이스 작업에는 Cloud 자격 증명이 필요하지 않습니다.

데스크톱과 CLI의 자격 증명

화면	자격 증명 경로	권한의 기준
Digital Design Studio 2.0.2 Windows	보호된 로컬 기능은 브라우저 로그인, 편집·저장은 로그인 없이 가능	My PC 기기 라이선스 없음. 안내된 로컬 기능은 Free 로그인으로 이용하며 Cloud·AI 권한은 별도 확인
`alti` `ide` `cloud`	브라우저 PKCE 및 비공개 CLI 세션	서버에서 계정 식별 정보와 조직·프로젝트 권한을 확인합니다.
고객 액션·작업 클라이언트	`ALTI_TOKEN` 및 `ALTI_ORG_ID`	선택한 API에 제시하는 자격 증명과 범위
`alti` `ide` `service`	설정된 서비스 origin 및 `ALTI_STUDIO_SERVICE_SECRET`	레거시 서비스의 기존 권한 계약

어떤 CLI 세션도 데스크톱 라이선스를 부여하지 않습니다. 데스크톱 세션 파일, 브라우저 쿠키, 내부 서비스 헤더를 네이티브 Cloud 요청에 가져오지 마세요.

네이티브 Cloud 로그인

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

로그인은 브라우저 PKCE 흐름의 인증 URL을 출력합니다. 기본값은 https://api.altifigence.com이며 비공개 세션 디렉터리는 ~/.local/state/altifigence/cloud-cli입니다. 다른 세션을 선택하려면 --session-dir을 일관되게 사용하세요. 로그인은 --org와 제한된 --wait-seconds도 받습니다. 후속 명령은 각자의 요청 시간 제한을 사용합니다.

저장된 토큰에서 추정하지 말고 whoami로 서버 식별 정보를 확인하세요. 갱신과 로그아웃은 이 네이티브 세션을 대상으로 합니다. Cloud 검색·터미널 명령의 조직·프로젝트 ID는 요청 범위를 정하지만 접근 권한을 부여하지는 않습니다. 타입 기반 ide cloud run 작업은 서버 권한 검사를 유지하며 계약에 소스 업로드가 포함되면 --allow-source-upload가 필요합니다.

CLI는 명시된 네이티브 API 경로를 통해 연결합니다. 로그인 흐름이 있다고 모든 조직에서 모든 Cloud 작업이 활성화된다는 뜻은 아닙니다.

CLI 환경 변수

레거시 고객 액션 및 Cloud 작업 클라이언트는 다음 설정을 유지합니다.

변수	효과
`ALTI_TOKEN`	필수 bearer 자격 증명. 누락되거나 비어 있으면 거부합니다.
`ALTI_ORG_ID`	필수 조직 범위
`ALTI_API_BASE`	API 기본 주소. 기본값은 `https://api.altifigence.com`입니다.
`ALTI_BYO`	`1`, `true`, `yes`는 자체 제공 principal 유형을 선택합니다.
`ALTI_ALLOW_SOURCE_UPLOAD`	소스를 포함하는 고객 MCP 액션에 대한 명시적 동의. 없으면 거부합니다.

엔드포인트 재정의는 직접 관리하는 서비스나 계정용으로 명시적으로 제공받은 주소에만 설정하세요. origin을 바꾸면 해당 자격 증명이 다른 호스트로 전송될 수 있습니다.

레거시 DDS HTTP 명령은 대신 --endpoint 또는 ALTI_STUDIO_ENDPOINT와 기존 서비스 비밀 환경 설정을 사용합니다. 네이티브 Cloud 로그인을 재사용하거나 서비스의 인증 흐름을 새로 만들지 않습니다.

설정 상태와 사용자 인증의 차이

alti auth status는 레거시 환경 설정만 확인합니다. serverVerification은 not_performed로 유지되며 alti ide cloud whoami와 같지 않습니다.

레거시 최상위 alti login과 alti whoami는 여전히 AUTH_FLOW_UNAVAILABLE, IDENTITY_NOT_VERIFIED와 함께 종료 코드 4를 반환합니다. 최상위 alti logout은 부모 프로세스에서 상속한 값을 지울 수 없습니다. 해당 값은 원본에서 삭제하거나 교체하고, 네이티브 세션에는 ide cloud logout을 사용하세요.

자격 증명 관리

CI 자격 증명은 CI 비밀 저장소에 보관하고 필요한 단계에만 주입하세요.
세션 디렉터리는 소유자만 접근할 수 있게 유지하세요. 소스 관리, 사용자 간 공유 캐시, 공개 자산에 포함하지 마세요.
토큰, 서비스 비밀, 브라우저 쿠키, 전체 환경을 로그에 남기지 마세요.
자격 증명을 사용하는 명령 주변에서는 셸 추적을 끄고, 로그에 기록됐을 수 있는 값은 교체하세요.

원격 API 접근

선택한 백엔드에 맞는 타입 기반 Job 및 Cloud 명령을 사용하세요. 클라이언트 검증과 로그인 성공은 서버 권한을 대체하지 않으며 요청한 작업의 완료도 입증하지 않습니다.

native 세션 확인·복구

alti ide cloud login
alti ide cloud whoami

CLI를 사용할 동일한 일반 Linux 사용자로 실행하세요. 브라우저 절차를 마치고 whoami 성공 응답을 확인한 뒤 워크스페이스 작업을 시작합니다. 다른 --session-dir을 사용하면 로그인·후속 호출에 일관되게 지정하세요. 디렉터리가 다르면 저장된 세션도 다릅니다.

세션이 만료되면 native 갱신·로그인 절차를 사용하세요. 사용자 확인은 성공하지만 프로젝트가 거부되면 조직 구성원·프로젝트 권한을 확인합니다. 거부를 우회하려고 데스크톱 인증 정보를 복사하거나 API 주소를 바꾸지 마세요. 계정 복구는 계정 보안을 참고하세요.