# Email Skill 인증 오류 및 Cron 토큰 문제

**작성일**: 2025-09-13  
**작성자**: happybell80 & Claude  
**영향 서비스**: skill-email, rb8001  
**심각도**: 높음  

## 1. 문제 상황

### Email Skill HTTP 500 오류
- **증상**: skill_email 서비스가 HTTP 500 반환
- **에러**: `No credentials found for user: 0914eagle@gmail.com`
- **영향**: 3명 사용자 이메일 동기화 실패 (매분 재시도 중)
  - happybell80 (goeun2dc@gmail.com)
  - 0914eagle (0914eagle@gmail.com)
  - cdctfm (cdctfm@gmail.com)

### Cron 트리거 권한 오류
- **증상**: `Unauthorized cron trigger attempt` 경고 발생
- **위치**: rb8001/main.py:558
- **문제**: 인증 실패에도 요청 처리 계속됨 (보안 취약)

## 2. 원인 분석

### Email 인증 실패 원인
```python
# skill-email/services/gmail_service.py:49
if creds_result is None:
    return Err(EmailError(f"No credentials found for user: {user_id}"))

# skill-email/services/db_credentials_provider.py:67
SELECT token_data->>'refresh_token' as refresh_token
FROM gmail_token  # 테이블명 맞음: 실제 DB도 gmail_token (단수형)
WHERE slack_user_id = %s AND is_equipped = true
```

1. **테이블명 일치 확인**: 코드와 DB 모두 `gmail_token` (250911 문서 확인)
2. **토큰 데이터 구조**: token_data JSONB 내부에 저장 (250909 문서 확인)
3. **is_equipped 조건**: 토큰이 있어도 장착되지 않으면 조회 실패

### Cron 인증 취약점
```python
# rb8001/main.py:556-560
expected_token = settings.CRON_TOKEN if hasattr(settings, 'CRON_TOKEN') else "cron-secret-2024"

if auth_header != f"Bearer {expected_token}":
    logger.warning("Unauthorized cron trigger attempt")
    # raise HTTPException(status_code=401, detail="Unauthorized")  # 주석 처리됨!
```

- 하드코딩된 기본 토큰 사용
- 인증 실패시 경고만 기록, 요청은 계속 처리

## 3. 관련 문서 참조

- **250909**: gmail_refresh_token 컬럼/JSONB 불일치 해결
- **250825**: Gmail 토큰 만료 문제 (동일 사용자 3명)
- **250801**: 크론잡 로그 동기화 설정

## 4. 해결 방안

### 즉시 조치 (로컬 개발자)
```python
# 1. 테이블명은 이미 맞음 (gmail_token 단수형)
# 실제 문제: 데이터가 없거나 is_equipped=false

# 2. Cron 인증 강화
# rb8001/main.py:560
- # raise HTTPException(status_code=401, detail="Unauthorized")
+ raise HTTPException(status_code=401, detail="Unauthorized")
```

### 서버 작업 필요 (서버 관리자)
```sql
-- 토큰 상태 확인
SELECT slack_user_id, is_equipped, 
       token_data->>'refresh_token' IS NOT NULL as has_token
FROM gmail_tokens 
WHERE slack_user_id IN ('0914eagle', 'happybell80', 'cdctfm');

-- is_equipped 설정
UPDATE gmail_tokens 
SET is_equipped = true 
WHERE slack_user_id IN ('0914eagle', 'happybell80', 'cdctfm');
```

## 5. 교훈

1. **DB 현황**: gmail_token 테이블 0건, 데이터 없음
2. **auth-server**: gmail_tokens와 gmail_token 혼용 (gmail_refresh.py는 복수, gmail_passport.py는 단수)
3. **skill-email**: gmail_token 단수형 사용 (정상)
4. **실제 원인**: 데이터 부재가 문제 (테이블명 아님)