JetBrains Account API
JetBrains Account API를 사용하면 라이선스를 자동으로 관리하고 JetBrains Account에서 라이선스 사용 데이터를 검색할 수 있습니다.
이 API 메서드를 사용하면 라이선스 정보를 확인하고 라이선스를 할당 또는 취소하고 팀 간에 이동할 수 있습니다. JetBrains Account 역할에 따라 API 메서드에 대한 액세스 수준이 결정됩니다. 자세한 내용은 JBA API 참조를 확인하세요.
역할
API에는 조직에 할당될 수 있는 역할을 그대로 반영하는 세 가지 액세스 수준이 있습니다.
- 조직 관리자는 API를 활성화 및 비활성화하고, 자신을 위한 토큰을 생성 및 재생성하고, 조직의 다른 관리자를 포함하여 조직의 모든 사용자로부터 액세스 토큰을 회수할 수 있습니다.
- 팀 관리자는 팀의 다른 관리자를 포함하여 해당 팀의 모든 팀원에 대한 액세스 토큰을 생성, 재생성 및 제거할 수 있습니다.
- 열람자 및 기본 담당자는 자신에 대한 액세스 토큰을 생성, 재생성 및 제거할 수 있습니다. 열람자와 기본 담당자 액세스 토큰은 API에 읽기 전용 액세스를 허용합니다.
API를 활성화하는 방법
API를 활성화하려면 다음 단계를 따르세요.
- 조직 관리자 자격 증명으로 JetBrains Account에 로그인합니다.
팀 관리자는 API를 활성화하거나 비활성화할 수 없습니다. - 왼쪽 메뉴에서 조직 이름을 클릭한 다음 Administration(관리)을 클릭합니다.
-
Enable API(API 사용)를 클릭합니다.
그러면 열람자와 기본 담당자를 비롯해 모든 조직 및 팀 관리자가 API를 사용할 수 있습니다. 역할이 할당된 모든 사용자는 토큰을 생성할 수 있습니다.
API를 비활성화하는 방법
API를 비활성화하려면 위의 1단계와 2단계를 수행한 다음 Disable API(API 사용 안 함)를 클릭하세요.
이 버튼을 누르면 모든 관리자, 열람자 및 기본 담당자에 대해 API가 비활성화됩니다.
API 메서드에 액세스하는 방법
이 메서드에 액세스하려면 두 개의 매개변수가 필요합니다.
1. X-Customer-Code
매개변수에 대한 고객 코드
고객 코드는 고유한 조직 ID입니다. 고객 코드를 찾아보려면 JetBrains Account로 이동하여 조직 이름 옆에 있는 번호를 찾으세요.
이 값을 X-Customer-Code
매개변수에 전달합니다.
2. X-Api-Key
매개변수에 대한 액세스 토큰
액세스 토큰을 생성하려면:
- JetBrains Account로 이동합니다.
- 왼쪽 메뉴에서 조직 또는 팀 이름을 클릭한 다음 Administration(관리)
을 클릭합니다. -
Generate Token(토큰 생성)을 클릭합니다.
- 팝업 대화 상자에 토큰이 표시됩니다. 보안상의 이유로 한 번만 표시됩니다. 대화 상자를 닫기 전에 코드를 안전한 장소에 보관하세요. 토큰을 다른 사람과 공유하지 마세요.
토큰을 분실한 경우 다시 생성해야 합니다. 새 토큰을 생성하면 이전 토큰은 무효화됩니다.
획득한 토큰을 X-Api-Key
매개변수로 전달합니다.
토큰 수명
API를 비활성화하고 다시 활성화하면 액세스 토큰은 수동으로 다시 생성하지 않는 한 계속 유효합니다.
각 사용자는 여러 역할이 할당된 경우에도 정확히 하나의 토큰을 갖습니다. 사용자가 하나 이상의 역할을 유지하는 동안 토큰은 동일하게 유지됩니다. 사용자가 모든 역할을 상실하면 해당 액세스 토큰이 자동으로 취소됩니다.