451b37955e
- inout_db 003: 공장 이메일, 사람별 Gmail 연결(갱신 토큰 암호문만), 발주 메일 기록, 입고증 사진(bytea). init 에도 같게.
- 발주 메일: 새 발주서 저장 → 미리보기 팝업(받는 사람 = 공장 이메일, 요약 표 HTML + 글 본문) → 사람이 [메일 발송]을
눌러야 Gmail API(gmail.send)로 본인 Gmail 에서 발송. [Gmail 연결]은 사람마다 1회 — 고른 구글 계정 = ERP 계정 확인,
APP_ENCRYPTION_KEY(AES-GCM, AAD inout:gmail:{email})로 암호화 저장. 보낸 기록, 재발송은 확인 후(resend),
연결 끊김(invalid_grant)은 토큰 삭제 후 재연결 안내.
- 입고증 사진: 입고 저장 때 첨부(브라우저가 긴 변 2000px JPEG 로 줄임 — 7.9MB → 0.8MB), 10장·10MB, 파일 머리로 형식 검사,
입고와 한 트랜잭션. 썸네일·크게 보기(←/→)·나중에 더하기·지우기, 보기는 nosniff·CSP sandbox. 초과 확인은 브라우저가 먼저(사진 유지).
- 테스트: 메일 본문·escape·받는 주소·Gmail 연결 검사·토큰 갱신/발송(가짜 구글)·암호화, 사진 검사, 실제 PostgreSQL 저장,
실제 앱 흐름(사진 업로드·보기 헤더·권한, 메일 미리보기·연결·발송·재발송·끊김). 실제 브라우저로 팝업·사진·축소 확인.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
187 lines
8.7 KiB
Python
187 lines
8.7 KiB
Python
"""발주 메일 — 발주 담당자 본인 Gmail 로 보내기(2026-10-16 사용자 요청, Gmail API).
|
|
|
|
연결(사람마다 한 번): [Gmail 연결] → 구글 동의 화면(로그인과 같은 OAuth 클라이언트 GOOGLE_CLIENT_ID, 범위 = gmail.send 만)
|
|
→ /inout/gmail/callback 에서 ① 고른 구글 계정이 ERP 로그인 계정과 같은지(다르면 거절 — 남의 메일함으로 보내지 않게)
|
|
② gmail.send 를 허락했는지 ③ 갱신 토큰이 왔는지 확인 → 갱신 토큰을 APP_ENCRYPTION_KEY(실적 모듈과 같은 마스터 키,
|
|
AES-256-GCM, AAD = inout:gmail:{email})로 암호화해 inout_gmail_tokens 에. 원문·접근 토큰은 저장·출력하지 않는다.
|
|
보내기: 갱신 토큰 → 접근 토큰(oauth2.googleapis.com/token) → gmail.users.messages.send(raw = RFC 822, 글 + HTML).
|
|
사람이 [메일 발송]을 눌렀을 때만 보낸다(자동 발송 없음). 연결이 끊겼으면(invalid_grant·권한 없음) 다시 연결 안내.
|
|
구글 클라우드 준비(관리자 1회): Gmail API 사용 설정 · OAuth 동의 화면에 …/auth/gmail.send 범위 추가 ·
|
|
OAuth 클라이언트의 승인된 리디렉션 URI 에 {PUBLIC_BASE_URL}/inout/gmail/callback 추가. 상세 docs/INOUT_MODULE.md.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import base64
|
|
import os
|
|
from email.message import EmailMessage
|
|
from email.utils import formataddr
|
|
from typing import Any
|
|
|
|
import httpx
|
|
|
|
GMAIL_SCOPE = "https://www.googleapis.com/auth/gmail.send"
|
|
TOKEN_URI = "https://oauth2.googleapis.com/token"
|
|
SEND_URI = "https://gmail.googleapis.com/gmail/v1/users/me/messages/send"
|
|
REVOKE_URI = "https://oauth2.googleapis.com/revoke"
|
|
CLIENT_NAME = "inout_gmail"
|
|
|
|
|
|
class GmailNotConnected(Exception):
|
|
"""Gmail 연결이 없거나 끊김 — 다시 [Gmail 연결]."""
|
|
|
|
|
|
class GmailError(Exception):
|
|
"""보내기 실패(구글 오류 등) — 문구는 화면에 그대로(비밀값 없음)."""
|
|
|
|
|
|
def _http() -> httpx.Client:
|
|
"""HTTP 클라이언트 — 테스트가 바꿔 끼운다."""
|
|
return httpx.Client(timeout=20.0)
|
|
|
|
|
|
# ── 토큰 암호화(실적 모듈과 같은 마스터 키) ─────────────────
|
|
def _ring() -> Any:
|
|
from app.modules.performance.security.crypto import CryptoConfigError, KeyRing # noqa: WPS433
|
|
|
|
try:
|
|
return KeyRing.from_env()
|
|
except CryptoConfigError as exc:
|
|
raise GmailError(f"암호화 키가 없어 Gmail 연결을 저장할 수 없습니다 — {exc}") from None
|
|
|
|
|
|
def _aad(email: str) -> str:
|
|
return f"inout:gmail:{(email or '').strip().lower()}"
|
|
|
|
|
|
def encrypt_token(email: str, refresh_token: str) -> str:
|
|
from app.modules.performance.security.crypto import encrypt # noqa: WPS433
|
|
|
|
return encrypt(refresh_token, aad=_aad(email), ring=_ring())
|
|
|
|
|
|
def decrypt_token(email: str, enc: str) -> str:
|
|
from app.modules.performance.security.crypto import DecryptError, decrypt # noqa: WPS433
|
|
|
|
try:
|
|
return decrypt(enc, aad=_aad(email), ring=_ring())
|
|
except DecryptError:
|
|
raise GmailNotConnected("저장된 Gmail 연결을 읽을 수 없습니다(암호화 키가 바뀌었을 수 있음) — 다시 연결하세요.") from None
|
|
|
|
|
|
# ── OAuth 클라이언트(로그인과 같은 GOOGLE_CLIENT_ID, 범위만 다름) ──
|
|
def oauth_client() -> Any:
|
|
from app.main import env, oauth # noqa: WPS433
|
|
|
|
if not env("GOOGLE_CLIENT_ID") or not env("GOOGLE_CLIENT_SECRET"):
|
|
raise GmailError("GOOGLE_CLIENT_ID/SECRET 이 없어 Gmail 을 연결할 수 없습니다.")
|
|
client = oauth.create_client(CLIENT_NAME)
|
|
if client is None:
|
|
oauth.register(
|
|
name=CLIENT_NAME,
|
|
client_id=env("GOOGLE_CLIENT_ID"),
|
|
client_secret=env("GOOGLE_CLIENT_SECRET"),
|
|
server_metadata_url="https://accounts.google.com/.well-known/openid-configuration",
|
|
client_kwargs={"scope": f"openid email {GMAIL_SCOPE}"},
|
|
)
|
|
client = oauth.create_client(CLIENT_NAME)
|
|
return client
|
|
|
|
|
|
def check_grant(token: dict[str, Any], *, expected_email: str) -> tuple[str, str]:
|
|
"""콜백 토큰 확인 → (갱신 토큰, 허락된 범위). 계정이 다르거나 발송 권한·갱신 토큰이 없으면 GmailError."""
|
|
info = token.get("userinfo") or {}
|
|
got = str(info.get("email") or "").strip().lower()
|
|
want = (expected_email or "").strip().lower()
|
|
if not got or got != want:
|
|
raise GmailError(f"ERP 로그인 계정({want})과 다른 구글 계정({got or '알 수 없음'})을 골랐습니다 — 같은 계정으로 다시 연결하세요.")
|
|
scopes = str(token.get("scope") or "")
|
|
if GMAIL_SCOPE not in scopes.split():
|
|
raise GmailError("메일 보내기 권한(gmail.send)을 허락하지 않았습니다 — 동의 화면에서 체크한 뒤 다시 연결하세요.")
|
|
refresh = str(token.get("refresh_token") or "")
|
|
if not refresh:
|
|
raise GmailError("구글이 갱신 토큰을 주지 않았습니다 — 구글 계정 → 보안 → 타사 앱 접근에서 이 앱을 지우고 다시 연결하세요.")
|
|
return refresh, scopes
|
|
|
|
|
|
# ── 보내기 ──────────────────────────────────────────────
|
|
def _google_message(resp: httpx.Response) -> str:
|
|
try:
|
|
body = resp.json()
|
|
except ValueError:
|
|
return f"HTTP {resp.status_code}"
|
|
err = body.get("error")
|
|
if isinstance(err, dict):
|
|
return str(err.get("message") or err.get("status") or resp.status_code)[:200]
|
|
return str(body.get("error_description") or err or resp.status_code)[:200]
|
|
|
|
|
|
def access_token(refresh_token: str) -> str:
|
|
from app.main import env # noqa: WPS433
|
|
|
|
try:
|
|
with _http() as client:
|
|
resp = client.post(TOKEN_URI, data={"client_id": env("GOOGLE_CLIENT_ID"), "client_secret": env("GOOGLE_CLIENT_SECRET"),
|
|
"refresh_token": refresh_token, "grant_type": "refresh_token"})
|
|
except httpx.HTTPError as exc:
|
|
raise GmailError(f"구글 인증 서버에 연결하지 못했습니다({type(exc).__name__}).") from None
|
|
if resp.status_code != 200:
|
|
try:
|
|
code = str(resp.json().get("error") or "")
|
|
except ValueError:
|
|
code = ""
|
|
if code in ("invalid_grant", "unauthorized_client", "invalid_client"):
|
|
raise GmailNotConnected("Gmail 연결이 끊겼습니다(권한 취소·비밀번호 변경 등) — 다시 연결하세요.")
|
|
raise GmailError(f"구글 인증 실패: {_google_message(resp)}")
|
|
token = str(resp.json().get("access_token") or "")
|
|
if not token:
|
|
raise GmailError("구글 인증 서버가 접근 토큰을 주지 않았습니다.")
|
|
return token
|
|
|
|
|
|
def build_message(*, sender_name: str, sender_email: str, to: list[str], cc: list[str], subject: str,
|
|
text: str, html: str) -> bytes:
|
|
msg = EmailMessage()
|
|
msg["From"] = formataddr((sender_name or sender_email, sender_email))
|
|
msg["To"] = ", ".join(to)
|
|
if cc:
|
|
msg["Cc"] = ", ".join(cc)
|
|
msg["Subject"] = subject
|
|
msg.set_content(text)
|
|
msg.add_alternative(html, subtype="html")
|
|
return msg.as_bytes()
|
|
|
|
|
|
def send(refresh_token: str, raw: bytes) -> str:
|
|
"""보내고 Gmail 메시지 id 를 돌려준다."""
|
|
token = access_token(refresh_token)
|
|
body = {"raw": base64.urlsafe_b64encode(raw).decode("ascii")}
|
|
try:
|
|
with _http() as client:
|
|
resp = client.post(SEND_URI, json=body, headers={"Authorization": f"Bearer {token}"})
|
|
except httpx.HTTPError as exc:
|
|
raise GmailError(f"Gmail 에 연결하지 못했습니다({type(exc).__name__}).") from None
|
|
if resp.status_code in (401, 403):
|
|
msg = _google_message(resp)
|
|
if "has not been used" in msg or "disabled" in msg.lower():
|
|
raise GmailError(f"Gmail API 가 꺼져 있습니다 — 관리자가 구글 클라우드에서 Gmail API 를 사용 설정해야 합니다. ({msg})")
|
|
raise GmailNotConnected(f"Gmail 보내기 권한이 없습니다 — 다시 연결하세요. ({msg})")
|
|
if resp.status_code != 200:
|
|
raise GmailError(f"메일을 보내지 못했습니다: {_google_message(resp)}")
|
|
return str(resp.json().get("id") or "")
|
|
|
|
|
|
def revoke(refresh_token: str) -> None:
|
|
"""연결 끊기 — 구글 쪽 권한도 취소(실패해도 무시, 우리 쪽 토큰은 지운다)."""
|
|
try:
|
|
with _http() as client:
|
|
client.post(REVOKE_URI, data={"token": refresh_token})
|
|
except httpx.HTTPError:
|
|
pass
|
|
|
|
|
|
def configured() -> bool:
|
|
"""APP_ENCRYPTION_KEY·GOOGLE_CLIENT_ID/SECRET 이 있는지(화면 안내용)."""
|
|
return bool(os.getenv("APP_ENCRYPTION_KEY", "").strip() and os.getenv("GOOGLE_CLIENT_ID", "").strip()
|
|
and os.getenv("GOOGLE_CLIENT_SECRET", "").strip())
|