Files
sso/rust/crates/plugin-sso/src/ldap.rs
T
admin 1e2b117218 refactor(paths): 拆 source/ 包层,顶层与 ipass/ipass 对齐
- 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
2026-09-21 15:44:55 +08:00

253 lines
7.9 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 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()
}