API 토큰

ntro_ API 토큰은 사용자에게 발급되는 Bearer 자격 증명입니다. 대화형 CLI 로그인 대신 CI나 스크립트에서 사용할 수 있으며 토큰 문자열은 생성 응답에서 한 번만 확인할 수 있습니다. 콘솔에서 토큰을 만들거나 Identity 로그인으로 얻은 access JWT를 사용해 POST /v1/tokens로 생성합니다. API 토큰으로 다른 API 토큰을 만들거나 조회·철회할 수 없습니다.

export NITROSHIP_TOKEN='<발급받은 ntro_ 토큰>'
ntro whoami
ntro deploy ./dist --app my-app --prod

토큰은 --token 또는 NITROSHIP_TOKEN으로 전달할 수 있습니다. 명령행 인자는 프로세스 목록과 셸 기록에 남을 수 있으므로 자동화에서는 비밀 저장소에서 환경 변수로 주입합니다. 토큰은 사용자와 팀 역할의 권한 범위 안에서 동작하며 쓰기 작업에는 인증된 이메일이 필요합니다.

토큰 API는 생성 시 {name,expiresInDays?}를 받습니다(expiresInDays는 1..365). 조회에서는 토큰 문자열이 아닌 메타데이터만 반환하고, 필요 없어지면 DELETE /v1/tokens/{tokenId}로 철회합니다. 자세한 인증 방식은 API 인증을 참고합니다.