> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/ai-totsru/secrets-autotriage.md).
# Secrets AutoTriageのノイズ除去
Secrets AutoTriage は、シークレットスキャンのノイズを減らし、実際に危険な露出済みシークレットに集中できるようにします。まず誤検知を除外し、次に検出結果が本物である場合は、その露出したシークレットがどれほど危険かに基づいて順位付けします。
{% hint style="info" %}
Secrets AutoTriage は、コード内で Aikido が検出したシークレットに対して動作します。スキャン対象は変えず、検出結果の絞り込みと優先順位付けの方法だけを変えます。この機能は **Pro および Advanced プランでのみご利用いただけます**.
{% endhint %}
## Secrets AutoTriage を有効にする
Secrets AutoTriage は **デフォルトでは有効になっていません**。ワークスペース管理者のみが、ワークスペース設定から有効にできます。
{% stepper %}
{% step %}
### トリアージ設定を開く
移動先 **設定** → **トリアージ**.
{% endstep %}
{% step %}
### Secrets AutoTriage を有効にする
次の場所で **シークレットのノイズ削減**、 **Secrets AI トリアージ**。有効にすると、次回のスキャンで Aikido はシークレットの検出結果に AutoTriage を適用します。
{% endstep %}
{% endstepper %}
## Secrets AutoTriage とは何か（そして何ではないか）
Secrets AutoTriage 自体はスキャナーではありません。シークレットスキャンの下流で動作し、一致したものが ***実際の、露出したシークレット*** であるかどうか、そして該当する場合はその ***危険度*** を判断します。
ほとんどの検出結果について、Aikido は Aikido 定義のルールと有効性チェックに基づいてトリアージします。より曖昧なケースでは、Aikido は周囲のコードコンテキストを使って、その一致が本物のシークレットなのか、それともプレースホルダー、例、またはテスト値なのかを判断します。
## Secrets AutoTriage の仕組み
### トリアージ前の偽陽性フィルタリング
シークレットがフィードに届く前に、Aikido はシークレットのように見えても実際にはそうではない一致を除外します。これには次が含まれる場合があります。
* テストファイル、モックデータ、サンプル設定をスキップする
* 実際のシークレットと同じ形式を持つプレースホルダー値やサンプル値を認識する
* ワークスペースの [Secret Keyword Filter](/docs/docs-ja/kdosukyan/scanning-practices/denoise-via-secret-keyword-filter.md) を適用して、既知の安全なキーワードを含む行を除外する
* を尊重する [コードコメントの除外設定](/docs/docs-ja/kdosukyan/scanning-practices/ignoring-secrets-via-code-comments.md) および [`.aikido` ファイルの除外設定](/docs/docs-ja/kdosukyan/scanning-practices/ignore-via-code-with-aikido-files.md)
これらの手順だけでも、シークレットアラートのかなりの割合を抑制できます。
{% hint style="warning" %}
一見すると本物らしいシークレットの中には、パターンだけでは本物と区別できないものがあります。判断が難しい場合、Aikido は実際の露出を隠してしまうよりも、結果を保持して確認できるようにします。
{% endhint %}
### 有効性と権限のチェック
一致したものが本物のシークレットのように見える場合、Aikido の [Live Secret Detection](/docs/docs-ja/kdosukyan/scanning-practices/live-secret-detection.md) が、そのシークレットがまだ有効かどうかを検証し、付与するアクセス範囲を調べます。AutoTriage はこれらのシグナルを使って優先度を調整します。
* **期限切れまたはローテーション済みのシークレット** は、もはやリスクをもたないため優先度が下がります
* **読み取り専用のスコープ** は、書き込みまたは削除アクセスよりも優先度が低くなります
* **書き込み/削除スコープを持つ有効なシークレット** は、直ちに対応すべきものとして優先度が上がります
### Secrets AutoTriage が考慮するシグナル
Secrets AutoTriage は **文脈を強く必要とする** という設計です。実際には、次のようなものを考慮します：
* 一致したものが有効か、期限切れか、すでにローテーション済みか
* 有効なシークレットが付与する権限の範囲
* そのファイルがテスト、モック、サンプル、またはドキュメント用のファイルであるか、あるいは本番コードであるか
* 値が実際の認証情報ではなく、プレースホルダーまたは例であるか
* シークレットで解放されるシステムの機密性
## 分析履歴を確認する
すべての AutoTriage の判定変更は記録されるため、Aikido が何を分析し、何を行ったかを確認できます。 [トリアージ設定](https://app.aikido.dev/settings/advanced)、次を開きます： **管理** ドロップダウンで、 **履歴を表示** へ移動するには [**Secrets トリアージ履歴**](https://app.aikido.dev/settings/advanced/secrets-triage-history) ページ。
履歴テーブルでは、関連する評価をファイル、リポジトリ、時間ごとにグループ化します。各行には、日付、ファイルパス、リポジトリ、分析されたシークレット数、および実行されたトリアージアクションの概要が表示されます。検索とリポジトリのフィルターを使って一覧を絞り込めます。
表示されるアクション：
* **アップグレード済み**：シークレットがより悪用されやすい、またはリスクが高いように見えるため、優先度が上がった
* **優先度を下げた**：シークレットがあまり危険ではないように見えるため、優先度が下がった（たとえば、プレースホルダー、テスト値、または影響の小さいスコープ）
* **自動的に無視された**：誤検知としてフィードから削除された検出結果
* **中立**：優先度を変更せずに評価が実行された
## トリアージ済みシークレットの解決
シークレットが実際の露出であると確認されたら、できるだけ早くローテーションしてください。git 履歴に残るため、コードからシークレットを削除するだけでは不十分です。露出したシークレットのクリーンアップとローテーションの手順については、 [マルウェアと漏えいしたシークレットの問題を解決する](/docs/docs-ja/hajimeni/core-functionalities/resolving-malware-and-leaked-secret-issues.md).
AutoTriage が誤検知だと思うものを指摘した場合は、 [UI で問題を無視する](/docs/docs-ja/hajimeni/core-functionalities/ignore-issues-to-remove-issues-from-main-feed.md), [コードコメントで無視する](/docs/docs-ja/kdosukyan/scanning-practices/ignoring-secrets-via-code-comments.md)、またはワークスペース全体に適用される [Secret Keyword Filter](/docs/docs-ja/kdosukyan/scanning-practices/denoise-via-secret-keyword-filter.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.aikido.dev/docs/docs-ja/ai-totsru/secrets-autotriage.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.