구글 로그인 정리 + CORS 오류 해결 FastAPI+React환경

사실 이건

“Access to fetch at ’https://accounts.google/….com’ (redirected from ’https://myExpressAPI.com’) from origin ’https://myReactApp.com’ has been blocked by CORS policy: No ‘Access-Control-Allow-Origin’ header is present on the requested resource”.

이 오류를 해결하기 위해 작성되었다.

구글 로그인을 눌렀을 때 실제로 무슨 일이 벌어질까?

Google 계정으로 로그인

을 클릭하는 순간 어떤일이 일어날까?

1. 프론트엔드에서 Google OAuth 서버로 리다이렉트

  • 브라우져가 https://accounts.google.com/o/oauth2/v2… 로 이동
    이때 파라미터가 같이갑니다.
    • client_id
    • redirect_uri
    • response_type=code
    • scope (예: openid profile email)
    • state, code_challenge(PKCE) 등

2. 사용자가 google로그인 + 동의

3. Google이 우리 앱으로 다시 리다이랙트(Redirect URL)

구글 로그인 콘솔에서 설정하는 리다이랙트URL이 그것입니다.

하지만 이때 https://example.com/auth/google/callback?code=XXX&state=YYY
Code를 같이주는데 이 Code으로 토큰을 발급받을 수 있습니다!

4. 백엔드가 Authorization Code로 토큰 교환

백엔드 서버가 Google 토큰 엔드포인트로 요청:
• https://oauth2.googleapis.com/token
• grant_type=authorization_code
• code=…
• redirect_uri, client_id, client_secret 등 포함

응답으로 받는 것:
• access_token
• refresh_token (옵션)
• id_token (OpenID Connect일 때, 사용자 정보 포함) -> 이거를 디코딩하면

{

“iss”: “https://accounts.google.com”, “azp”: “4234567890-a2bc.apps.googleusercontent.com”, “aud”: “4234567890-a2bc.apps.googleusercontent.com”, “sub”: “110123456789012345678”, “email”: “user@example.com”, “email_verified”: true, “name”: “홍기현”, “picture”: “https://lh3.googleusercontent.com/abcdefg”, “given_name”: “기현”, “family_name”: “홍”, “locale”: “ko”, “iat”: 1733870000, “exp”: 1733873600, “at-hash”: “abcdefzHhL_Qgg” }


대충 이런거 나옴 여기서 sub -> 이게 변하지 않는거라 이걸로 사용자를 보통 판단 

•    expires_in 등

5. 이제 사용자 세션을 제공하고 프론트로 응답을 보내면 로그인 성공!

토큰안에 사용자 정보를 DB에 저장되어있는 사용자가 맞는지 메핑후 JWT발급!


CORS(Cross-Origin Resource Sharing)의 역할

이거는 서버가 헤더로 ’이 출처 요청은 허용해도 된다’라고 브라우저에게 알려주는거임

서버는 예를들어 이런식으로 내려줍니다

Access-Control-Allow-Origin: http://localhost:5173
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization

따라서 그럼 브라우져단에서
“아 이 서버는 http://localhost:5173에서 오는 요청을 허용했구나, OK~”
하고 JS코드를 컴퓨터에서 실행시킵니다.

간단히 말해:
• CORS는 “브라우저 ↔ 우리 백엔드” 통신 문제
• 구글 OAuth 서버랑은 CORS 이슈가 없다 (브라우저 네비게이션/리다이렉트는 CORS 대상이 아님)

따라서

CORS와 구글 로그인에서 자주 나오는 실수

편하게 요약하면:
• https://accounts.google.com/… 으로 브라우저가 직접 이동하는 건 CORS와 무관
• 문제가 되는 것은:
• 프론트: http://localhost:5173
• 백엔드: http://localhost:8080
• 프론트에서 fetch(“http://localhost:8080/auth/google”) 할 때
→ 이때 백엔드가 CORS 허용을 안 해주면 에러 발생

따라서, Google Cloud Console에 http://localhost:5173을 넣는다고 CORS가 해결되는 게 아니라,
우리 백엔드 서버에서 CORS를 설정해줘야 하는 것입니다.


OAuth 2.0

OAuth의 본질
사용자의 비밀번호를 알려달라고 하지말고, 사용자가 직접 서비스 제공자(Google 등)에게 로그인하고,
그 서비스가 ’토큰’을 대신 발급해주면,그 토큰을 통해 제한된 권한으로 리소스에 접근하자.

즉
• 우리가 사용자 비밀번호를 직접 저장/검증하지 않는다.
• 대신 Google, GitHub, Kakao 같은 Identity Provider에게 위임한다.
• 우리가 받는 것은 Access Token 같은 “권한 티켓”.

OAuth 2.0은 원래 Authorization 프로토콜에 가깝지만,
OpenID Connect (OIDC) 라는 확장 규격을 사용하면 로그인(인증) 용도로도 쓸 수 있습니다.
구글 로그인에서 흔히 사용하는 것이 바로:

OAuth 2.0 + OpenID Connect

입니다.


나중에 또 햇갈리면 다시 정리하러 와야겠다.

따라서 CORS 오류가 나면 프론트에서 구글을 거치고 리다이랙트로 떨구는 URL을 + 구글 콘솔에 이거 추가해주고

# 프로덕션과 로컬 개발 환경 모두 지원
allowed_origins = [
    "https://gang-nang-bot.vercel.app",  # 프로덕션 프론트엔드 (실제 URL)
    "https://gangnangbot.vercel.app",  # 프로덕션 프론트엔드 (이전 URL)
    "http://localhost:3000",
    "http://localhost:8080",
    "http://127.0.0.1:3000",
    "http://127.0.0.1:8080",
    "http://localhost:5173",
    "https://gang-naeng-bot-fe.vercel.app"
]

app.add_middleware(
    CORSMiddleware,
    allow_origins=allowed_origins,
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

이런식으로 관리를 해주어야 한다!

태그
#CORS#구글#로그인#보안#오류 해결
티스토리 원문 ↗