## Utilizzo```console
tlsx -h

## Utilizzare tlsx come libreria

Esempi di utilizzo di tlsx come libreria sono forniti nella cartella [examples](https://github.com/projectdiscovery/tlsx/blob/HEAD/examples/).

## Esecuzione di tlsx

### Input per tlsx

**tlsx** richiede **ip** per stabilire una connessione TLS e accetta più formati come elencato di seguito:```bash
AS1449 # ASN input
173.0.84.0/24 # CIDR input
93.184.216.34 # IP input
example.com # DNS input
example.com:443 # DNS input with port
https://example.com:443 # URL input port

Esempio di input host basato su file:```console
$ tlsx -list host_list.txt

Esempio di input di porta basato su file:```
$ tlsx -u hackerone.com -p port_list.txt

projectdiscovery.io

### SAN/CN Probe

Il certificato TLS contiene nomi DNS nei campi **subject alternative name** e **common name** che possono essere estratti usando i flag `-san`, `-cn`.```console
$ echo 173.0.84.0/24 | tlsx -san -cn -silent

173.0.84.104:443 [uptycspay.paypal.com]
173.0.84.104:443 [api-3t.paypal.com]
173.0.84.104:443 [api-m.paypal.com]
173.0.84.104:443 [payflowpro.paypal.com]
173.0.84.104:443 [pointofsale-s.paypal.com]
173.0.84.104:443 [svcs.paypal.com]
173.0.84.104:443 [uptycsven.paypal.com]
173.0.84.104:443 [api-aa.paypal.com]
173.0.84.104:443 [pilot-payflowpro.paypal.com]
173.0.84.104:443 [pointofsale.paypal.com]
173.0.84.104:443 [uptycshon.paypal.com]
173.0.84.104:443 [api.paypal.com]
173.0.84.104:443 [adjvendor.paypal.com]
173.0.84.104:443 [zootapi.paypal.com]
173.0.84.104:443 [api-aa-3t.paypal.com]
173.0.84.104:443 [uptycsize.paypal.com]

I **sottodomini** ottenuti dai certificati TLS possono essere ulteriormente passati ad altri strumenti PD per un'ispezione più approfondita; ecco un esempio di piping di sottodomini TLS a **[dnsx](https://github.com/projectdiscovery/dnsx)** per filtrare i sottodomini passivi e poi a **[httpx](https://github.com/projectdiscovery/httpx)** per elencare gli host che eseguono servizi web attivi.```console
$ echo 173.0.84.0/24 | tlsx -san -cn -silent -resp-only | dnsx -silent | httpx

    __    __  __       _  __
   / /_  / /_/ /_____ | |/ /
  / __ \/ __/ __/ __ \|   /
 / / / / /_/ /_/ /_/ /   |
/_/ /_/\__/\__/ .___/_/|_|
             /_/              v1.2.2

    projectdiscovery.io

Use with caution. You are responsible for your actions.
Developers assume no liability and are not responsible for any misuse or damage.
https://api-m.paypal.com
https://uptycsize.paypal.com
https://api.paypal.com
https://uptycspay.paypal.com
https://svcs.paypal.com
https://adjvendor.paypal.com
https://uptycshap.paypal.com
https://uptycshon.paypal.com
https://pilot-payflowpro.paypal.com
https://slc-a-origin-pointofsale.paypal.com
https://uptycsven.paypal.com
https://api-aa.paypal.com
https://api-aa-3t.paypal.com
https://uptycsbrt.paypal.com
https://payflowpro.paypal.com
http://pointofsale-s.paypal.com
http://slc-b-origin-pointofsale.paypal.com
http://api-3t.paypal.com
http://zootapi.paypal.com
http://pointofsale.paypal.com

# Configurazione errata TLS

### Certificato scaduto / autofirmato / non corrispondente / revocato / non attendibile

È possibile fornire un elenco di host a tlsx per rilevare certificati **scaduti / autofirmati / non corrispondenti / revocati / non attendibili**.```console
$ tlsx -l hosts.txt -expired -self-signed -mismatched -revoked -untrusted
  

  _____ _    _____  __
 |_   _| |  / __\ \/ /
   | | | |__\__ \>  < 
   |_| |____|___/_/\_\  v0.0.1

    projectdiscovery.io

[WRN] Use with caution. You are responsible for your actions.
[WRN] Developers assume no liability and are not responsible for any misuse or damage.

wrong.host.badssl.com:443 [mismatched]
self-signed.badssl.com:443 [self-signed]
expired.badssl.com:443 [expired]
revoked.badssl.com:443 [revoked]
untrusted-root.badssl.com:443 [untrusted]

### [JA3](https://github.com/salesforce/ja3) Impronta digitale TLS```console
$ echo hackerone.com | tlsx -ja3 -silent

hackerone.com:443 [20c9baf81bfe96ff89722899e75d0190]

{
  "timestamp": "2022-08-22T21:22:59.799053+05:30",
  "host": "example.com",
  "ip": "93.184.216.34",
  "port": "443",
  "probe_status": true,
  "tls_version": "tls13",
  "cipher": "TLS_AES_256_GCM_SHA384",
  "not_before": "2022-03-14T00:00:00Z",
  "not_after": "2023-03-14T23:59:59Z",
  "subject_dn": "CN=www.example.org, O=Internet Corporation for Assigned Names and Numbers, L=Los Angeles, ST=California, C=US",
  "subject_cn": "www.example.org",
  "subject_org": [
    "Internet Corporation for Assigned Names and Numbers"
  ],
  "subject_an": [
    "www.example.org",
    "example.net",
    "example.edu",
    "example.com",
    "example.org",
    "www.example.com",
    "www.example.edu",
    "www.example.net"
  ],
  "issuer_dn": "CN=DigiCert TLS RSA SHA256 2020 CA1, O=DigiCert Inc, C=US",
  "issuer_cn": "DigiCert TLS RSA SHA256 2020 CA1",
  "issuer_org": [
    "DigiCert Inc"
  ],
  "fingerprint_hash": {
    "md5": "c5208a47259d540a6e3404dddb85af91",
    "sha1": "df81dfa6b61eafdffffe1a250240db5d2e6cee25",
    "sha256": "7f2fe8d6b18e9a47839256cd97938daa70e8515750298ddba2f3f4b8440113fc"
  },
  "tls_connection": "ctls",
  "sni": "example.com"
}
```
### Integrazione con il Dashboard PDCP

**tlsx** supporta il caricamento dei risultati delle scansioni sul dashboard di ProjectDiscovery Cloud Platform (PDCP) per visualizzazione e analisi.

#### Caricamento dei risultati in tempo reale

Abilita il caricamento sul dashboard per caricare automaticamente i risultati man mano che vengono scoperti:```console
$ tlsx -u example.com -pd -json
```
I risultati verranno automaticamente caricati su PDCP e riceverai un URL della dashboard per visualizzarli.

#### Caricamento di un file esistente

Carica un file di output JSONL precedentemente salvato su PDCP:```console
$ tlsx -pdu results.jsonl -tid your-team-id -aname "My Scan"
```
#### Opzioni di Configurazione

- `-pd, --dashboard`: Abilita il caricamento in tempo reale al dashboard PDCP
- `-pdu, --dashboard-upload <file>`: Carica un file JSONL specifico su PDCP
- `-auth <key>`: Chiave API PDCP (può anche essere impostata tramite ambiente o gestore di credenziali)
- `-tid, --team-id <id>`: Specifica l'ID del team per i caricamenti
- `-aid, --asset-id <id>`: Carica su un ID asset esistente
- `-aname, --asset-name <name>`: Imposta un nome personalizzato per il gruppo di asset

Esempio con tutte le opzioni:```console
$ tlsx -u example.com -pd -json -tid team123 -aname "Production Scan"
```
## Configurazione

### Modalità di Scansione

tlsx fornisce molteplici modalità per effettuare la connessione TLS -

- `auto` (fallback automatico ad altre modalità in caso di fallimento) - **predefinita**
- `ctls` (**[crypto/tls](https://github.com/golang/go/blob/master/src/crypto/tls/tls.go)**)
- `ztls` (**[zcrypto/tls](https://github.com/zmap/zcrypto)**)
- `openssl` (**[openssl](https://github.com/openssl/openssl)**)

Alcuni suggerimenti per la modalità/libreria specifica sono evidenziati nelle [discussioni collegate](https://github.com/projectdiscovery/tlsx/discussions/2), la modalità `auto` è supportata per garantire la massima copertura e scansioni per gli host che eseguono versioni obsolete di TLS riprovando la connessione utilizzando le modalità `ztls` e `openssl` in caso di errore di connessione.

Un esempio di utilizzo della modalità `ztls` per scansionare un sito web che utilizza una versione vecchia/obsoleta di TLS.```console
$ echo tls-v1-0.badssl.com | tlsx -port 1010 -sm ztls
  

  _____ _    _____  __
 |_   _| |  / __\ \/ /
   | | | |__\__ \>  < 
   |_| |____|___/_/\_\  v0.0.1

    projectdiscovery.io

[WRN] Use with caution. You are responsible for your actions.
[WRN] Developers assume no liability and are not responsible for any misuse or damage.

tls-v1-0.badssl.com:1010
```
### OpenSSL

Per utilizzare la modalità di connessione openssl, è necessario avere openssl installato sul sistema. La maggior parte dei sistemi moderni viene fornita con openssl preinstallato, ma se non è presente sul sistema, è possibile installarlo manualmente. È possibile verificare se openssl è installato eseguendo il comando `openssl version`. Se openssl è installato, questo comando mostrerà il numero di versione.

<table>
<tr>
<td>

### Pre-Handshake (Terminazione anticipata)

**tlsx** supporta la terminazione anticipata della connessione SSL, che porta a scansioni più veloci e a minori richieste di connessione (disconnettendosi dopo il `serverhello` TLS e la raccolta dei dati del certificato).

Per maggiori dettagli, fare riferimento a [Hunting-Certificates-And-Servers](https://github.com/erbbysam/Hunting-Certificates-And-Servers/blob/master/Hunting%20Certificates%20%26%20Servers.pdf) di [@erbbysam](https://twitter.com/erbbysam)

Un esempio di utilizzo della modalità `-pre-handshake`:```console
$ tlsx -u example.com -pre-handshake 
  

  _____ _    _____  __
 |_   _| |  / __\ \/ /
   | | | |__\__ \>  < 
   |_| |____|___/_/\_\  v0.0.1

    projectdiscovery.io

[WRN] Use with caution. You are responsible for your actions.
[WRN] Developers assume no liability and are not responsible for any misuse or damage.

example.com:443
```
> **Nota**:

> La modalità **pre-handshake** utilizza `ztls` (**zcrypto/tls**), il che significa anche che il supporto è limitato fino a `TLS v1.2` poiché `TLS v1.3` non è supportato dalla libreria `ztls`.

</table>
</tr>
</td>

### Versione TLS

Le versioni TLS **minima** e **massima** possono essere specificate usando i flag `-min-version` e `-max-version`; di default questi valori sono impostati dalla libreria sottostante utilizzata.

I valori accettabili per la versione TLS sono specificati di seguito.

- `ssl30`
- `tls10`
- `tls11`
- `tls12`
- `tls13`

Ecco un esempio che utilizza `max-version` per scansionare gli host che supportano una versione precedente di TLS, ovvero **TLS v1.0**```console
$ tlsx -u example.com -max-version tls10
  

  _____ _    _____  __
 |_   _| |  / __\ \/ /
   | | | |__\__ \>  < 
   |_| |____|___/_/\_\  v0.0.1

    projectdiscovery.io

[WRN] Use with caution. You are responsible for your actions.
[WRN] Developers assume no liability and are not responsible for any misuse or damage.
example.com:443
```
### Cifrario Personalizzato

Il cifrario personalizzato supportato può essere fornito usando il flag `-cipher-input / -ci`, l'elenco dei cifrari supportati per ogni modalità è disponibile nella [pagina wiki](https://github.com/projectdiscovery/tlsx/wiki/Ciphers).```console
$ tlsx -u example.com -ci TLS_AES_256_GCM_SHA384 -cipher
```
Le seguenti opzioni sono attualmente supportate:```console
$ tlsx -u example.com -ci cipher_list.txt -cipher
```
## Ringraziamenti

Questo programma utilizza opzionalmente:

- [zcrypto](https://github.com/zmap/zcrypto) libreria del team zmap.
- [cfssl](https://github.com/cloudflare/cfssl) libreria del team cloudflare
- dati sui cipher da [ciphersuite.info](https://ciphersuite.info) per la classificazione delle suites di cifratura

--------

<div align="center">

tlsx è realizzato con ❤️ dal team [projectdiscovery](https://projectdiscovery.io) e distribuito sotto [Licenza MIT](https://github.com/projectdiscovery/tlsx/blob/HEAD/LICENSE).


<a href="https://discord.gg/projectdiscovery"><img src="https://assets.kitploit.com/production/public/readmes/41152/d0624f94cb9ea6401be5a089bb694bc963c47fa82aa3b758c893e3b0bbfdf663.png" width="300" alt="Join Discord"></a>

</div>

### Streaming dei Registri di Trasparenza dei Certificati (CT)

`tlsx` può operare in una modalità _fire-hose_ che trasmette continuamente i certificati TLS appena emessi dall'ecosistema pubblico di Trasparenza dei Certificati, fornendo un flusso quasi in tempo reale di nomi host e metadati.

Abilita la modalità dei registri CT tramite l'opzione `-ctl` (impostazione predefinita quando non viene fornito alcun input):```bash
tlsx -ctl -silent | jq .subject_an
```
#### Offset di partenza

Lo strumento offre tre comportamenti di avvio mutuamente esclusivi controllati dalle seguenti flag:

| Flag | Comportamento |
|------|-----------|
| _default_ | Avvia **ora** (dimensione dell'albero all'avvio) – solo i certificati futuri vengono trasmessi in streaming |
| `-cb, --ctl-beginning` | Avvia dall'indice **0** per ogni log (riproduzione storica completa) |
| `-cti, --ctl-index <log>=<n>` | Indice personalizzato per log (ripetibile). Imposta l'indice di partenza su _n_ per l'URL/ID del log specificato. Esempio: `--ctl-index https://ct.googleapis.com/logs/argon2023=123456` |```bash
# Replay the entire history
$ tlsx -ctl -cb -silent > all_certs.jsonl

# Resume at custom positions for two logs
$ tlsx -ctl -cti https://ct.googleapis.com/logs/argon2023=987654 -cti cloudflare-nimbus2024=543210 \
      -silent | jq -r .ct_source
```
Per impostazione predefinita, i duplicati vengono filtrati utilizzando un grande filtro bloom inverso. Passa `-v` per osservare statistiche verbose.