# Adobe

## Adobe 연동

Adobe Admin Console API를 활용하여 조직의 라이선스 정보를 SMPLY에서 통합 관리할 수 있습니다.

{% hint style="info" %}
**Beta 기능** Adobe 연동은 현재 베타 버전으로 제공됩니다. 기능 개선 및 변경이 있을 수 있습니다.
{% endhint %}

***

#### 주요 기능

| 기능           | 설명                             |
| ------------ | ------------------------------ |
| **라이선스 조회**  | 조직 내 Adobe 라이선스 현황 확인          |
| **라이선스 사용량** | Creative Cloud 등 라이선스 사용 현황 파악 |
| **비용 분석**    | Adobe 소프트웨어 비용 통합 관리           |

***

#### 사전 요구사항

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

| 요구사항                           | 설명                                      |
| ------------------------------ | --------------------------------------- |
| **Adobe Admin Console 접근**     | Adobe Admin Console에 접근 권한이 있어야 합니다     |
| **Adobe Developer Console 계정** | API 자격증명 발급을 위한 Developer Console 접근 필요 |
| **시스템 관리자 권한**                 | Adobe Admin Console의 시스템 관리자 권한 필요      |
| **SMPLY 관리자**                  | SMPLY에서 연동 설정 권한이 필요합니다                 |

***

#### 연동 방법

Adobe 연동은 OAuth 2.0 Server-to-Server 인증 방식을 사용합니다.

**단계 1: Adobe Developer Console 프로젝트 생성**

1. [Adobe Developer Console](https://developer.adobe.com/console)에 로그인합니다.
2. 우측 상단의 **새 프로젝트 만들기**를 클릭합니다.
3. 프로젝트 이름을 입력합니다 (예: "SMPLY Integration").

**단계 2: API 추가**

1. 프로젝트 페이지에서 **API 추가**를 클릭합니다.
2. **User Management API**를 선택합니다.
3. **OAuth Server-to-Server** 인증 방식을 선택합니다.
4. **저장**을 클릭합니다.

**단계 3: 자격증명 확인**

API를 추가한 후, 다음 정보를 확인합니다:

| 항목                 | 위치                              |
| ------------------ | ------------------------------- |
| **조직 ID (Org ID)** | 프로젝트 상단 또는 Admin Console에서 확인   |
| **클라이언트 ID**       | OAuth Server-to-Server 자격증명 페이지 |
| **클라이언트 시크릿**      | OAuth Server-to-Server 자격증명 페이지 |

{% hint style="danger" %}
**자격증명 보안** 클라이언트 시크릿은 안전하게 보관하세요. 노출 시 보안 위험이 발생할 수 있습니다.
{% endhint %}

**단계 4: SMPLY에 연동**

1. SMPLY에서 **설정 > 연동 관리**로 이동합니다.
2. **Adobe** 카드에서 **Adobe API 연동하기**를 클릭합니다.
3. 다음 정보를 입력합니다:
   * **조직 ID**: Adobe Developer Console에서 확인한 Org ID
   * **클라이언트 ID**: OAuth 자격증명의 Client ID
   * **클라이언트 시크릿**: OAuth 자격증명의 Client Secret
4. **Adobe API 연동하기**를 클릭합니다.

{% hint style="info" %}
**연동 완료 확인** 연동이 완료되면 "Adobe API 연동을 완료했습니다" 메시지가 표시됩니다.
{% endhint %}

***

#### 연동 범위

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

| 항목         | 동기화 내용                                   |
| ---------- | ---------------------------------------- |
| **라이선스**   | Creative Cloud, Document Cloud 등 라이선스 현황 |
| **사용자 할당** | 라이선스가 할당된 사용자 정보                         |
| **제품 그룹**  | 제품별 라이선스 그룹 정보                           |

{% hint style="info" %}
**자동 동기화** Adobe 라이선스 정보는 **매일 오전 4시 (KST)** 에 자동으로 동기화됩니다.

**Adobe 대시보드** 연동 완료 후 **소프트웨어 > Adobe** 메뉴에서 Adobe 라이선스 현황, 사용자 할당 정보, 비용 분석을 한눈에 확인할 수 있습니다.
{% endhint %}

***

#### 연동 해제

연동을 해제하려면 다음 단계를 따릅니다:

1. **설정 > 연동 관리**로 이동합니다.
2. Adobe 카드의 연동 날짜를 클릭합니다.
3. **연동 해제하기**를 선택합니다.
4. 확인 다이얼로그에서 **해제하기**를 클릭합니다.

{% hint style="warning" %}
**주의사항** 연동을 해제해도 이미 수집된 라이선스 정보는 유지됩니다. 단, 더 이상 Adobe와 동기화되지 않습니다.
{% endhint %}

***

#### 문제 해결

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

**원인 1: 잘못된 자격증명**

* 조직 ID, 클라이언트 ID, 클라이언트 시크릿이 정확한지 확인하세요.
* 복사 시 앞뒤 공백이 포함되지 않았는지 확인하세요.

**원인 2: API 권한 부족**

* Adobe Developer Console에서 User Management API가 추가되어 있는지 확인하세요.
* 시스템 관리자 권한으로 프로젝트를 생성했는지 확인하세요.

**원인 3: 클라이언트 시크릿 만료**

* 클라이언트 시크릿이 만료되었을 수 있습니다. Adobe Developer Console에서 새 시크릿을 생성하세요.

{% hint style="info" %}
**인증 정보 오류** "인증 정보를 다시 확인해주세요" 메시지가 표시되면 입력한 자격증명을 다시 확인하세요.
{% endhint %}

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

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

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

**원인 2: API 스코프 제한**

* Adobe Developer Console에서 User Management API의 스코프가 올바르게 설정되어 있는지 확인하세요.

***

#### 자주 묻는 질문

**Q: Adobe 연동에 필요한 Adobe 계정 유형은?**

Enterprise 라이선스를 보유한 조직이어야 합니다. 개인 계정으로는 연동할 수 없습니다.

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

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

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

현재는 Adobe Admin Console에서 관리한 내용이 SMPLY에 동기화되는 방식입니다. SMPLY에서 직접 라이선스를 할당/회수하는 기능은 추후 지원 예정입니다.

**Q: Creative Cloud 외에 다른 Adobe 제품도 지원되나요?**

네, Adobe Admin Console에서 관리되는 모든 제품 라이선스가 연동됩니다 (Document Cloud, Experience Cloud 등).

**Q: 클라이언트 시크릿이 만료되면 어떻게 하나요?**

Adobe Developer Console에서 새 클라이언트 시크릿을 생성한 후, SMPLY에서 연동을 해제하고 다시 연동하세요.

**Q: Beta 기능이라서 불안정한가요?**

핵심 기능은 안정적으로 동작합니다. Beta는 추가 기능 개발 및 UI 개선이 진행 중임을 의미합니다.