JetBrains 계정 API

업데이트 시간 2025년 10월 27일 13:47

JetBrains 계정 API를 사용하면 조직의 라이선스와 사용자 계정을 자동으로 관리할 수 있습니다.

이 API를 사용하여 다음을 수행할 수 있습니다.

라이선스 세부 정보 가져오기
라이선스 할당 또는 취소
팀 간 라이선스 양도
사용자 계정 생성 또는 삭제

JetBrains 계정 API 참조

API 메서드의 전체 목록은 JetBrains 계정 API 참조에서 확인하세요.

계정 관리 기능은 검증된 도메인이 있는 조직에서만 사용할 수 있습니다.

API 액세스 수준

조직 프로필에서의 역할에 따라 JetBrains 계정 UI에서 수행할 수 있는 작업, API를 통해 액세스할 수 있는 정보, 변경 권한이 있는지 여부가 결정됩니다.

역할	JetBrains 계정 UI에서 할 수 있는 일	API를 통해 액세스할 수 있는 부분	API 액세스 수준
조직 관리자	조직 전체에 대한 API 활성화 또는 비활성화 개인 API 액세스 토큰을 생성, 업데이트 또는 삭제 다른 조직 관리자를 포함하여 조직의 다른 구성원에 대한 액세스 토큰 철회	전체 조직 프로필	전체 액세스
팀 관리자	개인 API 액세스 토큰을 생성, 업데이트 또는 삭제 다른 팀 관리자를 포함하여 팀의 다른 구성원에 대한 액세스 토큰 철회	우리 팀	전체 액세스
뷰어 및 주요 연락처	개인 API 액세스 토큰을 생성, 업데이트 또는 삭제	전체 조직 프로필	읽기 전용

API 활성화 또는 비활성화

🔒 필요한 권한: 조직 관리자.

API를 활성화하는 방법:

JetBrains 계정에 로그인합니다.
왼쪽 메뉴에서 조직 이름을 클릭합니다.
표시된 메뉴에서 Administration(관리)을 선택합니다.
API 섹션에서 Enable API(API 활성화)을 클릭합니다.

이를 통해 모든 관리자, 뷰어 및 주요 연락처에 API 액세스가 제공됩니다. 이들은 개인 API 토큰을 생성하고 역할에 따라 API를 통해 조직이나 팀 프로필에 액세스할 수 있습니다.

API 비활성화

API를 비활성화하려면 위 지침의 1~3단계를 따른 다음 Disable API(API 비활성화)를 클릭하세요. 그러면 조직 전체의 API가 비활성화됩니다.

Disable API

API를 비활성화하면 API 메서드를 통해 조직 프로필에 액세스할 수 없지만 이미 생성된 토큰은 무효화되지 않습니다. 나중에 API를 다시 활성화하면 이러한 토큰은 계속 유효합니다. 자세한 내용은 토큰 수명을 참조하세요.

API 액세스 토큰 관리

조직 프로필의 역할이 API 액세스 권한을 부여하는 경우, 개인 액세스 토큰을 생성하고 필요에 따라 다시 생성하거나 삭제할 수 있습니다. 조직 및 팀 관리자는 조직이나 팀 내의 다른 사람이 생성한 토큰을 관리할 수도 있습니다.

개인 API 토큰 관리

🔒 필요한 권한: 조직 관리자, 팀 관리자 또는 주요 청구 담당자.

API를 사용하려면 개인 액세스 토큰이 필요합니다. 이 토큰은 언제든지 생성, 재생성 또는 삭제할 수 있습니다. 토큰은 해당 계정에 연결되어 있으므로 이 토큰을 사용하여 이루어진 모든 API 요청은 관련자와 연결됩니다. 조직에서 API 액세스 권한이 있는 다른 구성원도 자신의 토큰을 생성할 수 있습니다.

개인 토큰 생성

조직에서 JetBrains 계정 API가 활성화되어 있는지 확인합니다.
JetBrains 계정에 로그인합니다.
왼쪽 메뉴에서 역할에 따라 다음 중 하나를 선택합니다.
- 조직 관리자, 뷰어 또는 주요 연락처인 경우 조직 이름을 클릭합니다.
- 팀 관리자인 경우 팀 이름을 클릭합니다.
관리 페이지의 API 섹션에서 Generate Token(토큰 생성)을 클릭합니다.
대화상자가 나타나면 토큰이 표시됩니다. 보안상의 이유로 이 대화상자는 한 번만 표시됩니다. 닫기 전에 안전한 곳에 저장해 두세요.

토큰을 누구와도 공유하지 마세요. 누출된 경우 즉시 다시 생성하거나 제거하세요.

개인 토큰 재생성

다음과 같은 상황에서는 개인 토큰을 다시 생성해야 할 수도 있습니다.

현재 토큰에 접근할 수 없는 경우
토큰이 손상된 경우

새로운 토큰을 생성하려면:

개인 토큰 생성 지침의 1~3단계를 따릅니다.
관리 페이지의 API 섹션에서 Re-Generate Token(토큰 재생성)을 클릭합니다.
확인 대화상자가 나타나면 Re-Generate Token(토큰 재생성)을 다시 클릭합니다.
다음 팝업 대화상자에서 새 토큰을 볼 수 있습니다. 보안상의 이유로 이 대화상자는 한 번만 표시됩니다. 닫기 전에 안전한 곳에 저장해 두세요.

토큰을 다시 생성하면 이전 토큰은 즉시 무효화됩니다. API를 사용하는 모든 애플리케이션에서 토큰을 업데이트하세요.

개인 액세스 토큰 제거

더 이상 API 액세스가 필요하지 않은 경우, 다음 단계에 따라 토큰을 제거하세요.

토큰 생성 지침의 1~3단계를 따릅니다.
관리 페이지의 API 섹션에서 Remove Token(토큰 제거)을 클릭합니다.
확인 대화상자가 나타나면 Remove Token(토큰 제거)을 다시 클릭합니다.

다른 사람이 생성한 API 토큰 관리

조직이나 팀 관리자는 조직이나 팀의 다른 구성원이 생성한 API 토큰을 보고 취소할 수 있습니다.

조직 전체 API 토큰 보기 및 취소

🔒 필요한 권한: 조직 관리자.

위 지침의 1~3단계를 수행하여 조직 관리 페이지를 엽니다.
관리 페이지에서 회사 라이선스에 액세스할 수 있는 사용자까지 아래로 스크롤합니다.
API token(API 토큰) 열에는 토큰을 생성한 조직의 모든 구성원이 표시됩니다.
토큰을 취소하려면 표에서 사용자를 찾아 Revoke(취소)를 클릭합니다.

특정 팀의 API 토큰 보기 및 취소

🔒 필요한 권한: 조직 관리자 또는 팀 관리자.

토큰 생성 지침의 1~3단계를 수행하여 팀 관리 페이지를 엽니다.
관리 페이지에서 Team Administration(팀 관리) 섹션까지 아래로 스크롤합니다.
API token(API 토큰) 열에는 토큰을 생성한 팀의 모든 구성원이 표시됩니다.
토큰을 취소하려면 표에서 사용자를 찾아 Revoke(취소)를 클릭합니다.

토큰 수명

JetBrains 계정 API 토큰은 발행 후 무기한의 유효 기간을 갖습니다.

여러 역할이 있더라도 각 사용자는 토큰을 하나만 얻을 수 있습니다. 적어도 하나의 역할을 유지하고 재생성하거나 제거하지 않는다면 토큰은 계속 활성 상태를 유지합니다. 모든 역할을 잃으면 토큰은 자동으로 취소됩니다.

API를 비활성화한 다음 나중에 다시 활성화하면 이전에 생성된 토큰은 제거하거나 다시 생성하지 않는 한 유효 상태로 유지됩니다.

개인 토큰이 손상된 경우 즉시 재생성하거나 제거하세요. 다른 사람의 토큰이 손상된 경우에는 해당 토큰을 취소하세요.

API 메서드 사용

사용 가능한 메서드의 전체 목록은 JetBrains 계정 API 참조를 참고하세요. 계정 관리 기능은 검증된 도메인이 있는 조직에서만 사용할 수 있습니다.

API 메서드를 사용하려면 두 개의 매개변수가 필요합니다.

1. `X-Customer-Code` 고객 ID

사용자의 JetBrains 고객 ID는 조직의 주문 및 라이선스와 관련된 고유 식별자입니다. 이 정보는 JetBrains 계정에서 확인할 수 있습니다.

이 값을 요청의 X-Customer-Code 매개변수로 사용합니다.

2. `X-Api-Key` 액세스 토큰

위의 단계에 따라 개인 토큰을 생성합니다. 이를 X-Api-Key 매개변수에 사용합니다.

더 궁금한 점이 있으신가요?

문의 등록