[Google API] 구글 앱 인증 받기

Backend/API

[Google API] 구글 앱 인증 받기

dddzr 2025. 7. 26. 15:05

📌 1. 인증이 필요한 이유

✅ 1.1. 구글 클라우드에서 제공하는 calendar API를 사용함.

Calendar API는 구글에서 “비공개 Google 사용자 데이터에 대한 액세스 권한을 부여하는 민감한 범위” 라고 판단하는 API임. (readonly인 경우에도)

Google Calendar를 사용하여 액세스할 수 있는 모든 캘린더 보기, 수정, 공유, 영구 삭제

✅ 1.2. 사용자 유형을 외부로 설정함.

사용자 유형

외부: 구글 계정이 있는 모든 사용자 대상

내부: 구글 클라우드 조직과 연결된 프로젝트에서 내부 사용자 구성.

✅ 1.3. 민감한 범위 API 사용 + 사용자 유형이 외부인 경우

Oauth 동의 화면에서 아래 화면(안전하지 않은 앱으로 이동)을 띄우지 않기 위해서는

구글 인증이 필요함.

📌 2. 구글 인증 받기

✅ 2.1. Google Cloud 콘솔에 접속

https://console.cloud.google.com/auth/

✅ 2.2. Oauth 동의 화면으로 이동 (APIs & Services > Oauth Consent screen)

✅ 2.3. 설정해야 할 것 목록

구글 인증 요청을 위한 메뉴는 Verification Center이지만 아래 설정 전에는 제출버튼이 활성화 되어있지 않다. (버튼 아예 안 나타남) 만약 버튼이 보인다면 이미 설정을 완료한 것으로 바로 클릭해서 진행하면 된다.

설정 미리보기

Brading > 홈 URL, Privacy URL, Terms URL
Brading > 앱 로고
Brading, 소유권 확인 페이지 > 승인된 도메인 (도메인 소유권 인증 포함)
Data Access > OAuth 범위 설명
Audience > publishing status, User type
Verification Center > 제출 버튼 => 위 항목 완료 시 활성화

✅ 2.4. Brading에서 App 정보를 입력.

App Name, 관리자 email, App logo 이미지 등록

🔹 2.4.1. Application home page

설명: 사용자가 앱에 대해 더 알아볼 수 있는 첫 페이지 URL
예시 입력값: https://dddzr.co.kr/calendar/

🔹 2.4.2. Application privacy policy link (개인정보처리방침)

설명: 개인정보를 어떻게 수집·사용·보관하는지 설명한 문서 링크
필수 조건: 공개 접근 가능한 웹 페이지여야 하고 HTTPS여야 함
별도 HTML로 간단히 만들어서 등록
예시 입력값: https://dddzr.co.kr/privacy.html

<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8">
  <title>개인정보처리방침</title>
</head>
<body>
  <h1>개인정보처리방침</h1>
  <p>본 애플리케이션은 Google OAuth를 이용하여 사용자 인증 및 Google Calendar 접근 기능을 제공합니다.</p>

  <h2>1. 수집하는 개인정보 항목</h2>
  <ul>
    <li>Google 계정 이메일 주소</li>
    <li>사용자 이름 및 프로필 사진 (선택적)</li>
    <li>Google Calendar 일정 정보 (사용자가 승인한 범위 내)</li>
  </ul>

  <h2>2. 개인정보의 이용 목적</h2>
  <p>수집한 정보는 다음의 목적을 위해 사용됩니다:</p>
  <ul>
    <li>사용자 인증 및 로그인 유지</li>
    <li>사용자의 Google Calendar 일정 조회 및 표시</li>
  </ul>

  <h2>3. 개인정보 보관 및 파기</h2>
  <p>이 애플리케이션은 사용자 정보를 별도로 저장하지 않으며, Google API를 통해 실시간으로 필요한 정보만 사용합니다.</p>

  <h2>4. 제3자 제공</h2>
  <p>수집된 개인정보는 제3자에게 제공되지 않습니다.</p>

  <h2>5. 사용자 권리</h2>
  <p>사용자는 Google 계정의 권한 관리 페이지를 통해 언제든지 접근 권한을 해제할 수 있습니다.</p>

  <h2>6. 문의</h2>
  <p>앱 운영자 이메일: contact@dddzr.co.kr</p>
</body>
</html>

🔹 2.4.3. Application terms of service link (서비스 약관)

설명: 사용자가 앱을 사용할 때 동의해야 하는 이용 약관 링크
예시 입력값: https://dddzr.co.kr/terms.html

<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8">
  <title>서비스 이용약관</title>
</head>
<body>
  <h1>서비스 이용약관</h1>
  
  <h2>1. 목적</h2>
  <p>본 약관은 사용자가 본 애플리케이션(이하 "서비스")을 이용함에 있어 필요한 조건 및 절차를 규정합니다.</p>
  
  <h2>2. 서비스 내용</h2>
  <p>서비스는 Google OAuth를 통해 인증된 사용자의 Google Calendar 일정을 읽고 표시하는 기능을 제공합니다.</p>
 
 <h2>3. 사용자의 의무</h2>
  <ul>
    <li>사용자는 본인의 Google 계정을 안전하게 관리할 책임이 있습니다.</li>
    <li>허가되지 않은 방법으로 서비스를 사용해서는 안 됩니다.</li>
  </ul>

  <h2>4. 책임의 제한</h2>
  <p>본 서비스는 Google API에 의존하며, Google 서비스 오류에 대해 책임지지 않습니다.</p>

  <h2>5. 약관 변경</h2>
  <p>운영자는 사전 고지 없이 약관을 변경할 수 있으며, 변경된 내용은 본 페이지에 게시됩니다.</p>

  <h2>6. 문의</h2>
  <p>앱 운영자 이메일: contact@dddzr.co.kr</p>
</body>
</html>

🔹 2.4.4. Authorized domain (승인된 도메인)

목표: 앱이 사용하는 실제 도메인을 Google에 등록해서 신뢰성을 확보하는 것
예시 입력 값:dddzr.co.kr
*서브도메인이 아닌 메인도메인을 넣어야한다고 한다.
*포트번호 (:1443)는 제외하고 도메인만 입력해야 함.
*등록한 도메인은 소유권 인증을 받아야한다.

⭐서브도메인 확인 기준

도메인 구성 구조: [호스트명].[서브도메인].[기본 도메인].[최상위 도메인]

예: calendar.dddzr.co.kr

co.kr → 최상위 도메인 (TLD)
dddzr→ 등록된 기본 도메인 (2차 도메인)
calendar→ 서브도메인 (3차 도메인)

⭐구글 도메인 소유 인증

1. Google Search Console에 접속하여 구글계정으로 로그인한다.

https://search.google.com/search-console/welcome

2. Domain을 입력하고 Continue 클릭

3. TXT 레코드를 복사하여 DNS서버에 추가한다.

도메인 DNS 관리 사이트에서 dddzr.co.kr 도메인에 아래와 같이 DNS TXT 레코드를 추가

호스트(Name): @
타입(Type): TXT
값(Value): google-site-verification={복사한 레코드}

4. 완료 후 인증 확인 버튼(VERIFY) 클릭.

*txt코드는 인증 전 화면을 닫았다가 시도해도 고정된다.

✅ 2.4. Data Access (scope 설정)

사용하는 api 선택, 사용 이유, 데모 비디오

🔹 2.4.1. Add or remove scope 버튼을 클릭하여 사용 api 선택.

*나는 calendar만 사용하려 했지만 앱 파일 확인하니 profile, email이 자동으로 추가 되어있었다.

scope: profile, email, https://www.googleapis.com/auth/calendar

Google OAuth 2.0에서는 openid 없이 email과 profile을 요청하면,

보통 기본 로그인 + 사용자 식별용으로 자동 포함(Spring Security OAuth2, Google API Client, passport.js 등 라이브러리에서 기본값처럼 포함)되는 경우가 많다고 한다.

🔹 How will the scops be used와 demo vedio

*Missing the following fields for one or more requested scopes: scope justification, demo video.

How will the scops be used와 demo vedio 같은 경우에는 처음에 입력칸이 보이지 않다가 아래 과정 전부 진행 후 인증 요청하려고 할 때 작성하라고 나와서 다시 돌아와서 작성했다.

🔹 사용이유 ( How will the scops be used )

내용은 챗지피티의 도움을 받아 작성했다.

Our application integrates with Google Calendar as part of a groupware system to allow users to synchronize and manage their personal schedules. Currently, we use the Calendar API to retrieve (read) and create events on behalf of the user. In the future, we plan to add update and delete functionality to provide full calendar management capabilities. Calendar data is accessed only with the user’s consent, and is used solely within the scheduling module for enhancing productivity and ensuring consistency across systems.

저희 애플리케이션은 사용자가 개인 일정을 동기화하고 관리할 수 있도록 그룹웨어 시스템의 일부로 Google 캘린더와 통합되어 있습니다. 현재는 캘린더 API를 사용하여 사용자를 대신하여 이벤트를 검색(읽기)하고 생성하고 있습니다. 앞으로는 업데이트 및 삭제 기능을 추가하여 전체 캘린더 관리 기능을 제공할 계획입니다. 캘린더 데이터는 사용자의 동의가 있어야만 액세스할 수 있으며, 생산성 향상과 시스템 간 일관성을 보장하기 위해 스케줄링 모듈 내에서만 사용됩니다.

🔹 Demo video

유튜브에 Private로 영상 업로드 후 링크 입력.

✅ 2.5. Audience (대상)

🔹 Testing -> Publish

🔹 User Type -> External

대상을 외부로 바꾸면 인증이 필요하다는 알림이 뜬다.

✅ 2.6. 인증 요청

🔹 Prepare for verification 버튼 클릭 시 앞서 했던 설정들을 점검하고, 가장아래 추가정보 입력하는 칸이 나온다.

🔹 Additional info: Google이 앱을 검토할 때 참고할 부가 정보, 테스트 방법, 관련 프로젝트 ID 등을 적는 곳

빈칸으로 두어도 괜찮지만 쓰면 승인이 수월해진다고 한다.

*나는 테스트 계정을 여기 썼어야하는 것 같은데 그냥 넘어가 버려서 시스템에 로그인 부분을 임시로 처리하게 해서 배포해뒀다!!

Our system requires login prior to accessing most features.

However, to assist with the verification process, we have temporarily enabled a test bypass login page at the following URL: https://dddzrr.co.kr/calendar/loginfortest.do

Google Sign-In and Calendar integration can be accessed via the "Google Calendar" checkbox on the left-hand side of the main calendar interface.

우리 시스템은 기본적으로 로그인이 필요한 구조이지만,

구글 OAuth 검토팀이 테스트할 수 있도록

URL: https://dddzrr.co.kr/calendar/loginfortest.do

에서 로그인 없이 접근 가능하도록 설정했습니다.

실제 구글 로그인 및 캘린더 연동은 좌측 메뉴의 "Google 일정" 체크박스를 통해 이루어집니다.

🔹 마지막 질문지 체크

✅ 질문 항목별 해설

🔹 1. Is your application for personal use only?

"앱이 나 혼자 쓰거나, 지인 100명 이하에게만 쓸 거냐?"

외부 공개하려는 앱이면 반드시 No 선택

Yes → 앱을 나 또는 내가 아는 소수만 쓰고, 공개할 계획 없음 → “테스트 상태(Testing)” 유지하면 검토 없이 사용 가능
No → 앱을 더 넓은 사용자(외부 공개 포함)에게 쓸 계획 있음 → 검토 대상

🔹 2. Is your application for Internal use only?

"이 앱이 우리 회사/학교 같은 조직 내부 사용자 전용이냐?"

회사 내부에서만 사용한다면 Yes, 그 외에는 반드시 No

Yes → google workspace 같은 도메인 계정 사용자만 쓰는 조직 내 앱
No → Gmail 등 일반 사용자 대상, 외부 사용자 포함

🔹 3. Is your application for Development/Testing/Staging use only?

"이 앱이 아직 개발 중이고, 완성 전 테스트만 하고 있냐?"

검토를 받을 생각이면 반드시 No

Yes → 검토 신청하지 말고 “테스트 상태”로 놔둬
No → 실제 사용자 대상 운영용 앱이라서 검토받고 공개하고 싶음

🔹 4. Is your application a Gmail SMTP Plugin only for use by WordPress Site Admin(s)?

"이 앱이 워드프레스 SMTP용 Gmail 로그인 플러그인이냐?"

나는 해당 없음 → 무조건 No

🔹 5. I acknowledge that I have read through the verification requirements...

검토 요건을 다 읽었고, 내 앱이 요건에 맞는다고 인정함

🔹 6. I understand that if I am requesting restricted scopes... CASA가 필요하다

제한된 범위(scope)를 요청하면 Cloud App Security Assessment(CASA) 라는 보안 심사를 받아야 한다는 걸 이해함

캘린더 scope는 Restricted가 아니라 Sensitive니까 이 항목은 단순 동의만 하면 됨. (별도 CASA 제출은 필요 없음)

🚀 요약

질문	선택
Is your application for personal use only?	❌ No
Is your application for internal use only?	❌ No
Is your application for development/testing only?	❌ No
Is your application a Gmail SMTP plugin...?	❌ No
두 동의 항목	✅ 모두 체크

✅ 2.7. 인증 실패시 재요청

승인 실패 시 재검토 요청하려면 audience에서 publishing status를 testing으로 변경했다가 다시 publish 한다.

한번에 통과되지 않아서 보니

🔹 1. Privat policy링크를 절대경로로 입력해야 하는 것 같다.

<a href="https://dddzr.co.kr/privacy.html">개인정보처리방침</a> |

</footer>

🔹 2. 앱 기능 확인을 위한 임시 로그인 처리 (접속 시 테스트유저로 로그인처리함)

'Backend > API' 카테고리의 다른 글

ICal을 이용한 외부 캘린더 연동 (0)	2025.07.26
[Google API] 구글 캘린더 연동 (0)	2025.07.26

현재글[Google API] 구글 앱 인증 받기

메모장