Jetbrains

Jetbrains 라이선스 관리를 위한 연동 가이드

JetBrains 계정 API를 심플리에 연동하여 조직의 라이선스 현황과 계정 정보를 한곳에서 확인할 수 있습니다.

주요 기능

기능	설명
라이선스 조회	조직 내 모든 라이선스 현황 확인
사용 현황 조회	라이선스 할당 상태 및 할당된 사용자 정보 확인
계정 정보 조회	JetBrains 조직 계정 정보 확인

사전 요구사항

연동을 시작하기 전에 다음 조건을 확인하세요.

요구사항	설명
JetBrains 조직 계정	JetBrains Central Console에 조직이 등록되어 있어야 합니다
API 활성화 권한	조직 설정에서 API를 활성화하려면 조직 관리자 권한이 필요합니다 (활성화는 1회만 수행)
토큰 발급 멤버	토큰은 조회 권한만 있는 멤버(뷰어)가 발급해도 충분합니다 — 최소 권한 계정 사용을 권장합니다
SMPLY 관리자	SMPLY에서 연동 설정 권한이 필요합니다

연동 방법

연동에는 Customer Code(조직 식별 코드)와 API 토큰 두 가지가 필요합니다. 모두 JetBrains Central Console에서 확인·발급합니다.

Customer Code 확인 및 입력
1. JetBrains Central Console에 로그인합니다.
2. 좌하단 Help center → Copy support information을 클릭합니다. 조직 정보가 클립보드에 복사됩니다.
Help center → Copy support information
1. 복사된 내용에서 Customer Code 값을 사용합니다.
Customer Code를 사용하세요 (≠ Customer Id) 복사된 정보에는 Customer Code와 Customer Id 두 값이 따로 있습니다. 연동에 필요한 값은 Customer Code 이며, Customer Id(다른 숫자)를 입력하면 인증에 실패합니다.
1. 심플리의 연동 관리 > JetBrains 화면에서 Customer Code 입력란에 위 값을 붙여넣습니다.
SMPLY 연동 관리 → JetBrains
조직 API 활성화 및 토큰 발급
1. 좌하단 조직명 → Org administration으로 이동합니다.
2. API 섹션에서 API를 활성화합니다. 처음이라면 Enable API를 클릭하고, 이미 켜져 있으면 이 단계는 건너뜁니다.
3. Generate Token(이미 토큰이 있으면 Re-Generate Token)을 클릭해 연동용 토큰을 발행합니다.
Org administration → API 섹션

최소 권한 안내 API는 관리자뿐 아니라 뷰어(viewer)·primary contact 도 사용할 수 있습니다. 조회 전용 연동이므로 읽기 전용 역할 멤버가 토큰을 발급해도 충분합니다.
토큰 복사

발행된 토큰을 복사합니다.

토큰은 한 번만 표시됩니다 발급 직후 화면에서만 토큰 전체 값을 확인할 수 있습니다. 즉시 복사해 안전한 곳에 보관하세요. 토큰은 별도 만료 기간이 없으며(무기한), 사용자당 1개를 발급할 수 있고, 발급한 사용자가 조직에서 제외되거나 역할을 잃으면 자동으로 회수됩니다.
토큰 입력

같은 화면의 API Key 입력란에 복사한 토큰을 붙여넣고 연동하기를 클릭합니다.

Customer Code + API Key 입력 후 연동하기

🔗 https://www.jetbrains.com/help/jetbrains-console/jetbrains-account-api.html

연동 범위

JetBrains 연동 시 다음 정보를 가져옵니다.

항목	동기화 내용
라이선스	라이선스 유형, 만료일, 할당 상태
사용자	라이선스가 할당된 사용자 정보
팀	조직 내 팀 구조
사용 현황	라이선스 활성화 및 사용 기록

문제 해결

연동이 실패합니다

원인 1: 잘못된 Customer Code

Customer Id가 아니라 Customer Code 를 입력했는지 확인하세요 (Help center → Copy support information에서 확인).
값 앞뒤에 공백이 포함되지 않았는지 확인하세요.

원인 2: API가 비활성화됨

좌하단 조직명 → Org administration → API 섹션에서 API가 활성화되어 있는지 확인하세요.

원인 3: 토큰이 회수됨

토큰은 만료되지 않지만, 발급한 사용자가 조직에서 제외되거나 역할을 잃으면 자동으로 회수됩니다. 유효한 멤버 계정으로 새 토큰을 발급한 뒤 다시 입력하세요.

라이선스가 표시되지 않습니다

원인 1: 개인 라이선스

개인 소유 라이선스는 조직 연동으로 조회할 수 없습니다.

원인 2: 동기화 미실행

JetBrains 연동은 정기 자동 동기화가 없습니다. 연동 직후 데이터가 보이지 않으면 수동 동기화(새로고침) 를 실행하세요.

특정 사용자의 라이선스가 보이지 않습니다

원인: 조직 외부 계정

해당 사용자가 조직에 속해 있는지 JetBrains Central Console에서 확인하세요.

자주 묻는 질문

Q: Customer Code는 어디서 확인하나요?

JetBrains Central Console 좌하단 Help center → Copy support information을 클릭하면 조직 정보가 복사되며, 그 안의 Customer Code 값을 사용합니다. 같이 표시되는 Customer Id는 다른 값이므로 사용하지 마세요.

Q: 연동 후 라이선스를 SMPLY에서 직접 할당/회수할 수 있나요?

현재는 조회 전용입니다. 라이선스 할당/회수와 팀 간 이동은 JetBrains 포털에서 수행하면 그 결과가 SMPLY에 반영됩니다. SMPLY에서 직접 할당/회수하는 기능은 추후 지원 예정입니다.

Q: 여러 조직을 연동할 수 있나요?

네, 복수 조직 연동을 지원합니다. 조직을 추가하여 여러 JetBrains 조직을 하나의 SMPLY 워크스페이스에 연동할 수 있습니다.

Q: 토큰은 만료되나요? 몇 개까지 발급할 수 있나요?

토큰은 별도 만료 기간이 없습니다(무기한). 사용자당 1개를 발급할 수 있으며, 발급한 사용자가 조직 역할을 잃으면 자동으로 회수됩니다. 발급 직후 화면에서만 전체 값을 확인할 수 있으니 즉시 복사해 보관하세요. 조회 전용 연동이므로 읽기 전용 역할(뷰어) 토큰으로도 충분합니다.

Q: 데이터는 얼마나 자주 동기화되나요?

JetBrains 연동은 정기 자동 동기화가 없습니다. 연동 시 1회 가져오며, 이후에는 수동 동기화(새로고침)로 최신 정보를 반영합니다.

Q: 연동을 해제하면 데이터가 삭제되나요?

연동을 해제해도 이미 수집된 라이선스 정보는 유지됩니다. 단, 더 이상 JetBrains와 동기화되지 않습니다.

Q: All Products Pack 같은 번들 라이선스도 관리되나요?

네, 조직에 할당된 모든 라이선스 유형이 연동됩니다.