> 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/start/integrate_gws/microsoft.md).

# Microsoft 연동 상세 설정

## Microsoft 연동 상세 설정

Microsoft 365(Entra)를 연동하면 선택한 도메인의 라이선스·그룹·사용자가 심플리의 조직·그룹·구성원으로 자동 동기화됩니다. 매일 **오후 9시**에 자동 동기화되며, 설정 화면에서 즉시 수동 동기화도 실행할 수 있습니다.

{% hint style="info" %}
**필요한 준비물**

Microsoft 365 연동은 **관리자** 권한을 가진 구성원만 설정할 수 있습니다. 연동에 사용하는 Microsoft 계정은 도메인·라이선스·그룹·사용자 정보를 읽을 수 있는 **전역 관리자** 또는 **사용자 관리자** 권한이 필요합니다.
{% endhint %}

***

### 1. 연동하기

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

1. 사이드바에서 **설정** > **연동 관리**로 이동합니다.
2. **Microsoft** 카드를 클릭합니다.
3. 아직 연동되지 않은 경우 *"Microsoft 365를 연동하면 구성원 정보를 자동으로 동기화합니다."* 안내와 함께 **`연동하기`** 버튼이 표시됩니다. 버튼을 클릭합니다.
4. Microsoft 관리자 계정으로 로그인하고 요청된 권한을 승인합니다.

**단계 2: 권한 설정 확인 대기**

권한 승인 직후에는 *"Microsoft 365 연동 준비 중 — 권한 설정을 확인하고 있습니다. 잠시만 기다려주세요."* 화면이 잠시 표시됩니다. 도메인·라이선스·그룹 정보를 불러오는 단계로, 자동으로 다음 화면으로 넘어갑니다.

{% hint style="warning" %}
**동기화 범위 설정까지 완료해야 합니다** 연동만 하고 동기화 범위를 저장하지 않으면 데이터가 동기화되지 않습니다. 반드시 최소 하나 이상의 도메인을 선택하고 **`저장 및 동기화하기`** 까지 완료하세요.
{% endhint %}

***

### 2. 동기화 범위 설정

연동이 완료되면 **동기화 범위** 영역에서 어떤 도메인의 데이터를 가져올지 지정합니다. 선택한 도메인의 라이선스·그룹·사용자가 심플리의 조직·그룹·구성원으로 동기화됩니다.

**단계 1: 도메인 선택**

조직이 여러 Microsoft 도메인을 사용하는 경우, 동기화할 도메인을 체크박스로 선택합니다. 기본 도메인에는 **`기본`** 배지가 표시됩니다.

**단계 2: 도메인별 동기화 방식 선택**

선택한 각 도메인은 탭으로 나뉘며, 도메인마다 독립적으로 다음 중 하나를 고릅니다.

| 방식          | 설명                                   | 사용 사례               |
| ----------- | ------------------------------------ | ------------------- |
| **전체 동기화**  | 해당 도메인의 모든 데이터를 동기화합니다.              | 소규모 조직, 전사 IT 자산 관리 |
| **선택적 동기화** | 라이선스(SKU)·그룹(Group)으로 대상을 좁혀 동기화합니다. | 특정 부서·라이선스 보유자만 관리  |

{% hint style="info" %}
**선택적 동기화는 라이선스와 그룹을 함께 쓸 수 있습니다** 선택적 동기화에서는 **라이선스**와 **그룹**을 각각 여러 개 지정할 수 있고, 둘은 **합집합**으로 동작합니다. 즉 *지정한 라이선스를 가진 사용자* **또는** *지정한 그룹에 속한 사용자* 가 모두 동기화됩니다. 탭 옆 배지에 *"라이선스 N + 그룹 M"* 처럼 선택 개수가 표시됩니다.
{% endhint %}

각 도메인 탭에서 동기화 대상을 지정하면, 화면 하단의 **`저장 및 동기화하기`** 버튼으로 설정 저장과 동시에 즉시 동기화가 실행됩니다.

{% hint style="info" %}
**보이지 않는 도메인·라이선스가 있나요?** 설정 화면에 *"보이지 않는 도메인, 라이선스가 있나요?"* 안내가 항상 표시됩니다. 일부 도메인·라이선스가 보이지 않는다면 연동한 Microsoft 계정의 권한이 부족할 수 있습니다. 관리자 권한을 가진 계정으로 다시 연동해 보세요.
{% endhint %}

***

### 3. 라이선스(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" %}
조직이 보유한 라이선스 목록은 동기화 범위 설정 화면의 **라이선스** 선택 항목에서 자동으로 표시됩니다. Microsoft 365 관리 센터 > **청구** > **라이선스**에서도 확인할 수 있습니다.
{% endhint %}

**사용 예시:**

```
시나리오 1: E3 라이선스 보유자만 동기화
- 선택적 동기화 → 라이선스: Microsoft 365 E3 선택
- 결과: 해당 라이선스 보유자만 심플리에 구성원으로 등록

시나리오 2: 라이선스 + 그룹 함께 사용
- 선택적 동기화 → 라이선스: Microsoft 365 E5, 그룹: 개발실 선택
- 결과: E5 보유자 또는 개발실 그룹원이 모두 동기화 (합집합)
```

***

### 4. 그룹(Group) 기준 선택

선택적 동기화에서는 라이선스뿐 아니라 **Microsoft 그룹(Entra Group)** 으로도 대상을 좁힐 수 있습니다. 도메인 탭의 **그룹** 선택 항목에서 동기화할 그룹을 고릅니다.

* 지정한 그룹에 속한 사용자가 심플리에 구성원으로 동기화됩니다.
* 동시에 해당 그룹은 심플리의 **그룹**으로 생성되고, 그룹원 정보도 함께 동기화됩니다.
* 라이선스와 그룹을 함께 지정하면 두 조건의 **합집합**이 동기화 대상이 됩니다.

{% hint style="info" %}
조직이 보유한 그룹 목록은 동기화 범위 설정 화면의 **그룹** 선택 항목에서 자동으로 표시됩니다. 그룹은 Microsoft 측 그룹 식별자를 기준으로 매칭되므로, 그룹 이메일이 없는 그룹도 선택할 수 있습니다.
{% endhint %}

***

### 5. 동기화되는 데이터

선택한 도메인·범위에 따라 다음 데이터가 심플리로 동기화됩니다.

| 데이터     | 심플리 반영           | 설명                                                         |
| ------- | ---------------- | ---------------------------------------------------------- |
| 구성원     | 구성원으로 등록         | 사용자 이름·이메일·할당된 라이선스                                        |
| 조직(조직도) | 조직(Unit)으로 자동 생성 | 사용자의 부서(department) 정보를 기준으로 조직도를 자동 구성 (부서 미배정 사용자도 동기화됨) |
| 그룹      | 그룹으로 생성          | 선택적 동기화에서 지정한 Microsoft 그룹 및 그룹원                           |
| 구독      | 구독 데이터로 반영       | 조직이 보유한 라이선스(구독) 정보                                        |

**자동 반영 동작**

Microsoft 365에서 사용자가 변경되면 다음 동기화 시 심플리에 반영됩니다.

| Microsoft 변경 | 심플리 동작                                  |
| ------------ | --------------------------------------- |
| 사용자 추가       | 동기화 조건 충족 시 새 구성원으로 자동 등록               |
| 사용자 삭제       | 관리자에게 알림 발송 + 구성원에 *"계정 발견되지 않음"* 배지 표시 |
| 라이선스 변경      | 동기화 조건 미충족으로 바뀌면 배지 표시                  |

***

### 6. 수동 동기화

자동 동기화는 매일 오후 9시에 실행됩니다. 즉시 동기화가 필요하면 동기화 범위 설정 화면에서 **`저장 및 동기화하기`** 버튼을 클릭합니다. 설정 저장과 동시에 동기화가 실행되며, 완료되면 요청한 관리자에게 알림이 발송됩니다.

{% hint style="warning" %}
**10분 재동기화 제한** 직전 동기화로부터 10분 이내에는 다시 동기화할 수 없습니다. 너무 빨리 다시 시도하면 *"이전 동기화로부터 10분 이내에는 동기화할 수 없습니다. 잠시 후 다시 시도해주세요."* 안내가 표시됩니다. 잠시 후 다시 시도하세요.
{% endhint %}

***

### 7. 연동 정보 확인

연동된 상태에서는 화면 상단의 **연동 정보** 카드에서 현재 상태를 확인할 수 있습니다.

| 항목          | 의미                                                   |
| ----------- | ---------------------------------------------------- |
| **상태 배지**   | `연동됨` / `연동 대기` / `인증 만료` 중 현재 상태                    |
| **연동**      | 연동을 설정한 구성원과 연동한 시점                                  |
| **마지막 동기화** | 직전 동기화의 성공/실패 여부와 시각. 아직 동기화 전이면 *"아직 동기화되지 않았습니다."* |

***

### 8. 연동 해제

Microsoft 365 연동을 해제하면:

* **구성원 및 구독 데이터 동기화가 중단**됩니다.
* 기존에 동기화된 구성원 데이터는 유지됩니다.
* 언제든 다시 연동할 수 있습니다.

**해제 방법**

1. 동기화 범위 설정 화면 하단의 **`연동 해제하기`** 버튼을 클릭합니다.
2. *"정말 Microsoft 365 연동을 해제하시겠습니까? 연동 해제 후에는 구성원 및 구독 데이터 동기화가 중단됩니다."* 확인 창에서 해제를 진행합니다.

***

### 9. 문제 해결

#### Q: 연동을 시작하지 못했어요

**원인**: 연동에 사용한 Microsoft 계정의 권한 부족 또는 인증 토큰 만료.

**해결 방법**:

1. **설정** > **연동 관리** > **Microsoft** 카드로 이동합니다.
2. ✅ 연동 계정이 **전역 관리자** 또는 **사용자 관리자** 권한인지 확인하세요.
3. 권한을 갖춘 계정으로 다시 **`연동하기`** 를 진행합니다.

#### Q: 도메인·라이선스 목록에 *"문제가 발생했습니다"* 가 떠요

연동은 됐지만 도메인·라이선스 정보를 불러오지 못한 상태입니다. *"연동 해제 후 다시 시도해주세요."* 안내대로 **`연동 해제하기`** 후 다시 연동하세요.

#### Q: 특정 사용자가 동기화되지 않아요

**확인사항**:

1. 해당 사용자의 도메인이 동기화 대상으로 선택되어 있는지 확인하세요.
2. 선택적 동기화를 쓰는 경우, 해당 사용자가 지정한 **라이선스**를 가졌거나 지정한 **그룹**에 속하는지 확인하세요. (둘 중 하나만 충족해도 동기화됩니다.)
3. Microsoft 365에서 해당 사용자 계정이 활성 상태인지 확인하세요.

#### Q: 동기화 버튼을 눌렀는데 *"10분 이내에는 동기화할 수 없습니다"* 가 떠요

직전 동기화로부터 10분이 지나지 않았기 때문입니다. 잠시 후 다시 시도하세요.

#### Q: 보이지 않는 도메인·라이선스가 있어요

연동한 Microsoft 계정의 권한이 부족할 수 있습니다. 관리자 권한을 가진 계정으로 다시 연동하면 누락된 도메인·라이선스가 표시됩니다.

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

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

#### Q: 이 외의 문제

채널톡으로 문의해 주세요.