Gmail 계정 연결 (OAuth)

## 이 방식을 쓰는 이유 Gmail 은 두 가지 방법으로 연결할 수 있습니다. | | 앱 비밀번호 (IMAP) | 계정 연결 (OAuth) | |---|---|---| | 준비물 | 2단계 인증 + 앱 비밀번호 발급 | Google 로그인만 | | 비밀번호 전달 | 앱 비밀번호를 서비스에 저장 | **전달하지 않음** | | 갱신 | 계정 비밀번호 변경 시 재발급 | **자동 갱신** | | 권한 철회 | 앱 비밀번호 삭제 | Google 계정에서 즉시 철회 | **계정 연결(OAuth)이 더 안전하고 관리가 편합니다.** 가능하면 이 방식을 쓰세요. ## 이 연동으로 보이는 것 [이메일 연동 (IMAP·POP3)](/news/guide/email-imap)과 동일합니다. - 받은 메일 목록 · 본문 - 읽음 처리 · 삭제 (실제 메일함에 반영) - AI 요약 · 분류 ## 사전 준비물 | 항목 | 비고 | |---|---| | Google 계정 로그인 정보 | 승인 단계에서 본인이 직접 입력 | > **고객이 준비할 것은 이것뿐입니다.** > Google Cloud 앱 등록(Client ID/Secret)은 서비스 쪽에서 이미 되어 있습니다. > 자체 구축 환경이라면 → [운영자 가이드 — Google 앱 등록](/news/guide/operator-google) ## 연결 절차 1. **설정 → 데이터 연동** 탭 2. **이메일 연동** 카드 클릭 3. **Gmail 계정 연결** 버튼 클릭 4. 팝업에서 Google 로그인 5. 권한 요청 화면에서 **허용** 6. 팝업이 닫히고 계정이 목록에 추가됩니다 여러 Gmail 계정을 각각 연결할 수 있습니다. ## 확인 방법 1. 이메일 연동 목록에 해당 주소가 나오는지 2. **이메일** 화면에 메일이 나오는지 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 팝업이 안 열린다 | 브라우저 팝업 차단 | 주소창 팝업 아이콘에서 허용 | | 팝업이 바로 닫힌다 | 브라우저에 다른 Google 계정으로 로그인 중 | Google 에서 로그아웃 후 재시도 | | `403 access_denied` | 앱이 테스트 단계이고 계정이 미등록 | 서비스 쪽 설정 → [문의](/news/guide/contact) | | `redirect_uri_mismatch` | 서비스 앱 설정 문제 | 고객이 해결 불가 → [문의](/news/guide/contact) | | "확인되지 않은 앱" 경고 | 앱이 아직 Google 검증 전 | **고급 → 계속** 으로 진행 | | 연결됐는데 메일이 없다 | 받은 편지함이 비어 있음 | 다른 계정으로 확인 | | 갑자기 끊김 | Google 계정에서 앱 권한 철회 | **Gmail 계정 연결** 재시도 | ## 권한 철회하기 연결을 끊는 방법은 두 가지입니다. 1. 모닝인사이트 이메일 연동 화면에서 해당 계정 제거 2. Google 계정 → **보안 → 서드파티 앱** 에서 접근 권한 철회 두 번째 방법을 쓰면 모닝인사이트 쪽 상태가 `재인증 필요` 로 바뀝니다. ## 제약 - 앱이 Google 검증(Verification)을 받지 않은 상태면 경고 화면이 표시되고, **토큰 유효기간이 7일로 제한**될 수 있습니다. 7일마다 재인증을 요구하면 [문의](/news/guide/contact)해 주세요 - 읽음 처리·삭제는 실제 메일함에 반영됩니다 ## 관련 문서 - [이메일 연동 (IMAP·POP3)](/news/guide/email-imap) — 앱 비밀번호 방식 - [Outlook 계정 연결 (OAuth)](/news/guide/outlook-oauth) - [운영자 가이드 — Google 앱 등록](/news/guide/operator-google)