O diretório que contém `nse_main.lua` é o que este nmap usa.

</details>

## Argumentos do script

| Argumento | Padrão | Significado |
|---|---|---|
| `vulners.mincvss` | `0` | Oculta resultados abaixo desta pontuação. Boletins sem pontuação e qualquer coisa com exploit conhecido são exibidos independentemente do limite |
| `vulners.paths` | os 939 caminhos publicados | Caminhos para a varredura web: uma lista Lua, uma string nomeando um arquivo com um caminho por linha, ou `none` para desativar a varredura. Um arquivo que você nomear e que não puder ser lido interrompe a varredura e informa isso, em vez de recorrer à lista publicada |
| `vulners.width` | `80` | Largura do terminal para a qual a tabela é formatada |
| `vulners.max_items` | `32` | Teto de itens cobrados para toda a varredura |
| `vulners.api_key` | - | Token da API. Vazado: o nmap copia sua própria linha de comando para `-oX` |
| `vulners.api_key_file` | - | Caminho absoluto para um arquivo cuja primeira linha é o token |
| `vulners.api_host` | `vulners.com` | Nome do host da API |
| `vulners.api_port` | `443` | Porta em `api_host` |

Um nome simples também funciona, então `--script-args mincvss=7` é suficiente.

Os prefixos de argumento da versão 1.x - `vulners_enterprise.*` e
`http-vulners-regex.paths` - são aceitos por uma versão e exibem um aviso de
depreciação.

## Onde manter a chave da API

Em ordem de preferência:

1. `~/.nmap/vulners.key`, uma linha, modo 600 - o instalador se oferece para escrevê-la
2. `VULNERS_API_KEY` no ambiente
3. `--script-args vulners.api_key_file=/absolute/path`
4. `--script-args vulners.api_key=<token>`

A última é conveniente e vazada: o nmap copia sua própria linha de comando para
cada relatório, então o token acaba no atributo `args` da saída `-oX` e no seu
histórico do shell. O script em si nunca escreve o token em lugar algum,
incluindo sua saída de depuração - há um teste de regressão que afirma isso.

Um arquivo de chave que você nomear explicitamente e que não puder ser lido
interrompe a execução em vez de recorrer silenciosamente - um operador que
nomeia um arquivo quer dizer aquele arquivo - e o relatório informa qual arquivo
foi. Um caminho digitado errado não pode parecer uma varredura limpa.

## De onde vêm as impressões digitais

O script não as carrega. Ele baixa três dicionários uma vez por varredura,
antes de o primeiro host ser tocado:```
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

As respostas são armazenadas em cache para toda a verificação, indexadas por identidade, então cem servidores idênticos custam uma única consulta. O enriquecimento é armazenado em cache por ID de descoberta, então duas portas web executando software sobreposto buscam cada documento apenas uma vez.

## Saída legível por máquina

Tudo o que é impresso também é estruturado, então `-oX` pode ser analisado sem tocar no texto legível por humanos. O ID do script, os dois níveis de tabela e as cinco chaves originais dos elementos permanecem inalterados desde a versão 1.x, que é o que DefectDojo, Faraday, nmap2csv e raven leem:```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 casos de unidade executados dentro do nmap contra as bibliotecas NSE reais; 64 casos de ponta a ponta
acionam o binário real do nmap contra um servidor web local e uma API Vulners substituta
que impõe o que a real impõe; o portão de higiene mantém segredos, saída de varredura e lixo do editor
fora da árvore e recusa uma leitura global que o NSE transformaria em um resultado perdido; e os últimos quatro guardam os dados e
as ferramentas que os publicam - a forma do catálogo, o contrato XML que todo
importador lê, o tradutor de padrões e o portão que decide se uma reconstrução é
segura para publicar. O último guarda todo o repositório conforme os
[Padrões de Código do próprio Nmap](https://secwiki.org/w/Nmap/Code_Standards), que
o `HACKING` nomeia como a autoridade para um script que queira viver na árvore do
nmap: sem tabs, sem espaços em branco no fim das linhas, linhas com menos de 80 colunas, sem ponto e vírgula,
documentação NSEdoc privada começando com `--;`, PEP 8 para o Python.
`python3 tests/e2e/run_e2e.py --live` adiciona verificações contra o serviço real.
Consulte [CONTRIBUTING.md](https://github.com/vulnerscom/nmap-vulners/blob/master/CONTRIBUTING.md).

## FAQ

**Ele explora algo?** Não. Ele lê banners e páginas e consulta um
banco de dados - não envia payload e não tenta credencial. Ele é categorizado
como `discovery, intrusive, vuln, external` em vez de `safe`, por um motivo: a
varredura de caminhos solicita 939 caminhos de uma porta web, e a definição de `safe` do nmap
exclui scripts que usam grandes quantidades de largura de banda. O próprio `http-enum` do nmap
solicita 2 204 e carrega o mesmo rótulo. Seu `-T` define a velocidade com que eles saem
e nunca quantos, e `--script-args vulners.paths=none` desativa a varredura
por completo.

**Funciona sem uma chave de API?** Sim, totalmente. Sem uma, ele usa o endpoint
gratuito, que retorna as mesmas vulnerabilidades para um CPE que o pago. Uma
chave adiciona detalhes por descoberta e pode nomear software que o caminho gratuito não pode.

**Por que o `-sC` parou de encontrar software web?** Porque `vulners` não está mais na
categoria `default` do nmap, e nem a varredura de impressão digital que costumava
viver em `http-vulners-regex.nse`. Enviar a identidade do software de um alvo para
um terceiro deve ser algo que você pediu: execute `--script vulners`.

**Por que uma vulnerabilidade mostra `cvss2.0` enquanto outra mostra `cvss3.1`?** O
rótulo nomeia a escala em que a pontuação está. O Vulners retorna a que a fonte
publicou; uma pontuação v2 de 9.3 não é uma pontuação v3 de 9.3.

**Por que uma entrada de baixa pontuação é exibida quando defino `mincvss`?** Porque ela tem um
exploit conhecido, ou porque a fonte nunca a pontuou. Ambos são intencionais.

**O relatório diz que o catálogo não pôde ser baixado.** Então a impressão digital
web não foi executada e todo o resto foi: o software que o próprio nmap
nomeou ainda foi consultado. É dito em voz alta por esse motivo - uma capacidade
que não foi executada parece uma capacidade que não encontrou nada. As duas causas têm
redação separada: "could not be downloaded" é a rede, e "answered, but
one of its dictionaries could not be read" é o espelho para o qual você a apontou.

**Não encontrou nada em um host que sei que é vulnerável.** Execute com `-d2`: ele registra
cada identidade sobre a qual perguntou. Normalmente o nmap nomeou o serviço, mas não sua
versão, e não há versão para consultar.

## Licença

Os scripts são licenciados da mesma forma que o próprio Nmap - consulte [LICENSE](https://github.com/vulnerscom/nmap-vulners/blob/master/LICENSE) para a
Nmap Public Source License, e
[nmap.org/npsl](https://nmap.org/npsl/) para saber o que ela significa.

Os dados de vulnerabilidade vêm do [Vulners](https://vulners.com) e estão sujeitos aos
seus termos.

## Relacionados

* [vulners.com](https://vulners.com) - o banco de dados por trás destes scripts
* [vulnersCom/api](https://github.com/vulnersCom/api) - o cliente Python
* [vulnersCom/burp-vulners-scanner](https://github.com/vulnersCom/burp-vulners-scanner) - os mesmos dados dentro do Burp Suite
* [nmap.org/book/nse.html](https://nmap.org/book/nse.html) - como os scripts NSE funcionam

---

<div align="center">

Mantido pela Equipe 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>