reverse-skills-max: initial public release (restored, redacted, hardened)

2026-10-20 02:17:15 +03:00
commit da24c2bd20
2227 changed files with 443931 additions and 0 deletions
--- a/vendor-new/rev-skills/.claude/skills/re-drm/references/examples.md
+++ b/vendor-new/rev-skills/.claude/skills/re-drm/references/examples.md
@@ -0,0 +1,139 @@
+# DRM 最小解析示例
+
+示例以本机可复现的最小样本为主：PSSH 用 Python 构造并解析（ISO/IEC 23001-7 字段），Widevine protobuf 用官方测试向量与 pywidevine 同源字段号（见 [[layout]]）。所有示例不涉及真实密钥材料。
+
+## 1. PSSH box 解析（Python，本机可直接跑）
+
+```python
+import struct
+
+# 构造一个 Widevine PSSH v0（Widevine SystemID + 初始数据）
+WIDEVINE_SYSTEM_ID = bytes.fromhex('edef8ba979d64acea3c827dcd51d21ed')
+
+def build_pssh(system_id, data, version=0, key_ids=()):
+    body = bytes([version, 0, 0, 0]) + system_id
+    if version == 1:
+        body += struct.pack('>I', len(key_ids))
+        for kid in key_ids:
+            body += kid
+    body += struct.pack('>I', len(data)) + data
+    return struct.pack('>I', 8 + len(body)) + b'pssh' + body
+
+def parse_pssh(buf):
+    assert buf[4:8] == b'pssh', 'not a pssh box'
+    size, = struct.unpack_from('>I', buf, 0)
+    version = buf[8]
+    sysid = buf[12:28].hex()
+    off = 28
+    kids = []
+    if version == 1:
+        n, = struct.unpack_from('>I', buf, off); off += 4
+        kids = [buf[off + 16*i : off + 16*(i+1)].hex() for i in range(n)]
+        off += 16 * n
+    dsize, = struct.unpack_from('>I', buf, off); off += 4
+    data = buf[off : off + dsize]
+    return dict(size=size, version=version, system_id=sysid,
+                key_ids=kids, data_len=dsize, data=data)
+
+pssh = build_pssh(WIDEVINE_SYSTEM_ID, b'\x08\x10\x12\x04test')
+print(parse_pssh(pssh))
+# {'size': 40, 'version': 0, 'system_id': 'edef8ba979d64acea3c827dcd51d21ed',
+#  'key_ids': [], 'data_len': 8, 'data': b'\x08\x10\x12\x04test'}
+# size = 8(头) + 4(version/flags) + 16(SystemID) + 4(DataSize) + 8(Data) = 40 ✓
+```
+
+对照要点：v0 布局 size + pssh + version/flags + SystemID + DataSize + Data；SystemID 判 DRM 类型（对照表见 [[layout]]）；v1 的 KID 列表插在 SystemID 与 DataSize 之间——解析必须先读 version（坑 5）。
+
+## 2. 真实媒体里找 PSSH（命令）
+
+```sh
+# 简易定位（box 链遍历更可靠，见上）
+grep -oba 'pssh' sample.mp4 | head -5
+# 结构化解析用 ffprobe（ffmpeg 自带）
+ffprobe -v error -show_entries stream_tags=variant_bitrate -of json sample.mp4
+# 或 mp4dump（bento4）：输出所有 box 树
+mp4dump sample.mp4 | grep -A4 pssh
+```
+
+## 3. Widevine 挑战/响应结构速查（字段号对照）
+
+以 pywidevine 同源 protobuf 字段号（完整表见 [[layout]]）验证解析：
+
+```python
+# 依赖: pip install protobuf
+# 用 grpcio-tools 从 Widevine 协议 .proto 生成后：
+# 外层 SignedMessage: msg.type 判定层（0=license request 1=license 2=error）
+# 内层 LicenseRequest: client_id(1) content_id(2) type(3) request_time(4)
+#                     protocol_version(6) key_control_nonce(7)
+def peek_proto(data, fields):
+    """极简 protobuf 字段窥探（varint 场景）：打每字段的 字段号/类型/值头"""
+    out = []
+    i = 0
+    while i < len(data):
+        tag = data[i]; i += 1
+        fno, wtype = tag >> 3, tag & 7
+        if wtype == 0:                      # varint
+            val = 0; sh = 0
+            while True:
+                b = data[i]; i += 1
+                val |= (b & 0x7f) << sh
+                if not b & 0x80: break
+                sh += 7
+            out.append((fno, 'varint', val))
+        elif wtype == 2:                    # length-delimited
+            ln = data[i]; i += 1
+            out.append((fno, 'bytes', ln, data[i:i+ln]))
+            i += ln
+        else:
+            break
+    return out
+
+# 用例：构造的 WidevineCencHeader 初始数据（见 [[layout]] WidevinePsshData 字段）
+```
+
+对照要点：外层 SignedMessage 的 `type` 决定内层 schema——直接按 LicenseRequest 解析响应必错（坑 6）。
+
+## 4. PlayReady 头/挑战 XML 对照
+
+```xml
+<!-- 内容元数据里的 WRMHEADER（PlayReadyHeader 命名空间） -->
+<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.0.0.0">
+  <DATA>
+    <PROTECTINFO><KEYLEN>16</KEYLEN><ALGID>AESCTR</ALGID></PROTECTINFO>
+    <KID>Cofu3FaCfjuAJNqKod80iw==</KID>      <!-- KID GUID（小端 base64） -->
+    <CHECKSUM>2u+jpp0wDIk=</CHECKSUM>
+    <LA_URL>https://lic.example/rightsmanager.asmx</LA_URL>
+  </DATA>
+</WRMHEADER>
+
+<!-- 许可证挑战（SOAP，protocols 命名空间） -->
+<AcquireLicense xmlns="http://schemas.microsoft.com/DRM/2007/03/protocols">
+  <challenge><Challenge xmlns="http://schemas.microsoft.com/DRM/2007/03/protocols/messages">
+    <LA xmlns="http://schemas.microsoft.com/DRM/2007/03/protocols" Id="SignedData">
+      <Version>1</Version><ContentHeader><!-- 内嵌 WRMHEADER --></ContentHeader>
+    </LA>
+  </Challenge></challenge>
+</AcquireLicense>
+```
+
+对照要点：KID 是公开标识（对得上许可证 URL 才有后续）；CHECKSUM 防 KID/密钥错配——拿到"密钥"后先按此核对再下结论（坑 2）。
+
+## 5. CDM 导出表核验（Ghidra/readelf）
+
+```sh
+# 自有环境 Widevine CDM（路径见 SKILL.md 步骤 1）
+readelf -d libwidevinecdm.so | grep NEEDED          # 依赖链（沙箱环境核对）
+readelf -s libwidevinecdm.so | grep -E 'Initialize|CreateSession|UpdateSession|Decrypt'
+# 导出函数是静态分析入口：交叉引用到密钥加载/解密路径
+```
+
+## 实现教训（内化）
+
+- 分层建模先行（设备密钥 → CEK → 媒体），任何"密钥"先问属于哪一层、解什么
+- PSSH 解析先读 version；Widevine 消息先解 SignedMessage 再按 type 选 schema
+- 版本锚点（CDM 版本 + sha256 + 分析时间）是所有结论的前提
+
+## 使用注意
+
+- 所有步骤限授权范围与受控环境（[[re-analyze/platform-tips]] 最高原则）；密钥材料不进报告
+- 与 [[re-protocol]]、[[re-crypto-id]]、[[re-netcap]] 配合；本文件示例不含真实密钥材料
--- a/vendor-new/rev-skills/.claude/skills/re-drm/references/layout.md
+++ b/vendor-new/rev-skills/.claude/skills/re-drm/references/layout.md
@@ -0,0 +1,137 @@
+# DRM 布局：密钥分层 / CENC-PSSH / Widevine protobuf / PlayReady SOAP
+
+DRM 分析的三个结构层：媒体侧（PSSH 与加密方案）、协议侧（许可证挑战/响应格式）、设备侧（CDM 导出与密钥链）。本文件给出三层的关键字段表，字段以 ISO/IEC 23001-7、Widevine protobuf（pywidevine 同源）与 PlayReady 官方规范为准。
+
+## 密钥分层模型（先建层再动手）
+
+```
+设备密钥 (device key, L3 软件密钥在 CDM 内/持久化存储；L1 在 TEE)
+  │ 解密许可证响应（含 CEK 密文 + 权限策略）
+  ▼
+内容密钥 (CEK, content key)
+  │ AES-CBC/CTR 解密媒体样本（cenc/cbc1/cbcs）
+  ▼
+明文媒体
+```
+
+- 分析每层时回答"哪来的、解什么"：设备密钥解许可证、CEK 解媒体——拿到中间层去解媒体必失败（坑 2）
+- CEK 通常还有权限策略约束（输出保护 HDCP 等）与短生命周期（密钥轮换）
+
+## CENC PSSH box（ISO/IEC 23001-7，大端）
+
+```
+offset  字段              说明
+0x00    size (u32)        整 box 字节数（含自身）
+0x04    'pssh' (u32)      类型（0x70 73 73 68）
+0x08    version (1B) + flags (3B)   version 0 / 1
+0x0C    SystemID (16B)    DRM 系统 UUID
+[version=1 时] KID count (u32) + KIDs (16B×N)
+0x?     DataSize (u32)    初始数据长度
+0x?     Data              DRM 特定初始数据（Widevine 为 WidevineCencHeader protobuf）
+```
+
+### SystemID 对照表
+
+| DRM | SystemID |
+|---|---|
+| Widevine | `edef8ba9-79d6-4ace-a3c8-27dcd51d21ed` |
+| PlayReady | `9a04f079-9840-4286-ab92-e65be0885f95` |
+| FairPlay | `94ce86fb-07ff-4f43-adb8-93d2fa968ca2` |
+| Common (v1) | `1077efec-c0b2-4d02-ace3-3c1e52e2fb4b` |
+
+- EME keySystem 字符串：`com.widevine.alpha` / `com.microsoft.playready` / `com.apple.fairplay`
+- DASH 等价：`ContentProtection schemeIdUri="urn:uuid:EDEF8BA9-..."` + base64 `<cenc:pssh>`
+- 媒体加密方案：cenc（AES-CTR）/ cbc1（AES-CBC）/ cbcs（模式保留，样本级加密）——决定解密分析走向
+
+## Widevine 消息（protobuf）
+
+所有客户端-服务端消息外层为 SignedMessage，按 type 选内层 schema。
+
+### SignedMessage（外层）
+
+| 字段号 | 名称 | 说明 |
+|---|---|---|
+| 1 | type | 0=license request 1=license 2=error |
+| 2 | msg | 内层序列化消息（按 type 解析） |
+| 3 | signature | 签名（会话密钥/设备密钥派生） |
+| 4 | session_key | 会话密钥（RSA-OAEP 封装） |
+| 5 | remote_attestation | 远程证明 |
+
+### LicenseRequest（type=0 时的内层）
+
+| 字段号 | 名称 | 说明 |
+|---|---|---|
+| 1 | client_id | ClientIdentification（设备证书/指纹） |
+| 2 | content_id | ContentIdentification（oneof） |
+| 3 | type | 1=NEW 2=RENEWAL 3=RELEASE（首次获取恒 NEW） |
+| 4 | request_time | Unix 秒（客户端时钟） |
+| 6 | protocol_version | 恒 CURRENT（协议版本 21） |
+| 7 | key_control_nonce | u32 随机数（31 位），参与 CMAC 密钥派生 |
+| 8 | encrypted_client_id | 隐私模式（AES-CBC 加密的 ClientIdentification） |
+
+### ClientIdentification
+
+- 1=token（TOKEN_TYPE_KEYBOX 或 DEVICE_CERTIFICATE）、2=client_info（name/value 对）、3=provider_info、4=supported_protocols（含 3=SRM 等）、5=key_control_nonces（老式）
+
+### ContentIdentification（oneof content_id_variant）
+
+| 变体号 | 名称 | 说明 |
+|---|---|---|
+| 1 | widevine_pssh_data | WidevinePsshData：pssh_data、key_ids、content_id、protection_scheme、crypto_period_* |
+| 2 | webm_key_id | WebM（header + license_type） |
+| 3 | existing_license | 续期/释放（引用已有 license） |
+| 4 | init_data | 原始 init data（隐私/非标准 PSSH） |
+
+### License（type=1 时的内层）
+
+- 1=license_identification（request_id + session_id）、2=content_key_info[]（每条：1=key_id、2=key_type（SW_SECURE_CRYPTO/SW_SECURE_DECODE/HW_SECURE_CRYPTO/HW_SECURE_DECODE/HW_SECURE_ALL）、3=key（CEK 密文）、4=permissions）、3=certificate、4=protection_scheme
+- key_type 等级与安全级别（L1/L3）对应——设备侧能力决定能拿到哪种 key
+
+## PlayReady 许可证（SOAP/XML）
+
+- 命名空间三件套：头 `http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader`；协议操作 `http://schemas.microsoft.com/DRM/2007/03/protocols`（`AcquireLicense`/`LicenseResponse`）；消息包裹 `.../protocols/messages`
+- 挑战：`AcquireLicense` → `challenge` → `LA`（SignedData，Version=1 + ContentHeader 内嵌 WRMHEADER）
+- 响应：`Response` → `LicenseResponse` → 加密 `License` blob（base64）
+
+### WRMHEADER（PlayReady 头，version 属性 4.0.0.0+）
+
+```xml
+<WRMHEADER xmlns="http://schemas.microsoft.com/DRM/2007/03/PlayReadyHeader" version="4.0.0.0">
+  <DATA>
+    <PROTECTINFO><KEYLEN>16</KEYLEN><ALGID>AESCTR</ALGID></PROTECTINFO>
+    <KID>base64-KID</KID>              <!-- 4.1+ 为 VALUE/ALGID/CHECKSUM 属性形式 -->
+    <CHECKSUM>base64-checksum</CHECKSUM>
+    <LA_URL>https://.../rightsmanager.asmx</LA_URL>
+  </DATA>
+</WRMHEADER>
+```
+
+- KID 是公开的密钥标识 GUID（小端字节序 base64）；CHECKSUM 防 KID/密钥错配
+- 服务端按 KID 查/派生内容密钥（key seed + KID 派生算法）
+- FairPlay（Apple 侧）：SPC（Server Playback Context，设备证书+会话）→ CKC（Content Key Context，含 CEK 密文）——由 [[re-ios]] 域延伸
+
+## CDM 导出函数（libwidevinecdm.so，C ABI）
+
+| 导出 | 作用 |
+|---|---|
+| Initialize | 初始化 CDM 实例（allow_distinctive_identifier / allow_persistent_state 等标志） |
+| CreateSession | 建会话（session_type + init_data_type + init_data），产出挑战 |
+| UpdateSession | 喂许可证响应（服务端返回的 license 消息） |
+| CloseSession / RemoveSession | 关会话 / 删持久会话 |
+| Decrypt | 解密样本（InputBuffer → 明文；无密钥返回 kNoKey） |
+| SetServerCertificate | 设置服务端证书（隐私模式/会话密钥封装） |
+
+- 静态分析入口：导出函数 → 交叉引用到密钥加载/解密路径
+- 接口带版本号（ContentDecryptionModule_7/8/11），同一导出名不同版本行为有差异
+
+## 版本差异要点
+
+- PSSH version 0（老）vs 1（新，带 KID 列表）——解析先读 version
+- Widevine 协议版本 CURRENT=21（字段号稳定，但服务端可能拒绝旧协议）
+- PlayReady WRMHEADER：4.0 的 KID 元素 → 4.1+ 的 VALUE/ALGID/CHECKSUM 属性形式
+- CDM 每季度更新：分析方法跨版本复用，密钥/偏移/签名不跨版本复用
+
+## 使用注意
+
+- 所有动态步骤在受控环境内（[[re-analyze/platform-tips]] 最高原则）；密钥材料不进报告
+- 与 [[re-protocol]]（协议结构）、[[re-crypto-id]]（算法识别）、[[re-netcap]]（抓包）配合使用