| 项 | 值 |
|---|---|
| Base URL | https://ctlog.darksphere.ai(pdns.darksphere.ai 同样可用) |
| 鉴权方式 | 请求头 X-API-Key: <API Key>(与 pDNS 平台同一套 Key,在 pdns 控制台签发) |
| 响应格式 | JSON(count 条数 / elapsed_ms 耗时 / data[] 结果数组) |
| 限速 | 每 key 120 次/分钟;每租户日配额见 Key 配置 |
| 错误码 | 401 key 无效 · 429 限速/超配额 · 400 参数缺失 · 5xx 服务端异常 |
data 为空数组 = 无匹配记录(不代表错误)。时间字段为 UTC。
返回该域名在 CT 日志中的全部证书签发记录(最多 500 条,按时间倒序)。
| 响应字段 | 类型 | 说明 |
|---|---|---|
| ts | datetime | 证书入库时间(UTC) |
| issuer_org | string | 签发 CA 机构(Let's Encrypt / DigiCert / Google Trust Services ...) |
| not_before | datetime | 证书生效开始时间 |
| fingerprint | string | 证书 SHA-256 指纹(用于同证书聚类) |
| log_source | string | 来源 CT 日志分片 |
| wildcard | bool | 是否泛域名证书 |
| risk_tld | bool | 域名是否使用高风险 TLD |
# 请求 curl -H "X-API-Key: YOUR_KEY" \ "https://ctlog.darksphere.ai/api/ct/domain/threathunter.cn"
# 响应(节选)
{"count": 24, "elapsed_ms": 45.2, "data": [
{"ts": "2026-09-15 08:21:33", "issuer_org": "Let's Encrypt",
"not_before": "2026-09-15 07:58:10",
"fingerprint": "8f3a...e91", "log_source": "gcs2x25",
"wildcard": false, "risk_tld": false}, ...]}
时间窗内最新签发的证书,用于钓鱼基建分钟级发现。
| 参数 | 说明 |
|---|---|
hours | 时间窗(1-720,默认 24) |
brand | 品牌词过滤(如 apple / qq / bank),命中 brand_hit |
risk | 1 = 仅高风险 TLD |
limit | 返回条数(默认/上限 5000) |
# 过去 1 小时新签发的苹果高仿证书 curl -H "X-API-Key: YOUR_KEY" \ "https://ctlog.darksphere.ai/api/ct/recent?brand=apple&hours=1"
{"count": 3, "elapsed_ms": 120.8, "data": [
{"ts": "2026-09-15 09:01:12", "domain": "appleidverify-support.com",
"brand_hit": "apple", "risk_tld": false,
"issuer_org": "Let's Encrypt", "wildcard": false}, ...]}
同一张证书签给的所有域名 —— 同一诈骗套件的强信号。
curl -H "X-API-Key: YOUR_KEY" \ "https://ctlog.darksphere.ai/api/ct/fingerprint/<sha256指纹>"
{"count": 4, "elapsed_ms": 38.1, "data": [
{"domain": "login-appleid-support.com", "brand_hit": "apple",
"wildcard": false, "first_seen": "...", "last_seen": "..."}, ...]}
按域名聚合(hours/brand/risk/limit),返回 first_seen/last_seen/entries/issuer,适合"过去 N 小时首次出现的证书域名"巡检。
curl -H "X-API-Key: YOUR_KEY" \ "https://ctlog.darksphere.ai/api/ct/new?hours=24&risk=1&limit=100"
hours 时间窗内的 by_hour(按小时)/ by_issuer(按签发 CA Top10)/ by_brand(品牌命中 Top10)。
curl -H "X-API-Key: YOUR_KEY" \ "https://ctlog.darksphere.ai/api/ct/stats?hours=24"
# 1. 品牌高仿分钟级预警
/api/ct/recent?brand=apple&hours=1
# 2. 新注册域名 × 当天新证书 → 钓鱼基建孵化
/api/registered/今天 ∩ /api/ct/new?hours=24
# 3. 同证书域名群 → 诈骗套件批量下架
/api/ct/fingerprint/{任一可疑域名的指纹}
CT 采集覆盖 23 个日志分片(Google / Cloudflare / DigiCert / Sectigo / TrustAsia 全系),全球新签发证书分钟级入库;不覆盖自签名与私有 PKI。控制台本身不带 Key 管理 —— Key 在 pdns.darksphere.ai 控制台统一签发。