처음 한 번, 내 구글 프로젝트 만들기
개인정보 보안관은 내가 만든 로그인 열쇠로 구글에 로그인합니다. 그래서 파일과 로그인 정보가 내 컴퓨터 ↔ 구글 사이에서만 오가고, 개발자를 포함한 누구에게도 전달되지 않습니다.
학교에서 관리자가 만든 클라이언트를 받았다면 이 안내는 건너뛰고 받은 값을 바로 넣으세요.
데스크톱 앱과 크롬 확장 프로그램을 둘 다 쓰면 같은 프로젝트 하나에 열쇠를 두 개(5-A, 5-B) 만들면 됩니다.
-
프로젝트 만들기
구글 콘솔에서 열기 ↗- 앱에서 쓸 구글 계정으로 로그인 (처음이면 약관 동의)
- 프로젝트 이름:
보안관-개인용(아무 이름이나 괜찮음) → 만들기 - 화면 위쪽에 방금 만든 프로젝트가 선택됐는지 확인
"프로젝트 한도에 도달했습니다"가 나오면 → 있는 프로젝트 쓰기를 보세요.
-
Google Drive API 켜기
구글 콘솔에서 열기 ↗- 사용(Enable) 버튼 누르기
-
앱 정보 입력
Google 인증 플랫폼브랜딩
구글 콘솔에서 열기 ↗- "구성되지 않음"이 보이면 시작하기
- 앱 이름:
개인정보 보안관 (개인용) - 사용자 지원 이메일 · 개발자 연락처: 내 이메일
- 사용자 유형(대상): 외부 → 동의 → 만들기
-
나를 테스트 사용자로 추가
Google 인증 플랫폼대상테스트 사용자
구글 콘솔에서 열기 ↗- + 사용자 추가 → 로그인할 내 이메일 → 저장
- 게시 상태가 이미 「프로덕션 단계」면 이 단계는 건너뛰세요. (「테스트로 돌아가기」는 누르지 않기)
이걸 빠뜨리면 로그인할 때 "액세스 차단됨 · 403 access_denied"가 나옵니다.
-
로그인 열쇠(클라이언트) 만들기
Google 인증 플랫폼클라이언트+ 클라이언트 만들기
구글 콘솔에서 열기 ↗5-A데스크톱 앱용
- 애플리케이션 유형: 데스크톱 앱
- 이름:
보안관-데스크톱→ 만들기 - JSON 다운로드 →
client_secret_….json저장 - 앱 첫 화면 → 개인 설정 → JSON 파일 선택…
- 원본 파일을 휴지통으로 이동 → 휴지통도 비우기
5-B크롬 확장 프로그램용
- 애플리케이션 유형: 웹 애플리케이션
- 이름:
보안관-확장 - 승인된 리디렉션 URI → + URI 추가 → 아래 주소 붙여 넣기
https://gjlomabldjleleakkeffjojhjdgeekgj.chromiumapp.org/ - 만들기 → 클라이언트 ID만 복사 (보안 비밀번호는 필요 없음)
- 확장 프로그램 패널 → ⚙ 설정 → 클라이언트 ID 붙여 넣고 저장
목록에 「Web client (auto created by Google Service)」가 이미 있으면 Firebase가 만든 것입니다. 건드리지 말고 새로 만드세요.
열쇠(JSON 파일·클라이언트 ID)는 남에게 보내거나 공유 드라이브에 올리지 마세요.
-
로그인
- 앱(또는 확장 프로그램)에서 로그인 → 계정 선택
- "Google에서 확인하지 않은 앱" → 고급 → (앱 이름)(으)로 이동 또는 계속
내가 직접 만든 앱이라 구글 공개 심사를 받지 않아서 나오는 화면입니다. 정상입니다. - 권한 화면에서 모든 항목 체크 → 계속
-
(선택) 7일마다 다시 로그인하지 않게
Google 인증 플랫폼대상앱 게시
- 테스트 상태에서는 구글 정책상 로그인이 7일 뒤 풀립니다.
- 앱 게시 → 확인하면 "프로덕션"이 되어 풀리지 않습니다. 나만 쓰는 열쇠라 인원 한도(100명)는 상관없습니다.
새 프로젝트를 못 만들 때: 있는 프로젝트 쓰기
Firebase로 앱을 만든 적이 있다면 그 프로젝트들이 모두 여기 들어 있어 한도가 찼을 수 있습니다. 안 쓰는 프로젝트 하나를 골라 2단계부터 하면 됩니다. 기존 앱과 데이터는 바뀌지 않습니다.
그 프로젝트 고르기
구글 콘솔 화면 맨 위 왼쪽 프로젝트 이름을 눌러 그 프로젝트로 바꿉니다. 모든 단계에서 이 이름이 맞는지 확인하세요.
2단계부터 진행
이미 채워진 화면은 그대로 두고 넘어가면 됩니다. 최근에 누가 쓰는 프로젝트는 고르지 마세요.
로그인 화면에 다른 앱 이름이 나올 때: 열쇠 바꾸기
예전에 다른 열쇠를 넣었던 컴퓨터는 그 열쇠가 남아 있어 "액세스 차단됨"이 나옵니다. 새 열쇠로 바꾸세요. 드라이브 파일·암호화 파일·복구 키는 그대로입니다.
- 오른쪽 위 🔁 계정·열쇠 바꾸기 → 바꾸기
(로그인 화면에서는 「다른 열쇠로 바꾸기」 · v0.2.0은 파일 → 설정 → 클라이언트 교체/삭제) - 설정 마법사가 열리면 개인 설정 → 새 JSON 파일 선택…
- 구글 로그인
- 계정 줄의 열쇠: (프로젝트 이름)이 새 프로젝트인지 확인
- 패널 ⚙ 설정 → 클라이언트 ID 칸을 지우고 새 ID 붙여 넣기 → 저장
- 계정 메뉴 → 로그아웃
- 다시 로그인
로그인 화면에 내가 정한 앱 이름이 나오면 성공입니다.
막히면
| 화면에 보이는 문구 | 해결 |
|---|---|
| 액세스 차단됨 · 403 access_denied | 로그인 화면의 앱 이름이 내 것이 아니면 → 열쇠 바꾸기. 내 것이면 → 4단계 테스트 사용자 추가 |
| 프로젝트 한도에 도달했습니다 | 있는 프로젝트 쓰기 |
| Google Drive API가 사용 설정되지 않음 | 2단계 후 1~2분 기다렸다 다시 로그인 |
| redirect_uri_mismatch (확장 프로그램) | 5-B의 리디렉션 주소를 끝의 /까지 그대로 붙여 넣었는지 확인 |
| '웹 애플리케이션' 유형의 클라이언트 (데스크톱 앱) | 5-A를 데스크톱 앱 유형으로 다시 만들기 |
| invalid_client | 열쇠를 지웠거나 잘못 복사함 → 5단계 다시 |
| 프로젝트를 만들 권한 없음 · admin_policy_enforced | 학교 계정 정책 때문입니다. 학교 관리자에게 조직 내부용 클라이언트를 요청하세요. |
로그인 권한을 직접 끊으려면 구글 계정 → 연결된 앱에서 앱을 고르고 액세스 권한 삭제.