AuthToken
이 페이지의 내용 섹션 8개
AuthToken은 기기 한 대의 Localtonet 앱을 계정에 연결합니다. 내 토큰에서 기기마다 토큰을 만들고, 그 토큰으로 기기에 로그인한 다음 터널을 만들 때 해당 토큰을 선택하세요.
AuthToken이란 #
Localtonet 앱은 이메일과 비밀번호 대신 AuthToken으로 로그인합니다. 대시보드에서 토큰은 그 토큰을 사용하는 기기를 나타냅니다. 터널은 토큰에 대해 만들어지며, 해당 토큰을 사용하는 앱이 연결되어 있는 동안 작동합니다.
- 기기마다 별도의 토큰을 사용하세요. 같은 토큰을 사용하는 새 연결은 이전 연결을 대체합니다.
- 토큰 이름은 단순한 라벨입니다. 토큰 자체는 Localtonet이 생성합니다.
- AuthToken은 기기를 로그인시킵니다. 방문자로부터 터널을 보호하지는 않습니다. 그 용도로는 접근 제어를 참고하세요.
토큰을 비공개로 유지하세요. 토큰을 가진 사람은 누구나 그 토큰으로 앱에 로그인할 수 있습니다. 토큰의 QR 코드와 PIN도 마찬가지입니다.
토큰 만들기 #
-
내 토큰 열기 #
내 토큰을 열고 토큰 생성을 펼칩니다.
-
기기 이름 지정 #
토큰 이름에 알아보기 쉬운 이름(예:
Office-PC)을 입력하고 토큰 생성을 선택합니다.규칙 세부 내용 필수 이름이 비어 있으면 사용자 지정 이름은 필수입니다!라고 표시됩니다. 길이 최대 30자입니다. 공백 허용되지 않습니다. 입력란에 공백을 입력할 수 없으며, 붙여넣은 이름의 공백은 제거됩니다. 고유성 토큰 두 개가 같은 이름을 가질 수 없습니다. -
앱에 토큰 복사 #
새 토큰은 내 토큰 아래에 나타납니다. 토큰을 선택해 전체 토큰을 복사한 다음, 그 토큰으로 Localtonet 앱을 시작합니다.
터미널localtonet --authtoken <YOUR_TOKEN>Android에서는 QR 코드나 PIN을 대신 사용하세요. 아래의 Android 기기 연결을 참고하세요.
-
내 터널에서 기기 선택 #
터널을 만들 때 기기 토큰에서 이 토큰을 선택합니다. 전체 과정은 빠른 시작에서 볼 수 있습니다.
토큰 목록 #
내 토큰에는 현재 작업 중인 계정의 모든 토큰이 나열됩니다. 토큰 검색으로 이름이나 토큰으로 필터링하고, 새로고침으로 목록을 다시 불러옵니다. 화면이 좁으면 일부 열이 각 행의 세부 정보 버튼 뒤로 이동합니다.
| 열 | 표시 내용 | 할 수 있는 작업 |
|---|---|---|
| 이름 | 토큰에 지정한 이름입니다. | 이름을 선택하면 토큰 이름을 바꿀 수 있습니다. 새 이름의 규칙이 적용됩니다. |
| 상태 | 온라인은 Localtonet 앱이 연결되어 있다는 뜻입니다. 오프라인은 터널이 계속 설정되어 있더라도 기기의 연결이 끊어졌다는 뜻입니다. | |
| 토큰 | 가운데 부분이 가려진 토큰입니다. | 선택하면 전체 토큰이 복사됩니다. QR 버튼은 기기 연결을 엽니다. |
| 터널 | 이 토큰에 연결된 활성 터널 수 / 전체 터널 수입니다. 온라인 기기에 활성 터널이 있다고는 할 수 없습니다. | |
| 클라이언트 | 마지막으로 보고된 앱 버전과 업데이트 상태입니다. | 업데이트 필요 배지는 다운로드 페이지로 연결되므로 최신 Localtonet 앱을 설치할 수 있습니다. 이 정보를 새로 고치려면 기기를 연결하세요. |
| 기기 | 기기가 마지막으로 보고한 스레드 사용량, 배터리 잔량, 배터리 온도입니다. | Android 기기의 경우 Android 기기 설정, 지원되는 경우 SMS 설정, 기기 작업 로그를 사용할 수 있습니다. 프록시 매니저에서는 기기 전체에 같은 제어 기능을 제공합니다. |
| 작업 | IP 기록, 토큰 설정, 토큰 삭제. |
IP 기록 #
IP 기록은 토큰에 기록된 공인 IP 주소를 날짜와 함께 나열합니다. 목록 위에는 총 반복 횟수, 총 반복 IP, 최근 1시간 반복 IP, 최근 1시간 총 IP의 네 가지 카운터가 표시됩니다. 새로고침을 선택하면 카운터가 업데이트됩니다. 모바일 IP가 바뀌는 휴대폰처럼 IP가 변하는 기기에서 특히 유용합니다.
토큰 설정 #
토큰 설정은 전체 토큰, 토큰 복사 버튼, QR / PIN 버튼, 그리고 두 가지 설정이 있는 패널을 엽니다.
| 설정 | 기능 | 값 |
|---|---|---|
| USB 기기 모드 | 토큰이 USB 기기를 연결할 때 이 모드를 사용합니다. 해당 기기는 내 USB 기기에서 관리합니다. | 예 또는 아니요. 변경할 때 확인을 요청합니다. |
| 클라이언트 인수 | 클라이언트 옵션을 토큰과 함께 저장합니다. 관리를 선택하고 활성을 켠 다음 인수를 입력하세요. Localtonet 클라이언트는 여기에 저장된 인수를 적용하지 않고, 터널에 설정된 인수를 적용합니다. 네트워크 인터페이스나 로컬 IP 주소를 선택하려면 각 터널에서 설정하세요. | 활성을 켜면 입력란을 비워 둘 수 없습니다. 네트워크 선택을 참고하세요. |
토큰 삭제 #
토큰 삭제를 선택하고 확인합니다. 대시보드가 먼저 경고를 표시합니다.
이 토큰을 사용하는 터널은 중지되고 삭제됩니다. 해당 토큰을 아직 사용하는 기기는 더 이상 그 토큰으로 연결할 수 없습니다. 그 기기가 다시 필요하면 새 토큰을 만드세요.
QR 코드 또는 PIN으로 Android 기기 연결 #
휴대폰에서 토큰을 직접 입력할 필요는 없습니다. 모든 토큰에는 QR 코드와 짧은 PIN이 있습니다.
-
기기 연결 열기 #
내 토큰에서 토큰 옆의 QR 버튼을 선택합니다. 기기 연결 대화 상자가 열립니다.
-
코드를 스캔하거나 PIN 입력 #
Android용 Localtonet을 엽니다. QR 코드 스캔 아래의 코드를 스캔하거나, 대신 PIN 입력 아래에 표시된 6자리 PIN을 앱의 로그인 필드에 입력하고 Connect를 선택합니다.
- PIN은 1분 동안 유효합니다. 대화 상자에 카운트다운이 표시되고 이후 PIN이 만료되었습니다. 계속하려면 새 PIN을 생성하세요.라고 표시됩니다.
- PIN은 한 번만 사용할 수 있습니다. 다른 기기에 사용하거나 다시 시도하려면 새 PIN 생성을 선택하세요.
- QR 코드는 만료되지 않습니다. 토큰 자체가 들어 있으므로 QR 코드 사진도 토큰처럼 취급하세요.
- 토큰을 앱에 직접 붙여넣을 수도 있습니다. 대화 상자에 복사 버튼과 함께 토큰이 표시됩니다.
토큰 그룹 #
토큰 그룹에는 기기 토큰이 들어 있습니다. 그룹은 기기를 풀(pool)로 묶습니다. 로테이팅 프록시는 선택한 그룹의 기기를 사용하며, 토큰 웹훅은 그룹에 대해 만듭니다.
-
그룹 만들기 #
내 토큰에서 토큰 그룹을 펼치고 그룹 이름을 입력한 다음 그룹 생성을 선택합니다. 이름은 최대 30자이며 공백을 포함할 수 없고 내 그룹 중에서 고유해야 합니다.
-
그룹의 토큰 선택 #
토큰 그룹 관리 대화 상자가 열리고 모든 토큰의 목록이 표시됩니다. 그룹에 속할 기기 토큰을 선택하고 변경 사항 저장을 선택합니다.
나중에 그룹을 변경하려면 해당 행에서 관리를 선택합니다. 이 대화 상자는 긴 목록을 다루도록 만들어져 있습니다.
- 이름으로 검색합니다. 여러 이름은 쉼표로 구분합니다.
- 기기 상태로 필터링합니다: 모든 상태, 온라인, 오프라인.
- 전체, 그룹에 포함, 그룹에 미포함 사이를 전환합니다.
- 모두 선택을 사용하면 표시된 모든 토큰이 선택되며, 제외할 토큰은 선택을 해제합니다. Shift+클릭으로 범위를 선택할 수 있습니다.
- 하단에는 변경될 내용이 표시됩니다(예: +3개 추가 예정). 초기화는 변경 사항을 취소합니다.
그룹에서 토큰을 제거하면 대화 상자가 확인을 요청합니다. 그룹을 사용하는 로테이팅 프록시가 해당 기기에서 중지되기 때문입니다. 한 번 저장할 때 최대 5000개의 토큰을 변경할 수 있습니다.
그룹 삭제는 그룹과 그 구성원 정보를 제거합니다. 토큰 자체는 그대로 남습니다.
토큰이 사용되는 곳 #
| 위치 | 토큰 사용 방식 |
|---|---|
| 터널 생성 양식 | 기기 토큰은 터널을 제공하는 기기를 선택합니다. 기존 터널을 다른 기기로 옮기려면 터널의 AuthToken 변경을 사용하세요. 실행 중인 터널은 중지되고 2초 기다린 뒤 선택한 토큰으로 다시 시작됩니다. |
| 로테이팅 프록시 | 단일 토큰 대신 토큰 그룹을 사용합니다. 선택한 그룹에서 연결된 모든 기기가 공유 엔드포인트의 출구가 됩니다. |
| 웹훅 | 토큰 웹훅은 AuthToken 그룹에 대해 설정합니다. |
| VPN 매니저 | 네트워크에 기기를 추가할 때 그 기기에서 Localtonet에 로그인하는 데 사용할 토큰을 선택합니다. 기기마다 별도의 토큰이 필요합니다. |
| 기기 터미널 | 토큰은 내 기기에서 컴퓨터를 계정에 연결합니다. |
| USB 기기 | USB 기기 모드의 토큰은 USB 모뎀이나 휴대폰이 연결된 컴퓨터를 연결합니다. |
| 프록시 매니저 | 모든 Android 휴대폰은 각자의 토큰으로 로그인합니다. |
API와 MCP 서버로도 토큰과 토큰 그룹을 조회, 생성, 삭제할 수 있습니다.
대시보드에서 팀을 선택한 동안에는 내 토큰이 해당 팀의 토큰을 표시하고 생성합니다. 팀 관리를 참고하세요.
문제 해결 #
… 이름의 토큰이 이미 존재합니다
토큰 이름은 고유해야 합니다. 다른 이름을 선택하거나 기존 토큰의 이름을 먼저 바꾸세요.
이름은 30자를 초과할 수 없습니다
토큰 이름이나 그룹 이름을 30자 이하로 줄이세요.
토큰이 오프라인으로 표시됩니다
기기의 연결이 끊어졌습니다. 기기에서 Localtonet 앱을 열어 연결하세요. 같은 토큰으로 다른 기기를 시작했다면 그 기기가 이 연결을 대체한 것입니다. 기기마다 별도의 토큰을 만드세요.
클라이언트가 Wrong Token!이라고 표시합니다
입력한 값이 완전한 토큰이 아닙니다. 내 토큰에서 전체 토큰을 다시 복사하세요. 목록은 가운데 부분을 가리므로 보이는 텍스트를 선택하지 말고 복사 버튼을 사용하세요.
PIN이 만료되었습니다
PIN은 1분 동안 유효하며 한 번만 사용할 수 있습니다. 새 PIN 생성을 선택하거나 대신 QR 코드를 스캔하세요.
QR 코드와 PIN을 불러올 수 없습니다
대화 상자에서 다시 시도를 선택하세요. 계속 실패하면 토큰을 복사해 앱에 붙여넣으세요.