> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/privileged-access-manager/secrets-scanner.md).

# シークレットスキャナ

漏えいした認証情報の検出、セキュリティ検出結果の確認、シークレットのKeeperボルトへの移行

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-1d0b131d4a90d9cf6e14ffe67a5cb0240edd33d6%2FKeeper%20-%20Secrets%20Scanner.jpg?alt=media" alt=""><figcaption></figcaption></figure>

Keeperシークレットスキャナは、ソースコード、リポジトリの履歴、構成ファイル、ローカル環境に残された認証情報を検出します。検出対象は、パスワード、APIキー、サービストークン、データベース接続文字列、秘密鍵ファイルなどです。検出結果を1件ずつ確認し、対応している認証情報については現在も有効かどうかを確かめたうえで、アプリを離れることなく認証情報をKeeperボルトに移せます。

デスクトップアプリでは、スキャン、確認、是正を1つのワークスペースで行えます。パスワード不要の管理者アクセスや危険なSSH設定など、ローカルのアクセス設定の一部も確認します。ターミナルでの作業やビルドパイプラインには、コンソール、JSON、CSV、SARIFの形式で検出結果を出力するコマンドラインスキャナーを利用できます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-ffd3863c463170ea1168ac845a79836b4daff29a%2Fworkspace-full.jpg?alt=media" alt="左側にプロジェクト、中央に検出結果、右側に選択中の検出結果が表示されたKeeperシークレットスキャナのワークスペース"><figcaption><p>メインのワークスペース。プロジェクトまたはスキャン対象を選択して検出結果を確認し、アクションを選びます。</p></figcaption></figure>

{% hint style="success" %}
Keeperにサインインしなくてもスキャンできます。検出した認証情報をボルトに保存する際に、Keeperアカウントを接続してください。GitHub、Jira、クラウドAIの機能には、それぞれの接続が必要です。
{% endhint %}

### Keeperシークレットスキャナの利用場面 <a href="#when-to-use-keeper-secrets-scanner" id="when-to-use-keeper-secrets-scanner"></a>

Keeperシークレットスキャナは、共有前のリポジトリの確認、開発者のワークステーションの構成ファイルに残った認証情報の確認、情報漏えい後の過去のコミットの再確認にご利用いただけます。セキュリティチームは、関連するリポジトリやフォルダをプロジェクトにまとめ、検出結果の優先度を付けて、フォローアップ用のJiraチケットを作成できます。開発者は、ビルドパイプラインやpre-commitのワークフローにスキャンを組み込み、検出結果をデスクトップアプリに取り込んで確認できます。

検出される認証情報の多くは、人ではなく、アプリケーション、スクリプト、サービスのものです。これらの認証情報を見つけることで、コードや構成ファイルに埋め込まずにKeeperで保管・管理すべきシークレットを特定できます。

以下のスクリーンショットは、サンプルのプロジェクトと検出結果を使用しています。アカウント情報とサインイン用トークンは伏せてあります。

### 事前準備 <a href="#before-you-begin" id="before-you-begin"></a>

* お使いのOS向けのKeeperシークレットスキャナデスクトップアプリをインストールします。デスクトップアプリは、macOS、Windows、Linuxに対応しています。
* スキャンするのは、検査する権限のあるファイル、リポジトリ、環境のみにしてください。OSのアカウントに、選択したファイルの読み取り権限が必要です。
* GitHubリポジトリをスキャンするには、GitHub CLIをインストールし、**\[Settings] > \[Integrations]** からサインインします。リポジトリの選択画面には、そのGitHubアカウントでアクセスできるリポジトリが表示されます。
* Keeperに認証情報を保存するには、保存先のフォルダにレコードを作成する権限を持つKeeperアカウントが必要です。
* AI支援を利用するには、**\[Local (on-device)]** を選択するか、**\[Settings] > \[AI]** で承認済みのプロバイダを構成します。

### アプリのロック解除 <a href="#unlock-the-app" id="unlock-the-app"></a>

初回起動時は、**\[Get started]** を選択してアプリをセットアップします。2回目以降の起動では、保存した検出結果と連携用の認証情報にアクセスするため、アプリのロックを解除します。

対応するMacでは、ロック画面に **\[Unlock with Touch ID]** が表示されます。OSの画面の指示に従ってください。利用できる場合は、デバイスのパスコードも使用できます。その他のシステムでは、アプリに表示されるロック解除の方法を使用します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-a5026fdc004a66c90bc34aa7eb8614fa48876ce7%2Funlock-full.jpg?alt=media" alt="Unlock with Touch IDボタンが表示されたKeeperシークレットスキャナのロック画面"><figcaption><p>ロック画面により、スキャンの検出結果と連携用の認証情報へのアクセスが保護されます。</p></figcaption></figure>

アプリのロックとKeeperからのサインアウトは、別の操作です。席を離れるときは、アプリをロックしてください。Keeperアカウントの接続を解除する場合は、**\[Log out]** を使用します。

### Keeperアカウントの接続 <a href="#connect-your-keeper-account" id="connect-your-keeper-account"></a>

サインイン時に **\[Skip for now]** を選択して、スキャンを続けることもできます。後から接続するには、ワークスペースの左下にあるKeeper接続用のコントロールを使用するか、**\[Settings] > \[Keeper Vault]** を開きます。

Keeperのメールアドレスを入力し、アカウントのリージョンを選択して **\[Continue]** を選択します。アカウントに応じたプロンプトを完了します。マスターパスワード、二要素認証、セキュリティキー、デバイス承認などが求められる場合があります。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-e6101d27bbe7b0d58a74df844787f43dd91a04fd%2Fkeeper-sign-in-full.jpg?alt=media" alt="メールアドレス、リージョン、Continue、Skip for nowのコントロールが表示されたKeeperボルトの接続画面"><figcaption><p>検出した認証情報を保存する準備ができたら、Keeperにサインインします。</p></figcaption></figure>

#### シングルサインオン <a href="#single-sign-on" id="single-sign-on"></a>

組織でSSOを使用している場合は、ブラウザでサインインを完了します。プロンプトが表示されたら、確認ページに表示されるトークンをコピーして **\[Token from browser]** に貼り付け、**\[Complete sign-in]** を選択します。ブラウザでの手順に戻る必要がある場合は、**\[Reopen SSO sign-in page]** を使用します。組織で必要な追加の承認があれば、それも完了してください。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-e0c59e7e2959ddc6ba0920f2ec247b8dda8c4231%2Fkeeper-sso-full.jpg?alt=media" alt="ブラウザのトークンを伏せた状態のKeeper SSOサインイン画面。Complete sign-inボタンが表示されている"><figcaption><p>SSOのブラウザでの手順を完了してから、アプリに戻ります。</p></figcaption></figure>

### プロジェクトの作成 <a href="#create-a-project" id="create-a-project"></a>

プロジェクトは、まとめて確認したいスキャン対象をグループ化したものです。たとえば、1つのアプリケーションのリポジトリ、ローカルフォルダのセット、ワークステーションのアクセスチェックなどをまとめられます。

**\[New project]** を選択し、名前を入力して、最初に追加するスキャン対象を選択します。**\[Create the project without a target for now]** を選択して、スキャン対象を後から追加することもできます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-9135c9380892a9aa171db09c885435ee208274bb%2Fnew-project-full.jpg?alt=media" alt="プロジェクト名のフィールドと、最初に選択できるスキャン対象が表示された新規プロジェクトのダイアログ"><figcaption><p>プロジェクトに名前を付け、スキャンを開始する対象を選択します。</p></figcaption></figure>

#### スキャン対象の追加 <a href="#add-scan-targets" id="add-scan-targets"></a>

プロジェクトの横にある **+** を選択するか、空のプロジェクトで **\[Add scan target]** を選択します。1つのプロジェクトに、複数の、種類の異なるスキャン対象を追加できます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-70dae76f540809c50ff3ebdb9ed2e74495a8ec40%2Fadd-target-full.jpg?alt=media" alt="フォルダ、GitHubリポジトリ、環境変数、一般的な場所、ローカルのアクセスチェックが一覧表示されたスキャン対象の追加ダイアログ"><figcaption><p>別のプロジェクトを作成せずに、スキャン対象を追加できます。</p></figcaption></figure>

| スキャン対象                | 確認する内容                                                  | 主な用途                                       |
| --------------------- | ------------------------------------------------------- | ------------------------------------------ |
| Folder                | ローカルディレクトリ内の読み取り可能なテキストファイル (Gitリポジトリのルートを選択した場合は履歴も含む) | アプリケーションのコード、スクリプト、構成ファイルの確認               |
| GitHub repositories   | 接続したGitHubアカウントでアクセスできるリポジトリ                            | ローカルにクローンを用意せずに、1つまたは複数のリポジトリを確認           |
| Environment variables | 実行中のスキャナープロセスで利用できる環境変数                                 | ローカルのアプリケーションやシェルセッションに渡された認証情報の確認         |
| Common locations      | ホームディレクトリ配下の一般的な認証情報の保存場所 (AWSの構成、SSHファイル、クラウドCLIの設定など) | アプリケーションのリポジトリ外に保存された認証情報の確認               |
| sudoers               | 選択したsudoersの構成ファイルとドロップインファイル                           | パスワード不要のroot権限や、意図より広いアクセスを与えかねないコマンド許可の特定 |
| PAM access.conf       | ローカルログインのアクセスルール                                        | 後続のより厳格なルールを上書きする包括的なルールの特定                |
| Local privilege       | ローカルユーザーとグループのメンバーシップ                                   | 管理者またはroot相当のアクセス権や、root権限を持つ追加アカウントの確認    |
| sshd\_config          | SSHサーバーの構成                                              | rootの直接パスワードログイン、およびユーザーまたはグループの制限がないことの確認 |

ローカルのアクセスチェックは、OS、存在する構成ファイル、読み取り権限によって結果が異なります。構成に関する検出結果は設定の見直しが必要という意味であり、ボルトに移せる、取得済みのシークレットとは限りません。

#### GitHubリポジトリの選択 <a href="#choose-github-repositories" id="choose-github-repositories"></a>

**\[GitHub repositories]** を選択すると、リポジトリの選択画面が開きます。自分のアカウントまたは組織を選び、リポジトリ名で検索して、追加するリポジトリを選択します。複数のリポジトリを同時に選択できます。選択画面には、リポジトリのサイズと、プライベートかアーカイブ済みかが表示されます。

スキャン対象としてGitHubを選択できない場合は、**\[Settings] > \[Integrations]** で、GitHub CLIのインストールとサインインの状況を確認してください。プライベートリポジトリには、接続したアカウントの権限が必要です。GitHubが組織に求める承認も必要になる場合があります。

#### ローカルのスキャン範囲の選び方 <a href="#choose-the-right-local-scope" id="choose-the-right-local-scope"></a>

Gitの履歴も対象にする場合は、リポジトリのルートを選択します。サブフォルダを選択すると、そのフォルダの現在のファイルがスキャンされ、リポジトリ全体の履歴は対象になりません。

Environment variablesは、スキャナーが引き継いだ環境を確認するもので、コンピューター上で実行中のすべてのプロセスを確認するものではありません。デスクトップから起動したアプリと、ターミナルから起動したアプリでは、環境が異なる場合があります。

### スキャンの実行と進捗の確認 <a href="#run-a-scan-and-monitor-progress" id="run-a-scan-and-monitor-progress"></a>

個々のスキャン対象の横にある **\[scan]** を選択すると、そのスキャン対象をスキャンします。現在のプロジェクトのすべてのスキャン対象をスキャンするには、**\[Scan all]** を選択します。Active Scansパネルには、各スキャン対象の最新のステータスが表示されます。ステータスは、待機中 (queued)、クローン中 (cloning)、スキャン中 (scanning)、検証中 (verifying)、完了 (done)、失敗 (failed)、キャンセル済み (canceled) のいずれかです。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-5a14f7478cbd0f5233f0185996b0a8fb254832d7%2Factive-scans-full.jpg?alt=media" alt="完了したローカル権限のスキャンと、Active ScansおよびActivityのタブが表示されたActive Scansパネル"><figcaption><p>スキャン対象ごとの進捗を確認し、完了したスキャンをActive Scansパネルから開きます。</p></figcaption></figure>

待機中または実行中のスキャンを停止するには、**\[cancel]** を使用します。完了したエントリを選択すると、その検出結果が開きます。Clear finishedはこのパネルから完了したエントリを削除するもので、保存済みのスキャンデータの削除とは異なります。

**\[Activity]** タブを開くと、Keeperへの認証情報の移行、ソースからの削除、削除の取り消しなど、記録された是正アクションを確認できます。

### ワークスペースでの検出結果の確認 <a href="#review-findings-in-the-workspace" id="review-findings-in-the-workspace"></a>

ワークスペースは、主に3つのエリアで構成されます。

* 左側のプロジェクトツリーには、プロジェクト、スキャン対象の種類、個々のスキャン対象が整理されて表示されます。**\[Find a target]** で項目を検索できます。
* 中央の検出結果リストには、選択したプロジェクトまたはスキャン対象の結果が表示されます。プロジェクトを選択するとスキャン済みの全スキャン対象の検出結果が、個別のスキャン対象を選択するとその検出結果のみが表示されます。
* 右側の詳細パネルには、選択した検出結果の場所、補足情報、利用できるアクションが表示されます。

**\[Severity]** と **\[Status]** で一覧を絞り込めます。検索では、検出結果のタイトル、ファイル、シークレットの種類、値、タグが対象になります。アクセス情報がある場合は、**\[Privilege]** フィルターで管理者、書き込み、読み取りのアクセスに絞り込めます。

重大度のラベルは、確認の優先度を判断する目安です。CriticalやHighの検出結果はすぐに対応すべきですが、変更する前に必ずコンテキストを確認してください。検出された値は、有効な認証情報の場合もあれば、テストデータやサンプルの場合もあります。構成に関する検出結果は、システムの実際の使われ方によって判断が変わることがあります。

#### 検出結果を開く <a href="#open-a-finding" id="open-a-finding"></a>

検出結果を選択すると、その説明と場所を確認できます。利用できる場合は、場所のリンクからGitHub上のファイルやコミットを開く、パスをコピーする、ローカルファイルをFinderまたはエクスプローラーで表示する、といった操作ができます。

**\[Source]** を展開すると、周辺のコードを確認できます。**\[Details]** を展開すると、検出された値とその他の検出結果の情報を確認できます。Detailsではシークレットの値がデフォルトでマスクされます。値の確認が必要なときだけ、表示切り替えのコントロールを使用してください。画面を共有する前には、再び非表示にしてください。

Gitの履歴に関する検出結果には、作成者、日付、コミットメッセージなどのコミット情報も表示されます。現在のファイルから削除されていても、認証情報が古いコミットに残り、漏えいしたままになっていることがあります。

#### レビューのステータスを記録する <a href="#track-review-status" id="track-review-status"></a>

**\[Labels]** のステータスコントロールで、検出結果のレビュー状況を記録します。

| ステータス          | 使い方                             |
| -------------- | ------------------------------- |
| New            | 検出結果をまだ確認していない状態                |
| Triaged        | 検出結果を確認し、背景を把握した状態              |
| To Fix         | フォローアップのアクションが必要な状態             |
| Fixed          | 必要な作業を完了し、確認した状態                |
| Won't Fix      | 内容を確認したうえで、変更しないと判断した状態         |
| False Positive | 検出された値やコンテキストが、報告されたリスクに該当しない状態 |

これらのラベルはレビューの判断を記録するものです。検出結果をFixedにしても、ファイルが変更されたり、認証情報が失効したりすることはありません。同様に、In Keeperは認証情報がボルトに保存されていることを示すものであり、すべてのコピーが削除されたことや、プロバイダ側で漏えいした値が失効したことを示すものではありません。

### 認証情報の有効性の確認 <a href="#check-credential-liveness" id="check-credential-liveness"></a>

対応している認証情報の種類では、Livenessセクションに、認証情報で認証できたかどうかが表示されます。確認に対応しているのは、AWSアクセスキー、Google Cloudのサービスアカウント認証情報、Azureのクライアントシークレット、Stripeキーです。すべての種類のシークレットで有効性を確認できるわけではなく、対応するキーやアカウントの詳細など、近くにある情報が必要な確認もあります。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-7cf26c93985a172430d783daa1d124a9c5f3e20f%2Fliveness-full.jpg?alt=media" alt="Livenessの結果例とRe-check livenessのコントロールが表示された検出結果の詳細"><figcaption><p>AWSの検出結果に対する有効性の結果の例です。</p></figcaption></figure>

| 結果                       | 意味                                                            |
| ------------------------ | ------------------------------------------------------------- |
| Live - key authenticates | 確認時に認証情報で認証できた状態。漏えいした値の確認と交換を優先                              |
| Dead - key rejected      | 確認時にプロバイダが認証情報を拒否した状態。認証情報がすでに使えなくなっていても、漏えいの状況を確認して取り除いてください |
| Inconclusive             | 必要なコンテキストや接続が利用できなかったなどの理由で、スキャナーが有効性を判定できなかった状態              |
| Not checked              | この検出結果では、有効性の結果がまだ利用できない状態                                    |

**\[Re-check liveness]** で、対応している結果を更新できます。AWSの検出結果では、**\[View in IAM Console]** でAWS IAMコンソールを開き、さらに確認できます。

{% hint style="info" %}
認証情報の検証では、該当するプロバイダに接続するため、ネットワークアクセスが必要です。結果がInconclusiveでも、認証情報が安全とは限りません。確認が成功しても、その時点で有効だったことが確認できるだけで、認証情報が一度も悪用されていないことの証明にはなりません。
{% endhint %}

#### ID関連の検出結果のグループ化 <a href="#group-identity-related-findings" id="group-identity-related-findings"></a>

結果にID関連の検出結果が含まれる場合、シールドのコントロールから **\[IAM Posture]** を開けます。この別ビューでは、既存の検出結果を、利用できるアクセスレベル、続いて関連するIDまたは場所ごとにグループ化します。グループを選択して展開し、検出結果を選択すると、同じ詳細パネルを使用できます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-b38338ee64dc2151a009cfe352fef3ccf5ca12d9%2Fiam-posture-full.jpg?alt=media" alt="AWS認証情報の既存の検出結果を、アクセスレベルUnknownとソースファイルでグループ化したIAM Postureビュー"><figcaption><p>別のスキャンを開始せずに、ID関連のスキャン結果をグループ化します。</p></figcaption></figure>

Unknownは、検出結果からアクセスレベルを特定できないことを示します。このビューは完了済みのスキャンの情報を整理したもので、クラウドアカウントやその権限の完全な一覧として扱わないでください。標準の一覧に戻るには、**\[Back to findings]** を選択します。

### 検出結果に対するアクションの実行 <a href="#take-action-on-a-finding" id="take-action-on-a-finding"></a>

検出結果の詳細パネルで **\[Take Action]** を選択します。実行するアクションを1つ以上選択し、**\[Execute]** を選択します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-601dcbab32eb9f226d0f2cec25a85cb2de895048%2Ftake-action-full.jpg?alt=media" alt="Move to Keeper、Also remove from source、Generate Remediationのオプションが表示されたTake Actionダイアログ"><figcaption><p>Executeを選択する前に、実行するアクションを選びます。</p></figcaption></figure>

#### 認証情報のKeeperボルトへの移行 <a href="#move-a-credential-to-keeper-vault" id="move-a-credential-to-keeper-vault"></a>

**\[Move to Keeper]** を選択すると、検出した認証情報がKeeperレコードとして保存されます。ボルトの接続を求められた場合は、サインインしてください。

アクションが成功すると、検出結果に **\[In Keeper]** と表示されます。**\[Open in Vault]** で関連するレコードを開き、内容を確認します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-562d9ae61df0580a9713457c1f3ba425fcd0180b%2Faction-complete-full.jpg?alt=media" alt="Move to KeeperとGenerate Remediationが完了し、Open in Vaultのリンクが表示された、完了後のTake Actionダイアログ"><figcaption><p>選択した各アクションの結果を確認し、保存されたKeeperレコードを開きます。</p></figcaption></figure>

新しいレコードの保存先は、**\[Settings] > \[Keeper Vault] > \[Secret records folder]** で選択できます。フォルダを選択して **\[Save]** を選択します。この保存先は検出した認証情報用であり、スキャン対象のファイルの場所ではありません。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-35fec42516e0a46f8c33b3dd35dd1a26ba549622%2Fvault-destination-full.jpg?alt=media" alt="フォルダセレクターとSaveボタンが表示されたSecret records folderの設定"><figcaption><p>Keeperに移行した認証情報の保存先を選択します。</p></figcaption></figure>

#### ローカルファイルからの認証情報の削除 <a href="#remove-a-credential-from-a-local-file" id="remove-a-credential-from-a-local-file"></a>

書き込み可能なローカルファイル内の取得済みシークレットをアプリが置き換えるようにするには、**\[Also remove from source]** を選択します。事前に、認証情報をKeeperに保存しておく必要があります。置き換え後は、元の値ではなく `KEEPER_REMOVED` というマーカーが入ります。

削除に対応している場合は、暗号化されたリカバリー用のコピーが保存され、**\[Undo]** でファイルを復元できます。復元すると元の認証情報が戻るため、復元したファイルは慎重に確認してください。

すべての検出結果を自動で削除できるわけではありません。履歴のみの検出結果、リモートでスキャンしたリポジトリのファイル、秘密鍵の検出結果、構成上の問題などは、手動での対応が必要な場合があります。値を削除できなかったとアプリが報告した場合は、アクションが完了したものとみなさず、表示された説明に従ってください。

{% hint style="warning" %}
認証情報をKeeperに保存しても、その認証情報が失効することも、Gitの履歴から削除されることも、アプリケーションがKeeperから認証情報を取得するよう更新されることもありません。ハードコードされた値を置き換えると、構成を更新するまでアプリケーションが停止する場合もあります。変更内容を確認し、漏えいした認証情報はプロバイダ側で交換または失効させ、影響を受けるアプリケーションをテストしてから、問題を修正済みにしてください。
{% endhint %}

#### 是正ガイダンスの生成 <a href="#generate-remediation-guidance" id="generate-remediation-guidance"></a>

**\[Generate Remediation]** を選択すると、選択した検出結果に対する是正ガイダンスが作成されます。結果は詳細パネルに表示され、リスクの説明、すぐに実施すべき対応、フォローアップの確認事項などが含まれます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-a05cb726afa6174acb250dc048f39f1330ad5173%2Fremediation-guidance-full.jpg?alt=media" alt="npmアクセストークンに対するAI生成の是正ガイダンス。Risk、Do Now、Do Soonのセクションがある"><figcaption><p>生成されたガイダンスを使って、修正を計画し、確認します。</p></figcaption></figure>

ガイダンスを生成しても、提案されたコマンドが実行されたり、影響を受けるシステムが変更されたりすることはありません。実施する前に、お使いの環境と組織の手順に照らして推奨内容を確認してください。

### 複数の検出結果への対応 <a href="#work-through-several-findings" id="work-through-several-findings"></a>

**\[Remediate All]** を選択すると、一括アクションのダイアログが開きます。対象の検出結果の件数が表示され、修正の計画、認証情報のKeeperへの移行、対象のローカルソースファイルからの値の削除を行うコントロールが用意されています。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-d2301ce3a4dd7c6a9a498e1b15c5d71ab25254a5%2Fbulk-remediation-full.jpg?alt=media" alt="個別の一括アクションとRun all stepsが表示されたRemediate all findingsダイアログ"><figcaption><p>対象範囲を確認したうえで、特定のアクションを一括で実行するか、Run all stepsを選択します。</p></figcaption></figure>

個別のステップを実行することも、**\[Run all steps]** を選択してすべて実行することもできます。ソースからの削除は、認証情報がKeeperに保存済みの対象の検出結果に対してのみ実行されます。構成に関する検出結果や自動削除できない値は、引き続き手動での確認が必要です。

一括操作の実行中に **\[Stop]** を使用すると、以降の処理が停止します。すでに完了したアクションは取り消されません。その後、更新された検出結果と **\[Activity]** パネルを確認してください。

### KeeperAIに検出結果について質問する <a href="#ask-keeperai-about-a-finding" id="ask-keeperai-about-a-finding"></a>

ワークスペースのKeeperAIのコントロールを選択すると、チャットパネルが開きます。検出結果を選択した状態で、説明、是正計画、リスク評価の支援を依頼できます。候補のプロンプトとして、**\[Explain this finding]**、**\[How do I fix this?]**、**\[What's the risk?]** が表示されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-11478b899d8814e4070dd12a305b5a695b7000ac%2Fkeeperai-full.jpg?alt=media" alt="選択中のnpmアクセストークンの検出結果と候補のプロンプトが表示されたKeeperAIのウェルカムパネル"><figcaption><p>選択した検出結果をコンテキストにして、会話を始めます。</p></figcaption></figure>

質問を入力して **\[Send]** を選択します。送信は **Enter**、改行は **Shift+Enter** です。**\[New]** を選択すると、新しい会話を始められます。パネルには、応答の停止や、会話をHTMLファイルとして保存するコントロールもあります。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-8c16fa067a6793c6396e807ffecaa3038fd0c4e5%2Fkeeperai-response-full.jpg?alt=media" alt="選択した検出結果を説明し、是正を提案するKeeperAIの応答"><figcaption><p>説明を確認し、検出結果の画面を離れずに追加の質問ができます。</p></figcaption></figure>

AIの応答はあくまでガイダンスであり、検出結果が本物であることや、修正が完了したことの証明ではありません。質問しただけで、チャットパネルが修正を実行することはありません。内容を確認したうえで、変更する場合は製品のアクションコントロールを使用してください。

#### 誤検知の可能性があるものの確認 <a href="#review-potential-false-positives" id="review-potential-false-positives"></a>

**\[Weed out the false positives]** のプロンプトを使うと、対象となる検出結果のAIレビューが始まります。**\[Run across all findings]** で対象範囲を確認します。テストデータ、プレースホルダー、ドキュメント内のサンプルと思われる検出結果は、False Positiveと判定されることがあります。

結果には、分析した検出結果の件数と、判定した件数がまとめて表示されます。**\[Status]** フィルターで判定された検出結果を見直し、同意できない分類は修正してください。このレビューで変わるのは検出結果のラベルのみです。ファイルが削除されたり、認証情報が失効したりすることはありません。

### AIプロバイダの選択 <a href="#choose-an-ai-provider" id="choose-an-ai-provider"></a>

**\[Settings] > \[AI]** を開いて、AI支援機能で使用するプロバイダを選択します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-3c04d40a00aa54e000a0fcdca01cb2c1b6fb0907%2Fsettings-ai-full.jpg?alt=media" alt="プロバイダとモデルの選択、保存済みの認証情報、保存済みのプロバイダ、Save &#x26; Activateが表示されたAI設定"><figcaption><p>お使いの環境で承認されたAIプロバイダを構成して有効にします。</p></figcaption></figure>

* Local (on-device)は、対応するモデルをお使いのコンピューター上で実行します。選択したモデルは初回の使用時にアプリがダウンロードします。ダウンロード後は、ローカルのAI処理でクラウドモデルへのリクエストは送信されません。**\[Add custom model]** を選択して、対応するローカルのモデルファイルを使用することもできます。
* クラウドの選択肢には、OpenAI、Anthropic、Google Gemini、Azure OpenAI、AWS Bedrock、Vertex AIがあります。Keeper AI Gatewayと互換性のあるエンドポイントにも対応しています。プロバイダに応じて求められる認証情報と接続の詳細を入力します。

クラウドプロバイダの場合は、モデルまたはデプロイを選択し、必要なフィールドを入力して **\[Save & Activate]** を選択します。複数のプロバイダ構成を保存し、保存済みのプロバイダを切り替えて使用できます。**\[Deactivate AI]** を選択すると、スキャンには影響せず、AI支援のみが無効になります。

**\[Take Action]** の横にあるモデルセレクターで、利用できるローカルモデルと保存済みのクラウドプロバイダをすばやく切り替えられます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-2dbcc5f0ae5360c8b6795540536d22b611c2a934%2Fmodel-switcher-full.jpg?alt=media" alt="Take Actionの横にあるモデルセレクターに、ローカルモデル1つと保存済みのクラウドプロバイダ1つが表示されている"><figcaption><p>検出結果の詳細パネルから、使用中のモデルを切り替えます。</p></figcaption></figure>

{% hint style="info" %}
AIプロバイダの認証情報は、OSの認証情報ストアに保存されます。クラウドプロバイダを使用する場合、プロンプトと検出結果のコンテキストは、構成したサービスに送信されます。アプリは、AIに渡す検出結果のコンテキストから、取得済みのシークレットの値を伏せますが、ユーザー自身のメッセージやその他のコンテキストに機密情報が含まれる場合があります。組織のAIポリシーに従い、チャットに認証情報を貼り付けないでください。
{% endhint %}

### GitHubとJiraの接続 <a href="#connect-github-and-jira" id="connect-github-and-jira"></a>

**\[Settings] > \[Integrations]** を開いて、GitHubとJiraの接続状況を確認します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-e747354ba0b6d360a28142a1ad3a70d633325e5c%2Fsettings-integrations-full.jpg?alt=media" alt="JiraとGitHubの接続状況が表示された連携設定。アカウントの詳細は伏せてある"><figcaption><p>リポジトリへのアクセスと課題管理に使用する接続を管理します。</p></figcaption></figure>

#### GitHub <a href="#github" id="github"></a>

GitHub CLIがインストールされていてもサインインしていない場合は、**\[Sign in]** を選択します。ワンタイムコードをコピーし、ブラウザのリンクを開いて、GitHubの認可フローを完了します。アプリに戻ってアカウントが接続されたことを確認し、プロジェクトにリポジトリを追加します。

#### Jiraチケット <a href="#jira-tickets" id="jira-tickets"></a>

Jiraの **\[Connect]** を選択し、ブラウザでの認可を完了します。接続の更新が必要な場合は **\[Reconnect]**、アプリから接続を削除する場合は **\[Disconnect]** を使用します。

チケットを作成するには、検出結果を開いて **\[Create Jira ticket]** を選択します。Jiraのプロジェクト、課題タイプ、優先度を選択し、概要と説明を確認してから **\[Create ticket]** を選択します。生成される説明には、シークレットを伏せた検出結果のコンテキストが含まれます。作成後は、検出結果からチケットへのリンクを開けます。

選択した課題タイプにアプリが入力できない必須フィールドがある場合は、別の課題タイプを選択するか、Jiraで直接課題を作成してください。チケットの作成はフォローアップ作業の記録であり、検出結果の是正にはなりません。また、検出結果のステータスがJiraと自動的に同期されることもありません。

### スキャンレポートの作成 <a href="#create-a-scan-report" id="create-a-scan-report"></a>

スキャン済みのプロジェクトまたはスキャン対象を選択し、ワークスペースのツールバーにあるグラフのコントロールから **\[Report]** を開きます。プロジェクトのレポートにはプロジェクトの検出結果がまとめられ、スキャン対象を選択した場合は、そのスキャン対象のスキャン結果のレポートが作成されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-0a4c3a2c68e3306c804d31685db1fc613afd0e3c%2Fscan-report-full.jpg?alt=media" alt="スライドの移動、WhiteとDarkのテーマ、Download PDFを備えたKeeperシークレットスキャナのレポートビューア"><figcaption><p>スキャンレポートを確認し、セキュリティレビューやチームへの報告用にエクスポートします。</p></figcaption></figure>

9枚のスライドで構成されるレポートには、以下の内容が含まれます。

* スキャンと一意の検出結果の概要
* 重大度と種類別の検出結果
* 検出結果が見つかったソースと場所
* ファイル、リポジトリ、完了済みスキャンなどのスキャン範囲 (利用できる場合)
* 時間経過に伴う検出結果の推移 (スキャン履歴がある場合)
* 優先して対処すべき場所と結果のまとめ

矢印または番号付きのスライドコントロールで移動します。レポートの外観は **\[White]** または **\[Dark]** から選択します。**\[Download PDF]** でレポートを保存し、**\[Back to scans]** で検出結果のワークスペースに戻ります。

レポートには、完了済みのスキャンデータが必要です。推移ビューで比較を表示するには、複数回のスキャンが必要です。レポートを共有する前に、レポートの範囲と、機密性のあるファイル名やプロジェクト名が含まれていないかを確認してください。

### 設定のカスタマイズ <a href="#customize-settings" id="customize-settings"></a>

ワークスペースの左上から **\[Settings]** を開きます。設定の検索で、セクションやオプションを探せます。

#### 全般 <a href="#general" id="general"></a>

**\[Light]** または **\[Dark]** を選択し、カラープリセットを選んで、**\[Zoom]** を調整します。これらの設定が変えるのはインターフェースの表示のみで、スキャン結果には影響しません。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-98a2cb39e520493ace6c58fea1a30b8576e71b25%2Fsettings-general-full.jpg?alt=media" alt="テーマ、カラープリセット、ズーム、是正の設定が表示された全般設定"><figcaption><p>ワークスペースの外観と、検出結果のレビューに関する設定を調整します。</p></figcaption></figure>

**\[Remove from source by default]** を有効にすると、**\[Take Action]** を開いたときに **\[Also remove from source]** があらかじめ選択されます。アクションを実行するまでは、何も削除されません。**\[Expand Source and Details by default]** を有効にすると、検出結果を選択したときに、これらのセクションが自動的に展開されます。

#### セキュリティ <a href="#security" id="security"></a>

**\[Auto-lock after inactivity]** で、アプリがロックされるタイミングを設定します。すぐにロックするには、このセクションの **\[Lock now]** か、ワークスペースの **\[Lock]** を使用します。このセクションには、お使いのデバイスで利用できるロック解除の方法も表示されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-d526247a04a52f97f72ff5cafc70dd89333d4d92%2Fsettings-security-full.jpg?alt=media" alt="ロック解除の方法、自動ロックのタイムアウト、Lock nowが表示されたセキュリティ設定"><figcaption><p>無操作のタイムアウトを設定し、席を離れるときはアプリをロックします。</p></figcaption></figure>

#### プロジェクト <a href="#projects" id="projects"></a>

**\[Settings] > \[Projects]** を開くと、プロジェクト名、スキャン対象の数、作成に関する詳細を確認できます。**\[Open]** を選択すると、プロジェクトを切り替えられます。プロジェクト名の変更は、サイドバーのツリーから行います。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-f264aa84e9de75f59d89b001ef78b20f716f36cb%2Fsettings-projects-full.jpg?alt=media" alt="各プロジェクトのスキャン対象数と、OpenおよびDeleteのコントロールが表示されたプロジェクト設定"><figcaption><p>既存のプロジェクトを設定から開いて管理します。</p></figcaption></figure>

Deleteを選択すると、プロジェクトの定義とスキャン対象が削除されます。保存済みのスキャン結果はディスクに残ります。これは、プロジェクトのアクションメニューにあるReset all scansとは異なります。Reset all scansは、そのプロジェクトのスキャンとレビューのラベルを削除します。どちらの操作も、確認メッセージをよく読み、残しておきたい内容をエクスポートしてから実行してください。

#### バージョン情報と検出範囲 <a href="#about-and-detection-coverage" id="about-and-detection-coverage"></a>

**\[Settings] > \[About]** を開くと、インストール済みのバージョンの確認、ドキュメントの表示、フィードバックの送信ができます。**\[What we scan for]** のカタログには、対応するシークレットの種類がカテゴリ別に一覧表示されます。フィルターで、AWS、データベース認証情報、秘密鍵など、プロバイダや種類を検索できます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-15545bfccfcbdc9668113124ec1e3ed34eda255b%2Fdetection-catalog-full.jpg?alt=media" alt="検索フィルターと展開可能なシークレットのカテゴリが表示されたWhat we scan forカタログ"><figcaption><p>インストール済みのアプリで、検出の対応範囲を確認できます。</p></figcaption></figure>

### コマンドラインスキャナーの使用 <a href="#use-the-command-line-scanner" id="use-the-command-line-scanner"></a>

コマンドラインスキャナーは、繰り返し実施するレビュー、ビルドパイプライン、pre-commitのチェックに便利です。ローカルのパス、リポジトリの履歴、環境変数、一般的な認証情報の保存場所をスキャンできます。SSH、証明書、アクセス構成のローカルチェックも実行できます。

以下の例では、macOSとWindowsでのコマンド名である `ss` を使用します。Linuxのパッケージインストールでは、システムのソケット統計ユーティリティとの名前の衝突を避けるため、`keeper-ss` を使用してください。

ローカルフォルダをスキャンするには、以下を実行します。

```bash
ss scan /path/to/project
```

リポジトリの履歴を含めて、パイプライン向けのSARIFレポートを出力するには、以下を実行します。しきい値を**high**にすると、HighまたはCriticalの検出結果が残っている場合に、コマンドは終了コード1を返します。

{% code overflow="wrap" %}

```bash
ss scan /path/to/repository --git-history --severity high --exit-code --output sarif > findings.sarif
```

{% endcode %}

通常のコンソールへの検出結果レポートを表示せず、デスクトップ通知を要求するには、以下を実行します。

```bash
ss scan /path/to/project --silent --notify
```

サイレントモードでも、ローカルの実行サマリーは保存されます。警告とエラーはターミナルに引き続き表示されます。通知が利用できる場合は、通知を開くとデスクトップアプリで実行内容を確認できます。実行サマリーで **\[Remediate in app]** を選択すると、アクセスできるローカルパスがアプリで再スキャンされ、通常の是正コントロールを使用できます。

JSON、CSV、SARIFの出力では、シークレットの値が伏せられます。ただし検出結果のメタデータは含まれるため、共有する前にファイルの内容を確認してください。pre-commitスキャナーは、ステージ済みの変更をチェックし、シークレットを検出するとコミットをブロックできます。お使いのバージョンで使用できるオプションは、`ss scan --help` でご確認ください。

### 修正の確認 <a href="#verify-a-fix" id="verify-a-fix"></a>

{% stepper %}
{% step %}

#### 漏えい状況の確認 <a href="#review-the-exposure" id="review-the-exposure"></a>

認証情報とそのソースを確認し、他のファイルや過去のコミットにも含まれていないかを調べます。対応している場合は有効性を確認しますが、Inconclusiveの結果を根拠に検出結果を却下しないでください。
{% endstep %}

{% step %}

#### 認証情報の保管と置き換え <a href="#store-and-replace-the-credential" id="store-and-replace-the-credential"></a>

必要に応じて、認証情報をKeeperに保存します。漏えいした認証情報はプロバイダ側で交換または失効させ、置き換えた認証情報を安全に使用するようアプリケーションを更新します。書き込み可能なファイルからは漏えいした値を削除し、それ以外のソースについては手動でのクリーンアップ手順に従います。
{% endstep %}

{% step %}

#### テストと再スキャン <a href="#test-and-rescan" id="test-and-rescan"></a>

影響を受けるアプリケーションをテストし、関連するスキャン対象を再スキャンして、残っているコピーがないか確認します。必要に応じて、フォローアップの作業をJiraに記録します。必要な変更を確認できてから、検出結果を **\[Fixed]** にしてください。
{% endstep %}
{% endstepper %}

### よくある質問 <a href="#common-questions" id="common-questions"></a>

#### スキャンにKeeperアカウントは必要ですか？ <a href="#do-i-need-a-keeper-account-to-scan" id="do-i-need-a-keeper-account-to-scan"></a>

不要です。Keeperにサインインしなくても、スキャンと検出結果の確認ができます。検出した認証情報をKeeperボルトに移行する場合は、Keeperアカウントが必要です。

#### スキャンでファイルは変更されますか？ <a href="#does-scanning-change-my-files" id="does-scanning-change-my-files"></a>

スキャンでは、選択したソースを調べるだけです。ファイルが変更されるのは、対応している削除アクションを明示的に実行したときです。AIガイダンスの生成、レビューラベルの設定、Jiraチケットの作成では、ソースからシークレットが削除されることはありません。

#### 認証情報をKeeperに移行すれば、是正は完了しますか？ <a href="#does-moving-a-credential-to-keeper-finish-the-remediation" id="does-moving-a-credential-to-keeper-finish-the-remediation"></a>

いいえ。Keeperに認証情報が保管されるだけです。その後も、他のコピーの確認、漏えいした値のプロバイダ側での交換または失効、依存するアプリケーションの更新、結果の確認が必要です。

#### クラウドのAIプロバイダなしで使えますか？ <a href="#can-i-work-without-a-cloud-ai-provider" id="can-i-work-without-a-cloud-ai-provider"></a>

はい。スキャンにAIは不要です。AI支援を使うには、**\[Local (on-device)]** を選択し、対応するモデルをダウンロードします。GitHubへのアクセス、Keeperへのサインイン、認証情報の有効性確認には、引き続きそれぞれのネットワーク接続が必要です。

#### ローカルチェックの結果が空、または利用できないのはなぜですか？ <a href="#why-is-a-local-check-empty-or-unavailable" id="why-is-a-local-check-empty-or-unavailable"></a>

OSがそのチェックに対応していない、想定されるファイルが存在しない、アカウントにファイルの読み取り権限がない、といった可能性があります。結果が空でも、システム全体が安全だと決めつけず、スキャン対象とスキャンのステータスを確認してください。

#### アプリが検出結果を自動で削除できないのはなぜですか？ <a href="#why-cant-the-app-remove-a-finding-automatically" id="why-cant-the-app-remove-a-finding-automatically"></a>

検出結果が、書き込み可能なローカルのシークレットではなく、履歴、リモートリポジトリ、秘密鍵、構成上の問題に関するものである可能性があります。スキャン後にファイルが変更された場合もあります。表示されたメッセージを確認し、必要に応じて再スキャンして、残りのクリーンアップを手動で行ってください。

### 関連ドキュメント <a href="#related-documentation" id="related-documentation"></a>

* [Keeperシークレットマネージャー](https://docs.keeper.io/keeperpam/jp/secrets-manager/overview.md): シークレットをハードコードせずにアプリケーションで取得する方法
* [Keeperボルトユーザーガイド](https://docs.keeper.io/user-guides/jp/): レコードの管理と認証情報の共有
* [Keeperサポート](https://www.keepersecurity.com/support.html): 製品に関するお問い合わせ


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/keeperpam/jp/privileged-access-manager/secrets-scanner.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
