GitLab으로 싱글 사인온(SSO)
잔액 필요 HTTP 터널
이 페이지의 내용 섹션 4개
방문자가 HTTP 터널을 열기 전에 GitLab 계정으로 로그인하게 하세요. GitLab.com과 자체 관리형 GitLab 인스턴스 모두에서 작동합니다. GitLab에서 OAuth 애플리케이션을 만들고, Localtonet에 제공자로 추가한 다음, 터널에서 켜면 됩니다.
시작하기 전에 #
- HTTP 터널과 계정의 잔액이 필요합니다. 싱글 사인온(SSO) 개요를 참고하세요.
- GitLab.com 또는 자체 인스턴스의 GitLab 계정.
- 자체 관리형 인스턴스의 경우 주소가 인터넷에서 접근 가능해야 합니다. 방문자의 브라우저가 인스턴스의 로그인 페이지를 열고, Localtonet의 로그인 호스트가 인스턴스의 토큰 및 사용자 엔드포인트를 직접 호출합니다.
단계 #
-
GitLab에서 OAuth 애플리케이션 만들기 #
GitLab의 공식 가이드는 Configure GitLab as an OAuth 2.0 authentication identity provider입니다. 애플리케이션은 사용자, 그룹 또는 인스턴스 전체에 속할 수 있습니다.
소유자 만드는 위치 내 사용자 아바타를 선택한 다음 Edit profile, Access › Applications, Add new application을 차례로 선택하세요. 그룹 그룹을 연 다음 Settings › Applications를 엽니다. 인스턴스(자체 관리형, 관리자 전용) Admin › Applications 및 New application. 양식을 작성하고 Save application을 선택하세요.
GitLab 필드 값 Name 방문자가 알아볼 수 있는 이름입니다. GitLab이 방문자에게 승인을 요청할 때 이 이름을 표시합니다. Redirect URI http://auth.localtonet.com/auth/callbackConfidential 선택된 상태로 두세요. Scopes read_user그러면 GitLab이 Application ID와 Secret을 표시합니다. 둘 다 바로 복사하세요. GitLab은 애플리케이션을 만든 직후에만 시크릿을 보여 줍니다.
read_user스코프는/api/v4/user엔드포인트를 통해 로그인한 사용자의 프로필에 대한 읽기 권한을 제공하며, 이 엔드포인트가 Localtonet이 채워 넣는 사용자 정보 엔드포인트입니다. 로그인이 요청하는 스코프는 이것뿐이므로 애플리케이션에 다른 스코프는 필요 없습니다. -
Localtonet에 제공자 추가 #
내 터널 › HTTP를 열고 페이지 상단의 SSO를 선택하세요. SSO 제공자 대화 상자에서 제공자 추가를 선택합니다.
필드 값 제공자 이름 아무 이름이나 가능합니다. 예: Company GitLab. 터널 설정에 이 이름이 표시됩니다.제공자 유형 GitLab. 저장된 제공자의 유형을 바꾸면 클라이언트 ID가 비워지므로 클라이언트 ID와 클라이언트 시크릿을 다시 입력하세요. 활성 켜짐 클라이언트 ID GitLab의 Application ID. 클라이언트 시크릿 GitLab의 Secret. 저장한 뒤에는 표시되지 않습니다. 엔드포인트 & 콜백을 엽니다. GitLab.com의 주소는 자동으로 채워집니다. 자체 관리형 인스턴스라면 처음 세 필드의
gitlab.com을 인스턴스의 호스트 이름으로 바꾸세요.GitLab.com
필드 자동으로 채워지는 값 인증 엔드포인트 https://gitlab.com/oauth/authorize토큰 엔드포인트 https://gitlab.com/oauth/token사용자 정보 엔드포인트 https://gitlab.com/api/v4/user콜백 경로 /auth/callback/gitlab자체 관리형
필드 입력할 값 인증 엔드포인트 https://<YOUR_GITLAB_HOST>/oauth/authorize토큰 엔드포인트 https://<YOUR_GITLAB_HOST>/oauth/token사용자 정보 엔드포인트 https://<YOUR_GITLAB_HOST>/api/v4/user콜백 경로 /auth/callback/gitlab(변경 없음)GitLab 애플리케이션의 Redirect URI는 1단계의 Localtonet 주소 그대로 둡니다. 여기에는 GitLab 호스트가 포함되지 않습니다.
원하면 이메일 접근 규칙을 입력한 다음 제공자 저장을 선택하세요.
-
터널에서 켜기 #
내 터널 아래에서 터널의 설정을 선택한 다음 SSO 제공자 옆의 관리를 선택하세요. 싱글 사인온(SSO) 대화 상자에서 로그인 필수와 GitLab 제공자의 스위치를 켜고 저장을 선택합니다.
GitLab.com에서는 누구나 계정을 만들 수 있습니다. 규칙이 없으면 주소를 아는 모든 GitLab.com 사용자가 터널을 열 수 있습니다. 터널의 로그인할 수 있는 사용자 또는 제공자의 허용된 이메일 도메인을 입력하세요. 목록은 개요에서 설명합니다.
-
테스트하기 #
시크릿 브라우저 창에서 터널 URL을 여세요. Localtonet이 Sign in to continue와 제공자 버튼을 표시합니다. GitLab은 처음에 애플리케이션 승인을 요청합니다. 그 후에는 터널로 돌아가 서비스가 로드됩니다.
문제 해결 #
GitLab이 포함된 리디렉션 URI가 올바르지 않다고 표시합니다
GitLab 애플리케이션의 어떤 Redirect URI도 전송된 주소와 일치하지 않습니다. 애플리케이션의 Redirect URI에 http://auth.localtonet.com/auth/callback을 정확히 입력하세요.
GitLab이 요청한 스코프가 잘못되었거나 알 수 없거나 형식이 올바르지 않다고 표시합니다
요청된 스코프가 GitLab 애플리케이션에서 선택되어 있지 않습니다. 애플리케이션을 수정하고 read_user를 선택하세요.
GitLab이 클라이언트 인증에 실패했다고 표시합니다
Localtonet에 저장된 클라이언트 ID 또는 클라이언트 시크릿이 GitLab 애플리케이션과 일치하지 않습니다. Application ID와 Secret을 다시 붙여넣고 제공자 저장을 선택하세요. GitLab에서 시크릿을 갱신하면 새 시크릿을 Localtonet에 저장하기 전까지 애플리케이션이 작동하지 않습니다.
자체 관리형 인스턴스로 로그인이 끝나지 않습니다
세 엔드포인트에 오타가 없는지 확인하고, 인스턴스가 인터넷에서 응답하는지 확인하세요. HTTPS를 사용한다면 공개 클라이언트가 신뢰하는 인증서가 필요합니다. 네트워크 내부에서만 접근할 수 있는 인스턴스는 사용할 수 없습니다.
GitLab 로그인에 성공한 뒤 "403 - Access Denied"
Localtonet 규칙이 해당 계정을 거부했습니다. 제공자의 이메일 접근 규칙과 터널의 로그인할 수 있는 사용자를 확인하세요. 규칙을 고친 뒤 1분 기다렸다가 새로 고치세요.
로그인 페이지에 GitLab 버튼이 없습니다
제공자가 이 터널에서 켜져 있지 않거나 비활성으로 설정되어 있습니다. 둘 다 확인하세요.