아래는 **Cursor AI가 그대로 따라 하면서 Google Cloud(Cloud Run)까지 작업할 수 있게 만든 “Redirect URI 설정 지시서”**야.
네 프로젝트(v0.2.0) 기준으로 딱 필요한 것만 순서대로 넣었어.
Cursor AI 작업 지시서: 카페24 Redirect URI 설정 + Cloud Run 연동
목표
카페24 디벨로퍼 앱의 Redirect URI(s) 를
Google Cloud Run에 배포된 API 서버의 OAuth 콜백 엔드포인트로 정확히 연결한다.
1) Cloud Run 서비스 URL 확보
1-1. GCP 프로젝트/리전 확인
-
프로젝트:
cafe-api-auto -
리전:
asia-northeast3(서울)
1-2. Cloud Run 배포 후 서비스 URL 확인
Cloud Run 배포가 끝나면 서비스 URL이 아래 형태로 나온다:
예)
아직 배포 전이면, 먼저 v0.2.0을 Cloud Run에 배포한 뒤 URL을 확인한다.
2) Redirect URI 만들기 (정확히)
Cloud Run 서비스 URL 뒤에 반드시 /oauth/callback 을 붙인다.
예)
3) 카페24 디벨로퍼 콘솔 입력
카페24 디벨로퍼 → Apps → 해당 앱 → STEP 01 개발정보관리 화면에서
3-1. Redirect URI(s) 입력칸에 아래 값 붙여넣기
3-2. 규칙
-
HTTPS 필수 (HTTP 불가)
-
최대 10개까지 가능하지만 1개만 등록
-
엔터로 구분해서 여러 개 등록할 수 있음 (지금은 1개만)
3-3. 저장 클릭
[저장] 버튼을 눌러야 적용됨
4) Cloud Run 환경변수에도 동일하게 반영
Cloud Run 서비스의 환경변수에 아래를 정확히 등록
4-1. (로컬 배포 시) .env 예시
5) OAuth 1회 승인 테스트
5-1. 브라우저에서 OAuth 시작
아래 URL로 접속
5-2. 카페24 로그인 & 권한 승인
승인 후 자동으로 콜백으로 이동
5-3. 성공 조건
-
화면에
{ "ok": true, "message": "tokens saved" }
출력되면 성공 -
GCP Secret Manager의
cafe24-token-json에 access/refresh 토큰 저장됨.
6) 문제 발생 시 체크 포인트
-
Redirect URI 오타
-
/oauth/callback빠졌는지 -
Cloud Run URL이 정확한지
-
-
카페24 콘솔에 저장 누름 여부
-
Cloud Run 환경변수와 콘솔 Redirect URI가 완전히 일치하는지
-
HTTPS인지
-
권한(scope) Product/Category Read+Write 포함됐는지
최종 산출물(정리)
-
카페24 Redirect URI(s)
-
Cloud Run
CAFE24_REDIRECT_URI -
둘이 완벽히 같은 값이어야 OAuth가 성공한다.
이제 너가 Cloud Run URL만 확정해서 알려주면,
내가 그 URL로 Redirect URI 최종 문자열을 만들어서
다음 단계(v0.2.2 옵션/템플릿 고도화)로 바로 넘어가자.