Mentorust

用Rust编写的锐捷认证客户端，支持Linux系统和Windows系统。

温馨提示

本项目运行时不会保存任何配置文件，意味着您的所有配置都会在程序关闭后丢失，下一次启动您仍需要提供诸如密码之类的信息。 如果您需要保存配置，请自行修改源代码。

运行时环境变量

变量名	说明	默认值
RUST_LOG	日志级别，可选值：trace, debug, info, warn, error	info
EAPOL_ENABLE_DHCP	是否启用DHCP，可选值：1, 0	1
EAPOL_SERVICE	认证服务	network
EAPOL_HDD_SER	磁盘序列号	Static:AB45A862
MENTORUST_MAX_RETRIES	最大重试次数，超过此次数认证失败，0表示无限重试	3
MENTORUST_OUT_FILE	Linux平台后台运行时的输出文件	/tmp/mentorust.out
MENTORUST_PID_FILE	Linux平台后台运行时的PID文件	/tmp/mentorust.pid

帮助

mentorust auth -u 用户名 -p 密码

如果是Windows平台可以通过附加-b参数后台运行。

mentorust auth -u 用户名 -p 密码 -b

多网卡模式配置文件示例

[global]
# 是否后台运行
background = false
# 最大重试次数
max_retries = 3
# 日志级别
log_level = "info"
# 认证间隔（秒）
auth_interval = 15

[[networks]]
# 第一个网卡配置
nic = "eth0"
username = "student1@example.edu"
password = "password123"
# DHCP模式: 0(默认) 1(二次认证) 2(认证后) 3(认证前)
dhcp_mode = 1
# 反共享检测等级: 0（关闭） 1（低） 2（中） 3（高）
anti_share = 0
# 是否启用这个配置
enabled = true

[[networks]]
# 第二个网卡配置
nic = "eth1"
username = "student2@example.edu"
password = "password456"
dhcp_mode = 2
anti_share = 1
enabled = true

[[networks]]
# 第三个网卡配置（禁用状态）
nic = "wlan0"
username = "guest@example.edu"
password = "guestpass"
dhcp_mode = 0
anti_share = 0
enabled = false

安装依赖（构建）

Windows

1. 安装 Npcap
2. 安装界面勾选（Support 802.11 traffic）和（Install Npcap in WinPcap API-compatable Mode）
3. （可选）开发者需要设置环境变量LIB内容为Npcap SDK的LIB64或者LIB

Linux

需要安装libpcap库，例如：

• Debian: 安装 libpcap-dev
• Fedora: 安装 libpcap-devel
• OpenWrt 安装 libpcap 或者将libpcap.so放入/usr/lib并直接运行可执行文件 注意: 如果不是以root权限运行, 你需要像这样设置环境: sudo setcap cap_net_raw,cap_net_admin=eip path/to/bin。

Mac OS X

libpcap 需要被安装到Mac OS X。

TODO

• 反校园网共享检测支持
• 提供GUI界面
• 支持v3/v4算法