Google로 싱글 사인온 사용하기
잔액 필요 HTTP 터널
이 페이지의 내용 섹션 4개
방문자가 HTTP 터널을 열기 전에 Google 계정으로 로그인하도록 합니다. Google Cloud에서 OAuth 클라이언트를 만들고, 이를 Localtonet에 제공자로 추가한 다음, 터널에서 켭니다.
시작하기 전에 #
- HTTP 터널과 계정의 잔액이 필요합니다. 싱글 사인온 개요를 참고하세요.
- Google Cloud 콘솔에 접근할 수 있는 Google 계정과 그 안의 프로젝트.
단계 #
-
Google Cloud에서 OAuth 클라이언트 만들기 #
Google은 콘솔을 수시로 변경합니다. Google의 공식 안내는 Manage OAuth Clients입니다. 요약하면 다음과 같습니다.
- Google Cloud 콘솔에서 프로젝트의 Google Auth Platform을 엽니다. 새 프로젝트라면 콘솔이 먼저 앱을 설정하라고 안내합니다. 앱 이름, 지원 이메일, 대상(audience), 연락처 정보를 입력합니다.
- Audience에서 로그인할 수 있는 사용자를 선택합니다. 아래 표를 참고하세요.
- Clients를 열고 Create client를 선택합니다.
- Application type을 Web application으로 설정하고 클라이언트 이름을 지정합니다.
- Authorized redirect URIs에 아래의 리디렉션 URI를 추가합니다. Authorized JavaScript origins는 비워 두어도 됩니다.
- Create를 선택한 다음 Client ID와 Client secret을 복사합니다. Google은 전체 시크릿을 이 시점에만 보여 줍니다.
승인된 리디렉션 URIhttp://auth.localtonet.com/auth/callbackGoogle의 Audience 로그인할 수 있는 사용자 Internal Google Cloud 조직의 구성원만 해당됩니다. External, 게시 상태 Testing Google에 등록한 테스트 사용자이며 최대 100명입니다. 사용자의 이름, 이메일 주소, 프로필만 요청하는 앱은 예외여서 이 경우 사용자가 목록에 없어도 됩니다. 사람들의 접근을 막기 위해 테스트 사용자 목록에 의존하지 말고 Localtonet의 접근 규칙을 사용하세요. External, 게시 상태 In production Google 계정이 있는 모든 사람. 범위를 좁히려면 Localtonet의 접근 규칙을 사용하세요. 로그인 요청은
openid,email,profile범위를 사용합니다. Google이 앱의 범위를 선택하라고 하면 이 세 가지로 충분합니다.Google에 따르면 클라이언트 변경 사항이 적용되기까지 5분에서 몇 시간이 걸릴 수 있습니다.
-
Localtonet에 제공자 추가 #
내 터널 › HTTP를 열고 페이지 상단의 SSO를 선택합니다. SSO 제공자 대화상자에서 제공자 추가를 선택합니다.
필드 값 제공자 이름 원하는 이름을 쓰세요. 예: Company Google. 터널 설정에 표시됩니다.제공자 유형 Google. 저장된 제공자의 유형을 바꾸면 클라이언트 ID가 비워지므로 클라이언트 ID와 클라이언트 시크릿을 다시 입력하세요. 활성 켜짐 클라이언트 ID Google에서 받은 클라이언트 ID. 클라이언트 시크릿 Google에서 받은 클라이언트 시크릿. 저장한 후에는 표시되지 않습니다. 엔드포인트 & 콜백 아래에는 표준 Google 주소가 자동으로 채워집니다. 그대로 두세요.
필드 자동으로 채워지는 값 인증 엔드포인트 https://accounts.google.com/o/oauth2/v2/auth토큰 엔드포인트 https://oauth2.googleapis.com/token사용자 정보 엔드포인트 https://openidconnect.googleapis.com/v1/userinfo콜백 경로 /auth/callback/google필요하면 이메일 접근 규칙을 입력하세요. 회사 구성원만 허용하려면 허용된 이메일 도메인에 회사 도메인(예:
example.com)을 입력합니다. 제공자 저장을 선택합니다. -
터널에서 켜기 #
내 터널에서 터널의 설정을 선택한 다음 SSO 제공자 옆의 관리를 선택합니다. 싱글 사인온(SSO) 대화상자에서 로그인 필수와 Google 제공자의 스위치를 켭니다. 저장을 선택합니다.
로그인할 수 있는 사용자 아래의 목록과 로그인 경로는 선택 사항입니다. 개요에서 설명합니다.
-
테스트하기 #
비공개 브라우저 창에서 터널 URL을 엽니다. Localtonet이 제공자 버튼과 함께 Sign in to continue를 표시합니다. Google에서 로그인하면 터널로 돌아가 서비스가 로드됩니다.
문제 해결 #
Google이 redirect_uri_mismatch를 보고합니다
요청의 리디렉션 URI가 클라이언트의 Authorized redirect URIs 중 하나가 아닙니다. Google의 클라이언트에 http://auth.localtonet.com/auth/callback을 정확히 추가하고 변경 사항이 적용될 때까지 시간을 두세요.
Google 콘솔이 리디렉션 URI를 받아들이지 않습니다
Google은 리디렉션 URI를 유효성 검사 규칙에 따라 확인합니다. 필드 옆의 메시지에 실패한 규칙이 표시됩니다.
Google이 org_internal 같은 오류로 계정을 거부합니다
Localtonet이 확인하기 전에 Google이 계정을 거부했습니다. Audience가 Internal이면 조직 구성원만 로그인할 수 있고, 그 외의 모든 사람에게 Google은 org_internal을 보고합니다. External의 Testing이라면 Google에서 테스트 사용자 목록을 확인하세요.
Google이 invalid_client를 보고합니다
Google이 클라이언트를 받아들이지 않습니다. Localtonet에 저장된 클라이언트 ID와 클라이언트 시크릿을 확인하고, Google에 클라이언트가 아직 있는지 확인하세요. 두 값을 다시 붙여 넣고 제공자 저장을 선택하세요. 시크릿이 더 이상 없다면 Google에서 새로 만드세요.
Google 로그인에 성공한 뒤 "403 - Access Denied"가 표시됩니다
Localtonet 규칙이 계정을 거부했습니다. 방문자가 로그인한 주소를 제공자의 허용된 이메일 도메인, 차단된 이메일 도메인, 차단된 이메일 주소, 그리고 터널의 로그인할 수 있는 사용자와 비교해 보세요.
로그인 페이지에 Google 버튼이 없습니다
이 터널에서 제공자가 켜져 있지 않거나 비활성으로 설정되어 있습니다. 두 가지를 모두 확인하세요.