Edge Tunnel 관리
조직의 Edge Tunnel을 관리하고 안전한 연결을 위한 터널을 설정할 수 있습니다.
개요
Edge Tunnel은 조직의 보안 네트워크와 QueryPie AIP 간의 안전한 연결을 제공합니다. 관리자는 조직 Edge Tunnel과 개인 Edge Tunnel을 모두 관리할 수 있으며, 각각 다른 용도로 사용됩니다.
Edge Tunnel 관리 페이지 접근
관리자 로그인
관리자 계정으로 로그인합니다.
메뉴 이동
좌측 메뉴에서 SECURITY SETTINGS > Edge Tunnel을 클릭합니다.
페이지 확인
Edge Tunnel 관리 페이지가 표시됩니다.
조직 Edge Tunnel 관리
조직 Edge Tunnel 개요
조직 Edge Tunnel은 여러 서버가 동일한 인증 키를 사용하여 그룹으로 연결할 수 있는 터널입니다. 조직 관리자만 Edge Tunnel 그룹을 생성할 수 있습니다.
조직 Edge Tunnel 생성
탭 선택
Organization Tunnels 탭을 선택합니다.
생성 버튼 클릭
Create Organization Tunnel 버튼을 클릭합니다.
터널 별칭 입력
Tunnel Alias 필드에 터널 그룹명을 입력합니다.
- 영문자, 숫자, 하이픈, 언더스코어만 사용 가능 (공백 불가)
- 예:
production-cluster,dev-environment등
터널 생성 완료
입력 완료 후 체크 버튼을 클릭하여 터널을 생성합니다.
조직 Edge Tunnel 연결
터널 생성 후 서버에서 실행할 명령어가 제공됩니다:
설치 버튼 클릭
Install Edge Tunnel 버튼을 클릭합니다.
명령어 복사
표시된 명령어를 복사합니다:
npx -y @querypie/mcp@latest tunnel link '<터널 키>'서버에서 명령어 실행
연결하려는 서버의 터미널에서 복사한 명령어를 실행합니다.
연결 확인
터널이 성공적으로 연결되면 Connected Servers 목록에 서버 정보가 표시됩니다.
연결된 서버 정보 확인
연결된 각 서버에 대해 다음 정보를 확인할 수 있습니다:
- 서버명: 연결된 서버의 식별자
- IP 주소: 서버의 IP 주소
- OS 정보: 운영체제 및 버전 정보
- 생성일: 서버가 터널에 연결된 날짜
개인 Edge Tunnel 관리
개인 Edge Tunnel 개요
개인 Edge Tunnel은 개별 사용자가 생성하고 관리하는 터널입니다. 관리자는 조직 내 모든 개인 Edge Tunnel을 모니터링하고 관리할 수 있습니다.
개인 Edge Tunnel 목록 확인
각 터널에 대해 다음 정보가 표시됩니다:
- 터널 식별자: 고유한 터널 ID
- 사용자명: 터널을 생성한 사용자
- IP 주소: 연결된 클라이언트의 IP 주소
- OS 정보: 클라이언트의 운영체제 정보
- 생성일: 터널이 생성된 날짜
개인 Edge Tunnel 강제 종료
필요시 개인 Edge Tunnel을 강제 종료할 수 있습니다.
삭제 버튼 클릭
삭제하려는 터널 행의 우측 삭제 버튼(🗑️)을 클릭합니다.
확인 대화상자 표시
삭제 확인 대화상자가 표시됩니다.
터널 정보 확인
다음 정보를 확인합니다:
- Tunnel Alias: 삭제할 터널의 식별자
- Type: 터널 유형 (Personal)
- Created At: 터널 생성 시간
주의사항 확인
Warning 섹션의 주의사항을 확인합니다:
- 모든 활성 연결이 종료됩니다
- 이 터널을 사용하는 통합 설정이 실패할 수 있습니다
- 이 작업은 영구적이며 되돌릴 수 없습니다
삭제 확정
Delete Tunnel 버튼을 클릭하여 삭제를 확정합니다.
Edge Tunnel 상태 모니터링
연결 상태 확인
- 녹색 점: 터널이 활성 상태이며 정상 연결됨
- 연결된 서버 수: 각 조직 터널에 연결된 서버의 개수 표시
터널 관리 모범 사례
- 명명 규칙: 터널 별칭은 용도를 명확히 알 수 있도록 작성
- 정기 점검: 불필요한 개인 터널은 정기적으로 정리
- 보안 관리: 터널 인증 키는 안전하게 보관
- 모니터링: 연결된 서버 상태를 정기적으로 확인
주의사항
- 조직 Edge Tunnel 생성은 조직 관리자만 가능합니다
- 터널 삭제 시 모든 연결이 즉시 종료됩니다
- 삭제된 터널은 복구할 수 없으므로 신중하게 결정하세요
- 터널 연결 상태는 실시간으로 업데이트됩니다