CyInfo
A comprehensive Python network security toolkit for SSL/TLS analysis, certificate inspection, vulnerability scanning, and deep HTTP/TLS probing.
Features
🔍 Network Scanner (cyinfo.scanner)
Three-tier scanning with increasing depth:
| Level | Method | What it does |
|---|---|---|
| Basic | basic_scan(target) |
IP resolution, DNS records (A/AAAA/MX/NS/TXT/CNAME/SOA), geolocation, HTTP status, reverse DNS |
| Medium | medium_scan(target) |
SSL certificate details, TLS version, cipher suite, security headers grading, port scan with banner grabbing |
| Advanced | advanced_scan(target) |
SSL handshake breakdown, encryption algorithms, PFS analysis, full certificate chain via pyOpenSSL |
| Full | full_scan(target) |
Runs all three levels |
🔐 Certificate Analyzer (cyinfo.cert_analyzer)
Deep certificate and keystore inspection:
analyze_certificate(path)— Parse any cert format (PEM, DER, CRT, CER, P7B). Extracts: type/usage, subject, issuer, dates, fingerprints (SHA-256/SHA-1/MD5), crypto suite, key usage, SANs, extensions, and more.analyze_keystore(path, password)— Parse PKCS12/PFX and JKS keystores. Extracts private key info, certificate chain, and all cert details.test_ssl_with_private_key(key, cert, port)— Bind a private key to a socket and test all TLS versions with 20-field handshake detail extraction.
🌐 PyCurl Inspector (cyinfo.pycurl_inspector)
Low-level HTTP/TLS analysis using only pycurl — 17 parameters tested:
TLS handshake • Certificate chain & fingerprints • TLS version probing (1.0–1.3) • HTTP response & timing breakdown • HTTP/2 & HTTP/3/QUIC detection • Redirect chain tracing • Compression support • Cookie inspection • Security headers (10 checks) • Server/CDN/WAF fingerprinting • SSH banner & key exchange • Keep-alive behavior
Installation
pip install cyinfo
With JKS keystore support:
pip install cyinfo[jks]
For development:
pip install cyinfo[dev]
Quick Start
Python API
from cyinfo import basic_scan, medium_scan, advanced_scan
# Level 1 — Basic recon
result = basic_scan("example.com")
print(result['ip_info']['resolved_ip'])
print(result['geolocation']['country'])
# Level 2 — Medium analysis
result = medium_scan("example.com")
print(result['ssl_tls_info']['tls_version'])
print(result['security_headers_analysis']['grade'])
# Level 3 — Advanced SSL deep dive
result = advanced_scan("example.com")
print(result['encryption_details']['key_exchange'])
print(result['forward_secrecy']['supported'])
from cyinfo import analyze_certificate, analyze_keystore
# Analyze any certificate
cert = analyze_certificate("server.crt")
print(cert['certificates'][0]['validity']['days_remaining'])
# Parse a PKCS12 keystore
ks = analyze_keystore("keystore.p12", "password123")
print(ks['private_key_info']['bits'])
from cyinfo import pycurl_deep_inspect
# Full 17-parameter inspection
result = pycurl_deep_inspect("https://example.com")
print(result['4_tls_version_support']['supported_versions'])
print(result['13_security_headers']['grade'])
print(result['15_ssh_info']['banner'])
CLI
# Interactive scanner
cyinfo scan
# Quick commands
cyinfo scan --target example.com --level basic
cyinfo scan --target example.com --level full
cyinfo cert --file server.crt
cyinfo inspect --url https://example.com
Project Structure
cyinfo/
├── pyproject.toml # Package metadata & dependencies
├── README.md
├── LICENSE
├── src/
│ └── cyinfo/
│ ├── __init__.py # Public API exports
│ ├── cli.py # CLI entry point
│ ├── scanner.py # 3-tier network scanner
│ ├── cert_analyzer.py # Certificate & keystore analyzer
│ └── pycurl_inspector.py # PyCurl deep inspector
└── tests/
├── __init__.py
└── test_basic.py
Requirements
- Python 3.9+ (64-bit strictly required)
requests— HTTP requestsdnspython— DNS resolutionpyOpenSSL— Certificate chain analysispycurl— Low-level HTTP/TLS probing
License
MIT License — see LICENSE for details.
Metadata
Release files for cyinfo 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cyinfo-1.0.0.tar.gz | 40.8 kB | Without provenance | Details for cyinfo-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cyinfo-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for cyinfo-1.0.0-py3-none-any.whl |
Total release size: 78.9 kB
Release files / cyinfo-1.0.0.tar.gz
| Download URL | cyinfo-1.0.0.tar.gz |
|---|---|
| Size | 40.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
70c7050a1db343aa767d3a703d4523a1d2b5b2c650512bcde0668747a14604cc
|
|
BLAKE2b-256 checksum How to use checksums |
5575ea8232c3df04bea4a8c708a5d1898177b912b9f0d4d9ace08a0aebe92ecd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.5
|
Release files / cyinfo-1.0.0-py3-none-any.whl
| Download URL | cyinfo-1.0.0-py3-none-any.whl |
|---|---|
| Size | 38.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c2b158b83f5e6025f2be385f487bec1a50b1a501e8f6fc18372269f00bb0521f
|
|
BLAKE2b-256 checksum How to use checksums |
6b7eb058139100a35936cd8006f27bcc9c85cfccb06f61aef0a0c8bd722a336a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.5
|
Security for cyinfo 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.