> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/saas-integration/guide-main/jetbrains.md).

# Jetbrains

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

## 주요 기능

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

{% hint style="info" %}
**조회 전용 연동** 라이선스 할당/회수와 팀 간 이동은 JetBrains 포털에서 수행하며, SMPLY는 그 결과를 가져와 보여줍니다. SMPLY에서 직접 할당/회수하는 기능은 추후 지원 예정입니다.
{% endhint %}

{% hint style="warning" %}
**조직 라이선스만 연동 가능** 조직(Organization)에 포함된 라이선스 및 계정만 조회할 수 있습니다. 개인 소유 라이선스는 연동할 수 없습니다.
{% endhint %}

***

#### 사전 요구사항

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

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

{% hint style="info" %}
**Central Console 기준** JetBrains는 상용 라이선스 조직 관리를 **JetBrains Central Console** (console.jetbrains.cloud) 로 이전했습니다. 아래 안내는 Central Console 화면을 기준으로 합니다.
{% endhint %}

***

#### 연동 방법

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2FpKjwbQPpX3DgZVDDjQns%2FJetbrains-integration.mp4?alt=media&token=b632f8c7-062b-4393-9504-99c6b6e30953>" %}

{% stepper %}
{% step %}

#### Customer Code 확인 및 입력

1. [JetBrains Central Console](https://console.jetbrains.cloud)에 로그인합니다.
2. 좌하단 **Help center → Copy support information**을 클릭합니다. 조직 정보가 클립보드에 복사됩니다.

<figure><img src="/files/y7oXDaUUyTtHGEQxS6oG" alt=""><figcaption><p>Help center → Copy support information</p></figcaption></figure>

3. 복사된 내용에서 **`Customer Code`** 값을 사용합니다.

{% hint style="warning" %}
**`Customer Code`를 사용하세요 (≠ `Customer Id`)** 복사된 정보에는 `Customer Code`와 `Customer Id` 두 값이 따로 있습니다. 연동에 필요한 값은 **`Customer Code`** 이며, `Customer Id`(다른 숫자)를 입력하면 인증에 실패합니다.
{% endhint %}

4. 심플리의 **연동 관리 > JetBrains** 화면에서 **Customer Code** 입력란에 위 값을 붙여넣습니다.

<figure><img src="/files/q9h9AhYYaflO4BzIdNGJ" alt=""><figcaption><p>SMPLY 연동 관리 → JetBrains</p></figcaption></figure>
{% endstep %}

{% step %}

#### 조직 API 활성화 및 토큰 발급

1. 좌하단 **조직명 → Org administration**으로 이동합니다.
2. **API** 섹션에서 API를 활성화합니다. 처음이라면 **Enable API**를 클릭하고, 이미 켜져 있으면 이 단계는 건너뜁니다.
3. **Generate Token**(이미 토큰이 있으면 **Re-Generate Token**)을 클릭해 연동용 토큰을 발행합니다.

<figure><img src="/files/CKDZCCHrxRYXOSDivDPO" alt=""><figcaption><p>Org administration → API 섹션</p></figcaption></figure>

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

{% step %}

#### 토큰 복사

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

<figure><img src="/files/66Bz9pAh3TAtA0LZ0zbE" alt=""><figcaption></figcaption></figure>

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

{% step %}

#### 토큰 입력

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

<figure><img src="/files/UglNuxTY2Kvl1ZXTeDX6" alt=""><figcaption><p>Customer Code + API Key 입력 후 연동하기</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% embed url="<https://www.jetbrains.com/help/jetbrains-console/jetbrains-account-api.html>" %}

***

#### 연동 범위

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

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

{% hint style="warning" %}
**자동 동기화 없음** JetBrains 연동은 정기 자동 동기화가 없습니다. 데이터는 **연동 시 1회** 가져오며, 이후에는 **수동 동기화(새로고침)** 를 실행해야 최신 정보가 반영됩니다.
{% endhint %}

***

#### 문제 해결

**연동이 실패합니다**

**원인 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 같은 번들 라이선스도 관리되나요?**

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