Outlook 앱 등록 (운영자)

## 이 등록으로 얻는 것 고객의 Outlook · Microsoft 365 메일함 조회 (Microsoft Graph API 기반). ## 사전 준비물 - [ ] Microsoft 계정 또는 Azure 구독 - [ ] [Azure Portal](https://portal.azure.com) 접근 권한 - [ ] 서비스 도메인 (HTTPS) ## 등록 절차 ### 1. 앱 등록 1. [Azure Portal](https://portal.azure.com) → **Microsoft Entra ID** (구 Azure Active Directory) → **앱 등록** 2. **새 등록** | 항목 | 값 | |---|---| | 이름 | `Morning Insight` | | 지원 계정 유형 | **모든 조직 디렉터리 + 개인 Microsoft 계정** | | Redirect URI (플랫폼: **Web**) | `https://<서비스 도메인>/auth/outlook/callback` | > 지원 계정 유형을 "내 조직만"으로 두면 **고객사 계정으로 로그인할 수 없습니다.** > 반드시 다중 테넌트 + 개인 계정 옵션을 선택하세요. 3. 등록 후 아래를 복사 - **응용 프로그램(클라이언트) ID** - **디렉터리(테넌트) ID** ### 2. 클라이언트 비밀 발급 1. **인증서 및 비밀** → **새 클라이언트 비밀** 2. 설명과 만료 기간 지정 3. 생성된 **값(Value)** 을 복사 > ⚠️ **클라이언트 비밀 값은 생성 직후 한 번만 표시됩니다.** > 화면을 벗어나면 다시 볼 수 없어 새로 발급해야 합니다. > **만료 기간을 캘린더에 등록**하세요 — 만료되면 전체 고객의 메일 연동이 끊깁니다. ### 3. API 권한 설정 **API 권한** → **Microsoft Graph** → **위임된 권한(Delegated permissions)** | 권한 | 무엇을 위해 | |---|---| | `Mail.Read` | 메일 조회 | | `Mail.ReadWrite` | 읽음 처리 · 삭제 | | `User.Read` | 계정 기본 정보 | | `offline_access` | **토큰 자동 갱신 (필수)** | > `offline_access` 가 빠지면 갱신 토큰이 발급되지 않아 **주기적으로 재인증**을 요구합니다. ## 모닝인사이트에 입력 `/admin` 운영자 콘솔 → Outlook 섹션 | 항목 | |---| | Client ID | | Client Secret | | Tenant ID | ## 심사 **별도 심사가 없습니다.** 등록 즉시 사용할 수 있습니다. 다만 다중 테넌트로 운영하면 **고객사 테넌트 관리자 동의**가 필요한 경우가 있습니다. 이것은 서비스 쪽에서 해결할 수 없고, 고객사 IT 관리자가 승인해야 합니다. 고객 안내는 [Outlook 계정 연결](/news/guide/outlook-oauth)의 '관리자 동의' 절을 전달하세요. ## 운영 시 주의 — 클라이언트 비밀 만료 Azure 클라이언트 비밀은 **만료 기간이 있습니다** (최대 24개월). | 시점 | 할 일 | |---|---| | 만료 1개월 전 | 새 비밀 발급 → 운영자 콘솔에 교체 | | 만료 시 | **전체 고객의 Outlook 연동이 동시에 끊깁니다** | 가장 흔한 대형 장애 원인입니다. 만료일을 반드시 관리 대상에 넣으세요. ## 자주 나는 오류 | 오류 | 원인 | 해결 | |---|---|---| | 고객사 계정으로 로그인 불가 | 지원 계정 유형이 단일 테넌트 | 다중 테넌트로 변경 | | "관리자의 승인이 필요합니다" | 고객사 정책 | 고객사 IT 관리자 승인 요청 | | 주기적으로 재인증 요구 | `offline_access` 권한 누락 | API 권한에 추가 | | 갑자기 전체 고객 연동 실패 | **클라이언트 비밀 만료** | 새 비밀 발급 후 교체 | | `redirect_uri_mismatch` | Redirect URI 불일치 | Azure 등록 값 확인 | | 읽음 처리 실패 | `Mail.ReadWrite` 누락 | 권한 추가 | ## 관련 문서 - [심사 준비 체크리스트](/news/guide/operator-review) - [운영자 콘솔 사용법](/news/guide/operator-admin-console) - 고객용: [Outlook 계정 연결](/news/guide/outlook-oauth)