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/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]]（抓包）配合使用