projectdiscovery/tlsxTLSベースのデータ収集に特化した、高速で設定可能なTLSグラバー。
機能 • インストール • 使い方 • tlsxの実行 • Discordに参加
TLSベースのデータ収集と分析に焦点を当てた、高速で設定可能なTLSグラバーです。
tlsxのインストールにはGo 1.24が必要です。インストールするには、以下のコマンドを実行するか、リリースページからプリコンパイル済みバイナリをダウンロードしてください。```console go install github.com/projectdiscovery/tlsx/cmd/tlsx@latest
## 使用方法```console
tlsx -h
これはツールのヘルプを表示します。サポートされているすべてのスイッチは次のとおりです。```console TLSX is a tls data gathering and analysis toolkit.
Usage: tlsx [flags]
Flags: INPUT: -u, -host string[] target host to scan (-u INPUT1,INPUT2) -l, -list string target list to scan (-l INPUT_FILE) -p, -port string[] target port to connect (default 443)
SCAN-MODE: -sm, -scan-mode string tls connection mode to use (ctls, ztls, openssl, auto) (default "auto") -ps, -pre-handshake enable pre-handshake tls connection (early termination) using ztls -sa, -scan-all-ips scan all ips for a host (default false) -iv, -ip-version string[] ip version to use (4, 6) (default 4)
PROBES: -san display subject alternative names -cn display subject common names -so display subject organization name -tv, -tls-version display used tls version -cipher display used cipher -hash string display certificate fingerprint hashes (md5,sha1,sha256) -jarm display jarm fingerprint hash -ja3 display ja3 fingerprint hash (using ztls) -wc, -wildcard-cert display host with wildcard ssl certificate -tps, -probe-status display tls probe status -ve, -version-enum enumerate and display supported tls versions -ce, -cipher-enum enumerate and display supported cipher -ct, -cipher-type value ciphers types to enumerate. possible values: all/secure/insecure/weak (comma-separated) (default all) -ch, -client-hello include client hello in json output (ztls mode only) -sh, -server-hello include server hello in json output (ztls mode only) -se, -serial display certificate serial number
MISCONFIGURATIONS: -ex, -expired display host with host expired certificate -ss, -self-signed display host with self-signed certificate -mm, -mismatched display host with mismatched certificate -re, -revoked display host with revoked certificate -un, -untrusted display host with untrusted certificate
CONFIGURATIONS: -config string path to the tlsx configuration file -r, -resolvers string[] list of resolvers to use -cc, -cacert string client certificate authority file -ci, -cipher-input string[] ciphers to use with tls connection -sni string[] tls sni hostname to use -rs, -random-sni use random sni when empty -rps, -rev-ptr-sni perform reverse PTR to retrieve SNI from IP -min-version string minimum tls version to accept (ssl30,tls10,tls11,tls12,tls13) -max-version string maximum tls version to accept (ssl30,tls10,tls11,tls12,tls13) -cert, -certificate include certificates in json output (PEM format) -tc, -tls-chain include certificates chain in json output -vc, -verify-cert enable verification of server certificate -ob, -openssl-binary string OpenSSL Binary Path -hf, -hardfail strategy to use if encountered errors while checking revocation status -proxy string socks5 proxy to use for tlsx
OPTIMIZATIONS: -c, -concurrency int number of concurrent threads to process (default 300) -cec, -cipher-concurrency int cipher enum concurrency for each target (default 10) -timeout int tls connection timeout in seconds (default 5) -retry int number of retries to perform for failures (default 3) -delay string duration to wait between each connection per thread (eg: 200ms, 1s)
UPDATE: -up, -update update tlsx to latest version -duc, -disable-update-check disable automatic tlsx update check
OUTPUT: -o, -output string file to write output to -j, -json display output in jsonline format -dns display unique hostname from SSL certificate response -ro, -resp-only display tls response only -silent display silent output -nc, -no-color disable colors in cli output -v, -verbose display verbose output -version display project version
PDCP: -pd, -dashboard upload or view output in the PDCP UI dashboard -pdu, -dashboard-upload string upload tlsx output file (JSONL format) to the PDCP UI dashboard -auth string PDCP API key for authentication -tid, -team-id string upload asset results to a specified team ID -aid, -asset-id string upload new assets to an existing asset ID -aname, -asset-name string asset group name
DEBUG: -health-check, -hc run diagnostic check up
## ライブラリとしての tlsx の使用
tlsx をライブラリとして使用する例は、[examples](https://github.com/projectdiscovery/tlsx/blob/HEAD/examples/) フォルダにあります。
## tlsx の実行
### tlsx への入力
**tlsx** は TLS 接続を行うために **ip** を必要とし、以下に示す複数の形式を受け付けます：```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
-host / -uフラグを使用して入力ホストを指定でき、複数の値はカンマ区切りの入力で指定できます。同様に、file入力は-list / -lフラグを使用してサポートされています。
カンマ区切りのホスト入力の例:```console $ tlsx -u 93.184.216.34,example.com,example.com:443,https://example.com:443 -silent
ファイルベースのホスト入力の例:```console
$ tlsx -list host_list.txt
Port Input:
tlsx はデフォルトでポート 443 に接続します。これは -port / -p フラグを使用してカスタマイズできます。単一または複数のポートは、カンマ区切りの入力または接続するポートのリストを含む改行区切りのファイルを使用して指定できます。
カンマ区切りのポート入力の例:``` $ tlsx -u hackerone.com -p 443,8443
ファイルベースのポート入力の例:```
$ tlsx -u hackerone.com -p port_list.txt
注記:
入力ホストにポートが含まれている場合（例:
8.8.8.8:443やhackerone.com:8443）、ホストで指定されたポートが、デフォルトまたは-port / -pフラグで指定されたポートの代わりにTLS接続に使用されます。
これは、指定されたCIDRレンジに対してツールを実行し、ポート443でTLS接続を受け付けるホストを返します。```console $ echo 173.0.84.0/24 | tlsx
|_ | | / \ / / | | | |_ > < || ||/_/_\ 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.
173.0.84.69:443 173.0.84.67:443 173.0.84.68:443 173.0.84.66:443 173.0.84.76:443 173.0.84.70:443 173.0.84.72:443
### SAN/CN プローブ
TLS証明書の**subject alternative name**および**common name**フィールドにはDNS名が含まれており、`-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]
自動化を容易にするために、オプションで -resp-only フラグを使用すると、CLI出力にDNS名のみを一覧表示できます。```console
$ echo 173.0.84.0/24 | tlsx -san -cn -silent -resp-only
api-aa-3t.paypal.com pilot-payflowpro.paypal.com pointofsale-s.paypal.com uptycshon.paypal.com a.paypal.com adjvendor.paypal.com zootapi.paypal.com api-aa.paypal.com payflowpro.paypal.com pointofsale.paypal.com uptycspay.paypal.com api-3t.paypal.com uptycsize.paypal.com api.paypal.com api-m.paypal.com svcs.paypal.com uptycsven.paypal.com uptycsven.paypal.com a.paypal.com api.paypal.com pointofsale-s.paypal.com pilot-payflowpro.paypal.com
TLS証明書から取得された**サブドメイン**は、さらに検査するために他のPDツールにパイプで渡すことができます。以下は、TLSサブドメインを**[dnsx](https://github.com/projectdiscovery/dnsx)**にパイプしてパッシブサブドメインをフィルタリングし、**[httpx](https://github.com/projectdiscovery/httpx)**に渡してアクティブなWebサービスを実行しているホストを一覧表示する例です。```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
$ subfinder -d hackerone.com | tlsx -tls-version -cipher
mta-sts.hackerone.com:443 [TLS1.3] [TLS_AES_128_GCM_SHA256] hackerone.com:443 [TLS1.3] [TLS_AES_128_GCM_SHA256] api.hackerone.com:443 [TLS1.3] [TLS_AES_128_GCM_SHA256] mta-sts.managed.hackerone.com:443 [TLS1.3] [TLS_AES_128_GCM_SHA256] mta-sts.forwarding.hackerone.com:443 [TLS1.3] [TLS_AES_128_GCM_SHA256] www.hackerone.com:443 [TLS1.3] [TLS_AES_128_GCM_SHA256] support.hackerone.com:443 [TLS1.2] [TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256]
# TLS 設定ミス
### 期限切れ / 自己署名 / 不一致 / 失効 / 信頼されていない証明書
ホストのリストを tlsx に渡すことで、**期限切れ / 自己署名 / 不一致 / 失効 / 信頼されていない**証明書を検出できます。```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]
$ echo hackerone.com | tlsx -jarm -silent
hackerone.com:443 [29d3dd00029d29d00042d43d00041d5de67cc9954cc85372523050f20b5007]
### [JA3](https://github.com/salesforce/ja3) TLSフィンガープリント```console
$ echo hackerone.com | tlsx -ja3 -silent
hackerone.com:443 [20c9baf81bfe96ff89722899e75d0190]
tlsx は特定のデータを照会するための複数のプローブフラグをサポートしていますが、すべての情報は常にJSON形式で利用可能です。自動化や後処理には -json 出力を使用するのが最も便利なオプションです。```console
echo example.com | tlsx -json -silent | jq .
I need to translate the content from English to Japanese. However, I notice that the INPUT section is empty—there's no actual content provided after "INPUT:".
Since there is no content to translate, there is nothing to output. I'll return an empty response.```json
{
"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"
}
tlsx は、スキャン結果をProjectDiscovery Cloud Platform (PDCP) ダッシュボードにアップロードして、可視化および分析することをサポートしています。
ダッシュボードアップロードを有効にすると、結果が検出された時点で自動的にアップロードされます：```console $ tlsx -u example.com -pd -json
結果は自動的にPDCPにアップロードされ、表示用のダッシュボードURLが届きます。
#### 既存ファイルのアップロード
以前に保存したJSONL出力ファイルをPDCPにアップロード：```console
$ tlsx -pdu results.jsonl -tid your-team-id -aname "My Scan"
-pd, --dashboard: PDCPダッシュボードへのリアルタイムアップロードを有効にする-pdu, --dashboard-upload <file>: 特定のJSONLファイルをPDCPにアップロードする-auth <key>: PDCP APIキー（環境変数または資格情報ハンドラーで設定することも可能）-tid, --team-id <id>: アップロード用のチームIDを指定する-aid, --asset-id <id>: 既存のアセットIDにアップロードする-aname, --asset-name <name>: アセットグループにカスタム名を設定するすべてのオプションを使用した例：```console $ tlsx -u example.com -pd -json -tid team123 -aname "Production Scan"
## 設定
### スキャンモード
tlsx は TLS 接続を確立するための複数のモードを提供します -
- `auto` (失敗時に他のモードへ自動フォールバック) - **デフォルト**
- `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)**)
特定のモード / ライブラリに関するいくつかのポイントは、[リンクされたディスカッション](https://github.com/projectdiscovery/tlsx/discussions/2) で強調されています。`auto` モードは、接続エラー時に `ztls` および `openssl` モードを使用して接続を再試行することで、最大のカバレッジを確保し、古いバージョンの TLS を実行しているホストをスキャンするためにサポートされています。
古い / 旧式の TLS バージョンを使用するウェブサイトをスキャンするための `ztls` モードの使用例。```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 接続モードを使用するには、システムに openssl がインストールされている必要があります。最近のシステムのほとんどには openssl がプリインストールされていますが、システムにない場合は手動でインストールできます。openssl がインストールされているかどうかは、openssl version コマンドを実行することで確認できます。openssl がインストールされていれば、このコマンドはバージョン番号を表示します。
Pre-Handshake (早期終了)tlsx は SSL 接続を早期に終了することをサポートしており、これによりスキャンが高速化され、接続リクエストが少なくなります（TLS 詳細については、@erbbysam による Hunting-Certificates-And-Servers を参照してください。 |
|_ | | / \ / / | | | |_ > < || ||/_/_\ 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
> **注記**:
> **pre-handshake** モードは `ztls` (**zcrypto/tls**) を利用します。これは、`ztls` ライブラリが `TLS v1.3` をサポートしていないため、サポートが `TLS v1.2` までに限定されることを意味します。
</table>
</tr>
</td>
### TLS バージョン
**最小**および**最大** TLS バージョンは、`-min-version` および `-max-version` フラグを使用して指定できます。デフォルトでは、これらの値は使用中の基盤ライブラリによって設定されます。
TLS バージョンに指定できる値は以下のとおりです。
- `ssl30`
- `tls10`
- `tls11`
- `tls12`
- `tls13`
次に、`max-version` を使用して、より古いバージョンの TLS、すなわち **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
サポートされているカスタム暗号は -cipher-input / -ci フラグを使用して指定できます。各モードでサポートされている暗号の一覧は Wikiページ で確認できます。```console
$ tlsx -u example.com -ci TLS_AES_256_GCM_SHA384 -cipher
The input chunk is empty — no source text was provided to translate. Please supply the Markdown content for chunk 51 of 57.```console
$ tlsx -u example.com -ci cipher_list.txt -cipher
This program optionally uses:
tlsx is made with ❤️ by the projectdiscovery team and distributed under MIT License.
tlsx can operate in a fire-hose mode that continuously streams newly-issued TLS certificates from the public Certificate Transparency ecosystem, providing a near-real-time feed of hostnames and metadata.
Enable CT logs mode via the -ctl switch (default when no input is provided):```bash
tlsx -ctl -silent | jq .subject_an
#### 開始オフセット
このツールは、以下のフラグによって制御される、相互に排他的な3つの開始動作を提供します。
| フラグ | 動作 |
|------|-----------|
| _デフォルト_ | **今すぐ**開始（起動時のツリーサイズ）– 将来の証明書のみがストリームされます |
| `-cb, --ctl-beginning` | すべてのログについてインデックス**0**から開始（完全な履歴リプレイ） |
| `-cti, --ctl-index <log>=<n>` | ログごとのカスタムインデックス（繰り返し指定可能）。指定されたログURL/IDの開始インデックスを _n_ に設定します。例: `--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
デフォルトでは、重複は大きな逆ブルームフィルタを使用して除外されます。詳細な統計情報を表示するには -v を渡してください。
-pre-handshake モードの使用例：