- source/rust → rust/ - source/conf → conf/ - source/www → www/ - source/data-seed → data-seed/ - source/data → data/ - scripts/ 保留(语义不对应 ipass deploy/) - /build/ 加入 .gitignore(本机 nginx 源码树) - README.md 目录树同步 + build 路径 /tmp/sso-build → ./build - Cargo.toml path 依赖 '../../deps/ipass' → '../deps/ipass' - CLAUDE.md 同步路径示例 cargo check 通过(52s);release build 通过(1m26s),产物 libsso_gateway.dylib
253 lines
7.9 KiB
Rust
253 lines
7.9 KiB
Rust
//! LDAP / AD 认证源(对齐 MaxKey `maxkey-ldap`)。
|
||
//!
|
||
//! 把企业目录(Active Directory / OpenLDAP)作为**认证源**接入:用户用目录里的
|
||
//! 账号密码登录管理台,口令不在本网关落地(由 AD 校验)。
|
||
//!
|
||
//! **零外部依赖**:不引 ldap3(其 async/tokio 模型与 nginx 单线程 FFI 冲突),
|
||
//! 这里手工编码 LDAP 的 BER/ASN.1 简单绑定(Simple Bind)——只够做「bind 成功 /
|
||
//! 失败」判定,不拉属性。属性同步走 [`crate::sync`] 连接器。
|
||
//!
|
||
//! 配置(env,全部可选):
|
||
//! LDAP_ENABLED=1 开启
|
||
//! LDAP_SERVER=ldap.corp.com 目录服务器
|
||
//! LDAP_PORT=389 端口(仅明文 389;TLS 由上层终结)
|
||
//! LDAP_BASE_DN=dc=corp,dc=com 基准 DN
|
||
//! LDAP_USER_DN_TEMPLATE=uid={user},{base} 用户 DN 模板
|
||
//! LDAP_AUTO_CREATE=1 目录认证成功但本地无账号时自动建账号
|
||
//!
|
||
//! 安全性:连接超时 3s,任何错误都降级为「认证失败」(绝不 panic、绝不放行)。
|
||
|
||
use std::io::{Read, Write};
|
||
use std::net::TcpStream;
|
||
use std::time::Duration;
|
||
|
||
use ipass_core::util;
|
||
|
||
/// 配置读取
|
||
fn enabled() -> bool {
|
||
std::env::var("LDAP_ENABLED").map(|v| v.trim() == "1").unwrap_or(false)
|
||
}
|
||
|
||
pub(crate) fn auto_create() -> bool {
|
||
std::env::var("LDAP_AUTO_CREATE").map(|v| v.trim() == "1").unwrap_or(false)
|
||
}
|
||
|
||
fn server() -> String {
|
||
std::env::var("LDAP_SERVER").unwrap_or_default()
|
||
}
|
||
|
||
fn port() -> u16 {
|
||
std::env::var("LDAP_PORT")
|
||
.ok()
|
||
.and_then(|v| v.trim().parse::<u16>().ok())
|
||
.unwrap_or(389)
|
||
}
|
||
|
||
fn user_dn(username: &str) -> String {
|
||
let base = std::env::var("LDAP_BASE_DN").unwrap_or_default();
|
||
let tpl = std::env::var("LDAP_USER_DN_TEMPLATE")
|
||
.unwrap_or_else(|_| "uid={user},{base}".to_owned());
|
||
tpl.replace("{user}", username).replace("{base}", &base)
|
||
}
|
||
|
||
// ===========================================================================
|
||
// BER / ASN.1 极简编解码
|
||
// ===========================================================================
|
||
|
||
/// 定长 TLV:tag + 长度 + 内容。长度 < 128 用单字节,否则长形式。
|
||
fn ber_len(n: usize) -> Vec<u8> {
|
||
if n < 128 {
|
||
vec![n as u8]
|
||
} else {
|
||
let mut bytes = Vec::new();
|
||
let mut v = n;
|
||
while v > 0 {
|
||
bytes.push((v & 0xff) as u8);
|
||
v >>= 8;
|
||
}
|
||
bytes.reverse();
|
||
let mut out = vec![0x80 | bytes.len() as u8];
|
||
out.extend_from_slice(&bytes);
|
||
out
|
||
}
|
||
}
|
||
|
||
fn ber_seq(content: &[u8]) -> Vec<u8> {
|
||
let mut v = vec![0x30];
|
||
v.extend_from_slice(&ber_len(content.len()));
|
||
v.extend_from_slice(content);
|
||
v
|
||
}
|
||
|
||
fn ber_int(n: i64) -> Vec<u8> {
|
||
// 最小字节(补码),小正整数走一个字节
|
||
let mut b = (n as i64).to_be_bytes().to_vec();
|
||
while b.len() > 1 && b[0] == 0 {
|
||
b.remove(0);
|
||
}
|
||
let mut v = vec![0x02];
|
||
v.extend_from_slice(&ber_len(b.len()));
|
||
v.extend_from_slice(&b);
|
||
v
|
||
}
|
||
|
||
fn ber_octet(s: &[u8]) -> Vec<u8> {
|
||
let mut v = vec![0x04];
|
||
v.extend_from_slice(&ber_len(s.len()));
|
||
v.extend_from_slice(s);
|
||
v
|
||
}
|
||
|
||
/// [APPLICATION n] 构造(如 BindRequest=0x60, BindResponse=0x61)
|
||
fn ber_app(app: u8, content: &[u8]) -> Vec<u8> {
|
||
let mut v = vec![0x60 | app];
|
||
v.extend_from_slice(&ber_len(content.len()));
|
||
v.extend_from_slice(content);
|
||
v
|
||
}
|
||
|
||
/// [CONTEXT n] 构造(如 simple 认证 = 0x80)
|
||
fn ber_ctx(ctx: u8, content: &[u8]) -> Vec<u8> {
|
||
let mut v = vec![0x80 | ctx];
|
||
v.extend_from_slice(&ber_len(content.len()));
|
||
v.extend_from_slice(content);
|
||
v
|
||
}
|
||
|
||
/// 解析一个 TLV,返回 (tag, 内容起始, 内容结束)
|
||
fn read_tlv(buf: &[u8], pos: usize) -> Option<(u8, usize, usize)> {
|
||
let tag = *buf.get(pos)?;
|
||
let mut p = pos + 1;
|
||
let first = *buf.get(p)? as usize;
|
||
let len = if first & 0x80 == 0 {
|
||
p += 1;
|
||
first
|
||
} else {
|
||
let nbytes = first & 0x7f;
|
||
p += 1;
|
||
let mut l = 0usize;
|
||
for _ in 0..nbytes {
|
||
l = (l << 8) | *buf.get(p)? as usize;
|
||
p += 1;
|
||
}
|
||
l
|
||
};
|
||
let start = p;
|
||
let end = start + len;
|
||
if end > buf.len() {
|
||
return None;
|
||
}
|
||
Some((tag, start, end))
|
||
}
|
||
|
||
/// 从 BindResponse 里取 resultCode(ENUMERATED,tag 0x0A)。
|
||
/// 简单做法:在整条消息里找第一个 0x0A,读其整数值(BindResponse 中唯一 ENUMERATED)。
|
||
fn result_code(msg: &[u8]) -> Option<u8> {
|
||
let mut i = 0;
|
||
while i < msg.len() {
|
||
if msg[i] == 0x0a {
|
||
// 长度(单字节即可,resultCode 很小)
|
||
let l = *msg.get(i + 1)? as usize;
|
||
let val_pos = i + 2;
|
||
if val_pos + l <= msg.len() {
|
||
let mut v: u32 = 0;
|
||
for k in 0..l {
|
||
v = (v << 8) | (*msg.get(val_pos + k)? as u32);
|
||
}
|
||
return Some(v as u8);
|
||
}
|
||
}
|
||
i += 1;
|
||
}
|
||
None
|
||
}
|
||
|
||
/// 解析整条 LDAPMessage(外层 SEQUENCE 长度可能跨多个 read)。
|
||
fn take_message(buf: &[u8]) -> Option<&[u8]> {
|
||
let (_, _start, end) = read_tlv(buf, 0)?;
|
||
if end <= buf.len() {
|
||
Some(&buf[..end])
|
||
} else {
|
||
None
|
||
}
|
||
}
|
||
|
||
// ===========================================================================
|
||
// 绑定
|
||
// ===========================================================================
|
||
|
||
/// 与目录服务器做一次 Simple Bind。成功返回 Ok(()),否则 Err。
|
||
fn bind(dn: &str, password: &str) -> Result<(), String> {
|
||
let server = server();
|
||
if server.is_empty() {
|
||
return Err("LDAP_SERVER 未配置".to_owned());
|
||
}
|
||
let mut stream = TcpStream::connect((server.as_str(), port()))
|
||
.map_err(|e| format!("连接目录服务器失败:{e}"))?;
|
||
stream.set_read_timeout(Some(Duration::from_secs(3))).ok();
|
||
stream.set_write_timeout(Some(Duration::from_secs(3))).ok();
|
||
|
||
// BindRequest 内容 = version(INT 3) + name(OCTET DN) + authentication(ctx[0]=simple, password)
|
||
let mut content = ber_int(3);
|
||
content.extend_from_slice(&ber_octet(dn.as_bytes()));
|
||
content.extend_from_slice(&ber_ctx(0, password.as_bytes()));
|
||
let bindreq = ber_app(0, &content);
|
||
// LDAPMessage = SEQUENCE { messageID INT 1, bindRequest }
|
||
let mut msg = ber_seq(&ber_int(1));
|
||
msg.extend_from_slice(&bindreq);
|
||
|
||
stream
|
||
.write_all(&msg)
|
||
.map_err(|e| format!("发送绑定请求失败:{e}"))?;
|
||
|
||
// 读回应:循环读到拿到完整 LDAPMessage
|
||
let mut buf = Vec::new();
|
||
let mut tmp = [0u8; 4096];
|
||
loop {
|
||
if let Some(full) = take_message(&buf) {
|
||
return match result_code(full) {
|
||
Some(0) => Ok(()),
|
||
Some(code) => Err(format!("目录返回结果码 {code}(非成功)")),
|
||
None => Err("无法解析绑定响应".to_owned()),
|
||
};
|
||
}
|
||
match stream.read(&mut tmp) {
|
||
Ok(0) => break,
|
||
Ok(n) => buf.extend_from_slice(&tmp[..n]),
|
||
Err(_) => break,
|
||
}
|
||
if buf.len() > 65536 {
|
||
break;
|
||
}
|
||
}
|
||
Err("绑定未收到完整响应".to_owned())
|
||
}
|
||
|
||
/// 认证入口:LDAP 开启时校验用户名/口令。
|
||
///
|
||
/// 返回 true 仅当 bind 成功;其余情况(未开启 / 任何错误)一律 false。
|
||
pub fn authenticate(username: &str, password: &str) -> bool {
|
||
if !enabled() {
|
||
return false;
|
||
}
|
||
if password.is_empty() {
|
||
return false;
|
||
}
|
||
let dn = user_dn(username);
|
||
match bind(&dn, password) {
|
||
Ok(()) => {
|
||
util::log_notice(&format!("[ldap] 认证成功 user={username} dn={dn}"));
|
||
true
|
||
}
|
||
Err(e) => {
|
||
util::log_warn(&format!("[ldap] 认证失败 user={username}:{e}"));
|
||
false
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 供登录流程判断是否需要尝试 LDAP(未开启时直接 false,零开销)。
|
||
pub fn should_try() -> bool {
|
||
enabled()
|
||
}
|