> 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/adobe.md).

# Adobe

## Adobe 연동

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

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

***

#### 주요 기능

| 기능             | 설명                               |
| -------------- | -------------------------------- |
| **사용자 현황**     | 조직 내 Adobe 사용자(전체·활성) 현황 확인      |
| **라이선스 배정·쿼터** | 제품별 라이선스 배정 수와 보유 쿼터 파악          |
| **사용자 매칭**     | Adobe 사용자와 SMPLY 멤버를 이메일 기준으로 대조 |

***

#### 사전 요구사항

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

| 요구사항                           | 설명                                      |
| ------------------------------ | --------------------------------------- |
| **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)** | 프로젝트 생성 직후 나타나는 프로젝트 개요 화면에 표시된 조직 ID(`xxxx@AdobeOrg`)를 그대로 복사 |
| **클라이언트 ID**       | OAuth Server-to-Server 자격증명 페이지                                |
| **클라이언트 시크릿**      | OAuth Server-to-Server 자격증명 페이지                                |

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

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

1. SMPLY에서 **설정 > 연동 관리**로 이동합니다.
2. **소프트웨어 라이선스** 목록에서 **Adobe** 카드의 **`연동하기`** 를 클릭하면 Adobe 전용 설정 페이지(`/settings/integration/adobe`)로 이동합니다.
3. 자격증명 입력 폼에 다음 항목을 입력합니다. 입력란 라벨은 화면에 영문으로 표시됩니다:
   * **`Organization ID`**: 프로젝트 개요 화면에 표시된 조직 ID(`xxxx@AdobeOrg`)를 그대로 입력
   * **`Client ID`**: OAuth 자격증명의 Client ID
   * **`Client Secret`**: OAuth 자격증명의 Client Secret
4. **`연동하기`** 버튼을 클릭합니다.

{% hint style="success" %}
**입력한 자격증명은 암호화되어 저장됩니다** 클라이언트 시크릿을 포함한 자격증명은 SMPLY에 저장될 때 암호화 처리됩니다. 입력 화면에서도 시크릿은 가려진 상태로 입력됩니다.
{% endhint %}

{% hint style="info" %}
**연동 상태 확인** 연동이 완료되면 같은 Adobe 설정 페이지에 **연동 상태**가 *"연동됨"* 으로 표시되고, 연동일·마지막 동기화 정보가 함께 나타납니다.
{% endhint %}

***

#### 연동 범위

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

| 항목             | 동기화 내용                                 |
| -------------- | -------------------------------------- |
| **사용자**        | 조직 내 Adobe 사용자(이름·이메일·상태·유형·도메인·소속 그룹) |
| **라이선스 배정·쿼터** | 제품별 라이선스 그룹의 배정 사용자 수와 보유 쿼터           |

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

**Adobe 대시보드** 연동 완료 후 **소프트웨어 > Adobe** 메뉴에서 전체·활성 사용자 수, 제품별 라이선스 배정·쿼터 현황, 사용자 목록을 확인할 수 있습니다.
{% endhint %}

***

#### Adobe 대시보드

**소프트웨어 > Adobe** 메뉴에서 연동된 Adobe 데이터를 위젯 형태로 확인합니다. 기본으로 다음 4개의 위젯이 표시됩니다.

| 위젯          | 내용                                      |
| ----------- | --------------------------------------- |
| **전체 사용자**  | 조직 내 Adobe 사용자 총수                       |
| **활성 사용자**  | 활성/비활성 사용자 수                            |
| **라이선스 현황** | 제품별 라이선스 배정 수와 보유 쿼터 합계                 |
| **사용자 목록**  | 사용자별 이름·이메일·상태·유형·소속 그룹, SMPLY 멤버 매칭 결과 |

대시보드는 **커스터마이즈할 수 있습니다.** 우측 상단 **`연동 설정`** 버튼의 드롭다운에서 **`편집`** 을 선택하면 편집 모드로 전환됩니다.

* **`위젯 추가`** — 위젯 라이브러리를 열어 원하는 위젯을 캔버스에 추가합니다.
* 위젯을 끌어 위치를 조정하거나, 위젯 메뉴에서 제거합니다.
* **`저장`** — 변경한 레이아웃을 저장합니다. **`취소`** 로 되돌릴 수 있습니다.

{% hint style="info" %}
**자격증명 오류 안내** 동기화 도중 자격증명이 만료되었거나 권한이 부족하면, Adobe 설정 페이지의 연동 상태가 *"자격증명 오류"* 로 표시됩니다. 이 경우 Adobe Developer Console에서 자격증명을 확인한 뒤 연동을 해제하고 다시 연동하세요. 일시적인 요청 한도 초과(Rate Limit)는 다음 동기화 때 자동으로 재시도되므로 별도 조치가 필요하지 않습니다.
{% endhint %}

***

#### 연동 해제

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

1. **설정 > 연동 관리**의 **소프트웨어 라이선스** 목록에서 **Adobe** 카드의 **`설정 변경하기`** 를 클릭해 Adobe 설정 페이지(`/settings/integration/adobe`)로 이동합니다.
2. 페이지 우측 상단의 **`연동 해제하기`** 버튼을 클릭합니다.
3. *"연동을 해제하시겠습니까?"* 확인 창에서 **`연동 해제`** 를 클릭합니다.

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

***

#### 문제 해결

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

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

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

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

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

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

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

{% hint style="info" %}
**자격증명 오류** *"자격증명이 유효하지 않습니다."* 메시지가 표시되거나 연동 상태가 *"자격증명 오류"* 로 바뀌면, 입력한 조직 ID·클라이언트 ID·클라이언트 시크릿을 다시 확인하세요.
{% 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 개선이 진행 중임을 의미합니다.