연동 상태 · 재인증 · 토큰 만료

## 이 문서에서 얻는 것 연동은 한 번 하면 끝이 아닙니다. 토큰은 만료되고, 비밀번호는 바뀌고, 담당자는 퇴사합니다. **언제 끊기고 무엇을 다시 해야 하는지** 미리 알면 데이터 공백을 막을 수 있습니다. ## 연동 상태 세 가지 **데이터 연동** 화면의 카드에 표시됩니다. | 상태 | 의미 | 해야 할 일 | |---|---|---| | `미연동` | 아직 연결하지 않음 | 연동 진행 | | `연동됨` | 정상 | 없음 | | `재인증 필요` | 자격증명이 더 이상 유효하지 않음 | **계정 연결 다시 누르기** 또는 키 재발급 | ## 자동으로 갱신되는 것 OAuth 방식(계정 연결) 채널은 **액세스 토큰이 자동 갱신**됩니다. 예를 들어 YouTube 액세스 토큰은 1시간 만에 만료되지만, 모닝인사이트는 이렇게 처리합니다. ``` 데이터 조회 → 토큰 만료 응답 → 자동으로 새 토큰 발급 → 조회 재시도 → 성공 ``` 즉 **정상 상황에서는 사용자가 아무것도 하지 않아도 됩니다.** 자동 갱신은 갱신용 토큰(refresh token)이 살아 있는 동안만 동작합니다. ## 자동 갱신이 깨지는 경우 아래 상황에서는 자동 갱신이 불가능해 **재인증이 필요**합니다. | 원인 | 흔한 상황 | |---|---| | 사용자가 플랫폼에서 앱 접근 권한을 철회 | Google/Meta 보안 설정에서 '연결된 앱' 삭제 | | 플랫폼 계정 비밀번호 변경 | 일부 플랫폼은 비밀번호 변경 시 토큰 무효화 | | 계정에 2단계 인증 새로 적용 | 기존 토큰 무효화 | | 연동한 담당자 계정이 정지·삭제 | 퇴사자 계정으로 연동한 경우 | | 장기간 미사용 | 일부 플랫폼은 6개월 미사용 시 갱신 토큰 만료 | | 앱 권한 범위 변경 | 요구 권한이 늘어나면 재동의 필요 | **대응:** 설정 → 데이터 연동 → 해당 채널 → **계정 연결** 을 다시 누릅니다. 값 재입력은 필요 없습니다. ## 키 방식 채널이 끊기는 경우 키를 직접 넣은 채널(네이버 검색광고·Meta Ads·Jira 등)은 자동 갱신이 없습니다. 아래 경우에 **키를 재발급해 다시 입력**해야 합니다. - 키를 발급한 플랫폼 계정에서 키를 **폐기(revoke)** 했다 - 키에 **유효기간**이 있고 만료됐다 - 플랫폼에서 **권한 범위를 축소**했다 - 발급 계정 자체가 정지·삭제됐다 ## 인증서 방식이 끊기는 경우 법인 은행 계좌·법인카드는 준비물이 계속 바뀌므로 가장 자주 끊깁니다. | 원인 | 대응 | |---|---| | **공동인증서 만료** (보통 1년) | 은행에서 갱신 → 새 인증서 파일로 재등록 | | 카드사 홈페이지 **비밀번호 변경** | 새 비밀번호로 재등록 | | 카드사 비밀번호 **주기적 변경 강제** | 변경 후 즉시 재등록 | | 계정 잠김 (로그인 실패 누적) | 카드사 홈페이지에서 잠김 해제 후 재등록 | > **공동인증서 만료일을 캘린더에 넣어 두세요.** 만료되면 재무 데이터가 조용히 멈춥니다. ## 끊긴 것을 빨리 알아채는 방법 연동이 끊기면 화면이 텅 비는 대신 **지난번에 수집한 값이 계속 보일 수 있습니다.** 그래서 눈치채기 어렵습니다. 아래 신호를 확인하세요. 1. **데이터 연동 화면에 `재인증 필요` 표시** — 가장 확실한 신호 2. **같은 숫자가 며칠째 그대로** — 수집이 멈춘 정황 3. **7일 평균 증감이 0 에 수렴** — 새 데이터가 안 들어오는 정황 4. **아침 브리핑에서 특정 섹션이 사라짐** ## 정기 점검 권장 주기 | 주기 | 확인할 것 | |---|---| | 매주 | 데이터 연동 화면에서 `재인증 필요` 가 있는지 | | 매월 | 각 영역 화면의 최근 데이터 날짜가 어제인지 | | 분기 | 연동에 쓰인 플랫폼 계정이 아직 유효한지 (퇴사자 계정 여부) | | 연 1회 | 공동인증서 만료일 확인 및 갱신 | ## 담당자 교체 시 체크리스트 연동 담당자가 바뀔 때 가장 많이 사고가 납니다. - [ ] 어떤 채널이 어떤 플랫폼 계정으로 연동돼 있는지 목록화 - [ ] 퇴사자 개인 계정으로 연동된 채널을 **공용/관리자 계정으로 재연동** - [ ] 발급받은 키 원본이 인수인계됐는지 (모닝인사이트에서는 다시 볼 수 없습니다) - [ ] 공동인증서 파일과 비밀번호 인수인계 - [ ] 모닝인사이트 계정 권한 이전 (오너 변경 필요 시 운영 담당자 문의) ## 관련 문서 - [자격증명 보관과 보안](/news/guide/integration-security) - [연동이 실패할 때](/news/guide/trouble-integration)