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

Microsoft 통합 인증(SSO)

잔액 필요 HTTP 터널

이 페이지 도움받기
이 페이지의 내용 섹션 6개
  1. 시작하기 전에
  2. 단계
  3. Microsoft Entra에 애플리케이션 등록하기
  4. Localtonet에 제공자 추가하기
  5. 터널에서 켜기
  6. 테스트하기
  7. 계정 유형과 엔드포인트
  8. Localtonet이 Microsoft에서 읽는 정보
  9. 문제 해결
  10. 관련 페이지

방문자가 HTTP 터널을 열기 전에 Microsoft Entra ID 회사 또는 학교 계정이나 개인 Microsoft 계정으로 로그인하도록 합니다. Microsoft Entra에 애플리케이션을 등록하고, Localtonet에 제공자로 추가한 다음, 터널에서 켜면 됩니다.

시작하기 전에 #

  • HTTP 터널과 계정의 잔액이 필요합니다. 통합 인증(SSO) 개요를 참고하세요.
  • 애플리케이션을 등록할 수 있는 역할로 Microsoft Entra admin center에 접근할 수 있어야 합니다. Microsoft는 최소 역할로 Application Developer를 제시합니다.
  • 로그인할 수 있는 사용자에 대한 결정: 내 조직만, 모든 조직, 또는 개인 계정까지. 이 결정에 따라 Localtonet에 입력하는 주소 중 두 개가 달라집니다. 계정 유형과 엔드포인트를 참고하세요.

단계 #

  1. Microsoft Entra에 애플리케이션 등록하기 #

    Microsoft의 공식 가이드는 Register an app in Microsoft Entra ID, Add a redirect URI, Add app credentials입니다. 요약하면 다음과 같습니다.

    1. Microsoft Entra admin center에서 Entra ID › App registrations로 이동하여 New registration을 선택합니다.
    2. Name을 입력합니다. 방문자가 로그인할 때 이 이름이 표시됩니다.
    3. Supported account types에서 애플리케이션을 사용할 수 있는 대상을 선택한 다음 Register를 선택합니다.
    4. Overview 페이지에서 Application (client) ID를 복사합니다. 단일 테넌트 애플리케이션이라면 Directory (tenant) ID도 복사합니다.
    5. Manage 아래에서 Authentication을 열고 Add Redirect URI를 선택한 다음 Web 플랫폼을 선택하고, 아래의 리디렉션 URI를 입력한 뒤 Configure를 선택합니다.
    6. Certificates & secrets › Client secrets를 열고 New client secret을 선택합니다. 설명을 입력하고 만료 기간을 선택한 다음 Add를 선택합니다. 시크릿의 Value를 바로 복사하세요. 페이지를 벗어나면 Microsoft는 이 값을 다시 표시하지 않습니다.
    Redirect URI (platform: Web)
    http://auth.localtonet.com/auth/callback

    클라이언트 시크릿은 만료됩니다. Microsoft는 수명을 최대 24개월로 제한합니다. 만료되면 새 시크릿을 만들어 Localtonet 제공자에 저장할 때까지 로그인이 작동하지 않습니다.

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

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

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

    엔드포인트 & 콜백을 엽니다. 이 값들은 자동으로 채워집니다.

    필드자동으로 채워지는 값변경해야 하나요?
    인증 엔드포인트https://login.microsoftonline.com/common/oauth2/v2.0/authorize다음 섹션의 표에 따라 common을 바꿉니다.
    토큰 엔드포인트https://login.microsoftonline.com/common/oauth2/v2.0/tokencommon을 위와 같은 값으로 바꿉니다.
    사용자 정보 엔드포인트https://graph.microsoft.com/oidc/userinfo아니요. 테넌트가 포함되어 있지 않습니다.
    콜백 경로/auth/callback/microsoft아니요.

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

  3. 터널에서 켜기 #

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

    로그인할 수 있는 사용자 아래의 목록과 로그인 경로는 선택 사항입니다. 개요에서 설명합니다.

  4. 테스트하기 #

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

계정 유형과 엔드포인트 #

Microsoft 주소에서 login.microsoftonline.com/ 뒤의 부분이 로그인할 수 있는 사용자를 결정합니다. 이 값은 애플리케이션의 Supported account types와 맞아야 합니다. 인증 엔드포인트와 토큰 엔드포인트에는 항상 같은 값을 사용합니다. 사용자 정보 엔드포인트는 바뀌지 않습니다.

Microsoft Entra의 Supported account typescommon 대신 사용할 값로그인할 수 있는 사용자
Single tenant only내 Directory (tenant) ID내 테넌트의 사용자와 게스트.
Multiple Entra ID tenantsorganizations모든 조직의 회사 또는 학교 계정.
Any Entra ID Tenant + Personal Microsoft accountscommon 유지회사 또는 학교 계정과 개인 Microsoft 계정.
Personal accounts onlyconsumers개인 Microsoft 계정.

단일 테넌트 애플리케이션의 예시입니다. <TENANT_ID>를 Directory (tenant) ID로 바꾸세요.

단일 테넌트
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint:         https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint:     https://graph.microsoft.com/oidc/userinfo

단일 테넌트 애플리케이션은 common에서 작동하지 않습니다. Microsoft가 AADSTS50194 오류로 응답합니다. 두 엔드포인트에 테넌트 ID를 넣거나, 애플리케이션을 멀티테넌트 계정 유형으로 변경하세요.

멀티테넌트 또는 개인 계정 유형에서는 조직 밖의 사람도 Microsoft에서 로그인할 수 있습니다. 허용할 사람만 받으려면 제공자의 허용된 이메일 도메인이나 터널의 로그인할 수 있는 사용자를 사용하세요.

Localtonet이 Microsoft에서 읽는 정보 #

Microsoft의 사용자 정보 엔드포인트는 계정에 이메일 주소가 연결되어 있을 때만 이메일 주소를 반환합니다. 따라서 이메일 주소가 없는 계정은 이메일을 기준으로 하는 규칙을 통과하지 못할 수 있습니다.

문제 해결 #

AADSTS50011: 응답 URL이 일치하지 않습니다

요청에 포함된 리디렉션 URI가 애플리케이션에 등록되어 있지 않습니다. 메시지에 전송된 주소가 표시됩니다. 이 주소는 앱 등록의 Authentication 페이지에 있는 Web 플랫폼의 리디렉션 URI와 대소문자까지 똑같아야 합니다. http://auth.localtonet.com/auth/callback을 정확히 그대로 등록하세요.

AADSTS50194: 애플리케이션이 멀티테넌트 애플리케이션으로 구성되어 있지 않습니다

애플리케이션은 단일 테넌트인데 엔드포인트에 여전히 common이 들어 있습니다. 인증 엔드포인트와 토큰 엔드포인트의 common을 Directory (tenant) ID로 바꾸고 제공자 저장을 선택하세요.

AADSTS700016: 디렉터리에서 애플리케이션을 찾을 수 없습니다

클라이언트 ID가 잘못되었거나, 엔드포인트가 애플리케이션이 없는 테넌트를 가리키고 있습니다. Application (client) ID와 엔드포인트의 테넌트 ID를 확인하세요.

AADSTS7000215 또는 AADSTS7000222: 클라이언트 시크릿이 잘못되었거나 만료되었습니다

Certificates & secrets에서 새 클라이언트 시크릿을 만들고, 그 Value를 Localtonet의 클라이언트 시크릿에 붙여 넣은 다음 제공자 저장을 선택하세요.

Microsoft가 관리자 승인을 요구합니다

테넌트에서 사용자가 애플리케이션에 직접 동의할 수 없도록 설정되어 있습니다. 테넌트 관리자가 Microsoft Entra admin center에서 애플리케이션에 대한 동의를 부여해야 합니다.

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

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

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

지원