OAuth 앱 등록 개요 (운영자)

## 이 카테고리는 누구를 위한 것인가 **서비스를 직접 운영하는 담당자**를 위한 문서입니다. | 역할 | 하는 일 | 문서 | |---|---|---| | 서비스 운영자 | 플랫폼 개발자 콘솔에 **앱을 등록**하고 Client ID/Secret 을 서비스에 넣는다 | **이 카테고리** | | 고객 (사용자) | 설정에서 **계정 연결**을 눌러 본인 계정으로 승인한다 | [연동 준비](/news/guide/integration-overview) | 일반 사용자라면 이 카테고리는 읽지 않아도 됩니다. 자체 구축(온프레미스)으로 모닝인사이트를 운영한다면 여기가 출발점입니다. ## 왜 두 단계인가 OAuth 는 "누가 만든 앱이, 누구의 데이터를, 어떤 범위로 읽는가"를 분리합니다. ``` [1단계 · 운영자가 한 번] 플랫폼 개발자 콘솔에 앱 등록 → Client ID / Client Secret 발급 → /admin 운영자 콘솔에 입력 [2단계 · 고객이 매번] 설정 → 계정 연결 클릭 → 플랫폼 로그인 → 권한 동의 → 그 고객 전용 토큰이 발급되어 워크스페이스에 저장 ``` 1단계가 없으면 고객이 **계정 연결** 을 눌러도 오류가 납니다. 1단계는 플랫폼당 한 번만 하면 전체 고객이 씁니다. ## 초기 1회 준비물 플랫폼 등록을 시작하기 전에 아래를 먼저 확보하세요. **대부분의 플랫폼이 심사 단계에서 이것들을 요구합니다.** - [ ] **서비스 도메인 (HTTPS)** — 대부분의 플랫폼이 `https` 콜백만 허용합니다 - [ ] **개인정보 처리방침 공개 URL** - [ ] **서비스 이용약관 공개 URL** - [ ] **앱 로고** 1024×1024 PNG - [ ] 회사 **사업자등록증** (Cafe24 · Kakao · 오픈뱅킹 등) - [ ] 플랫폼별 관리자 계정 — **개인 계정이 아닌 회사 도메인 계정 권장** > ⚠️ HTTPS 도메인 없이는 1단계를 완료할 수 없는 플랫폼이 많습니다. 여기부터 확정하세요. ## 콜백 URL 규칙 서비스가 요청에 실어 보내는 콜백 주소는 **접속한 도메인 기준으로 런타임에 생성**됩니다. 따라서 플랫폼 콘솔에는 아래 형식을 등록하면 됩니다. ``` https://<서비스 도메인>/auth/<플랫폼>/callback ``` 실제로 쓰이는 경로는 8종입니다. | 플랫폼 | 콜백 경로 | |---|---| | YouTube | `/auth/youtube/callback` | | Gmail | `/auth/gmail/callback` | | Meta (광고) | `/auth/meta/callback` | | Instagram | `/auth/instagram/callback` | | Cafe24 | `/auth/cafe24/callback` | | 스마트스토어 | `/auth/smartstore/callback` | | 오픈뱅킹 | `/auth/openbanking/callback` | | Outlook | `/auth/outlook/callback` | 소셜 로그인을 쓰면 `/auth/{google,kakao,naver,apple}/callback` 도 함께 등록합니다. > **정확히 일치해야 합니다.** 프로토콜 · 호스트 · 포트 · 경로 · 끝 슬래시까지. > 하나만 달라도 `redirect_uri_mismatch` 가 발생합니다. ## 권장 진행 순서 심사 기간이 긴 것을 먼저 신청하고, 즉시 되는 것으로 먼저 서비스를 띄우는 순서입니다. | 순서 | 플랫폼 | 얻는 것 | 심사 | |---|---|---|---| | 1 | [Google](/news/guide/operator-google) | Google Ads + YouTube + Gmail (**한 프로젝트로 3개**) | 4~6주 | | 2 | [Meta](/news/guide/operator-meta) | Facebook 광고 + Instagram (**한 앱으로 2개**) | 1~3주 | | 3 | [Naver](/news/guide/operator-naver) | 검색광고 + 블로그 + 로그인 | 즉시 | | 4 | [Cafe24](/news/guide/operator-cafe24) · [스마트스토어](/news/guide/operator-smartstore) | 쇼핑몰 매출 | 1~2주 | | 5 | [Kakao](/news/guide/operator-kakao) | 소셜 로그인 + 알림톡 | 1~3일 | | 6 | [Outlook](/news/guide/operator-outlook) | 메일 | 즉시 | | 7 | [오픈뱅킹](/news/guide/operator-openbanking) | 계좌 조회 | **1~2개월** | Google 과 오픈뱅킹은 **첫날에 신청**해 두세요. 나머지를 진행하는 동안 심사가 돕니다. ## 입력한 값은 어디로 가나 발급받은 Client ID / Secret 은 **`/admin` 운영자 콘솔**에 입력합니다. - 저장 시 암호화되며 화면에는 마스킹 표시됩니다 - 이 값은 **전체 고객이 공유**합니다 (워크스페이스별 값이 아닙니다) - 변경은 감사 로그에 기록됩니다 자세한 사용법은 [운영자 콘솔 사용법](/news/guide/operator-admin-console)에 있습니다. ## 등록 후 반드시 할 테스트 플랫폼 등록과 값 입력을 마쳤으면 **고객 시점으로 검증**하세요. 1. **시크릿 모드 또는 다른 브라우저**에서 일반 고객 계정으로 로그인 2. **설정 → 데이터 연동** 에서 해당 플랫폼 **계정 연결** 클릭 3. 플랫폼 로그인 화면이 뜨는지 → 동의 4. 상태가 `연동됨` 으로 바뀌는지 5. 해당 화면(매출·광고·SNS)에 데이터가 나오는지 운영자 계정으로만 테스트하면 심사 상태·테스트 사용자 제약을 놓치기 쉽습니다. ## 관련 문서 - [심사 준비 체크리스트](/news/guide/operator-review) — 심사에서 요구하는 것 정리 - [운영자 콘솔 사용법](/news/guide/operator-admin-console) - 플랫폼별 등록: [Google](/news/guide/operator-google) · [Meta](/news/guide/operator-meta) · [Naver](/news/guide/operator-naver) · [Kakao](/news/guide/operator-kakao) · [Cafe24](/news/guide/operator-cafe24) · [스마트스토어](/news/guide/operator-smartstore) · [오픈뱅킹](/news/guide/operator-openbanking) · [Outlook](/news/guide/operator-outlook)