# Microsoft 연동 상세 설정

{% hint style="info" %}
Microsoft 365 연동은 **관리자** 권한을 가진 구성원만 설정할 수 있습니다.
{% endhint %}

**주요 기능:**

* 사용자 정보 자동 동기화 (이름, 이메일)
* 라이선스 기반 선택적 동기화 (SKU 필터링)
* 도메인별 동기화 설정
* 사용자 변경 사항 자동 반영

***

### 연동 방법

#### 1단계: 연동 시작

1. **설정** > **연동 관리** 메뉴로 이동
2. **Microsoft** 카드에서 **Microsoft 365 연동하기** 클릭
3. Microsoft 관리자 계정으로 로그인
4. 요청된 권한 승인

#### 2단계: 동기화 설정 구성

연동 완료 후 동기화 설정 페이지가 표시됩니다.

{% hint style="warning" %}
연동만 완료하고 동기화 설정을 하지 않으면 데이터가 동기화되지 않습니다. 반드시 최소 하나 이상의 도메인에 대해 동기화 설정을 완료하세요.
{% endhint %}

***

### SKU 기반 필터링

Microsoft 365 연동의 핵심 기능으로, **라이선스 유형(SKU)별로** 동기화 대상을 지정할 수 있습니다.

#### SKU란?

\*\*SKU(Stock Keeping Unit)\*\*는 Microsoft 365의 라이선스 유형을 식별하는 고유 코드입니다.

**주요 SKU 예시:**

| 제품명                             | SKU 코드                     |
| ------------------------------- | -------------------------- |
| Microsoft 365 E3                | ENTERPRISEPACK             |
| Microsoft 365 E5                | ENTERPRISEPREMIUM          |
| Office 365 E1                   | STANDARDPACK               |
| Microsoft 365 Business Standard | O365\_BUSINESS\_PREMIUM    |
| Microsoft 365 Business Basic    | O365\_BUSINESS\_ESSENTIALS |

{% hint style="info" %}
동기화 설정 화면에서 조직이 보유한 모든 SKU 목록을 확인할 수 있습니다.
{% endhint %}

#### 동기화 옵션

도메인별로 다음 중 하나를 선택할 수 있습니다:

| 옵션         | 설명                  | 사용 사례               |
| ---------- | ------------------- | ------------------- |
| **전체 동기화** | 해당 도메인의 모든 사용자 동기화  | 소규모 조직, 전사 IT 자산 관리 |
| **선택 동기화** | 특정 SKU를 가진 사용자만 동기화 | 특정 부서만 관리, 비용 절감    |

#### 사용 예시

**시나리오 1: 정규직만 관리**

```
- 동기화 대상: Microsoft 365 E3 라이선스 보유자만
- SKU 선택: ENTERPRISEPACK
- 결과: 정규직 임직원만 SMPLY에 등록
```

**시나리오 2: 여러 라이선스 통합 관리**

```
- 동기화 대상: E3 + E5 라이선스 보유자
- SKU 선택: ENTERPRISEPACK, ENTERPRISEPREMIUM
- 결과: 고급 라이선스 사용자만 SMPLY에 등록
```

***

### 도메인별 설정

#### 다중 도메인 조직

조직이 여러 Microsoft 도메인을 사용하는 경우, **각 도메인별로 독립적인 동기화 설정**을 구성할 수 있습니다.

**예시:**

* `company.com` → 전체 동기화
* `subsidiary.com` → Microsoft 365 E3 라이선스만 동기화
* `contractors.com` → 동기화 안 함

#### 설정 변경 방법

1. **설정** > **연동 관리** 이동
2. Microsoft 카드의 메뉴(⋮) 클릭
3. **설정 변경** 선택
4. 도메인별 동기화 옵션 수정

***

### 동기화되는 데이터

#### 사용자 정보

| 데이터     | 동기화 주기 | 설명         |
| ------- | ------ | ---------- |
| 이름      | 일 1회   | 사용자 표시 이름  |
| 이메일     | 일 1회   | 기본 이메일 주소  |
| 라이선스 정보 | 일 1회   | 할당된 SKU 목록 |

#### 자동 반영 동작

Microsoft 365에서 사용자 변경 시 SMPLY에 자동 반영됩니다:

| Microsoft 변경 | SMPLY 동작                    |
| ------------ | --------------------------- |
| 사용자 추가       | 새 구성원으로 자동 등록 (동기화 조건 충족 시) |
| 사용자 삭제       | 알림 발송 + 배지 표시               |
| 라이선스 변경      | 동기화 조건 미충족 시 배지 표시          |

#### 구성원 배지

Microsoft 연동 구성원에게 다음 배지가 표시될 수 있습니다:

| 배지             | 의미                  | 대응 방법                                        |
| -------------- | ------------------- | -------------------------------------------- |
| **계정 발견되지 않음** | Microsoft에서 사용자 삭제됨 | <p>1. Microsoft 상태 확인<br>2. SMPLY에서 비활성화</p> |

***

### 수동 동기화

자동 동기화는 일 1회 진행됩니다. 즉시 동기화가 필요한 경우:

1. **설정** > **연동 관리** 이동
2. Microsoft 카드에서 **지금 동기화** 클릭

{% hint style="info" %}
현재 Microsoft 연동은 수동 동기화 기능을 준비 중입니다. Google Workspace 연동만 지원됩니다.
{% endhint %}

***

### 문제 해결

#### 연동 실패

**원인:**

* 연동한 Microsoft 계정의 권한 변경
* Microsoft 365 관리 설정 변경
* 인증 토큰 만료

**해결 방법:**

1. **설정** > **연동 관리** 이동
2. Microsoft 카드에서 **재연동** 클릭
3. 권한 다시 승인

#### "연동 설정이 필요합니다"

연동은 완료되었으나 동기화 설정이 미완료된 상태입니다.

**해결 방법:**

1. Microsoft 카드의 메뉴(⋮) 클릭
2. **설정 변경** 선택
3. 최소 하나 이상의 도메인에 대해 동기화 설정 완료

#### 특정 사용자가 동기화되지 않음

**확인 사항:**

1. 해당 사용자의 Microsoft 도메인이 동기화 대상인지 확인
2. 선택 동기화를 사용하는 경우, 해당 사용자가 지정된 SKU를 보유하고 있는지 확인
3. Microsoft 365에서 해당 사용자 계정이 활성 상태인지 확인

***

### 연동 해제

Microsoft 365 연동을 해제하면:

* 신규 데이터 동기화 중단
* 기존 동기화된 구성원 데이터 유지
* 언제든 재연동 가능

**해제 방법:**

1. **설정** > **연동 관리** 이동
2. Microsoft 카드의 메뉴(⋮) 클릭
3. **연동 해제** 선택
4. 확인

***

### FAQ

#### Q. Microsoft 관리자 계정이 필요한가요?

네, Microsoft 365 데이터에 접근하려면 **전역 관리자** 또는 **사용자 관리자** 권한이 필요합니다.

#### Q. SKU 정보는 어디서 확인하나요?

Microsoft 365 관리 센터 > **청구** > **라이선스**에서 조직이 보유한 SKU 목록을 확인할 수 있습니다. SMPLY 동기화 설정 화면에서도 자동으로 표시됩니다.

#### Q. 라이선스가 없는 사용자도 동기화할 수 있나요?

전체 동기화를 선택하면 라이선스 할당 여부와 관계없이 모든 사용자가 동기화됩니다.

#### Q. Google Workspace와 동시에 연동할 수 있나요?

네, 가능합니다. 각 서비스에서 동기화된 구성원은 이메일 주소를 기준으로 자동 병합됩니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/start/integrate_gws/microsoft.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.