본문으로 건너뛰기
Localtonet Localtonet 대시보드

GitHub 통합 인증(SSO)

잔액 필요 HTTP 터널

이 페이지 도움받기
이 페이지의 내용 섹션 4개
  1. 시작하기 전에
  2. 단계
  3. GitHub에 OAuth 앱 등록하기
  4. Localtonet에 제공자 추가하기
  5. 터널에서 켜기
  6. 테스트하기
  7. 문제 해결
  8. 관련 페이지

방문자가 HTTP 터널을 열기 전에 GitHub 계정으로 로그인하도록 합니다. GitHub에 OAuth 앱을 등록하고, Localtonet에 제공자로 추가한 다음, 터널에서 켜면 됩니다.

시작하기 전에 #

  • HTTP 터널과 계정의 잔액이 필요합니다. 통합 인증(SSO) 개요를 참고하세요.
  • GitHub 계정이 필요합니다. 조직용으로 앱을 등록하려면 해당 조직의 설정에 접근할 수 있어야 합니다.

단계 #

  1. GitHub에 OAuth 앱 등록하기 #

    GitHub의 공식 가이드는 Creating an OAuth app입니다. 요약하면 다음과 같습니다.

    1. GitHub에서 프로필 사진 아래의 메뉴를 열고 Settings, Developer settings, OAuth apps를 차례로 선택합니다.
    2. New OAuth App을 선택합니다. 아직 앱이 없다면 버튼이 Register a new application으로 표시됩니다.
    3. 아래 값으로 양식을 작성하고 Register application을 선택합니다.
    4. 새 앱의 페이지에서 Client ID를 복사한 다음 Generate a new client secret을 선택하고 시크릿을 바로 복사합니다.
    GitHub 필드값
    Application name방문자가 알아볼 수 있는 이름. GitHub가 방문자에게 승인을 요청할 때 이 이름을 표시합니다.
    Homepage URL앱을 설명하는 웹 주소(예: 내 웹사이트).
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device Flow끈 상태로 둡니다.

    GitHub에서는 스코프를 선택하지 않습니다. 로그인 요청이 스코프를 지정하며, read:user와 user:email입니다. GitHub는 방문자가 처음 로그인할 때 이를 승인하도록 요청합니다.

  2. Localtonet에 제공자 추가하기 #

    내 터널 › HTTP를 열고 페이지 상단에서 SSO를 선택합니다. SSO 제공자 대화상자에서 제공자 추가를 선택합니다.

    필드값
    제공자 이름원하는 이름(예: GitHub). 터널 설정에 표시됩니다.
    제공자 유형GitHub. 저장된 제공자의 유형을 바꾸면 클라이언트 ID가 비워지므로 클라이언트 ID와 클라이언트 시크릿을 다시 입력하세요.
    활성켜짐
    클라이언트 IDGitHub의 클라이언트 ID.
    클라이언트 시크릿GitHub의 클라이언트 시크릿. 저장한 뒤에는 표시되지 않습니다.

    엔드포인트 & 콜백에는 표준 GitHub 주소가 자동으로 채워집니다. 그대로 두세요.

    필드자동으로 채워지는 값
    인증 엔드포인트https://github.com/login/oauth/authorize
    토큰 엔드포인트https://github.com/login/oauth/access_token
    사용자 정보 엔드포인트https://api.github.com/user
    콜백 경로/auth/callback/github

    원하면 이메일 접근 규칙을 입력한 다음 제공자 저장을 선택합니다.

  3. 터널에서 켜기 #

    내 터널에서 터널의 설정을 선택하고, SSO 제공자 옆의 관리를 선택합니다. 싱글 사인온(SSO) 대화상자에서 로그인 필수와 GitHub 제공자의 스위치를 켜고 저장을 선택합니다.

    누구나 GitHub 계정을 만들 수 있습니다. 규칙이 없으면 주소를 아는 모든 GitHub 사용자가 터널을 열 수 있습니다. 터널의 로그인할 수 있는 사용자나 제공자의 허용된 이메일 도메인을 입력하세요. 목록은 개요에서 설명합니다.

  4. 테스트하기 #

    시크릿 브라우저 창에서 터널 URL을 엽니다. Localtonet이 제공자 버튼과 함께 Sign in to continue를 표시합니다. GitHub는 처음에 앱을 승인하라고 요청합니다. 그 뒤에는 터널로 돌아오고 서비스가 로드됩니다.

문제 해결 #

GitHub가 리디렉션 URI 불일치를 보고합니다

GitHub의 오류는 redirect_uri_mismatch이며 "The redirect_uri MUST match the registered callback URL for this application."라고 표시됩니다. OAuth 앱의 어떤 콜백 URL도 전송된 주소와 일치하지 않습니다. GitHub의 Authorization callback URL을 정확히 http://auth.localtonet.com/auth/callback으로 설정하세요.

주소가 목록에 있는데도 방문자가 거부됩니다

GitHub 사용자가 프로필에 공개 이메일을 설정하지 않았다면 기본 사용자 정보 엔드포인트 https://api.github.com/user가 이메일 주소를 반환하지 않을 수 있습니다. 방문자에게 GitHub 프로필에서 공개 이메일로 설정된 주소를 확인하도록 안내하고, 그 주소를 목록과 비교하세요.

GitHub 로그인에 성공한 뒤 “403 - Access Denied”가 표시됩니다

Localtonet 규칙이 해당 계정을 거부했습니다. 제공자의 이메일 접근 규칙과 터널의 로그인할 수 있는 사용자를 확인하세요. 규칙을 수정한 뒤에는 1분 정도 기다렸다가 새로고침하세요.

GitHub 승인 페이지 전후에 로그인이 실패합니다

Localtonet에 저장된 클라이언트 ID와 클라이언트 시크릿을 OAuth 앱과 비교해 확인하세요. 클라이언트 ID를 다시 붙여 넣고, GitHub에서 새 클라이언트 시크릿을 만들어 제공자에 붙여 넣은 다음 제공자 저장을 선택하세요.

로그인 페이지에 GitHub 버튼이 없습니다

이 터널에서 제공자가 켜져 있지 않거나 비활성으로 설정되어 있습니다. 두 가지를 모두 확인하세요.

이 페이지에 도움이 필요하신가요? 커뮤니티에 질문하거나 지원 티켓을 만들어 주세요.

지원