JetBrains Account API

JetBrains Account API를 사용하면 라이선스를 자동으로 관리하고 JetBrains Account에서 라이선스 사용 데이터를 검색할 수 있습니다.

이 API 메서드를 사용하면 라이선스 정보를 확인하고 라이선스를 할당 또는 취소하고 팀 간에 이동할 수 있습니다. JetBrains Account 역할에 따라 API 메서드에 대한 액세스 수준이 결정됩니다. 자세한 내용은 JBA API 참조를 확인하세요.

역할

API에는 조직에 할당될 수 있는 역할을 그대로 반영하는 세 가지 액세스 수준이 있습니다. 

  • 조직 관리자는 API를 활성화 및 비활성화하고, 자신을 위한 토큰을 생성 및 재생성하고, 조직의 다른 관리자를 포함하여 조직의 모든 사용자로부터 액세스 토큰을 회수할 수 있습니다.
  • 팀 관리자는 팀의 다른 관리자를 포함하여 해당 팀의 모든 팀원에 대한 액세스 토큰을 생성, 재생성 및 제거할 수 있습니다.
  • 열람자기본 담당자는 자신에 대한 액세스 토큰을 생성, 재생성 및 제거할 수 있습니다. 열람자와 기본 담당자 액세스 토큰은 API에 읽기 전용 액세스를 허용합니다.

API를 활성화하는 방법

API를 활성화하려면 다음 단계를 따르세요. 

  1. 조직 관리자 자격 증명으로 JetBrains Account에 로그인합니다.
    팀 관리자는 API를 활성화하거나 비활성화할 수 없습니다.
  2. 왼쪽 메뉴에서 조직 이름을 클릭한 다음 Administration(관리)을 클릭합니다.
  3. Enable API(API 사용)를 클릭합니다.
    mceclip3.png
    그러면 열람자와 기본 담당자를 비롯해 모든 조직 및 팀 관리자가 API를 사용할 수 있습니다. 역할이 할당된 모든 사용자는 토큰을 생성할 수 있습니다.

API를 비활성화하는 방법

API를 비활성화하려면 위의 1단계와 2단계를 수행한 다음 Disable API(API 사용 안 함)를 클릭하세요.

mceclip2.png

이 버튼을 누르면 모든 관리자, 열람자 및 기본 담당자에 대해 API가 비활성화됩니다.

API 메서드에 액세스하는 방법

이 메서드에 액세스하려면 두 개의 매개변수가 필요합니다. 

1. X-Customer-Code 매개변수에 대한 고객 코드

고객 코드는 고유한 조직 ID입니다. 고객 코드를 찾아보려면 JetBrains Account로 이동하여 조직 이름 옆에 있는 번호를 찾으세요.

find-profile-id.png

 

이 값을 X-Customer-Code 매개변수에 전달합니다.

 

2. X-Api-Key 매개변수에 대한 액세스 토큰

액세스 토큰을 생성하려면:

  1. JetBrains Account로 이동합니다. 
  2. 왼쪽 메뉴에서 조직 또는 팀 이름을 클릭한 다음 Administration(관리)
    을 클릭합니다.
  3. Generate Token(토큰 생성)을 클릭합니다.
    generate-token-screen.png
  4. 팝업 대화 상자에 토큰이 표시됩니다. 보안상의 이유로 한 번만 표시됩니다. 대화 상자를 닫기 전에 코드를 안전한 장소에 보관하세요. 토큰을 다른 사람과 공유하지 마세요.
    mceclip0.png
    토큰을 분실한 경우 다시 생성해야 합니다. 새 토큰을 생성하면 이전 토큰은 무효화됩니다.

획득한 토큰을 X-Api-Key 매개변수로 전달합니다.

토큰 수명

API를 비활성화하고 다시 활성화하면 액세스 토큰은 수동으로 다시 생성하지 않는 한 계속 유효합니다. 

각 사용자는 여러 역할이 할당된 경우에도 정확히 하나의 토큰을 갖습니다. 사용자가 하나 이상의 역할을 유지하는 동안 토큰은 동일하게 유지됩니다. 사용자가 모든 역할을 상실하면 해당 액세스 토큰이 자동으로 취소됩니다.

27명 중 13명이 도움이 되었다고 했습니다.

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

문의 등록