CLI 인증
로컬에서 로그인하고, CI용 인증 정보를 제공하고, 명령 실행에 사용할 계정을 확인하세요.
CLI는 명령 실행 시 지정한 전역 --api-key, LINGO_API_KEY, ~/.lingo/credentials.json에 저장된 키 또는 브라우저 세션 순으로 확인해 가장 먼저 사용 가능한 인증 정보를 사용합니다. 계정을 전환할 때는 이 순서가 중요합니다. 새로 저장한 로그인 정보가 셸에서 이미 제공한 키보다 우선하지는 않습니다.
로그인 #
lingo login
lingo whoami키 없이 로그인하면 브라우저에서 OAuth 인증이 진행되고 세션이 저장됩니다. CLI는 만료가 임박한 세션을 갱신합니다. 갱신에 실패하면 다시 로그인하세요.
로그인에 성공했다고 해서 조직 설정이 완료되거나 모든 조직의 SSO 요구 사항이 충족되는 것은 아닙니다. 연결 과정에서 웹 앱으로 다시 안내되면 해당 조직의 설정이나 SSO 로그인을 완료한 뒤 다시 시도하세요.
lingo login --api-key <value>는 키를 검증하고 저장합니다. 반면 다른 명령에 지정한 전역 --api-key는 해당 명령을 실행할 때만 적용됩니다. 값을 분리해 지정하는 형식과 --api-key=value 형식을 모두 사용할 수 있습니다. 명령줄에 비밀 정보를 직접 입력하면 셸 기록, 프로세스 조회 또는 진단 정보에 노출될 수 있으므로 비밀 정보 주입 방식을 권장합니다.
CLI는 인증 정보 디렉터리를 0700 모드로, 인증 정보 파일을 0600 모드로 생성합니다.
내 정보 확인 #
lingo whoami --json결과에는 인증 유형과 사용 가능한 조직 및 로컬라이제이션 엔진 컨텍스트가 표시됩니다. 내 정보 확인 명령은 온라인으로 인증 정보를 검증합니다. 연결에 실패하면 저장된 정보 중 일부만 반환할 수 있습니다. 인증이 거부된 경우에는 유효한 계정으로 확인된 것이 아닙니다.
checkout 연결 전에 이 계정 정보를 확인하세요. 저장된 리소스 ID는 사용할 대상을 지정할 뿐, 인증 정보에 해당 리소스를 사용할 권한을 부여하지는 않습니다.
로그아웃 #
lingo logout로그아웃하면 영구 저장된 인증 정보가 삭제됩니다. 다만 환경 변수로 제공한 키나 명령 실행 시 지정한 플래그로 이후 명령에서도 계속 인증할 수 있습니다. 더 이상 사용하지 않으려면 셸에서 우선 적용되는 설정을 제거하세요. 로그아웃해도 키가 폐기되거나 리소스가 삭제되거나 프로젝트 연결이 해제되지는 않습니다.
CI #
실행기의 비밀 정보 관리 기능을 통해 LINGO_API_KEY를 제공하고, 비밀 정보가 포함되지 않은 프로젝트 설정만 커밋하세요. 작업할 프로젝트의 루트에서 CLI를 실행하세요. 개발자의 홈 디렉터리에 저장된 세션을 CI에 복사하지 마세요.
기본 제공 GitHub 연동은 자체 권한과 실행 승인 체계를 사용하며, 직접 관리하는 CLI 실행기와는 별개입니다.