`nse_main.lua` を保持するディレクトリが、この nmap が使用するものです。

</details>

## スクリプト引数

| 引数 | デフォルト | 意味 |
|---|---|---|
| `vulners.mincvss` | `0` | この値未満のスコアの検出結果を非表示にします。スコアなしの速報や既知のエクスプロイトがあるものは、しきい値に関係なく表示されます |
| `vulners.paths` | 公開されている 939 パス | Web スイープ用のパス: Lua リスト、1 行に 1 パスを記述したファイルを指定する文字列、またはスイープを無効にする `none`。読み取れないファイルを指定すると、公開リストにフォールバックするのではなく、スイープが停止してその旨が通知されます |
| `vulners.width` | `80` | テーブルがレイアウトされるターミナル幅 |
| `vulners.max_items` | `32` | スキャン全体で課金される項目数の上限 |
| `vulners.api_key` | - | API トークン。漏洩に注意: nmap は自身のコマンドラインを `-oX` にコピーします |
| `vulners.api_key_file` | - | 最初の行がトークンであるファイルの絶対パス |
| `vulners.api_host` | `vulners.com` | API のホスト名 |
| `vulners.api_port` | `443` | `api_host` 上のポート |

名前だけでも機能するため、`--script-args mincvss=7` だけで十分です。

1.x の引数プレフィックス - `vulners_enterprise.*` および
`http-vulners-regex.paths` - は 1 リリースの間受け入れられ、非推奨の
通知が表示されます。

## API キーの保存場所

優先順位の高い順に:

1. `~/.nmap/vulners.key`、1 行、モード 600 - インストーラーが書き込みを提案します
2. 環境変数の `VULNERS_API_KEY`
3. `--script-args vulners.api_key_file=/absolute/path`
4. `--script-args vulners.api_key=<token>`

最後の方法は便利ですが漏洩に注意してください: nmap は自身のコマンドラインをすべてのレポートにコピーするため、トークンは `-oX` 出力の `args` 属性とシェル履歴に残ります。スクリプト自体は、デバッグ出力を含め、トークンをどこにも書き込みません - それを保証する回帰テストがあります。

明示的に指定したキーファイルが読み取れない場合は、静かにフォールバックするのではなく、実行が停止します - ファイルを指定したオペレーターはそのファイルを意図しているためです - そして、レポートにはどのファイルであったかが示されます。パスの入力ミスが、クリーンなスキャンのように見えることはありません。

## フィンガープリントの入手元

スクリプトはそれらを保持していません。スキャンごとに、最初のホストに触れる前に、3 つの辞書を 1 回ダウンロードします:```
https://raw.githubusercontent.com/vulnersCom/nmap-vulners/catalog/
    index.json          what exists, at which serial
    fingerprints.json   721 product and version rules
    paths.json          939 paths the sweep requests
    probes.json         targeted version probes

Answers are cached for the whole scan, keyed per identity, so a hundred
identical servers cost one lookup. Enrichment is cached per finding id, so two
web ports running overlapping software fetch each document once.

## Machine-readable output

Everything printed is also structured, so `-oX` can be parsed without touching
the human text. The script id, the two table levels and the five original
element keys are unchanged from 1.x, which is what DefectDojo, Faraday,
nmap2csv and raven read:```xml
<script id="vulners">
  <elem key="schema">2.0</elem>
  <elem key="mode">keyed</elem>
  <table key="cpe:/a:apache:http_server:2.4.7">
    <table>
      <elem key="id">CVE-2021-40438</elem>
      <elem key="type">cve</elem>
      <elem key="severity">CRITICAL</elem>
      <elem key="cvss">9.0</elem>
      <elem key="cvss_type">cvss3.1</elem>
      <elem key="is_exploit">false</elem>
      <elem key="exploit_known">true</elem>
      <elem key="kev">true</elem>
      <elem key="epss">0.99612</elem>
      <elem key="exploitation">active</elem>
      <elem key="title">Apache HTTP Server SSRF in mod_proxy</elem>
      <elem key="href">https://vulners.com/cve/CVE-2021-40438</elem>
      <elem key="source_href">https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2021-40438</elem>
    </table>
  </table>
</script>

270 件のユニットケースが、実際の NSE ライブラリに対して nmap 内で実行されます。64 件のエンドツーエンドケースは、実際の nmap バイナリをローカル Web サーバーと、実際の API が強制することを強制する Vulners API の代役に対して駆動します。衛生ゲートは、シークレット、スキャン出力、エディタの散らかりをツリーから排除し、NSE が失われた結果に変えるグローバル読み取りを拒否します。最後の 4 つは、それを公開するデータとツールを保持します。カタログの形状、すべてのインポーターが読み取る XML 契約、パターントランスレータ、再構築の公開が安全かを判断するゲートです。最後の 1 つは、リポジトリ全体を [Nmap 自身のコード標準](https://secwiki.org/w/Nmap/Code_Standards) に保持します。`HACKING` は、nmap のツリーに住みたいスクリプトの権威としてこれを挙げています。タブなし、末尾の空白なし、80 列未満の行、セミコロンなし、`--;` で始まるプライベート NSEdoc、Python には PEP 8。
`python3 tests/e2e/run_e2e.py --live` は、実際のサービスに対するチェックを追加します。
[CONTRIBUTING.md](https://github.com/vulnerscom/nmap-vulners/blob/master/CONTRIBUTING.md) を参照してください。

## FAQ

**何かを悪用しますか?** いいえ。バナーとページを読み取り、データベースに問い合わせます。ペイロードを送信せず、認証情報を試しません。`safe` ではなく `discovery, intrusive, vuln, external` に分類される理由は 1 つだけです。パススイープが Web ポートの 939 パスを要求し、nmap の `safe` の定義は、大量の帯域幅を使用するスクリプトを除外するためです。nmap 自身の `http-enum` は 2,204 を要求し、同じラベルを持ちます。`-T` はそれらが送信される速度を設定し、数を設定することはありません。`--script-args vulners.paths=none` はスイープを完全にオフにします。

**API キーなしで動作しますか?** はい、完全に動作します。キーがない場合、無料のエンドポイントを使用します。これは、CPE に対して有料版と同じ脆弱性を返します。キーは、検出結果ごとに詳細を追加し、無料パスでは指定できないソフトウェアを指定できます。

**なぜ `-sC` が Web ソフトウェアを見つけなくなったのですか?** `vulners` が nmap の `default` カテゴリに含まれなくなり、`http-vulners-regex.nse` にあったフィンガープリントスイープも同様です。ターゲットのソフトウェアの識別情報を第三者に送信することは、あなたが要求したものであるべきです。`--script vulners` を実行してください。

**なぜある脆弱性は `cvss2.0` を表示し、別の脆弱性は `cvss3.1` を表示するのですか?** ラベルは、スコアが乗っているスケールを指定します。Vulners は、ソースが公開した方を返します。v2 スコアの 9.3 は、v3 スコアの 9.3 ではありません。

**`mincvss` を設定したのに、なぜ低スコアのエントリが表示されるのですか?** 既知のエクスプロイトがあるか、ソースがスコアを付けなかったためです。どちらも意図的です。

**レポートにカタログをダウンロードできなかったと表示されます。** その場合、Web フィンガープリンティングは実行されず、他のすべては実行されました。nmap 自身が指定したソフトウェアは引き続き検索されました。そのため、これは明確に述べられています。実行されなかった機能は、何も見つからなかった機能として読み取られます。2 つの原因には別々の表現があります。「ダウンロードできませんでした」はネットワークであり、「応答したが、辞書の 1 つを読み取れませんでした」は、あなたが指定したミラーです。

**脆弱だとわかっているホストで何も見つかりませんでした。** `-d2` で実行してください。問い合わせたすべての識別情報をログに記録します。通常、nmap はサービスを指定しましたが、そのバージョンは指定せず、検索するバージョンがありません。

## ライセンス

スクリプトは Nmap 自体と同じライセンスです。Nmap Public Source License については [LICENSE](https://github.com/vulnerscom/nmap-vulners/blob/master/LICENSE) を、その意味については [nmap.org/npsl](https://nmap.org/npsl/) を参照してください。

脆弱性データは [Vulners](https://vulners.com) から提供され、その利用規約に従います。

## 関連

* [vulners.com](https://vulners.com) - これらのスクリプトの背後にあるデータベース
* [vulnersCom/api](https://github.com/vulnersCom/api) - Python クライアント
* [vulnersCom/burp-vulners-scanner](https://github.com/vulnersCom/burp-vulners-scanner) - Burp Suite 内の同じデータ
* [nmap.org/book/nse.html](https://nmap.org/book/nse.html) - NSE スクリプトの仕組み

---

<div align="center">

Vulners チーム &lt;[email protected]&gt; によって保守されています

`#nmap` `#nse` `#vulnerability-scanner` `#cve` `#cvss` `#cpe` `#vulners`
`#security-tools` `#pentest` `#infosec` `#network-scanner` `#exploit-database`
`#lua` `#vulnerability-detection` `#security-automation`

</div>