APIトークンの管理、再生成、無効化

トークンタブには、アクセス権、制限、最終使用日時とともにAPIトークンの一覧が表示されます。このタブから、トークンのシークレットの再生成やトークンの無効化を行ったり、トークンが機能しなくなった理由を確認したりできます。

トークンの確認場所#

ワークスペースメニューを開き、AIエージェントとAPIを選択します。トークンタブが最初のタブとして表示されます。各タブには件数が表示されます。

トークンの閲覧権限について：

各行には、名前（シークレットの末尾の文字、例：clv_agent_…k7Qe）、オーナー、アクセス（権限）、対象のサイト、作成日時、最終使用日時、有効期限が表示されます。フッターには、ワークスペースの制限に対するアクティブなトークンの数が表示されます。行に表示されるバッジ：

無効化済みおよび期限切れのトークンはデフォルトで非表示になっています。**無効化済みと期限切れを表示 (件数)**をクリックすると一覧が表示されます。これらは30日間リストに残ります。

トークンのアクセス権の変更#

トークンの権限、サイト、有効期限、消費上限、IP許可リストは、作成後に編集することはできません。これらを変更するには、新しい設定で新しいトークンを作成し、エージェントを切り替えてから、古いトークンを無効化してください。

トークンのシークレットの再生成#

シークレットが漏洩した可能性がある場合や、スケジュールに従ってローテーションを行う場合に再生成してください。新しいシークレットは、同じ名前、アクセス権、サイト、IP許可リスト、消費上限、有効期限を引き継ぎます。

1. トークンのメニューを開く#

   トークンタブで、トークンの行にある**⋯**メニューを開き、シークレットを再生成を選択します。

2. 古いシークレットの停止時期を選択する#

   ダイアログで「“name”を再生成しますか？」と尋ねられます。「同じアクセス権を持つ新しいシークレットが発行されます。古いシークレットは機能しなくなります」。エージェントがまだ使用中で切り替えに時間が必要な場合は、古いシークレットを24時間有効に保つにチェックを入れてください。すぐに古いシークレットを停止する場合は、チェックを外したままにします。

3. 新しいシークレットをコピーする#

   再生成をクリックします。トークンを作成しましたダイアログに新しいシークレットが1回だけ表示されます。コピーしてエージェントやシークレットストアを更新し、保存しましたをクリックします。

再生成のルール：

• トークンを作成した本人のみが再生成できます。 作成者ではないオーナーや管理者が操作しようとすると、「このトークンを作成した本人のみが再生成できます。無効化は可能です。」と表示されます。
• シークレットは1回のみ再生成可能です。 その後、古い行には「再生成されたシークレットに置き換えられました」と表示され、シークレットを再生成オプションはなくなります。代わりに新しいトークンを再生成してください。古いシークレットで再度実行しようとすると、「このトークンはすでに再生成、無効化、または期限切れです。置き換えられたトークンを使用するか、新しく作成してください。」と表示されます。
• 有効期限は変更されません。 90日用に作成されたトークンは、元の期限日に期限切れとなります。古いシークレットの24時間の重複期間がその期限日を過ぎる場合は、期限日で停止します。
• ワークスペースがアクティブトークンの上限に達していても再生成は可能です。24時間の重複期間中は両方のシークレットが機能し、両方ともアクティブなトークンとしてカウントされます。
• 再生成にはワークスペースがProプラン以上である必要があります。それ以外の場合は、シークレットを再生成をクリックするとアップグレードダイアログが開きます。

トークンの無効化#

1. トークンの行にある**⋯**メニューを開き、無効化を選択します。
2. トークンを無効化で確認します。「このトークンを使用しているエージェントは直ちにアクセス権を失います。この操作は取り消せません。」

無効化されたトークンは、ワークスペースのアクティブトークン制限枠を直ちに解放します。

有効期限#

すべてのトークンには有効期限があります。作成時に7日、30日、90日（デフォルト）、1年のいずれかの期間を選択します。「無期限」というオプションはないため、放置されたトークンが永遠に有効になることはありません。有効期限列に日付が表示されます。

有効期限を過ぎると、すべての呼び出しで「このトークンは期限切れです。統合 → AIエージェントとAPIで新しく作成してください。」と返されます。期限切れのトークンを更新または再生成することはできません。新しく作成してください。

IP許可リスト#

トークンは、エージェントが実行されるアドレス（CIランナーやサーバーなど）に制限できます。これはウィザードの制限ステップにある詳細設定 → IP許可リストで設定します。「任意。1行につき1つのアドレスまたは範囲を指定します。それ以外からの呼び出しは拒否されます。」

• IPv4またはIPv6アドレス（203.0.113.7）またはCIDR形式の範囲（198.51.100.0/24）を最大20件まで入力します。
• 空白のままにすると、すべてのアドレスが許可されます。その場合、確認ステップではすべてのアドレスと表示されます。
• 他のアドレスからの呼び出しは「このトークンはこのIPアドレスからは使用できません。」と返されます。
• アドレスや範囲ではない入力は拒否されます：「valueはIPアドレスまたは範囲ではありません。」

トークンが機能しなくなった理由#

異常なアクティビティ#

Cleveraは各トークンのバーストを監視しており、ワークスペースオーナーに「tokenでの異常なアクティビティ」という通知を送信します：

• 数分間に多数の拒否されたリクエスト: トークンは無効化されます。「数分間に多数の拒否されたリクエストが発生しました。」
• 数分間に異常に多い変更: （10分間に200回以上の書き込み、または20回以上のページ削除）書き込みが10分間一時停止されます。呼び出しには「異常な変更のバーストにより、このトークンからの書き込みは一時停止されました。ワークスペースオーナーに通知されました。」と返されます。読み取りは引き続き可能です。
• クレジットの異常な高速消費: トークンは24時間、有料の作業を開始できなくなります。「数分間に異常に多くのクレジットを消費したため、現在有料の作業を開始できません。」

ワークスペースがProプランから外れた場合#

AIエージェントとAPIはPro、Business、Customプランに含まれています。ワークスペースがStarterまたはFreeプランに移行すると、ページには「AIエージェントとAPIはProプランに含まれています」と表示されます：「Claude、ChatGPT、およびスクリプトをこのワークスペースで動作させるにはアップグレードしてください。既存のトークンやアプリはそれまで機能しません。ここから無効化することは可能です。」

• トークンはリストに残り、無効化も可能ですが、すべての呼び出しはplan_lockedで拒否されます。
• シークレットを再生成をクリックするとアップグレードダイアログが開きます。
• Proプランにアップグレードし直すと、トークンは再び機能します。データは削除されず、トークンは元の期限日に期限切れとなります。

関連情報#