OAuth 클라이언트 만들기

허브에 구글 계정을 붙이면 어느 OAuth 클라이언트로 로그인시킬지 물어봅니다. 그 선택지의 실체인 OAuth 클라이언트 ID와 OAuth 클라이언트 시크릿은 구글에서 받아와야 하는데, 이 페이지가 그 방법입니다. 클라이언트는 허브가 계정을 로그인시킬 때 쓰는 열쇠이고, Claude가 아닙니다. 말이 서로 섞여 헷갈리신다면 계정과 클라이언트에서 갈라두었습니다.

​

이것이 무엇이고 왜 필요한가

허브가 고객님의 Gmail을 읽으려면 구글에 “이 사람 허락을 받았습니다”라고 증명해야 합니다. 그 증명서에 해당하는 것이 OAuth 클라이언트입니다. 이것을 저희가 대신 만들어 드릴 수는 없습니다. 구글이 자동으로 만드는 방법을 제공하지 않아서, 본인 계정으로 콘솔에 들어가 직접 만드셔야 합니다. 대신 만들어진 클라이언트는 본인 프로젝트 안에 있습니다. 저희는 그 값을 보지도 보관하지도 않습니다. 한 번 만들면 계속 씁니다. 계정을 여러 개 붙이셔도 클라이언트는 하나면 됩니다.

​

1. 동의 화면 만들기

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

​

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

이 단계를 건너뛰면 일주일에 한 번씩 계정 로그인이 풀립니다. 그때마다 허브에서 재연결을 눌러야 합니다. 지금 30초 쓰면 그 일이 없어집니다.

​

3. 클라이언트 만들기

이제 실제로 ID와 시크릿을 받는 단계입니다. 클라이언트는 허브가 돌고 있는 그 프로젝트에서 만드세요. 콘솔에는 프로젝트가 여러 개 있을 수 있는데, 클라이언트는 만들어진 프로젝트에서만 동작합니다. 다른 프로젝트에서 가져온 클라이언트를 쓰는 것이 계정은 붙었는데 아무것도 못 하는 가장 흔한 원인입니다. 프로젝트가 정말로 달라야 하는 경우는 Developer Preview에서 다루고, 실수로 그렇게 된 경우는 잘못된 OAuth 클라이언트로 계정을 붙였을 때를 보세요.

​

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

만든 클라이언트는 콘솔의 클라이언트 목록에 계속 남아 있습니다. 열어보면 클라이언트 ID를 다시 확인할 수 있고, 나중에 붙인 계정이 어느 클라이언트를 쓰는지도 여기서 대조할 수 있습니다. 시크릿 값 자체는 다시 보여주지 않습니다. 허브가 아니라 구글의 규칙입니다. 잃어버리셨다면 Add secret을 눌러 새 시크릿을 발급받고, 그 클라이언트를 쓰던 계정마다 새 값으로 바꿔 넣으시면 됩니다.

​

프로젝트는 몇 개 필요한가

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

​

다음

• 설치하기로 돌아가 계정을 붙이세요
• 문제 해결