Flutter 앱 Google OAuth 동의 화면 인증 셋업 정리

Flutter 앱에 Google 로그인을 붙이면서 OAuth 동의 화면 인증까지 진행한 과정을 정리한다.

Firebase 없이 Google Cloud Console에서 직접 OAuth 클라이언트 ID를 발급받아 연동하는 경우, 동의 화면 설정과 인증 제출 과정에서 예상치 못한 에러가 자주 발생한다. 실제로 겪은 삽질 위주로 기록한다.

전체 흐름 요약

1. Google Cloud Console에서 OAuth 2.0 클라이언트 ID 생성 (iOS 타입)
2. 동의 화면 브랜딩 설정
3. 앱 도메인 및 개인정보처리방침 URL 등록
4. 필요한 범위(scope) 설정
5. 인증 제출 및 프로덕션 전환

브랜딩 설정

Google Cloud Console → API 및 서비스 → OAuth 동의 화면 → 브랜딩 에서 아래 항목을 입력한다.

• 앱 이름: 동의 화면에 표시될 이름 (홈페이지 본문과 반드시 일치해야 함)
• 사용자 지원 이메일: 문의용 이메일
• 앱 도메인: 홈페이지, 개인정보처리방침, 서비스 약관 URL
• 승인된 도메인: 위 URL들의 루트 도메인

삽질: 앱 이름 불일치 에러

저장 후 인증 제출 시 아래 에러가 발생할 수 있다.

OAuth 동의 화면에 구성된 앱 이름이 홈페이지의 앱 이름과 일치하지 않습니다.

Google이 홈페이지 URL을 크롤링해서 페이지 본문에 렌더링된 텍스트와 콘솔에 입력한 앱 이름을 비교한다.

<title> 태그나 <meta> 태그만으로는 통과되지 않는다. 실제 DOM에 보이는 텍스트여야 한다.

해결

홈페이지 HTML 본문에 콘솔 앱 이름과 동일한 텍스트를 추가한다.

<p>앱 이름 (콘솔에 입력한 것과 동일하게)</p>

데이터 액세스 (범위)

단순 Google 로그인만 구현한다면 범위를 추가하지 않아도 된다.

openid, email, profile은 Google Sign-In에 기본 포함된 범위로, 콘솔에서 별도 추가 없이 자동 동작하며 별도 심사도 필요 없다.

범위 추가가 필요한 경우:

불필요한 범위를 추가하면 심사 난이도만 올라가므로 실제 사용하는 것만 추가한다.

인증 제출

• 테스트 상태: 콘솔에 등록한 테스트 계정만 로그인 가능
• 프로덕션 상태: 인증 완료 후 모든 Google 계정 사용자 로그인 가능

브랜딩, 데이터 액세스 설정 완료 후 인증 탭에서 제출한다.

추가 삽질: 개인정보처리방침 URL 검증 실패

앱 도메인 항목에 입력한 개인정보처리방침 URL이 Google 봇에게 접근 가능해야 한다.

Hugo 블로그처럼 정적 사이트를 운영하는 경우 배포가 완료된 URL이어야 하며, localhost나 미배포 URL은 검증을 통과하지 못한다. 인증 제출 전에 실제 URL로 접근이 되는지 먼저 확인한다.

추가 삽질: 테스트 상태에서 “앱이 확인되지 않음” 경고

OAuth 동의 화면이 테스트 상태일 때 등록된 테스트 계정 외의 계정으로 로그인하면 “앱이 확인되지 않았습니다” 경고가 표시된다. 이는 정상이며, 인증 제출 후 프로덕션으로 전환되면 사라진다.

테스트 단계에서는 콘솔의 테스트 사용자 항목에 테스트 계정 이메일을 추가해두면 경고 없이 로그인 가능하다.

인증 심사 소요 기간

Google OAuth 인증 심사는 민감 범위가 없는 경우(기본 로그인만) 수 일 내에 완료되는 편이다. 민감 범위(drive, gmail 등)가 포함된 경우 수 주~수 개월이 걸릴 수 있으며, 공식 앱 웹사이트와 데모 영상 제출이 필요하다.

기본 Google 로그인만 사용하는 앱이라면 별도 심사 없이 프로덕션 전환이 바로 가능하다.

정리