cmp-mock-tester 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- cmp_mock_tester-0.1.0/LICENSE +21 -0
- cmp_mock_tester-0.1.0/PKG-INFO +204 -0
- cmp_mock_tester-0.1.0/README.md +177 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/__init__.py +37 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/asn1crypto_cmp/__init__.py +0 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/asn1crypto_cmp/rfc4210.py +437 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/cmpbuilder/__init__.py +814 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/cmpbuilder/cmp_mock.py +160 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/controllers/__init__.py +0 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/controllers/basic_server.py +224 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/controllers/cmp_server.py +48 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/controllers/handlers/__init__.py +0 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/controllers/handlers/cmpHandler.py +78 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/scripts/__init__.py +0 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester/scripts/ca.py +130 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester.egg-info/PKG-INFO +204 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester.egg-info/SOURCES.txt +21 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester.egg-info/dependency_links.txt +1 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester.egg-info/requires.txt +3 -0
- cmp_mock_tester-0.1.0/cmp_mock_tester.egg-info/top_level.txt +1 -0
- cmp_mock_tester-0.1.0/pyproject.toml +38 -0
- cmp_mock_tester-0.1.0/setup.cfg +4 -0
- cmp_mock_tester-0.1.0/tests/test_cmp.py +214 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 odele
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: cmp-mock-tester
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A field-level mocking CMP (RFC 4210) CA simulator for negative-testing certificate protocols on base stations (EE).
|
|
5
|
+
Author: odele
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/odeletteshaw/cmp_mock_tester
|
|
8
|
+
Project-URL: Source, https://github.com/odeletteshaw/cmp_mock_tester
|
|
9
|
+
Keywords: CMP,RFC 4210,PKI,CA,ASN.1,certificate,negative testing
|
|
10
|
+
Classifier: Development Status :: 3 - Alpha
|
|
11
|
+
Classifier: Intended Audience :: Developers
|
|
12
|
+
Classifier: Intended Audience :: Telecommunications Industry
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Topic :: Security :: Cryptography
|
|
19
|
+
Classifier: Topic :: System :: Networking
|
|
20
|
+
Requires-Python: <3.12,>=3.8
|
|
21
|
+
Description-Content-Type: text/markdown
|
|
22
|
+
License-File: LICENSE
|
|
23
|
+
Requires-Dist: asn1crypto>=1.5.1
|
|
24
|
+
Requires-Dist: oscrypto>=1.3.0
|
|
25
|
+
Requires-Dist: certbuilder>=0.15.0
|
|
26
|
+
Dynamic: license-file
|
|
27
|
+
|
|
28
|
+
# cmp-mock-tester
|
|
29
|
+
|
|
30
|
+
A field-level mocking **CMP (RFC 4210) CA simulator** for negative-testing
|
|
31
|
+
certificate protocols on base stations (EE).
|
|
32
|
+
|
|
33
|
+
一个用于**对基站(EE)做证书协议负向测试**的 CMP(RFC 4210)CA 模拟器。
|
|
34
|
+
它以 HTTP 服务的形式扮演 CA,接收基站发来的 `ir` / `kur` / `certconf`,
|
|
35
|
+
回以 `ip` / `kup` / `pkiconf`;核心能力是一个**通用字段注入器**,可在签名前
|
|
36
|
+
对响应报文的任意字段做篡改,从而验证基站是否正确校验/拒绝异常证书响应。
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 特性
|
|
41
|
+
|
|
42
|
+
- 只构建 **CA → EE** 方向的报文:`ip` / `kup` / `pkiconf`(及 `error`)。
|
|
43
|
+
- **字段级 mock 注入器**:在计算 PKIProtection **之前**篡改任意字段,签名覆盖篡改后内容。
|
|
44
|
+
- 支持 6 档操作:替换合法值、替换协议非法值、置空/零长度/NULL、删除可选字段(`OMIT`)、
|
|
45
|
+
新增字段、`Raw` 原样注入。
|
|
46
|
+
- 独立的**验签旋钮** `mock.protection`:`normal` / `skip` / `wrong_key` / `corrupt` / `empty`。
|
|
47
|
+
- 轻量 HTTP 服务(标准库 `http.server`),`POST /cmp` 收 DER、回 DER。
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 安装
|
|
52
|
+
|
|
53
|
+
依赖 `asn1crypto`、`oscrypto`、`certbuilder`,均为 PyPI 可安装的纯 Python 包。
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# 从源码(开发模式)
|
|
57
|
+
pip install -e .
|
|
58
|
+
|
|
59
|
+
# 或直接从 PyPI 安装
|
|
60
|
+
pip install cmp-mock-tester
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
> **Python 版本**:推荐 3.8 ~ 3.11。`oscrypto` / `certbuilder` 是较老的加密库,
|
|
64
|
+
> 在 Python 3.12+ 上可能出现兼容性问题;遇到安装/导入报错优先换回 3.11 或以下。
|
|
65
|
+
|
|
66
|
+
安装后可用一行命令验证核心模块可导入:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
python -c "from cmp_mock_tester import CmpServer, MockSpec, OMIT, general_name; print('OK')"
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 快速开始
|
|
75
|
+
|
|
76
|
+
```python
|
|
77
|
+
from oscrypto import asymmetric
|
|
78
|
+
|
|
79
|
+
from cmp_mock_tester import CmpServer, create_root_cert
|
|
80
|
+
|
|
81
|
+
# 1. 自签根 CA(onlyData=True 只返回材料,不落盘)
|
|
82
|
+
issuer_key, issuer_cert = create_root_cert(onlyData=True)
|
|
83
|
+
|
|
84
|
+
# 2. 起 CMP 服务
|
|
85
|
+
with CmpServer(port=0, host="127.0.0.1") as srv:
|
|
86
|
+
srv.ca_info = {"issuer_key": issuer_key, "issuer_cert": issuer_cert}
|
|
87
|
+
print("CMP 服务:", srv.url) # http://127.0.0.1:<random-port>
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
真实基站把 CMP 请求(`ir`/`kur`/`certconf`,DER,`application/pkixcmp`)POST 到
|
|
91
|
+
`{srv.url}/cmp`,服务自动解析并返回对应的 `ip`/`kup`/`pkiconf`。
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 核心:字段级 mock
|
|
96
|
+
|
|
97
|
+
`CmpServer.mock`(`MockSpec`)是一个**通用字段注入器**,对模拟器下发的报文做字段级篡改:
|
|
98
|
+
|
|
99
|
+
```text
|
|
100
|
+
mock.header[path] 签名前注入 header(dotted-path,支持 OMIT / Raw)
|
|
101
|
+
mock.body[path] 签名前注入 body(钻进 CertRepMessage,数字段=数组下标)
|
|
102
|
+
mock.protection 'normal' | 'skip' | 'wrong_key' | 'corrupt' | 'empty'
|
|
103
|
+
mock.protection_key wrong_key 模式下用于签名的假私钥
|
|
104
|
+
mock.extra_certs 默认(带签名证书) | OMIT/None(不带) | [cert,...](替换)
|
|
105
|
+
mock.reset() 清空
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
- **签名前注入**:`header` / `body` 的覆盖发生在计算 PKIProtection 之前,签名覆盖篡改后内容 ——
|
|
109
|
+
用于测设备的**字段语义校验**(会不会因字段非法而拒绝)。
|
|
110
|
+
- **验签单独测**:用 `mock.protection` 旋钮。
|
|
111
|
+
- **绕过 builder 校验**:注入不经过 builder 的类型/合法值 setter,可填“协议非法但结构合法”的值。
|
|
112
|
+
|
|
113
|
+
### 示例
|
|
114
|
+
|
|
115
|
+
```python
|
|
116
|
+
from cmp_mock_tester import OMIT, Raw, general_name
|
|
117
|
+
from cmp_mock_tester.asn1crypto_cmp.rfc4210 import PKIFailureInfo
|
|
118
|
+
from datetime import datetime, timezone
|
|
119
|
+
|
|
120
|
+
srv.mock.header['pvno'] = 'cmp1999' # 协议版本非法
|
|
121
|
+
srv.mock.header['transaction_id'] = b'' # 置零长度
|
|
122
|
+
srv.mock.header['message_time'] = datetime(2000, 1, 1, tzinfo=timezone.utc) # 过期
|
|
123
|
+
srv.mock.header['recip_nonce'] = OMIT # 删除可选字段
|
|
124
|
+
srv.mock.header['sender'] = general_name(fake_cert) # 换 sender(必须包 general_name)
|
|
125
|
+
|
|
126
|
+
srv.mock.body['response.0.status.status'] = 'rejection'
|
|
127
|
+
srv.mock.body['response.0.status.fail_info'] = PKIFailureInfo({'bad_pop'})
|
|
128
|
+
|
|
129
|
+
srv.mock.protection = 'corrupt' # 破坏签名(测验签)
|
|
130
|
+
# srv.mock.protection = 'wrong_key'; srv.mock.protection_key = fake_key
|
|
131
|
+
srv.mock.extra_certs = OMIT # 不带 extra_certs
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
> `mock.header['sender'|'recipient']` 直接写进 GeneralName 字段,不能传裸 `x509.Name`
|
|
135
|
+
> (asn1crypto 会拒绝),必须用 `general_name()` 包一下。它接受
|
|
136
|
+
> `Certificate` / `Name` / `GeneralName` 三种入参。
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 架构
|
|
141
|
+
|
|
142
|
+
```
|
|
143
|
+
真实基站 (EE) CMP 模拟器 (CA)
|
|
144
|
+
│ ir / kur / certconf (DER, application/pkixcmp) │
|
|
145
|
+
│ ─────────────────────────────────────────────────► │ POST /cmp
|
|
146
|
+
│ │ └─ msgHandler 分发
|
|
147
|
+
│ │ └─ issue_end_entity 签发 EE 证书
|
|
148
|
+
│ │ └─ builder.build() ── mock 注入 ──► 签名
|
|
149
|
+
│ ip / kup / pkiconf (DER) │
|
|
150
|
+
│ ◄───────────────────────────────────────────────── │
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
| 层 | 文件 | 职责 |
|
|
154
|
+
|---|---|---|
|
|
155
|
+
| 传输/路由 | `cmp_mock_tester/controllers/basic_server.py` | `@handler` 收集路由、后台线程 `HTTPServer`、`Request.send_der` |
|
|
156
|
+
| 服务 | `cmp_mock_tester/controllers/cmp_server.py` | `POST /cmp` 收 DER;持有 `ca_info` + `mock` |
|
|
157
|
+
| 消息分发 | `cmp_mock_tester/controllers/handlers/cmpHandler.py` | 按 `body.name` 分发并构建响应 |
|
|
158
|
+
| 构建 | `cmp_mock_tester/cmpbuilder/__init__.py` | 三个 builder + `_assemble_message`(签名 + mock 注入) |
|
|
159
|
+
| 字段注入 | `cmp_mock_tester/cmpbuilder/cmp_mock.py` | `MockSpec` —— 签名前篡改任意字段 |
|
|
160
|
+
| ASN.1 | `cmp_mock_tester/asn1crypto_cmp/rfc4210.py` | CMP/CRMF 结构定义,`PKIMessage.load/dump` 的依据 |
|
|
161
|
+
| 证书 | `cmp_mock_tester/scripts/ca.py` | 自签根 CA、签发 EE 证书 |
|
|
162
|
+
|
|
163
|
+
`ir` / `kur` / `certconf` 由真实基站主动发出,模拟器只**收取解析**、不构建;
|
|
164
|
+
模拟器只构建 CA→EE 方向的 `ip` / `kup` / `pkiconf`(及 `error`)。
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 目录结构
|
|
169
|
+
|
|
170
|
+
```
|
|
171
|
+
cmp_mock_tester/
|
|
172
|
+
├── __init__.py # 公开 API re-export + __version__
|
|
173
|
+
├── cmpbuilder/ # CMP 报文构建器(包)
|
|
174
|
+
│ ├── __init__.py # CMPResponseBuilder(ip/kup) / CMPConfirmBuilder(pkiconf) / CMPErrorBuilder(error)
|
|
175
|
+
│ └── cmp_mock.py # MockSpec / OMIT / Raw / general_name
|
|
176
|
+
├── asn1crypto_cmp/
|
|
177
|
+
│ └── rfc4210.py # CMP/CRMF 的 ASN.1 结构定义(PKIMessage 等)
|
|
178
|
+
├── controllers/
|
|
179
|
+
│ ├── basic_server.py # BasicServer / Request / @handler —— 轻量 HTTP 路由框架
|
|
180
|
+
│ ├── cmp_server.py # CmpServer:POST /cmp,持有 ca_info + mock
|
|
181
|
+
│ └── handlers/
|
|
182
|
+
│ └── cmpHandler.py # msgHandler:按 body 类型分发并构建响应
|
|
183
|
+
└── scripts/
|
|
184
|
+
└── ca.py # create_root_cert / issue_end_entity —— 证书工厂
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
> `tests/` 目录为**私有本地测试**,依赖内部测试框架与真实基站环境,**不在本仓库/包中**。
|
|
188
|
+
|
|
189
|
+
---
|
|
190
|
+
|
|
191
|
+
## 边界与已知限制
|
|
192
|
+
|
|
193
|
+
- **可 mock 的报文**:`ip` / `kup` / `pkiconf`。`error` 当前未接入 mock;
|
|
194
|
+
`ir` / `kur` / `certconf` 为收取解析、不构建。
|
|
195
|
+
- **只能注入“协议非法但结构合法”的值**(asn1crypto 仍能编码);尚不支持位级畸形 DER。
|
|
196
|
+
- **签名后篡改**(header_post / body_post)暂未实现。
|
|
197
|
+
- **已知缺口**:`mock.extra_certs = []` 当前被当作“不带”,故“在但空的 extra_certs”
|
|
198
|
+
暂不可表达;header / body 内的容器字段均支持“在但空”。
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## License
|
|
203
|
+
|
|
204
|
+
[MIT](./LICENSE)
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
# cmp-mock-tester
|
|
2
|
+
|
|
3
|
+
A field-level mocking **CMP (RFC 4210) CA simulator** for negative-testing
|
|
4
|
+
certificate protocols on base stations (EE).
|
|
5
|
+
|
|
6
|
+
一个用于**对基站(EE)做证书协议负向测试**的 CMP(RFC 4210)CA 模拟器。
|
|
7
|
+
它以 HTTP 服务的形式扮演 CA,接收基站发来的 `ir` / `kur` / `certconf`,
|
|
8
|
+
回以 `ip` / `kup` / `pkiconf`;核心能力是一个**通用字段注入器**,可在签名前
|
|
9
|
+
对响应报文的任意字段做篡改,从而验证基站是否正确校验/拒绝异常证书响应。
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 特性
|
|
14
|
+
|
|
15
|
+
- 只构建 **CA → EE** 方向的报文:`ip` / `kup` / `pkiconf`(及 `error`)。
|
|
16
|
+
- **字段级 mock 注入器**:在计算 PKIProtection **之前**篡改任意字段,签名覆盖篡改后内容。
|
|
17
|
+
- 支持 6 档操作:替换合法值、替换协议非法值、置空/零长度/NULL、删除可选字段(`OMIT`)、
|
|
18
|
+
新增字段、`Raw` 原样注入。
|
|
19
|
+
- 独立的**验签旋钮** `mock.protection`:`normal` / `skip` / `wrong_key` / `corrupt` / `empty`。
|
|
20
|
+
- 轻量 HTTP 服务(标准库 `http.server`),`POST /cmp` 收 DER、回 DER。
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 安装
|
|
25
|
+
|
|
26
|
+
依赖 `asn1crypto`、`oscrypto`、`certbuilder`,均为 PyPI 可安装的纯 Python 包。
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
# 从源码(开发模式)
|
|
30
|
+
pip install -e .
|
|
31
|
+
|
|
32
|
+
# 或直接从 PyPI 安装
|
|
33
|
+
pip install cmp-mock-tester
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
> **Python 版本**:推荐 3.8 ~ 3.11。`oscrypto` / `certbuilder` 是较老的加密库,
|
|
37
|
+
> 在 Python 3.12+ 上可能出现兼容性问题;遇到安装/导入报错优先换回 3.11 或以下。
|
|
38
|
+
|
|
39
|
+
安装后可用一行命令验证核心模块可导入:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
python -c "from cmp_mock_tester import CmpServer, MockSpec, OMIT, general_name; print('OK')"
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 快速开始
|
|
48
|
+
|
|
49
|
+
```python
|
|
50
|
+
from oscrypto import asymmetric
|
|
51
|
+
|
|
52
|
+
from cmp_mock_tester import CmpServer, create_root_cert
|
|
53
|
+
|
|
54
|
+
# 1. 自签根 CA(onlyData=True 只返回材料,不落盘)
|
|
55
|
+
issuer_key, issuer_cert = create_root_cert(onlyData=True)
|
|
56
|
+
|
|
57
|
+
# 2. 起 CMP 服务
|
|
58
|
+
with CmpServer(port=0, host="127.0.0.1") as srv:
|
|
59
|
+
srv.ca_info = {"issuer_key": issuer_key, "issuer_cert": issuer_cert}
|
|
60
|
+
print("CMP 服务:", srv.url) # http://127.0.0.1:<random-port>
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
真实基站把 CMP 请求(`ir`/`kur`/`certconf`,DER,`application/pkixcmp`)POST 到
|
|
64
|
+
`{srv.url}/cmp`,服务自动解析并返回对应的 `ip`/`kup`/`pkiconf`。
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## 核心:字段级 mock
|
|
69
|
+
|
|
70
|
+
`CmpServer.mock`(`MockSpec`)是一个**通用字段注入器**,对模拟器下发的报文做字段级篡改:
|
|
71
|
+
|
|
72
|
+
```text
|
|
73
|
+
mock.header[path] 签名前注入 header(dotted-path,支持 OMIT / Raw)
|
|
74
|
+
mock.body[path] 签名前注入 body(钻进 CertRepMessage,数字段=数组下标)
|
|
75
|
+
mock.protection 'normal' | 'skip' | 'wrong_key' | 'corrupt' | 'empty'
|
|
76
|
+
mock.protection_key wrong_key 模式下用于签名的假私钥
|
|
77
|
+
mock.extra_certs 默认(带签名证书) | OMIT/None(不带) | [cert,...](替换)
|
|
78
|
+
mock.reset() 清空
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
- **签名前注入**:`header` / `body` 的覆盖发生在计算 PKIProtection 之前,签名覆盖篡改后内容 ——
|
|
82
|
+
用于测设备的**字段语义校验**(会不会因字段非法而拒绝)。
|
|
83
|
+
- **验签单独测**:用 `mock.protection` 旋钮。
|
|
84
|
+
- **绕过 builder 校验**:注入不经过 builder 的类型/合法值 setter,可填“协议非法但结构合法”的值。
|
|
85
|
+
|
|
86
|
+
### 示例
|
|
87
|
+
|
|
88
|
+
```python
|
|
89
|
+
from cmp_mock_tester import OMIT, Raw, general_name
|
|
90
|
+
from cmp_mock_tester.asn1crypto_cmp.rfc4210 import PKIFailureInfo
|
|
91
|
+
from datetime import datetime, timezone
|
|
92
|
+
|
|
93
|
+
srv.mock.header['pvno'] = 'cmp1999' # 协议版本非法
|
|
94
|
+
srv.mock.header['transaction_id'] = b'' # 置零长度
|
|
95
|
+
srv.mock.header['message_time'] = datetime(2000, 1, 1, tzinfo=timezone.utc) # 过期
|
|
96
|
+
srv.mock.header['recip_nonce'] = OMIT # 删除可选字段
|
|
97
|
+
srv.mock.header['sender'] = general_name(fake_cert) # 换 sender(必须包 general_name)
|
|
98
|
+
|
|
99
|
+
srv.mock.body['response.0.status.status'] = 'rejection'
|
|
100
|
+
srv.mock.body['response.0.status.fail_info'] = PKIFailureInfo({'bad_pop'})
|
|
101
|
+
|
|
102
|
+
srv.mock.protection = 'corrupt' # 破坏签名(测验签)
|
|
103
|
+
# srv.mock.protection = 'wrong_key'; srv.mock.protection_key = fake_key
|
|
104
|
+
srv.mock.extra_certs = OMIT # 不带 extra_certs
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
> `mock.header['sender'|'recipient']` 直接写进 GeneralName 字段,不能传裸 `x509.Name`
|
|
108
|
+
> (asn1crypto 会拒绝),必须用 `general_name()` 包一下。它接受
|
|
109
|
+
> `Certificate` / `Name` / `GeneralName` 三种入参。
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 架构
|
|
114
|
+
|
|
115
|
+
```
|
|
116
|
+
真实基站 (EE) CMP 模拟器 (CA)
|
|
117
|
+
│ ir / kur / certconf (DER, application/pkixcmp) │
|
|
118
|
+
│ ─────────────────────────────────────────────────► │ POST /cmp
|
|
119
|
+
│ │ └─ msgHandler 分发
|
|
120
|
+
│ │ └─ issue_end_entity 签发 EE 证书
|
|
121
|
+
│ │ └─ builder.build() ── mock 注入 ──► 签名
|
|
122
|
+
│ ip / kup / pkiconf (DER) │
|
|
123
|
+
│ ◄───────────────────────────────────────────────── │
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
| 层 | 文件 | 职责 |
|
|
127
|
+
|---|---|---|
|
|
128
|
+
| 传输/路由 | `cmp_mock_tester/controllers/basic_server.py` | `@handler` 收集路由、后台线程 `HTTPServer`、`Request.send_der` |
|
|
129
|
+
| 服务 | `cmp_mock_tester/controllers/cmp_server.py` | `POST /cmp` 收 DER;持有 `ca_info` + `mock` |
|
|
130
|
+
| 消息分发 | `cmp_mock_tester/controllers/handlers/cmpHandler.py` | 按 `body.name` 分发并构建响应 |
|
|
131
|
+
| 构建 | `cmp_mock_tester/cmpbuilder/__init__.py` | 三个 builder + `_assemble_message`(签名 + mock 注入) |
|
|
132
|
+
| 字段注入 | `cmp_mock_tester/cmpbuilder/cmp_mock.py` | `MockSpec` —— 签名前篡改任意字段 |
|
|
133
|
+
| ASN.1 | `cmp_mock_tester/asn1crypto_cmp/rfc4210.py` | CMP/CRMF 结构定义,`PKIMessage.load/dump` 的依据 |
|
|
134
|
+
| 证书 | `cmp_mock_tester/scripts/ca.py` | 自签根 CA、签发 EE 证书 |
|
|
135
|
+
|
|
136
|
+
`ir` / `kur` / `certconf` 由真实基站主动发出,模拟器只**收取解析**、不构建;
|
|
137
|
+
模拟器只构建 CA→EE 方向的 `ip` / `kup` / `pkiconf`(及 `error`)。
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 目录结构
|
|
142
|
+
|
|
143
|
+
```
|
|
144
|
+
cmp_mock_tester/
|
|
145
|
+
├── __init__.py # 公开 API re-export + __version__
|
|
146
|
+
├── cmpbuilder/ # CMP 报文构建器(包)
|
|
147
|
+
│ ├── __init__.py # CMPResponseBuilder(ip/kup) / CMPConfirmBuilder(pkiconf) / CMPErrorBuilder(error)
|
|
148
|
+
│ └── cmp_mock.py # MockSpec / OMIT / Raw / general_name
|
|
149
|
+
├── asn1crypto_cmp/
|
|
150
|
+
│ └── rfc4210.py # CMP/CRMF 的 ASN.1 结构定义(PKIMessage 等)
|
|
151
|
+
├── controllers/
|
|
152
|
+
│ ├── basic_server.py # BasicServer / Request / @handler —— 轻量 HTTP 路由框架
|
|
153
|
+
│ ├── cmp_server.py # CmpServer:POST /cmp,持有 ca_info + mock
|
|
154
|
+
│ └── handlers/
|
|
155
|
+
│ └── cmpHandler.py # msgHandler:按 body 类型分发并构建响应
|
|
156
|
+
└── scripts/
|
|
157
|
+
└── ca.py # create_root_cert / issue_end_entity —— 证书工厂
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
> `tests/` 目录为**私有本地测试**,依赖内部测试框架与真实基站环境,**不在本仓库/包中**。
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 边界与已知限制
|
|
165
|
+
|
|
166
|
+
- **可 mock 的报文**:`ip` / `kup` / `pkiconf`。`error` 当前未接入 mock;
|
|
167
|
+
`ir` / `kur` / `certconf` 为收取解析、不构建。
|
|
168
|
+
- **只能注入“协议非法但结构合法”的值**(asn1crypto 仍能编码);尚不支持位级畸形 DER。
|
|
169
|
+
- **签名后篡改**(header_post / body_post)暂未实现。
|
|
170
|
+
- **已知缺口**:`mock.extra_certs = []` 当前被当作“不带”,故“在但空的 extra_certs”
|
|
171
|
+
暂不可表达;header / body 内的容器字段均支持“在但空”。
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## License
|
|
176
|
+
|
|
177
|
+
[MIT](./LICENSE)
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# coding: utf-8
|
|
2
|
+
"""cmp-mock-tester — a CMP (RFC 4210) CA simulator with field-level mocking.
|
|
3
|
+
|
|
4
|
+
The simulator acts as a Certificate Authority over HTTP: it receives ``ir`` /
|
|
5
|
+
``kur`` / ``certconf`` from a base station (EE) and replies with ``ip`` /
|
|
6
|
+
``kup`` / ``pkiconf``. Its core feature is a field-level mock injector that
|
|
7
|
+
can tamper with any response field *before* signing, to verify that the EE
|
|
8
|
+
correctly rejects malformed certificate responses.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from cmp_mock_tester.cmpbuilder import (
|
|
12
|
+
CMPConfirmBuilder,
|
|
13
|
+
CMPErrorBuilder,
|
|
14
|
+
CMPResponseBuilder,
|
|
15
|
+
MockSpec,
|
|
16
|
+
OMIT,
|
|
17
|
+
Raw,
|
|
18
|
+
general_name,
|
|
19
|
+
)
|
|
20
|
+
from cmp_mock_tester.controllers.cmp_server import CmpServer
|
|
21
|
+
from cmp_mock_tester.scripts.ca import create_root_cert, issue_end_entity
|
|
22
|
+
|
|
23
|
+
__version__ = '0.1.0'
|
|
24
|
+
|
|
25
|
+
__all__ = [
|
|
26
|
+
'CMPResponseBuilder',
|
|
27
|
+
'CMPConfirmBuilder',
|
|
28
|
+
'CMPErrorBuilder',
|
|
29
|
+
'MockSpec',
|
|
30
|
+
'OMIT',
|
|
31
|
+
'Raw',
|
|
32
|
+
'general_name',
|
|
33
|
+
'CmpServer',
|
|
34
|
+
'create_root_cert',
|
|
35
|
+
'issue_end_entity',
|
|
36
|
+
'__version__',
|
|
37
|
+
]
|
|
File without changes
|