# Jetbrains

Jetbrains 계정 API를 심플리에 연동하여 조직 라이선스와 계정 관리를 쉽게할 수 있습니다.

## 주요 기능

| 기능             | 설명                 |
| -------------- | ------------------ |
| **라이선스 조회**    | 조직 내 모든 라이선스 현황 확인 |
| **라이선스 할당/회수** | 구성원에게 라이선스 할당 및 회수 |
| **팀 간 이동**     | 라이선스를 다른 팀으로 이전    |
| **계정 관리**      | JetBrains 계정 정보 관리 |

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

***

#### 사전 요구사항

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

| 요구사항                | 설명                          |
| ------------------- | --------------------------- |
| **JetBrains 조직 계정** | JetBrains에 조직이 등록되어 있어야 합니다 |
| **관리자 권한**          | JetBrains 조직의 관리자 권한이 필요합니다 |
| **API 활성화 가능**      | 조직 설정에서 API를 활성화할 수 있어야 합니다 |
| **SMPLY 관리자**       | SMPLY에서 연동 설정 권한이 필요합니다     |

#### 연동 범위

JetBrains 연동 시 다음 정보가 동기화됩니다.

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

## 연동 방법

{% 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 %}

### 조직 코드 입력

1. [Jetbrains 라이선스 관리 페이지](https://account.jetbrains.com/licenses)에 로그인 후 조직 페이지로 이동합니다.
2. 조직 코드를 확인합니다.

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2FF0UbDmbbkrkF0fLZpfVJ%2FEnter%20organization%20profile.png?alt=media&#x26;token=753e0414-8325-4a86-92c1-c2684dde43e0" alt=""><figcaption></figcaption></figure>

4. 조직 코드를 심플리의 Jetbrains 연동을 클릭 하고 조직 코드 입력란에 입력합니다

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fkw6BLVz5oNTAviLE2ATr%2Fimage.png?alt=media&#x26;token=019e704d-b38d-44ed-9199-0894b14738db" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 조직 API 활성화

1. 관리(Adminstration)페이지로 이동합니다.

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2FIYPFmNJ9avVarqtFYxa5%2Fimage.png?alt=media&#x26;token=00a1a6e7-a084-494f-9e58-4bd14573b4c9" alt=""><figcaption></figcaption></figure>

2. API를 활성화합니다.

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2FeVCz26LSzc3uMldlKm17%2Fimage.png?alt=media&#x26;token=8e8aa653-0a56-425f-a8ee-ea38728a38f3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 토큰 발행 및 복사

1. 연동에 사용할 토큰을 발행합니다.

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2F5Gi8Cnal0whM2pgVzuB8%2Fimage.png?alt=media&#x26;token=6497fd35-109a-4340-9741-fa60914ec6b6" alt=""><figcaption></figcaption></figure>

2. 토큰을 복사합니다.

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2F7rTl3SUjWEqTTFWyapxK%2Fimage.png?alt=media&#x26;token=38f02487-9cd7-4e29-a994-ae48bec6c62a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 토큰 입력

1. 복사한 토큰을 심플리의 Jetbrains API키 입력란에 붙여넣습니다.

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fb0GKNFrOTfBkDFZzS2JT%2Fimage.png?alt=media&#x26;token=1a5b68df-37ec-4231-bccc-c70764bce14d" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% embed url="<https://sales.jetbrains.com/hc/ko/articles/4406854152978-JetBrains-%EA%B3%84%EC%A0%95-API>" %}

#### 문제 해결

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

**원인 1: 잘못된 조직 코드**

* JetBrains 포털에서 Organization 페이지의 코드가 맞는지 확인하세요.
* 코드 앞뒤 공백이 포함되지 않았는지 확인하세요.

**원인 2: API가 비활성화됨**

* JetBrains Administration에서 API가 활성화되어 있는지 확인하세요.

**원인 3: 토큰 만료**

* 토큰이 만료되었을 수 있습니다. 새 토큰을 생성하세요.

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

**원인 1: 개인 라이선스**

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

**원인 2: 동기화 지연**

* 연동 직후에는 데이터 동기화에 시간이 소요될 수 있습니다. 잠시 후 다시 확인하세요.

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

**원인: 조직 외부 계정**

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

***

#### 자주 묻는 질문

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

현재는 JetBrains 포털에서 할당/회수한 내용이 SMPLY에 동기화되는 방식입니다. SMPLY에서 직접 할당/회수하는 기능은 추후 지원 예정입니다.

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

하나의 SMPLY 워크스페이스에는 하나의 JetBrains 조직만 연동할 수 있습니다.

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

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

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

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