Ngrok이란?

🔍1. Ngrok란?

Ngrok는 로컬 개발 환경을 외부에서 접근 가능하게 만들어 주는 터널링 서비스

📌2. Ngrok 기능

• HTTP/HTTPS 터널링 → 로컬 서버를 안전하게 공개
• HTTPS 인증서 자동 제공 → LS/SSL 보안 연결을 사용하며, 인증서는 자동으로 생성
• 트래픽 확인 → http://127.0.0.1:4040에서 요청/응답 확인 가능
• TCP 터널링 → SSH, DB 등 TCP 서비스 터널링 가능
• Custom subdomain/Custom domain → 유료 계정에서 가능
  
  

📌3. Ngrok 설치 및 사용 방법

✅ 3-1. 다운로드

https://ngrok.com/

 

✅ 3-2. 인증 토큰 확인

1️⃣ 회원가입 및 로그인
2️⃣ Getting Started > Your Authtoken 페이지 이동
3️⃣ Authtoken 복사

✅ 3-3. ngrok CLI에 authtoken 등록

터미널에서 다음 명령어 실행:

ngrok config add-authtoken <YOUR_AUTHTOKEN>

✔️ 성공 메시지 나오면 인증 완료

 

✅ 3-4. HTTP 터널 시작

포털 서버가 로컬 8080 포트에서 실행 중이라고 가정:

ngrok http 8080

 

출력 예시 (무료 버전은 도메인 주소 자동 생성)

Forwarding                    https://abcd1234.ngrok.io -> http://localhost:8080

 

✅ 3-5. 주의사항

• 생성된 도메인은 2시간동안 사용 가능
• 무료 ngrok URL은 외부 사이트 Domain 검증용으로는 사용할 수 없다.
• ngrok 유료 플랜에서 Custom Domain 연결 가능
  
  

* ngrok + Custom Domain으로 도메인 검증

• 유료 플랜에서 Custom Domain 연결 (예: https://sso-test.yourcompany.com)
• DNS에 CNAME → ngrok 터널 주소 추가
• .well-known/microsoft-identity-association 파일도 해당 도메인에서 접근 가능해야 함