Files
insurance/API_KEYS.md
T
chpark cfd550bed8
Deploy via SSH / remote-deploy (push) Failing after 6s
feat: AI판정/OCR/알림톡/소셜로그인/푸시/CODEF 전체 구현 + CI SSH 전환
Backend (server/src):
- services/anthropic.ts — Claude API 래퍼 (키 없으면 룰베이스 fallback)
- services/ocr.ts — Naver Clova + Google Vision 듀얼 연동 + 영수증 필드 파서
- services/solapi.ts — 카카오 알림톡 HMAC 서명 + 드라이런
- services/expoPush.ts — Expo Push API 전송
- services/codef.ts — 보험 통합조회 mock + 실연동 포인트
- routes/ai.ts, ocr.ts, devices.ts, social.ts (naver/apple), alimtalk.ts, codef.ts
- Prisma: PushDevice 모델 + binaryTargets linux-musl-openssl-3.0.x
- Dockerfile: apk add openssl (Prisma schema engine 정상화)
- api-secrets에 9개 외부 API 키 슬롯 추가 (optional)

Frontend:
- api/endpoints.ts: aiApi, ocrApi, deviceApi, socialApi, codefApi
- services/kakao.ts — Kakao JS SDK 동적 로드 + Auth.login
- services/push.ts — expo-notifications 권한/토큰 등록 + 서버 전송
- LoginScreen — 카카오/네이버/애플 버튼 (웹은 토큰 입력 fallback)
- AIJudgeScreen — 실제 /ai/claim-judge 호출, source(llm/rules) 표시
- ClaimScreen — 영수증 촬영 시 자동 OCR → 병원/날짜/제목 자동 기입
- useAuthStore hydrate 시 푸시 토큰 등록

Infra:
- eas.json (development/preview/production 빌드 프로필)
- API_KEYS.md — 9개 외부 서비스 발급/등록 가이드
- scripts/deploy-remote.sh 개선 (sudo 정확히, traefik cp 버그 수정, API fail 시 로그 출력)
- deploy/k8s/api.yaml — 외부 API 키 환경변수 매핑 (optional=true)

CI/CD:
- .gitea/workflows/deploy.yml → SSH 기반으로 전환
  (appleboy/ssh-action으로 서버 접속 → deploy-remote.sh 실행)
- 필요 Secrets: SSH_HOST, SSH_USER, SSH_PASSWORD

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 00:56:06 +09:00

3.6 KiB

🔑 API Keys & 외부 연동 설정

모든 키는 없어도 앱은 동작합니다 (fallback 또는 dry-run). 키 등록 시 해당 기능이 자동으로 실 연동.

1. Anthropic Claude (AI 보험금 판정)

  • 발급: https://console.anthropic.com → API Keys
  • k8s secret key: api-secrets.anthropicApiKey
  • 환경변수: ANTHROPIC_API_KEY
  • 없을 때: 룰베이스 판정 (키워드 매칭)

2. Naver Clova OCR (영수증/증권 OCR)

  • 발급: https://www.ncloud.com/product/aiService/ocr → 도메인 생성 → APIGW 호출 URL + Secret Key
  • k8s secret key: api-secrets.clovaOcrUrl, api-secrets.clovaOcrSecret
  • 환경변수: CLOVA_OCR_URL, CLOVA_OCR_SECRET
  • 없을 때: Google Vision 시도 → 그것도 없으면 OCR 스킵 (수동 입력)

3. Google Cloud Vision (OCR fallback)

4. Solapi 카카오 알림톡

  • 발급: https://solapi.com 가입 + API key
  • 카카오 비즈채널: https://center-pf.kakao.com 개설 → 검색ID (pfId)
  • 발신번호 등록 + 알림톡 템플릿 심사 (1~2주)
  • 환경변수: SOLAPI_API_KEY, SOLAPI_API_SECRET, SOLAPI_PFID, SOLAPI_SENDER_KEY
  • 없을 때: console.log로 드라이런

5. 카카오 로그인 (웹)

  • 발급: https://developers.kakao.com → 앱 생성 → 플랫폼: Web (https://insurance.junggomoa.com) → JavaScript 키
  • 클라이언트 빌드 환경변수: EXPO_PUBLIC_KAKAO_JS_KEY
  • 백엔드에서 access_token 검증은 이미 구현 (/auth/kakao)

6. 네이버 로그인

  • 발급: https://developers.naver.com → 애플리케이션 등록 → Client ID/Secret
  • 웹: 네이버 SDK 연동 필요 (LoginScreen onNaver() 커스터마이즈)
  • 백엔드는 이미 완성 (/auth/naver)

7. Apple 로그인

  • Apple Developer 계정 필요 (연 $99)
  • 서비스 활성화: Sign in with Apple
  • iOS: expo-apple-authentication 자동 동작 (네이티브 빌드 후)
  • 백엔드는 이미 완성 (/auth/apple)

8. CODEF 보험 통합조회

  • 발급: https://developer.codef.io → 상품 계약
  • 비즈니스 계약 필요 (월 수십만원~)
  • 환경변수: CODEF_CLIENT_ID, CODEF_CLIENT_SECRET
  • 없을 때: mock 데이터 반환 (ENABLE_CODEF_MOCK=true가 기본)

9. Expo Push (iOS/Android 푸시)

  • iOS: Apple Developer 계정 + APNs 인증서 (EAS Build 시 자동)
  • Android: FCM server key 등록 (eas credentials)
  • 무료

📦 서버에 키 등록하는 법

SSH 접속 후:

# /home/chpark/.insurance-secrets 에 export 형식으로 추가
cat >> /home/chpark/.insurance-secrets <<EOF
ANTHROPIC_API_KEY=sk-ant-...
CLOVA_OCR_URL=https://...apigw-ntruss.com/custom/v1/.../general
CLOVA_OCR_SECRET=...
SOLAPI_API_KEY=...
SOLAPI_API_SECRET=...
SOLAPI_PFID=@채널검색ID
SOLAPI_SENDER_KEY=...
CODEF_CLIENT_ID=...
CODEF_CLIENT_SECRET=...
EOF

# 재배포
cd /home/chpark/insurance && bash scripts/deploy-remote.sh

k8s secrets에 자동 반영됩니다.


📱 클라이언트 빌드 환경변수

.env 또는 EAS Build 환경변수:

EXPO_PUBLIC_API_BASE=https://api.insurance.junggomoa.com
EXPO_PUBLIC_KAKAO_JS_KEY=<카카오 JS 키>
EXPO_PUBLIC_NAVER_CLIENT_ID=<네이버 Client ID>