验证 OpenMLS 原生及浏览器兼容性 #2

Merged
xhgit merged 1 commits from xhgit/mls-compatibility into main 2026-11-13 18:14:34 +08:00
8 changed files with 2307 additions and 0 deletions

No files matched your search

+1
View File
@@ -5,3 +5,4 @@ dist/
*.log
test-results/
playwright-report/
/crypto/target/
+2
View File
@@ -0,0 +1,2 @@
[target.wasm32-unknown-unknown]
runner = "wasm-bindgen-test-runner"
+2133
View File
File diff suppressed because it is too large. Load diff
+21
View File
@@ -0,0 +1,21 @@
[package]
name = "xhchat-mls-check"
version = "0.1.0"
edition = "2024"
publish = false
[lib]
crate-type = ["cdylib", "rlib"]
[dependencies]
openmls = { version = "=0.9.2", features = ["js"] }
openmls_basic_credential = "=0.6.0"
openmls_rust_crypto = "=0.6.0"
tls_codec = "=0.5.0"
[target.'cfg(target_arch = "wasm32")'.dependencies]
getrandom = { version = "0.2", features = ["js"] }
wasm-bindgen = "0.2"
[target.'cfg(target_arch = "wasm32")'.dev-dependencies]
wasm-bindgen-test = "0.3"
+7
View File
@@ -0,0 +1,7 @@
# OpenMLS 兼容性验证
本目录用固定依赖验证 OpenMLS 的 MLS 1.0 应用消息、Welcome、密钥更新和移除流程。测试使用临时内存状态与虚构身份。
在本目录使用 Rust 1.95 运行 `cargo test --locked` 执行原生验证。浏览器验证需安装 Rust 的 `wasm32-unknown-unknown` 目标、wasm-bindgen-cli 0.2.130 和与本机 Chrome 匹配的 ChromeDriver。将 ChromeDriver 放入 PATH 或设置 CHROMEDRIVER,再执行 `cargo test --locked --target wasm32-unknown-unknown`。
用例用独立的三个客户端加入同一 MLS 群,使用 TLS 编码传输 Welcome、应用消息和移除 Commit。验证接收者能解密,重复消息被拒绝,且被移除的客户端无法解密新世代消息。
+137
View File
@@ -0,0 +1,137 @@
#[cfg(test)]
mod tests {
use ::tls_codec::{Deserialize as _, Serialize as _};
use openmls::prelude::*;
use openmls_basic_credential::SignatureKeyPair;
use openmls_rust_crypto::OpenMlsRustCrypto;
#[cfg(target_arch = "wasm32")]
use wasm_bindgen_test::wasm_bindgen_test;
#[cfg(target_arch = "wasm32")]
wasm_bindgen_test::wasm_bindgen_test_configure!(run_in_browser);
const SUITE: Ciphersuite = Ciphersuite::MLS_128_DHKEMX25519_AES128GCM_SHA256_Ed25519;
fn identity(id: &[u8]) -> (SignatureKeyPair, CredentialWithKey) {
let signer = SignatureKeyPair::new(SUITE.signature_algorithm()).unwrap();
let credential = CredentialWithKey {
credential: BasicCredential::new(id.to_vec()).into(),
signature_key: signer.to_public_vec().into(),
};
(signer, credential)
}
fn protocol_message(bytes: &[u8]) -> ProtocolMessage {
MlsMessageIn::tls_deserialize_exact(bytes)
.unwrap()
.try_into_protocol_message()
.unwrap()
}
fn deliver(group: &mut MlsGroup, provider: &OpenMlsRustCrypto, wire: &[u8]) -> Vec<u8> {
let processed = group
.process_message(provider, protocol_message(wire))
.unwrap();
let ProcessedMessageContent::ApplicationMessage(message) = processed.into_content() else {
panic!("expected an application message");
};
message.into_bytes()
}
#[cfg_attr(target_arch = "wasm32", wasm_bindgen_test)]
#[cfg_attr(not(target_arch = "wasm32"), test)]
fn messaging_and_removal() {
let alice = OpenMlsRustCrypto::default();
let bob = OpenMlsRustCrypto::default();
let carol = OpenMlsRustCrypto::default();
let (alice_key, alice_credential) = identity(b"alice-test-device");
let (bob_key, bob_credential) = identity(b"bob-test-device");
let (carol_key, carol_credential) = identity(b"carol-test-device");
let bob_package = KeyPackage::builder()
.build(SUITE, &bob, &bob_key, bob_credential)
.unwrap();
let carol_package = KeyPackage::builder()
.build(SUITE, &carol, &carol_key, carol_credential)
.unwrap();
let config = MlsGroupCreateConfig::builder()
.ciphersuite(SUITE)
.use_ratchet_tree_extension(true)
.build();
let join = MlsGroupJoinConfig::builder()
.use_ratchet_tree_extension(true)
.build();
let mut group = MlsGroup::new(&alice, &alice_key, &config, alice_credential).unwrap();
let (_, welcome, _) = group
.add_members(
&alice,
&alice_key,
&[
bob_package.key_package().clone(),
carol_package.key_package().clone(),
],
)
.unwrap();
group.merge_pending_commit(&alice).unwrap();
let encoded_welcome = welcome.tls_serialize_detached().unwrap();
let join_group = |provider: &OpenMlsRustCrypto| {
let decoded = MlsMessageIn::tls_deserialize_exact(&encoded_welcome).unwrap();
let MlsMessageBodyIn::Welcome(welcome) = decoded.extract() else {
panic!("expected a Welcome message");
};
StagedWelcome::new_from_welcome(provider, &join, welcome, None)
.unwrap()
.into_group(provider)
.unwrap()
};
let mut bob_group = join_group(&bob);
let mut carol_group = join_group(&carol);
let plaintext = b"xhchat test: end-to-end MLS payload";
let wire = group
.create_message(&alice, &alice_key, plaintext)
.unwrap()
.tls_serialize_detached()
.unwrap();
assert!(!wire.windows(plaintext.len()).any(|part| part == plaintext));
assert_eq!(deliver(&mut bob_group, &bob, &wire), plaintext);
assert_eq!(deliver(&mut carol_group, &carol, &wire), plaintext);
assert!(
bob_group
.process_message(&bob, protocol_message(&wire))
.is_err()
);
let carol_index = group
.members()
.find(|member| member.credential.serialized_content() == b"carol-test-device")
.expect("Carol is a member")
.index;
let (commit, _, _) = group
.remove_members(&alice, &alice_key, &[carol_index])
.unwrap();
group.merge_pending_commit(&alice).unwrap();
let wire_commit = commit.tls_serialize_detached().unwrap();
let change = bob_group
.process_message(&bob, protocol_message(&wire_commit))
.unwrap();
let ProcessedMessageContent::StagedCommitMessage(staged) = change.into_content() else {
panic!("expected a Commit message");
};
bob_group.merge_staged_commit(&bob, *staged).unwrap();
let wire = bob_group
.create_message(&bob, &bob_key, plaintext)
.unwrap()
.tls_serialize_detached()
.unwrap();
assert_eq!(deliver(&mut group, &alice, &wire), plaintext);
assert!(
carol_group
.process_message(&carol, protocol_message(&wire))
.is_err()
);
}
}
+2
View File
@@ -6,4 +6,6 @@
协议选型验收包括固定版本与依赖、公开审计覆盖、RFC 向量、独立实现互通、离线 Commit 重放、并发世代、恶意服务端替换密钥、存储中断与恢复、已撤销设备不能解密新内容。客户端需要原子提交协议状态与待发送密文,避免重试时复用发送状态。前向保密与入侵后恢复取决于 MLS 世代更新、旧秘密清除和对手退出设备。
OpenMLS 0.9.2 兼容性用例已在 Linux 原生和 Windows Chrome WebAssembly 中通过,覆盖三设备 Welcome、密文往返、重放拒绝和移除后无法读取新世代消息。OpenMLS 发布过 SRLabs 安全审计,应用层的身份绑定、WASM 封装、存储和投递仍需独立验证。 [OpenMLS 审计公告](https://blog.openmls.tech/)
附件采用公开的分块认证加密格式,评估带明确结束认证与大文件恢复语义的实现。每份附件生成独立随机密钥,密文通过对象存储分发,文件密钥及完整性元数据放在 E2EE 消息中。备份使用独立随机恢复秘密,显式确认恢复权限和完整性,服务端只存密文及版本。私人动态按受众分发密钥。Web 应用以同源、受控发布和严格 CSP 管理脚本信任,当前页面的恶意同源脚本属于独立威胁。
+4
View File
@@ -28,3 +28,7 @@ Web 和 Electron 共用 Vue 客户端,独立接入同一 Go API。真实 Postg
- 双端支持用户名查找、申请、接受、拒绝、撤回申请、备注、分组、删除、拉黑和解除拉黑。测试以 Web 与 Electron 两个账号验证申请和变更实时同步。
- 桌面端提供隔离浏览器窗口,支持地址栏、搜索、标签、导航、缩放、全屏、复制链接、普通窗口下载、隐私窗口和清除站点数据。集成测试确认远程网页位于独立 Session,Sandbox 生效,网页无 IPC 桥和 Node require,UA 保留真实 Chromium 版本并追加 XHChat 标识。测试同时验证地址栏拒绝本地文件协议。
## OpenMLS 兼容性
锁定 OpenMLS 0.9.2。Linux 原生 Rust 与 Windows Chrome WebAssembly 用例验证三台设备加入、消息加解密、重放拒绝和成员移除后新世代保密。应用消息接口、端侧持久化、可信设备绑定及 Electron 中的聊天互通仍待实现。