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

HTTP 터널용 싱글 사인온

잔액 필요 HTTP 터널

이 페이지 도움받기
이 페이지의 내용 섹션 10개
  1. 사용하면 좋은 경우
  2. 작동 방식
  3. 시작하기 전에
  4. 제공자
  5. 설정하기
  6. 제공자 추가
  7. 터널에서 켜기
  8. 테스트하기
  9. 리디렉션 URI
  10. 접근 규칙
  11. 로그인 경로와 로그아웃 경로
  12. 문제 해결
  13. 자동화

싱글 사인온(SSO)은 HTTP 터널 앞에 로그인 페이지를 둡니다. 방문자는 요청이 서비스에 도달하기 전에 Google, GitHub, Microsoft, GitLab 같은 ID 제공자 중 선택한 곳으로 로그인하거나, 직접 정의한 사용자 이름과 비밀번호로 로그인합니다.

사용하면 좋은 경우 #

보호하지 않으면 HTTP 터널은 주소를 아는 누구에게나 열려 있습니다. 사람들이 브라우저로 터널을 열고, 그 사람이 누구인지 직접 정하고 싶을 때(관리자 패널, 대시보드, 내부 도구, 스테이징 사이트 등) SSO가 알맞은 보호 수단입니다. 서비스는 바뀌지 않으며 비밀번호를 볼 일도 없습니다.

SSO는 브라우저용입니다. 로그인 쿠키가 없는 요청은 로그인 페이지로 리디렉션되므로 스크립트, 웹훅, API 클라이언트는 통과할 수 없습니다. 이런 경우에는 일부 경로만 보호하거나(로그인 경로 참고) 접근 제어의 옵션을 사용하세요.

작동 방식 #

방문자가 터널 URL을 엽니다. Localtonet 서버는 방문자를 auth.localtonet.com의 로그인 페이지로 리디렉션하고, 방문자는 그곳에서 ID 제공자로 로그인합니다. 이후 방문자는 터널 URL로 돌아가며 요청은 서비스로 전달됩니다. 방문자 브라우저 1. 열기 터널 URL Localtonet 서버 2. 리디렉션 로그인 페이지 auth.localtonet.com 3. 로그인 제공자 Google, GitHub… 4. 로그인 완료, 터널로 복귀 5. 요청 내 서비스 내 기기
로그인은 서비스가 아니라 Localtonet의 로그인 페이지에서 이루어집니다.
  1. 방문자가 터널 URL을 엽니다. HTTP 요청은 먼저 HTTPS로 리디렉션됩니다.
  2. 방문자가 아직 로그인하지 않았으므로 Localtonet 서버가 브라우저를 auth.localtonet.com의 로그인 페이지로 리디렉션합니다. 이 페이지에는 Sign in to continue라는 제목이 있으며 이 터널에 켜 둔 제공자가 표시됩니다.
  3. 방문자가 제공자를 선택하고 그곳에서 로그인합니다. 사용자 이름 및 비밀번호 제공자의 경우 로그인 양식이 로그인 페이지에 직접 표시됩니다.
  4. Localtonet은 접근 규칙을 확인한 다음 방문자를 요청했던 주소로 돌려보냅니다. 로그인 정보는 터널 호스트 이름의 쿠키에 보관됩니다. 이 쿠키는 브라우저 세션 쿠키이며 HTTPS로만 전송됩니다.
  5. 그 후에는 요청이 평소처럼 서비스로 전달됩니다. 로그인이 더 이상 유효하지 않으면 방문자는 다시 로그인 페이지로 이동합니다.

로그인했지만 규칙에서 허용되지 않은 방문자에게는 403 - Access Denied와 "You do not have permission to access this tunnel." 문구가 표시됩니다.

/.well-known 아래의 경로는 로그인 뒤에 두지 않습니다.

시작하기 전에 #

  • HTTP 터널. HTTP / HTTPS를 참고하세요.
  • 계정의 잔액. 잔액이 없으면 제공자를 저장하거나 로그인을 켤 때 "이 기능을 사용하려면 잔액을 구매해야 합니다."라는 메시지와 함께 실패합니다. 플랜 및 잔액과 요금을 참고하세요.
  • 외부 제공자의 경우: 그곳에서 OAuth 애플리케이션을 등록할 수 있는 계정.

SSO는 개인 대시보드에서 설정합니다. 팀 터널에서는 SSO 버튼과 SSO 제공자 설정이 표시되지 않습니다.

제공자 #

다음 가이드에서 가장 일반적인 선택지를 단계별로 안내합니다.

대시보드의 제공자 유형 목록에는 Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon, Yahoo가 있습니다. Username-Password와 Custom을 제외한 모든 유형은 엔드포인트가 자동으로 채워집니다. OpenID Connect에 채워지는 주소는 예시이므로 사용하는 제공자의 엔드포인트로 바꾸세요.

설정하기 #

설정은 두 부분으로 이루어집니다. 제공자를 한 번 추가하면 모든 HTTP 터널에서 사용할 수 있습니다. 그다음 보호하려는 터널마다 켭니다. 저장된 제공자는 터널에서 사용하기 전까지 아무것도 보호하지 않습니다.

  1. 제공자 추가 #

    내 터널 › HTTP를 열고 페이지 상단의 SSO를 선택합니다(툴팁에는 SSO 제공자 설정이라고 표시됩니다). SSO 제공자 대화 상자가 열립니다. 제공자 추가를 선택하고 양식을 작성한 다음 제공자 저장을 선택합니다. 제공자는 각각 따로 저장됩니다.

    필드설명참고
    제공자 이름터널 설정에서 이 제공자를 식별하기 위한 이름입니다.필수입니다. 예: Company Google.
    제공자 유형로그인 방식입니다.새 제공자는 Google로 시작합니다. 저장된 제공자의 유형을 바꾸면 클라이언트 ID가 비워지므로 클라이언트 ID와 클라이언트 시크릿을 다시 입력하세요.
    활성터널에서 제공자를 사용할 수 있게 합니다.제공자를 비활성으로 바꾸고 저장하면, 해당 제공자를 사용하던 모든 터널에서도 꺼집니다.
    클라이언트 ID제공자에 등록한 애플리케이션의 ID입니다.Username-Password와 Custom을 제외한 모든 유형에서 필수입니다.
    클라이언트 시크릿해당 애플리케이션의 시크릿입니다.저장한 뒤에는 표시되지 않습니다. 나중에 비워 두면 저장된 시크릿이 유지됩니다.
    엔드포인트 & 콜백인증 엔드포인트, 토큰 엔드포인트, 사용자 정보 엔드포인트, 콜백 경로.표준 제공자의 경우 자동으로 채워집니다. 가이드에서 안내할 때만 변경하세요.
    이메일 접근 규칙허용된 이메일 도메인, 차단된 이메일 도메인, 차단된 이메일 주소.선택 사항입니다. 접근 규칙을 참고하세요.
    로그인 사용자사용자 이름과 비밀번호입니다.Username-Password와 Custom 유형에만 해당합니다.

    제공자를 제거하려면 제공자 삭제를 선택합니다. 계정과 터널의 SSO 설정에서 제공자가 제거됩니다.

  2. 터널에서 켜기 #

    내 터널에서 해당 터널의 설정을 선택합니다. 터널 설정 패널에서 SSO 제공자를 찾아 관리를 선택합니다. 싱글 사인온(SSO) 대화 상자가 열립니다.

    설정기능
    로그인 필수이 터널에서 SSO를 켭니다. 로그인하지 않은 방문자는 먼저 로그인 페이지로 이동합니다.
    제공자활성 상태인 제공자마다 스위치가 하나씩 있습니다. 하나 이상 켜세요. 여러 개를 켜면 방문자가 로그인 페이지에서 선택합니다.
    로그인할 수 있는 사용자이 터널의 이메일 주소, 이메일 도메인, 사용자 이름 목록입니다(선택 사항).
    로그인 및 로그아웃 경로선택 사항인 로그인 경로와 로그아웃 경로입니다.

    저장을 선택합니다.

  3. 테스트하기 #

    비공개 브라우저 창에서 터널 URL을 엽니다. Sign in to continue 페이지가 표시되어야 하며, 로그인하면 서비스로 이동합니다.

리디렉션 URI #

외부 제공자는 로그인 후 사용자를 어디로 보낼 수 있는지 묻습니다. 모든 터널에서 이 주소는 터널 주소가 아니라 Localtonet 로그인 호스트의 주소입니다. 정확히 다음 값을 등록하세요.

리디렉션 URI
http://auth.localtonet.com/auth/callback

각 제공자 가이드에서 이 값을 입력할 위치를 안내합니다.

값입력 위치
위의 리디렉션 URI제공자 쪽: Authorized redirect URIs(Google), Authorization callback URL(GitHub), Redirect URI(Microsoft, GitLab).
콜백 경로, 예: /auth/callback/googleLocaltonet의 엔드포인트 & 콜백에 있습니다. 자동으로 채워지므로 그대로 두세요.

제공자는 리디렉션 URI를 등록된 값과 정확히 비교하므로 여기에 표시된 그대로 복사하세요.

접근 규칙 #

로그인은 방문자가 누구인지 증명합니다. 그 사람이 터널을 열 수 있는지는 규칙이 결정합니다. 규칙은 두 단계가 있으며 둘 다 적용됩니다.

위치목록대시보드에 표시되는 설명
제공자허용된 이메일 도메인비워 두면 도메인 제한이 없습니다. 와일드카드 사용 여부는 제공자에 따라 다릅니다.
제공자차단된 이메일 도메인이 이메일 도메인의 로그인을 차단합니다.
제공자차단된 이메일 주소이 개별 이메일 주소를 차단합니다.
터널이메일 주소, 이메일 도메인, 사용자 이름목록을 비워 두면 해당 검사를 건너뜁니다. 목록은 터널에서 켠 모든 제공자에 적용됩니다.

한 줄에 항목 하나를 입력하거나 쉼표로 구분합니다. 도메인은 @ 없이 입력합니다(예: example.com).

규칙을 변경한 후에도 이미 허용된 방문자는 최대 5분 동안 접근 권한을 유지할 수 있습니다. 거부된 방문자는 1분 후에 다시 확인됩니다.

로그인 경로와 로그아웃 경로 #

설정동작예시
로그인 경로비어 있으면 터널의 모든 경로에서 로그인이 필요합니다. 채워져 있으면 경로가 항목 중 하나로 시작하는 요청에만 로그인이 필요합니다./admin은 /admin과 /admin/users를 포함하며, /administrator는 포함하지 않습니다.
로그아웃 경로이 경로를 열면 이 터널의 로그인이 해제되고, 방문자는 터널의 시작 페이지 또는 returnUrl 쿼리 값에 지정된 주소로 이동합니다./sso/logout

경로는 슬래시로 시작합니다. 대소문자는 구분하지 않습니다.

로그인 경로 목록을 채우면 나머지 경로는 모두 열립니다. 목록에 /admin이 있으면 /admin만 보호되고 다른 모든 경로는 로그인 없이 접근할 수 있습니다. 터널 전체를 보호하려면 목록을 비워 두세요.

로그아웃 경로는 방문자를 터널에서만 로그아웃시킵니다. Google, GitHub 등 ID 제공자에서는 로그아웃되지 않습니다.

문제 해결 #

"이 기능을 사용하려면 잔액을 구매해야 합니다."

SSO에는 잔액이 필요합니다. 잔액을 추가한 다음 다시 저장하세요. 잔액이 없어도 대화 상자를 열고 로그인 필수를 끌 수는 있습니다.

"로그인을 켜기 전에 제공자를 추가하세요."

아직 활성 제공자가 없습니다. 대화 상자에서 제공자 추가를 선택하거나 HTTP 페이지 상단의 SSO 버튼을 사용하세요.

"제공자를 하나 이상 켜거나 로그인을 끄세요."

로그인 필수는 켜져 있지만 제공자 스위치가 하나도 켜져 있지 않습니다. 비활성으로 바꾼 제공자는 터널에서 꺼지며 더 이상 목록에 표시되지 않습니다.

로그인 페이지에 "No authentication providers are currently configured for this tunnel."라고 표시됩니다

로그인이 필요하지만 이 터널에 켜진 제공자가 없습니다. 터널에서 SSO 제공자 › 관리를 열고 하나를 켜세요.

터널이 로그인을 요구하지 않고 열립니다

로그인 필수가 켜져 있고 저장되었는지 확인하세요. 로그인 경로가 채워져 있으면 해당 경로만 보호됩니다. 사용 중인 브라우저가 이미 로그인된 상태일 수 있으므로 비공개 창에서도 테스트하세요.

로그인 후 "403 - Access Denied"가 표시됩니다

로그인은 되었지만 규칙이 해당 계정을 거부했습니다. 제공자의 이메일 접근 규칙과 터널의 로그인할 수 있는 사용자 목록을 확인하세요. 규칙을 수정한 후 1분 기다렸다가 새로 고치세요.

웹훅이나 API 클라이언트가 응답 대신 리디렉션을 받습니다

로그인 쿠키가 없는 요청은 로그인 페이지로 리디렉션됩니다. 사람이 사용하는 페이지만 로그인 경로에 넣거나, 기계 간 트래픽에는 별도의 터널을 사용하세요.

자동화 #

제공자와 터널의 SSO 설정은 /api/v2/sso-providers 아래의 API와 MCP 서버로도 관리할 수 있습니다.

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

지원