法语

安全意识网络协议解析库。

此库包含各种网络协议的解析器，并旨在用于网络安全传感器。

每个解析器都公开一个通用接口，允许传感器引擎将字节喂入解析器并接收解析后的元数据。字节应位于会话层，因此引擎负责将传输层数据组装成会话有效负载，然后将其馈入此库。

此库旨在具有弹性，解析尽可能多的野外看到的消息。如果消息无效或不符合规范，则解析器不应将其丢弃。当消息失败验证时，解析器将在消息上设置标志而不是返回错误。

每个解析器的接口都是统一和简单的，仅由几个函数组成

• 测试负载是否为所讨论的协议（例如，这是modbus吗？）
• 向解析器提供更多字节
• 设置回调以在特定于协议的元数据事件上调用（待办事项）
• 指示某些字节不可用（例如，通知数据包丢失）（待办事项）
• 指示会话已结束（待办事项）

库公开 Rust 和 C 绑定，以便轻松集成到现有的和未来的网络安全传感器平台。（待办事项）

使用方法

通过在项目的 Cargo.toml 依赖项中包含解析器来开始使用 SAWP。还需要基本库来使用常见类型。

Rustc 的最低支持版本是 rustc 1.63.0。

示例

[dependencies]
sawp-modbus = "0.13.0"
sawp = "0.13.0"

FFI 支持

一些解析器为 C/C++ 项目提供了外部函数接口。可以通过使用带有 ffi 功能来启用 FFI 支持。

还提供了一个 Makefile 以简化构建过程。请参阅此文件以获取更深入的文档。

# Install cbindgen which is required to generate headers
cargo install --force cbindgen

# Build headers and shared objects
make

贡献

该项目正在积极维护并接受开源贡献。有关详细信息，请参阅 CONTRIBUTING。