토큰

토큰은 Altium 365 API에 대한 요청을 승인하는 데 사용되는 자격 증명입니다. 모든 API 요청에는 Authorization 헤더에 유효한 토큰이 포함되어야 합니다.

토큰은 Workspace의 Admin → Developer에서 생성됩니다. Workspace 관리자만 토큰을 생성할 수 있습니다.

토큰 유형

사용 방식과 보안상의 절충점에 따라 두 가지 유형의 토큰을 사용할 수 있습니다.

장기 액세스 토큰

API 요청에서 bearer 토큰으로 직접 사용하는 단일 자격 증명입니다. 생성 시 유효 기간을 설정할 수 있으며 최대 1년까지 가능합니다.

Authorization: Bearer {token}

이것은 더 단순한 옵션입니다. 값 하나를 직접 사용하면 됩니다. 사용 편의성이 자격 증명 순환보다 더 중요한 스크립트, 자동화, 로컬 개발에 적합합니다.

주요 제한 사항은 토큰 값이 유효 기간 동안 바뀌지 않는다는 점입니다. 노출되면 만료되거나 수동으로 폐기될 때까지 계속 유효합니다.

리프레시 토큰

API 요청에 사용하는 단기 자격 증명과 장기 자격 증명을 분리하는, 더 안전한 옵션입니다. 생성 시 다음 세 가지 값을 받게 됩니다:

• Client ID – 토큰 클라이언트를 식별합니다

• Client secret – 토큰 클라이언트를 인증합니다

• Refresh token – 장기 자격 증명입니다

이 값들을 사용해 토큰 엔드포인트를 호출하여 단기 access token로 교환합니다. 액세스 토큰은 API 요청에 사용하는 값입니다. 만료되면 동일한 리프레시 토큰을 사용해 새 토큰을 요청합니다.

리프레시 토큰은 최대 1년까지 유효 기간을 설정할 수 있습니다. 이로부터 생성되는 액세스 토큰은 수명이 짧습니다.

이 방식은 운영 환경 통합에 더 적합합니다:

• 모든 API 요청과 함께 전달되는 자격 증명(액세스 토큰)은 수명이 짧습니다

• 장기 비밀 값(리프레시 토큰)은 안전한 저장소에 보관되며 API로 직접 전송되지 않습니다

토큰 교환 흐름은 Using a Refresh Token 를 참조하세요.

토큰 유형 선택

범위

모든 토큰은 승인할 수 있는 API 작업을 정의하는 OAuth scopes 세트와 연결됩니다. 범위는 토큰 생성 시 구성되며 이후에는 변경할 수 없습니다.

사용 가능한 전체 범위 목록과 API 기능에 어떻게 매핑되는지는 OAuth Scopes를 참조하세요.

토큰 유효 기간

두 유형의 토큰 모두 생성 시 최대 1년까지 유효 기간을 설정할 수 있습니다. 자동 갱신은 없으며, 토큰이 만료되면 새로 생성해야 합니다.

리프레시 토큰의 경우 유효 기간은 리프레시 토큰 자체에 적용됩니다. 이로부터 생성되는 액세스 토큰은 더 짧고, 고정된 1시간의 유효 기간을 가집니다.

토큰 폐기

토큰은 언제든지 Admin → Developer에서 폐기할 수 있습니다. 토큰을 폐기하면 즉시 무효화되며, 해당 토큰을 사용하는 모든 API 요청은 인증 오류와 함께 실패합니다.