메인 콘텐츠로 건너뛰기
허브에 구글 계정을 붙일 때 어느 OAuth 클라이언트로 로그인할지 고르게 됩니다. 이때 필요한 OAuth 클라이언트 ID와 OAuth 클라이언트 시크릿은 구글에서 받아 와야 하며, 이 페이지에서 그 방법을 안내합니다. 클라이언트는 허브가 계정을 로그인시킬 때 사용하는 열쇠이고, Claude를 가리키는 말이 아닙니다. 용어가 헷갈리신다면 계정과 클라이언트에서 구분해 두었습니다.
OAuth 클라이언트 ID와 시크릿 칸이 있는 계정 추가 화면
이 일은 한 번만 하시면 됩니다. 두 번째 계정부터는 허브가 이미 갖고 있는 클라이언트를 보여 주고 알맞은 것을 미리 골라 두므로, 따로 붙여넣으실 것이 없습니다. Google Cloud 프로젝트가 두 개 필요한 경우에만 이 페이지로 다시 오시면 되고, 그 내용은 이 페이지 아래쪽에 있습니다.

OAuth 클라이언트가 필요한 이유

허브가 고객님의 Gmail을 읽으려면 구글에 “이 사람 허락을 받았습니다”라고 증명해야 합니다. 그 증명서 역할을 하는 것이 OAuth 클라이언트입니다. 구글이 OAuth 클라이언트를 자동으로 만드는 방법을 제공하지 않아서, 본인 계정으로 콘솔에 들어가 직접 만드셔야 합니다. 만든 클라이언트는 본인 프로젝트 안에만 있고, 그 값은 본인 허브만 사용합니다. 한 번 만드시면 계속 사용하실 수 있습니다. 계정을 여러 개 붙이셔도 클라이언트는 하나면 됩니다.
10분쯤 걸립니다. 설치 페이지의 OAuth 클라이언트 만들기 카드에 단계마다 콘솔로 가는 버튼이 있으니, 그 버튼을 누르시면 콘솔에서 헤매지 않고 바로 해당 화면으로 가실 수 있습니다.

1. 동의 화면 만들기

동의 화면은 계정을 붙일 때 구글이 보여주는 “이 앱이 이런 권한을 요청합니다” 화면입니다. 동의 화면이 있어야 클라이언트를 만들 수 있습니다.
1

시작하기

설치 페이지에서 동의 화면 열기를 누르면 이 화면이 나옵니다. 시작하기를 누르세요.
아직 구성되지 않았다는 안내와 시작하기 버튼이 있는 Google 인증 플랫폼 개요 화면
2

앱 이름과 이메일

앱 이름은 알아보실 수 있는 이름이면 됩니다. 계정을 붙일 때 이 이름이 보입니다. 사용자 지원 이메일은 목록에서 본인 주소를 고르시면 됩니다.
앱 이름과 지원 이메일을 입력하는 프로젝트 구성의 첫 단계
3

외부 고르기

외부를 고르세요. 내부는 조직 안에서만 사용할 수 있는 설정이라, 개인 Gmail 계정을 붙이실 수 없게 됩니다.
내부와 외부 중 외부가 선택되고 그 설명이 강조된 대상 단계
“테스트 모드로 시작한다”는 설명이 있는데, 테스트 모드는 다음 단계에서 해제합니다.
4

연락처 이메일

본인 주소를 다시 넣습니다. 프로젝트에 변경 사항이 있을 때 구글이 연락하는 주소입니다.
연락처 이메일을 입력하는 연락처 정보 단계
5

동의하고 만들기

약관에 체크하고 만들기를 누릅니다.
네 단계가 모두 완료 표시되고 정책 동의 체크박스가 체크된 상태의 만들기 버튼
만들자마자 나오는 OAuth 개요 화면과 OAuth 구성 생성됨이라는 확인 토스트

2. 게시 상태를 프로덕션 단계로 올리기

이 단계를 건너뛰면 일주일에 한 번씩 계정 로그인이 풀립니다. 그때마다 허브에서 재연결을 누르셔야 합니다. 지금 30초만 들이시면 그럴 일이 없습니다.
1

앱 게시 누르기

왼쪽 메뉴의 대상으로 가면 게시 상태가 테스트 중으로 되어 있습니다. 이 상태 때문에 로그인이 7일마다 풀립니다. 앱 게시를 누르세요.
게시 상태가 테스트 중이고 앱 게시 버튼이 강조된 대상 화면
게시 대신 누락된 정보가 있다고 뜨면, 왼쪽 메뉴의 브랜딩으로 가세요. 앱 도메인과 애플리케이션 홈페이지, 개인정보처리방침, 서비스 약관 링크를 채워야 합니다. 이 앱은 본인 계정에서만 사용하므로 여기 입력한 내용을 구글이 따로 검사하지 않습니다. 설치 페이지의 OAuth 클라이언트 만들기 카드에 있는 브랜딩용 주소를 도메인 칸에는 그대로, 나머지 세 링크 칸에는 앞에 https://를 붙여서 입력하시면 됩니다. 저장하신 뒤 이 화면으로 돌아와 앱 게시를 다시 누르세요.
2

확인

“검증이 필요할 수 있다”는 안내가 뜹니다. 그대로 확인을 누르시면 됩니다. 검증을 받지 않아도 본인 계정으로는 정상 동작합니다.
프로덕션으로 푸시할지 묻고 확인 버튼이 있는 대화상자
3

바뀌었는지 확인

게시 상태가 프로덕션 단계로 바뀌었으면 됩니다.
게시 상태가 프로덕션 단계로 바뀌었고 이 상태가 성공이라는 안내가 있는 화면
게시해도 아무나 사용할 수 있는 것은 아닙니다. 계정을 붙일 수 있는 사람은 여전히 구글 로그인을 통과한 본인뿐입니다.

3. 클라이언트 만들기

이제 실제로 ID와 시크릿을 받는 단계입니다. 클라이언트는 허브가 실행 중인 프로젝트에서 만드세요. 콘솔에 프로젝트가 여러 개 있을 수 있는데, 클라이언트는 만든 프로젝트에서만 동작합니다. 계정은 붙었는데 아무것도 되지 않는다면, 다른 프로젝트의 클라이언트를 사용하신 경우가 가장 많습니다. 프로젝트를 일부러 나눠야 하는 경우는 Developer Preview에서 다루고, 실수로 그렇게 되었다면 잘못된 OAuth 클라이언트로 계정을 붙였을 때를 보세요.
1

클라이언트 만들기

왼쪽 메뉴의 클라이언트로 가서 클라이언트 만들기를 누릅니다.
아직 클라이언트가 없는 목록 화면과 클라이언트 만들기 버튼
2

애플리케이션 유형 고르기

애플리케이션 유형은 웹 애플리케이션으로 둡니다.
펼쳐진 애플리케이션 유형 드롭다운. 맨 위에 웹 애플리케이션이 강조되어 있다
3

이름 정하고 리디렉션 주소 추가하기

이름은 알아보실 수 있는 것이면 됩니다. 아래로 내려가 승인된 리디렉션 URI에서 URI 추가를 누르고, 설치 페이지가 알려준 주소를 붙여넣습니다. 그 주소는 설치 페이지의 OAuth 카드 3번 항목에 복사 버튼과 함께 있습니다.
클라이언트 만들기 화면의 이름 칸과 리디렉션 URI 칸. 옆에는 그 리디렉션 주소를 복사하는 설치 페이지의 OAuth 카드가 함께 있다
이 주소는 한 글자도 틀리면 안 됩니다. 직접 입력하지 마시고 반드시 복사 버튼을 사용하세요. 틀리면 계정을 붙일 때 구글이 주소가 맞지 않는다며 거부합니다.
4

AI 에이전트용으로 체크하고 만들기

만들기 바로 위의 Use this client for an AI-powered agent를 체크합니다. 체크해도 권한이 늘어나지는 않습니다.
이 칸은 반드시 체크하세요. 빠뜨리면 2026년 11월 11일부터 허브의 Gmail, 캘린더, 드라이브 도구가 막히고, 11월 12일부터는 이미 만든 클라이언트에 이 표시를 더할 수 없어 클라이언트를 새로 만들고 계정을 다시 연결하셔야 합니다. 자세한 내용은 OAuth 클라이언트를 AI 에이전트용으로 표시하기에 있습니다.
OAuth 클라이언트 ID 만들기 화면. Use this client for an AI-powered agent 체크박스와 만들기 버튼에 빨간 표시가 있다
다 하셨으면 만들기를 누릅니다.
5

지금 두 값 모두 복사하기

만들자마자 클라이언트 ID와 클라이언트 보안 비밀번호가 함께 뜹니다.
OAuth 클라이언트가 생성되었다는 대화상자. 클라이언트 ID와 클라이언트 보안 비밀번호가 각각 복사 버튼과 함께 나란히 보인다
창을 닫기 전에 두 값을 다 복사해 두세요. 시크릿은 이때 한 번만 보입니다. 복사하지 못하셨다면 아래를 보세요.
두 값을 허브의 계정 추가 화면에 붙여넣으시면 끝입니다.

클라이언트를 나중에 다시 찾을 때

만든 클라이언트는 콘솔의 클라이언트 목록에 계속 남아 있습니다.
방금 만든 클라이언트가 이름과 함께 보이는 클라이언트 목록
열어보면 클라이언트 ID를 다시 확인하실 수 있고, 나중에 붙인 계정이 어느 클라이언트를 사용하는지도 여기서 대조하실 수 있습니다.
클라이언트 ID가 보이는 클라이언트 상세 화면. 새 클라이언트 시크릿을 발급하는 Add secret 버튼도 있다
시크릿 값은 구글이 다시 보여 주지 않습니다. 잃어버리셨다면 Add secret을 눌러 새 시크릿을 발급받고, 그 클라이언트를 사용하던 계정마다 새 값으로 바꿔 넣으시면 됩니다.

프로젝트는 몇 개 필요한가

대부분 하나면 됩니다. 개인 Gmail과 업무용 Workspace 계정을 같이 붙이셔도 하나로 충분합니다. 프로젝트가 두 개 필요한 것은 Workspace 계정을 붙일 때뿐이고, 경우는 두 가지입니다. 하나는 조직이 미검증 앱을 차단해 둔 경우로, 그 계정은 동의 화면까지 가지도 못합니다. 다른 하나는 차단되어 있지 않더라도 조직 구성원에게 미검증 경고를 보이고 싶지 않은 경우입니다. 어느 쪽이든 Workspace 쪽은 그 조직이 소유한 프로젝트를 따로 두고 클라이언트를 하나 더 만듭니다. 이 설정이 왜 클라이언트가 아니라 프로젝트 단위인지는 Developer Preview에 적어 두었습니다. 이 경우 두 프로젝트 모두 Developer Preview 승인이 필요합니다. 설치 페이지의 연결할 Workspace 계정의 조직이 미검증 앱을 차단하나요? 카드에서 두 번째 프로젝트를 정하시면, 신청서에 넣을 두 프로젝트 번호를 한 줄로 정리해 줍니다.

다음