AuthToken
このページの内容 8セクション
AuthTokenは、1台のデバイス上のLocaltonetアプリをお使いのアカウントに接続するものです。マイトークンでデバイスごとにトークンを作成し、そのトークンでデバイスにログインしてから、トンネルの作成時にそのトークンを選びます。
AuthTokenとは #
Localtonetアプリは、メールアドレスとパスワードの代わりにAuthTokenでログインします。ダッシュボードでは、トークンはそれを使うデバイスを表します。トンネルはトークンに対して作成され、そのトークンを使うアプリが接続されている間だけ動作します。
- デバイスごとに専用のトークンを使ってください。同じトークンを使った新しい接続は、以前の接続を置き換えます。
- トークンの名前は単なるラベルです。トークン自体はLocaltonetが生成します。
- AuthTokenはデバイスにログインさせるためのものです。訪問者からトンネルを守る機能ではありません。その場合はアクセス制御を参照してください。
トークンは非公開にしてください。トークンを知っている人は誰でも、それを使ってアプリにログインできます。トークンのQRコードとPINも同様です。
トークンを作成する #
-
「マイトークン」を開く #
マイトークンを開き、トークンを作成を展開します。
-
デバイスに名前を付ける #
トークン名に分かりやすい名前(例:
Office-PC)を入力し、トークンを作成を選択します。ルール 詳細 必須 名前が空の場合は、名前は必須です!と表示されます。 長さ 30文字以内。 スペース 使用できません。フィールドにスペースは入力できず、貼り付けた名前に含まれるスペースは削除されます。 一意 同じ名前のトークンを2つ作成することはできません。 -
トークンをアプリにコピーする #
新しいトークンはあなたのトークンの下に表示されます。選択すると完全なトークンがコピーされるので、それを使ってLocaltonetアプリを起動します。
ターミナルlocaltonet --authtoken <YOUR_TOKEN>Androidでは、代わりにQRコードかPINを使ってください。下のAndroidデバイスを接続するを参照してください。
-
マイトンネルでデバイスを選ぶ #
トンネルを作成するときは、デバイストークンでこのトークンを選びます。全体の流れはクイックスタートで説明しています。
トークン一覧 #
あなたのトークンには、現在作業しているアカウントのすべてのトークンが表示されます。トークンを検索で名前またはトークンで絞り込み、更新で一覧を再読み込みします。画面が狭い場合、一部の列は各行の詳細ボタンの中に移動します。
| 列 | 表示内容 | できること |
|---|---|---|
| 名前 | トークンに付けた名前。 | 名前を選択すると、トークンの名前を変更できます。新しい名前のルールが適用されます。 |
| ステータス | オンラインは、Localtonetアプリが接続されていることを示します。オフラインは、トンネルの設定が残っていても、デバイスが切断されていることを示します。 | |
| トークン | 途中の部分が隠されたトークン。 | 選択すると、完全なトークンがコピーされます。QRボタンでデバイスを接続が開きます。 |
| トンネル | このトークンに紐づく、アクティブなトンネル数 / トンネルの合計数。オンラインのデバイスに、アクティブなトンネルがあるとは限りません。 | |
| クライアント | 最後に報告されたアプリのバージョンと、アップデートの状態。 | 要アップデートのバッジはダウンロードページにリンクしているので、最新のLocaltonetアプリをインストールできます。この情報を更新するには、デバイスを接続してください。 |
| デバイス | デバイスが最後に報告したスレッド使用率、バッテリー残量、バッテリー温度。 | Androidデバイス向け:Androidデバイスの設定、対応している場合はSMS設定、そしてデバイスの操作ログ。プロキシマネージャーでは、デバイス群全体に対して同じ操作ができます。 |
| 操作 | IP履歴、トークン設定、トークンを削除。 |
IP履歴 #
IP履歴を開くと、トークンに記録されたパブリックIPアドレスが日付とともに一覧表示されます。一覧の上には4つのカウンターが表示されます:重複合計、重複IP合計、直近1時間の重複IP、直近1時間のIP合計。更新を選択すると、これらが更新されます。モバイルIPがローテーションするスマートフォンなど、IPが変わるデバイスで特に役立ちます。
トークン設定 #
トークン設定を開くと、完全なトークン、トークンをコピーボタン、QR / PINボタン、2つの設定を含むパネルが表示されます。
| 設定 | 動作 | 値 |
|---|---|---|
| USBデバイスモード | このトークンでUSBデバイスを接続する場合に使うモードです。そのデバイスはマイUSBデバイスで管理します。 | はいまたはいいえ。変更時には確認が表示されます。 |
| クライアント引数 | クライアントのオプションをトークンに保存します。管理を選択し、有効をオンにして、引数を入力します。Localtonetクライアントは、ここに保存された引数を適用しません。適用するのは、トンネルに設定された引数です。ネットワークインターフェースやローカルIPアドレスを選ぶには、トンネルごとに設定してください。 | 有効をオンにしている間は、フィールドを空にできません。ネットワーク選択を参照してください。 |
トークンを削除する #
トークンを削除を選択して確定します。ダッシュボードが先に警告を表示します。
このトークンのトンネルは停止され、削除されます。そのトークンをまだ使っているデバイスは、それ以降そのトークンで接続できません。再び必要になる場合は、そのデバイス用に新しいトークンを作成してください。
QRコードまたはPINでAndroidデバイスを接続する #
スマートフォンでトークンを入力する必要はありません。すべてのトークンにQRコードと短いPINがあります。
-
「デバイスを接続」を開く #
マイトークンで、トークンの横にあるQRボタンを選択します。デバイスを接続ダイアログが開きます。
-
コードをスキャンするかPINを入力する #
Android版Localtonetを開きます。QRコードをスキャンの下のコードをスキャンするか、代わりにPINを入力の下に表示された6桁のPINをアプリのログインフィールドに入力して、Connectを選択します。
- PINの有効期間は1分です。ダイアログがカウントダウンし、その後PINの有効期限が切れました。続行するには新しいPINを生成してください。と表示されます。
- PINは1回だけ使えます。別のデバイスで使う場合や、やり直す場合は新しいPINを生成を選択します。
- QRコードに有効期限はありません。トークンそのものが含まれているため、QRコードの写真もトークンと同様に扱ってください。
- トークンをアプリに貼り付けることもできます。ダイアログには、コピーボタン付きでトークンが表示されます。
トークングループ #
トークングループには、デバイストークンが含まれます。グループを使うと、デバイスをプールとして整理できます。ローテーティングプロキシは、選択したグループのデバイスを使い、トークンWebhookはグループに対して作成されます。
-
グループを作成する #
マイトークンでトークングループを展開し、グループ名を入力してグループを作成を選択します。名前は30文字以内で、スペースを含めることはできず、お使いのグループの中で一意である必要があります。
-
トークンを選ぶ #
トークングループを管理ダイアログが開き、すべてのトークンが一覧表示されます。グループに含めるデバイストークンにチェックを入れて、変更を保存を選択します。
後でグループを変更するには、その行の管理を選択します。このダイアログは長い一覧を想定して作られています。
- 名前で検索します。複数の名前はカンマで区切ります。
- デバイスのステータスで絞り込みます:すべてのステータス、オンライン、オフライン。
- すべて、グループ内、グループ外を切り替えます。
- すべて選択を使うと、表示されているすべてのトークンにチェックが入るので、除外したいものだけチェックを外します。Shiftを押しながらクリックすると範囲を選択できます。
- フッターには、変更される内容が表示されます(例:+3件を追加)。リセットを選択すると、変更が破棄されます。
グループからトークンを削除すると、そのグループを使っているローテーティングプロキシがそれらのデバイスで停止するため、ダイアログが確認を求めます。1回の保存で変更できるトークンは最大5000件です。
グループを削除を選択すると、グループとそのメンバーシップが削除されます。トークン自体は残ります。
トークンが使われる場所 #
| 場所 | トークンの使われ方 |
|---|---|
| トンネル作成フォーム | デバイストークンは、トンネルを提供するデバイスを選択します。既存のトンネルを別のデバイスに移すには、トンネルのAuthTokenを変更を使います。実行中のトンネルは停止し、2秒待ってから、選択したトークンで再起動します。 |
| ローテーティングプロキシ | 単一のトークンではなく、トークングループを使います。選択したグループ内の接続中のすべてのデバイスが、共有エンドポイントの出口になります。 |
| Webhook | トークンWebhookは、認証トークングループに対して設定します。 |
| VPNマネージャー | ネットワークにデバイスを追加するときは、そのデバイスでLocaltonetにログインするためのトークンを選択します。各デバイスには専用のトークンが必要です。 |
| デバイスターミナル | トークンは、マイデバイスでコンピューターをアカウントに紐づけます。 |
| USBデバイス | USBデバイスモードのトークンは、USBモデムやスマートフォンが接続されているコンピューターを接続します。 |
| プロキシマネージャー | すべてのAndroidスマートフォンは、それぞれ専用のトークンでログインします。 |
APIとMCPサーバーでも、トークンとトークングループの一覧表示、作成、削除ができます。
ダッシュボードでチームを選択している間は、マイトークンにそのチームのトークンが表示され、作成もそのチームに対して行われます。チーム管理を参照してください。
トラブルシューティング #
… という名前のトークンはすでに存在します
トークン名は一意である必要があります。別の名前を選ぶか、先に既存のトークンの名前を変更してください。
名前は30文字以内で入力してください。
トークン名またはグループ名を30文字以内に短くしてください。
トークンがオフラインと表示される
デバイスが切断されています。デバイスでLocaltonetアプリを開いて接続してください。同じトークンで別のデバイスを起動した場合は、その接続が置き換えられています。デバイスごとに別のトークンを作成してください。
クライアントに Wrong Token! と表示される
入力された値が完全なトークンではありません。マイトークンから完全なトークンをもう一度コピーしてください。一覧では途中の部分が隠れているため、表示されているテキストを選択するのではなく、コピーボタンを使ってください。
PINの有効期限が切れました
PINの有効期間は1分で、1回だけ使えます。新しいPINを生成を選択するか、代わりにQRコードをスキャンしてください。
QRコードとPINを読み込めません。
ダイアログで再試行を選択します。それでも失敗する場合は、トークンをコピーしてアプリに貼り付けてください。