Files
dbx-main/scripts/google_sheets_authorize.py
king 80c9904771 fix(scripts): move OAuth callback port to 18765
8765-8767 are taken by local preview servers on the dev PC.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 12:50:14 +09:00

104 lines
4.8 KiB
Python

"""Google 스프레드시트 쓰기·회의록 보드(Drive·Slides)용 refresh token 1회 발급 스크립트.
조직 정책(`iam.disableServiceAccountKeyCreation`)으로 서비스 계정 키를 만들 수 없을 때
사용자 계정 OAuth 로 서버가 시트에 기록하도록 하기 위한 토큰을 받는다.
사전 준비 (Google Cloud Console)
1. API 및 서비스 → 라이브러리 → "Google Sheets API"·"Google Drive API"·"Google Slides API" 사용
2. API 및 서비스 → OAuth 동의 화면 구성(내부 또는 외부)
3. 사용자 인증 정보 → 사용자 인증 정보 만들기 → **OAuth 클라이언트 ID**
→ 애플리케이션 유형 **데스크톱 앱** → 클라이언트 ID / 보안 비밀 확인
실행 (개발 PC, 브라우저 있는 환경에서)
python scripts/google_sheets_authorize.py --client-id <ID> --client-secret <SECRET>
또는 환경변수로:
GOOGLE_SHEETS_OAUTH_CLIENT_ID / GOOGLE_SHEETS_OAUTH_CLIENT_SECRET
브라우저가 열리면 **시트를 편집할 수 있고 회의록 보드 공유 드라이브에 쓸 수 있는 계정**으로 로그인·동의한다.
마지막에 출력되는 refresh token 을 서버 `.env` 의
`GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN` 에 넣는다(시트·회의록 보드가 같이 쓴다).
400 redirect_uri_mismatch 가 나오면
- 쓰는 OAuth 클라이언트가 "웹 애플리케이션" 유형이면 승인된 리디렉션 URI 에 **http://localhost:18765/** 를 추가하고
(끝 / 포함, 반영까지 몇 분) 다시 실행한다. 포트를 바꾸면(--port N) 그 주소(http://localhost:N/)를 등록해야 한다.
- "데스크톱 앱" 유형 클라이언트는 등록 없이 된다.
- refresh token 은 발급한 클라이언트 ID 에 묶인다 — 서버 .env 의 GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET
(없으면 GOOGLE_CLIENT_ID/SECRET)이 여기서 쓴 클라이언트와 같아야 한다.
주의
- 출력된 refresh token 은 비밀값이다. Git·메신저에 남기지 말 것.
- 토큰은 발급한 사용자 권한으로 동작한다. 그 사용자가 대상 문서를 편집할 수
있어야 하며, 계정 비밀번호 변경·토큰 폐기 시 다시 발급해야 한다.
"""
from __future__ import annotations
import argparse
import os
import sys
# 스프레드시트(쿠팡 출고리스트) + Drive·Slides(주간 회의록 보드 — 공유 드라이브에 빈 슬라이드 만들기)
SCOPES = [
"https://www.googleapis.com/auth/spreadsheets",
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/presentations",
]
def main() -> int:
parser = argparse.ArgumentParser(description="Google Sheets refresh token 발급")
parser.add_argument("--client-id", default=os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_ID", ""))
parser.add_argument(
"--client-secret", default=os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_SECRET", "")
)
parser.add_argument(
"--port", type=int, default=18765,
help="로컬 콜백 포트(기본 18765 — 웹 애플리케이션 클라이언트면 http://localhost:18765/ 를 리디렉션 URI 로 등록)"
)
args = parser.parse_args()
client_id = (args.client_id or "").strip()
client_secret = (args.client_secret or "").strip()
if not client_id or not client_secret:
print("client id / secret 이 필요합니다. --client-id / --client-secret 또는 환경변수로 넣으세요.")
return 2
try:
from google_auth_oauthlib.flow import InstalledAppFlow
except ImportError:
print("google-auth-oauthlib 가 필요합니다: pip install google-auth-oauthlib")
return 2
flow = InstalledAppFlow.from_client_config(
{
"installed": {
"client_id": client_id,
"client_secret": client_secret,
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"redirect_uris": ["http://localhost"],
}
},
scopes=SCOPES,
)
# prompt=consent 를 줘야 refresh token 이 항상 내려온다.
creds = flow.run_local_server(port=args.port, prompt="consent", access_type="offline")
if not creds.refresh_token:
print("refresh token 을 받지 못했습니다. 계정의 기존 권한을 해제하고 다시 시도하세요.")
return 1
print()
print("=" * 70)
print("서버 .env 에 아래 값을 넣으세요 (비밀값 — 공유 금지)")
print("=" * 70)
print(f"GOOGLE_SHEETS_OAUTH_CLIENT_ID={client_id}")
print("GOOGLE_SHEETS_OAUTH_CLIENT_SECRET=<위에서 쓴 보안 비밀>")
print(f"GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN={creds.refresh_token}")
print("=" * 70)
return 0
if __name__ == "__main__":
sys.exit(main())