garrison 0.9.0

Garrison - 面向 Rust 生态的一站式身份认证鉴权框架
Documentation
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0

//! 社交登录 provider 名称校验工具:规则单一来源(DIP),供 garrison 内部与外部 crate(如 sinnan)共用。

// provider 名称校验

/// provider 名称最大长度(字节):覆盖已知社交平台标识,并防超长字符串攻击(内存消耗、日志膨胀、DAO key 注入)。
const MAX_PROVIDER_NAME_LEN: usize = 32;

/// 校验 provider 名称格式合法性:非空、1-32 字节、首字符小写字母、其余仅 `a-z0-9_`。
///
/// 仅允许小写且禁止冒号/空格/控制字符/SQL 元字符,防日志注入、DAO key 注入与 SQL 注入;非法名称调用方应返回 400 Bad Request。
///
/// # 示例
///
/// ```
/// use garrison::protocol::social::validation::is_valid_provider_name;
///
/// assert!(is_valid_provider_name("wechat"));
/// assert!(is_valid_provider_name("huawei"));
/// assert!(!is_valid_provider_name(""));
/// assert!(!is_valid_provider_name("WeChat"));
/// ```
pub fn is_valid_provider_name(provider: &str) -> bool {
    if provider.is_empty() || provider.len() > MAX_PROVIDER_NAME_LEN {
        return false;
    }
    let mut chars = provider.chars();
    if !chars
        .next()
        .map(|c| c.is_ascii_lowercase())
        .unwrap_or(false)
    {
        return false;
    }
    chars.all(|c| c.is_ascii_lowercase() || c.is_ascii_digit() || c == '_')
}

// 单元测试

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn is_valid_provider_name_accepts_valid_names() {
        assert!(is_valid_provider_name("wechat"), "'wechat' 应合法");
        assert!(is_valid_provider_name("huawei"), "'huawei' 应合法");
        assert!(is_valid_provider_name("alipay"), "'alipay' 应合法");
        assert!(is_valid_provider_name("a"), "单字符小写字母应合法");
        assert!(is_valid_provider_name("a1"), "字母+数字应合法");
        assert!(is_valid_provider_name("a_b"), "字母+下划线应合法");
        assert!(
            is_valid_provider_name("wechat_mini_app"),
            "多段下划线应合法"
        );
        assert!(
            is_valid_provider_name(&"a".repeat(32)),
            "32 字符(上限边界)应合法"
        );
    }

    #[test]
    fn is_valid_provider_name_rejects_invalid_names() {
        assert!(!is_valid_provider_name(""), "空字符串应拒绝");
        assert!(!is_valid_provider_name("A"), "大写字母开头应拒绝");
        assert!(!is_valid_provider_name("1abc"), "数字开头应拒绝");
        assert!(!is_valid_provider_name("_abc"), "下划线开头应拒绝");
        assert!(!is_valid_provider_name("-abc"), "连字符开头应拒绝");
        assert!(!is_valid_provider_name("weChat"), "含大写字母应拒绝");
        assert!(!is_valid_provider_name("Wechat"), "首字母大写应拒绝");
        assert!(!is_valid_provider_name("a!"), "含感叹号应拒绝");
        assert!(!is_valid_provider_name("a:b"), "含冒号应拒绝");
        assert!(!is_valid_provider_name("a-b"), "含连字符应拒绝");
        assert!(!is_valid_provider_name("a.b"), "含点号应拒绝");
        assert!(!is_valid_provider_name("a b"), "含空格应拒绝");
        assert!(
            !is_valid_provider_name("a\nb"),
            "含换行符应拒绝(日志注入)"
        );
        assert!(
            !is_valid_provider_name("wechat;DROP TABLE"),
            "含 SQL 注入字符应拒绝"
        );
        assert!(
            !is_valid_provider_name(&"a".repeat(33)),
            "33 字符应拒绝(超长攻击)"
        );
    }
}