토큰 유형과 사용 기간

작업 주체와 용도에 맞는 토큰을 선택하세요.

토큰 유형#

CI/CD처럼 사람이 지켜보지 않는 자동화에는 서비스 토큰을 사용하세요. 토큰의 접근 범위와 접근 규칙은 애플리케이션 역할 안에서 정해집니다. 개인 API 토큰은 본인의 신원으로 동작하며, 새 개인 토큰에는 명령어 실행이나 파일 전송 범위를 부여할 수 없습니다. 서버 등록 토큰 하나로 여러 서버를 등록할 수 있습니다.

키 표시#

토큰 키는 발급할 때 한 번만 표시됩니다. 페이지를 떠나기 전에 안전한 곳에 보관하세요. 승인 대기 중인 서비스 토큰 키는 활성화 전까지 인증에 사용할 수 없습니다. 활성화 후 키를 잃었다면 권한이 있는 사람이 교체할 수 있습니다.

만료#

개인 토큰과 등록 토큰 폼에서는 7일, 30일, 90일, 1년 또는 직접 설정한 날짜를 선택할 수 있습니다. 새 개인 토큰과 등록 토큰에는 만료일이 필요합니다. 워크스페이스의 토큰 최대 사용 기간은 1~366일이며 기본값은 366일입니다. 폼은 1년 또는 더 짧은 최대 기간으로 시작하며, 최대 기간을 넘는 옵션은 선택할 수 없습니다. 만료 전에 키를 교체하세요. 만료된 토큰은 사용할 수 없습니다.

서비스 토큰에는 별도의 만료일과 키 교체 정책이 적용됩니다. 개인 토큰과 등록 토큰의 최대 기간은 서비스 토큰에 적용되지 않습니다. 서비스 토큰 키 교체는 즉시 적용됩니다.

접근 규칙#

접근 범위는 토큰이 요청할 수 있는 API 작업을 정합니다. 서버, 명령어, 파일 접근 규칙은 이 범위를 더 좁힐 수 있습니다. 접근 범위가 있어도 해당 접근 규칙을 통과해야 합니다. 접근 범위 참고, 접근 규칙, 토큰 명령어 매칭을 참고하세요.

관련 문서#

• 개인 API 토큰 관리
• 서비스 토큰 관리
• 서버 등록 토큰 관리
• 토큰 API 참고