sk-tok-…）はクライアントがモデルを呼び出すためのものです。自動化トークン（at-tok-…）はプログラムがワークスペースを管理するためのもので、モデルを呼び出すことはできません。この二つが交差することはありません。
自動化トークンは自分のワークスペースにのみ作用します。パスワードやメールアドレスの変更、API キーの表示や共有、コネクタのトークンのローテーション、保存されたプロンプトの読み取り、リクエストログの変更、他の自動化トークンの作成はできません。これらの操作は、サインインしたコンソールセッションからのみ実行できます。
トークンを作成する
ワークスペースの管理者のみが自動化トークンの作成、一覧表示、取り消しを行えます。1
Settings を開く
コンソールで Settings を開き、Automation tokens までスクロールします。Create token をクリックします。
2
保持するものにちなんで名前を付ける
トークン一覧とそれが作成する行で認識できる名前を付けてください。たとえば
claude-code on my laptop や ci-deploy です。3
プリセットを選ぶかスコープを選択する
Setup は、コネクタをインストールしてモデルを呼び出せるようにするエージェントに適したプリセットです。Read-only はモニタリングに向いています。Full はすべてのスコープを付与します。その他の場合は個別にスコープをチェックしてください。下のスコープを参照してください。
4
有効期限を選ぶ
すべてのトークンには有効期限があります。一度限りのセットアップ実行には 1 時間を選び、常時ジョブにはより長い期間を選びます。最大は 1 年です。
5
トークンを一度だけコピーする
トークンは一度だけ表示されます。プログラムのシークレットストアまたはシェル変数にコピーしてください。紛失した場合は、一覧から Regenerate できます。古い値は直ちに機能しなくなります。
スコープ
スコープはresource:verb です。write スコープには対応する read が含まれます。どのスコープにも keys:rotate と models:reroute は含まれません。
トークンのスコープ外の呼び出しは
403 を返し、不足しているスコープがエラーに名前付きで表示されるため、プログラムがどの権限が不足しているかを正確に伝えられます。
トークンを使用する
Bearer トークンとして API ホストではなくコンソールホストに送信します。すべての管理呼び出しはhttps://tokios.com/account/ 配下に存在します。
- macOS & Linux
- Windows CMD
完全な呼び出し一覧と無人セットアップが呼び出す順序については、コーディングエージェントに Tokios をセットアップしてもらう を参照してください。
エージェントに渡す
トークンを Setup プリセット、1 時間の有効期限で作成し、モデルを実行しているマシンでエージェントを起動して、次のプロンプトを送信します。TOKIOS_TOKEN を設定し、会話にシークレットが現れないようにします。ガイドページにエージェントが必要とするすべての情報が記載されています。
トークンを管理する
コンソールの Settings の各行に、トークンのスコープ、フィンガープリント、有効期限、最後に使用された日時と IP アドレスが表示されます。- Regenerate はシークレットを置き換えます。古い値は直ちに機能しなくなり、新しい値は一度だけ表示されます。
- Revoke はトークンを永久に停止します。置き換えるには新しいトークンを作成してください。
- Delete は取り消し済みまたは有効期限切れのトークンを一覧から削除します。
トークンを安全に保つ
- スコープは最小限に絞ってください。 作業を終えた Setup トークンは保持せず、取り消しすべきです。
- 有効期限は短くしてください。 インタラクティブなエージェントセッションには 1 時間を使用します。長い有効期限はシークレットストア内の常時ジョブのみに使用します。
- トランスクリプトに残さないでください。 シェル変数から読み取らせ、エージェントとのチャットに貼り付けないでください。
- バッジと最終使用の列を確認してください。 知らないアドレスからトークンが使用された場合は、取り消してください。
- 発行されたキーが何を意味するかを理解してください。
keys:writeを持つトークンは API キーを作成でき、そのキーはトークンの有効期限が切れた後も機能し続けます。1 時間の Setup トークンを盗んだ人は、有効期限のないキーを発行して気づかれるまでモデルを呼び出せます。エージェントの実行後は、Keys タブを開き、via token とマークされた行を探し、予期しないものを取り消してください。 - 必要なときだけ
models:rerouteを付与してください。 既存のモデルを移動、名前変更、または削除すると、そのトラフィックを受け取るマシンが変わります。コネクタのペアリングもできるトークンは、保持者が管理するマシンをペアリングし、そこへモデルを移動できます。Setup では決して必要ありません。Setup はモデルを作成しますが、移動はしません。 - 共有アドレスではロックアウトも共有されます。 同じ IP アドレスからトークンの試行に 8 回失敗すると、そのアドレスからのすべてのトークンが、有効なものも含めて
429で 6 分間拒否されます。同じオフィスネットワーク、NAT ゲートウェイ、または CI ランナープールの背後にあるエージェントは、そのロックアウトを共有します。あるクライアントが無効なトークンを送り続ける場合は、ループで再試行させずに、停止するか修正してください。
エージェントによるセットアップ
Setup トークンを使ってエージェントが実行する手順。
API キー
クライアントがモデルを呼び出すために使用するキー。