キーマスキングと安全な表示

画面から読み取れる資格情報は、漏らせる資格情報です。新しいキーをコピーしたら、その平文を 再び必要とすることはほとんどありません — 認識する必要があるだけです：これはどのキーか、 どの環境か、失敗しているエージェントが使っているものか。OrcaRouter のコンソールは、機能する シークレットを再印刷することなくそれに答えます：すべてのキーは、それを識別するのにちょうど 十分な文字を保ち、残りを隠すマスクされた形式でレンダリングされます。 このページは、マスクされた形式がどう見えるか、平文がいつ表示されいつされないか、そして あなた自身のログとツールで安全に API キーをマスクする方法を扱います。

​

1. なぜ表示時に API キー値をマスクするのか

完全なキーはベアラー資格情報です：それを読む者は誰でも、そのキーの制限まで、あなたとして ゲートウェイを呼べます。コンソールビューは、スクリーンショット、画面共有、サポートチケット、 バグレポートに絶えずコピーされます — なのでキーのリストにライブシークレットを表示することは、 それらのひとつひとつを資格情報漏洩に変えてしまうでしょう。 マスキングは、通常混同される 2 つのニーズを分離することでこれを解決します：

• 識別 — これはどのキーか？ 一目で読める安定したマスクされたフィンガープリントが 答えます。
• 使用 — シークレットは何か？ 作成時に正確に一度、そしてその後は意図的な ロールゲートされた再表示の背後で答えられます。

コンソールは最初のニーズをあらゆる場所で満たし、2 番目をゲートするため、デフォルトの表面 — あなたが一日中眺めるキーリスト — は決して使用可能なシークレットを運びません。

​

2. マスクされた形式がどう見えるか

コンソールはキーのブランドプレフィックス、次に固定長のアスタリスク列、次に最後の 4 文字を 表示します — 2 つのキーを区別するのに十分で、どちらかを再構築するには不十分です。 最初のセグメントは sk-orca- プレフィックスと数文字の先頭文字を保ちます；最後の 4 文字は、 ログ行やエラーを相互参照するときに認識できる末尾です。その間のすべては固定マスクに 折りたたまれます — アスタリスク列は定数なので、その幅はキーの真の長さを決して明かしません。

​

3. 平文が表示されるとき — そしてされないとき

完全なキーをコピーできる瞬間はちょうど 1 つあり、それを再び取得する単一のゲートされたパスが あります。

​

4. ひとつの具体例：漏洩キーを識別する

アラートが発火したとしましょう — キーが予期しない IP から呼び出しを行っていて — ログ行は マスクされた末尾 …7Qm4 を運びます。行動するのに平文は必要ありません：

1. コンソールの Keys リスト（/console/token）を開きます。すべての行が、そのマスクされた フィンガープリント — sk-orca-9f3****7Qm4 — とその environment ラベルを表示します。
2. …7Qm4 の末尾（と prod タグ）を問題の行に照合します。マスクされた形式は、ここで必要な 識別子そのものです — リスト、アラート、あるいはあなたのそのスクリーンショットに、シークレットは 一切露出されません。
3. そのキーを無効化して一時停止するか、削除して完全に取り消します — どちらも平文を 決して印刷しないマスク安全なアクションです。キーを管理と 漏洩キー対応を参照。

トリアージ全体がマスクされたフィンガープリント上で実行されます。平文はそれが属する シークレットマネージャーに留まります。

​

5. あなた自身のログとツールでのマスキング

ゲートウェイは自身の表面をマスクします；あなたの側はあなたが制御します。同じ原則が、キーが あなたのスタックのどこに着地し得るかにも適用されます：

• Authorization ヘッダーや生の sk-orca-… 値を決してログしない。 どのキーが呼び出しを 行ったかを記録する必要がある場合、コンソールが使うのと同じ形 — プレフィックスと最後の 4 文字 — をログし、完全なシークレットではなく。
• 平文はシークレットマネージャーにのみ保存し、ソース管理、CI ログ、あるいはリポジトリに チェックインされた設定ファイルには決して保存しないでください。キーがコンソールでマスクされる のは、まさにあなた自身のシステムがライブシークレットが存在する唯一の場所であるようにするため です。
• キーを狭くスコープして、漏洩した資格情報でも被害範囲が境界づけられるようにしてください — 1 つのモデル、1 つの IP レンジ、1 つの支出上限。 最小権限チェックリストを参照。

​

6. これがキー衛生の残りにどうフィットするか

マスキングは、資格情報のための詳細な防御姿勢の 1 つの層です： キー、ポリシー、ワークスペースがどのように入れ子になって各エージェントに最も狭い アイデンティティを与えるかの全体像については、 スコープとキーを参照してください。 ルールはシンプルです：コンソールはキーを認識するのに十分なものを表示し、決して漏らすのに十分な ものは表示しません。平文をシークレットマネージャーに保ち、それ以外のあらゆる場所でマスクされた フィンガープリントに頼り、キーのアイデンティティが疑わしい瞬間にローテーションしてください。