> 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/kdosukyan/scanning-practices/denoise-via-secret-keyword-filter.md).
# シークレットキーワードフィルターによるノイズ除去
Secret Keyword Filter は、シークレットスキャンのノイズを減らします。ワークスペース管理者は、gitleaks が評価する前に、既知の安全なキーワードを含む行をスキップできます。
{% hint style="warning" %}
このフィルターは **行全体** をシークレットスキャンから除外します。慎重に使用してください。広すぎるキーワードは、該当する行上の本当のシークレットを隠してしまう可能性があります。
{% endhint %}
### ユースケース
Secret Keyword Filter を使用するのは、次のような場合です：
* 同じ誤検知が複数のファイルやリポジトリにまたがって発生している
* トリガーが、設定キーや変数名のような安定した文字列である
* 行ごとのコメントではなく、ワークスペース全体の設定にしたい
しないでください **しない** 一般的な許可リストの代わりとして使用しないでください。これは gitleaks の許可リストを補完するものであり、それに置き換わるものではありません。
### Secret Keyword Filter の追加方法
**ステップ 1.** 移動して **設定** → **Advanced** → **Secret Keyword フィルター** を開いて、［管理］をクリックします
**手順 2. キーワードを追加する** 入力フィールドに。複数追加できます。
**手順 3. 保存してスキャンを実行し、変更を適用します**
### 重要な注意事項
* **最小 5 文字：** それより短いキーワードは拒否されます
* **大文字と小文字を区別：** `MySecret` に、 `mysecret` は別のキーワードです
* **次回のスキャンのみ：** 保存した変更は、今後のスキャンにのみ適用されます
### 一致の仕組み
このフィルターは **単純な文字列一致**を使用します。これは **しない** 正規表現フィルターではありません。
設定したキーワードが行のどこかに現れると、その行全体がシークレット検出から除外されます。
例:
```javascript
const EXAMPLE_TOKEN = process.env.EXAMPLE_TOKEN;
const apiKey = "sk_live_123456";
```
もし `EXAMPLE_TOKEN` がキーワードリストにある場合、最初の行はスキップされます。2 行目は引き続きスキャンされます。
もし 1 行目にも実際のシークレットが含まれていた場合、そのシークレットもスキップされます。このフィルターはトークン単位ではなく、行単位で動作します。
### ベストプラクティス
* 一般的な用語ではなく、具体的なキーワードを使う
* 設定キーや変数名のような安定した識別子を優先する
* 必要に応じて、複数の大文字小文字のバリエーションを追加する
* 保存する前に、マッチ結果を慎重に確認する
* 変更後は再スキャンし、実際の問題を隠さずにノイズが減っていることを確認する
適した候補：
* `EXAMPLE_SENDGRID_KEY`
* `dummyStripeSecret`
* `integration_test_token`
不向きな候補：
* `token`
* `secret`
* `auth`
### 代替の抑制方法
Secret Keyword Filter を使うのは **繰り返し発生する、ワークスペース全体の誤検知**.
使用 [コードコメント](/docs/docs-ja/kdosukyan/scanning-practices/ignoring-secrets-via-code-comments.md) 〜を抑制したいとき **既知の安全な 1 行** をコード内で。
使用 [.aikido ファイルの除外](/docs/docs-ja/kdosukyan/scanning-practices/ignore-via-code-with-aikido-files.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/kdosukyan/scanning-practices/denoise-via-secret-keyword-filter.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.