尧图网络科技YAOTU DIGITAL 获取报价
获取报价
首页 / 资讯中心 / 文章详情

Bandit 插件 B505 深度解析:Python 弱加密密钥检测实战指南

发布时间:2026/9/26 15:50:20

资讯中心
01
ARTICLE

Bandit 插件 B505 深度解析:Python 弱加密密钥检测实战指南

Bandit 插件 B505 深度解析:Python 弱加密密钥检测实战指南
SAST应用安全【免费下载链接】banditBandit is a tool designed to find common security issues in Python code.项目地址https://gitcode.com/gh_mirrors/ba/bandit点击查看免费下载导读本文以 Bandit 安全扫描器中的B505weak_cryptographic_key检测插件为核心深入讲解它如何识别 Python 代码中不安全的 RSA、DSA 与 EC 密钥长度涵盖阈值划分逻辑、severity/confidence 分级、可配置参数、检测边界以及基于 examples/weak_cryptographic_key_sizes.py 的完整实战验证。读完本文你将掌握 B505 的触发条件、如何通过 Bandit 配置调优阈值以及如何在自己的代码中规避弱密钥告警。B505 是什么检测弱密钥长度的安全插件B505 是 Bandit 内置的测试插件用于检查 Python 代码中是否使用了过短的加密密钥。随着算力提升较短的密钥长度已可被暴力破解或因数分解攻击攻破因此该插件以 NIST 推荐标准为依据设置阈值RSA 与 DSA 算法推荐密钥长度 2048 及以上1024 及以下视为可破解椭圆曲线EC密钥推荐 224 及以上160 及以下视为可破解。凡是低于这些下限的密钥使用都会被 B505 标记为安全问题。该插件的完整源码位于 bandit/plugins/weak_cryptographic_key.py属于 B5xx密码学插件组其插件 ID 分组可参见 doc/source/plugins/index.rst 中的 ID 对照表。插件最早在 Bandit0.14.0版本引入并在1.7.3版本补充了 CWE 信息关联 CWE-326即“加密强度不足”。检测的核心对象三类受支持的密钥生成调用B505 并不是对所有密钥相关代码都做检查而是精确匹配以下两个主流加密库的密钥生成函数调用库/模块匹配的函数限定名 qual name对应算法cryptographycryptography.hazmat.primitives.asymmetric.dsa.generate_private_keyDSAcryptographycryptography.hazmat.primitives.asymmetric.rsa.generate_private_keyRSAcryptographycryptography.hazmat.primitives.asymmetric.ec.generate_private_keyECPyCryptoCrypto.PublicKey.DSA.generateDSAPyCryptoCrypto.PublicKey.RSA.generateRSAPyCryptodomeCryptodome.PublicKey.DSA.generateDSAPyCryptodomeCryptodome.PublicKey.RSA.generateRSA从源码结构看这一匹配逻辑分别由_weak_crypto_key_size_cryptography_io与_weak_crypto_key_size_pycrypto两个内部函数完成前者通过context.call_function_name_qual匹配 cryptography 库的调用后者匹配 PyCrypto/PyCryptodome 的调用。EC 曲线生成目前只覆盖 cryptography 库PyCrypto/PyCryptodome 的 EC 生成函数不在匹配范围内。阈值与分级High / Medium 两档告警机制默认阈值配置gen_config函数为 B505 提供了 6 个可调参数及其默认值源码见 bandit/plugins/weak_cryptographic_key.py配置项默认值含义weak_key_size_dsa_high1024DSA 密钥长度低于此值时告警 Highweak_key_size_dsa_medium2048DSA 密钥长度低于此值时告警 Mediumweak_key_size_rsa_high1024RSA 密钥长度低于此值时告警 Highweak_key_size_rsa_medium2048RSA 密钥长度低于此值时告警 Mediumweak_key_size_ec_high160EC 密钥长度低于此值时告警 Highweak_key_size_ec_medium224EC 密钥长度低于此值时告警 Medium分级判定逻辑_classify_key_size函数实现了分级判定源码见 bandit/plugins/weak_cryptographic_key.py当密钥长度低于 high 阈值如 RSA/DSA 小于 1024、EC 小于 160时报告High 严重级别、High 置信度当密钥长度低于 medium 阈值但高于等于 high 阈值如 RSA/DSA 在 1024~2048 之间、EC 在 160~224 之间时报告Medium 严重级别、High 置信度告警文本统一为算法 key sizes below 阈值 bits are considered breakable.并附带 CWE-326issue.Cwe.INADEQUATE_ENCRYPTION_STRENGTH。例如在 examples/weak_cryptographic_key_sizes.py 第 36 行中dsa.generate_private_key(512, backends.default_backend())使用了 512 位的 DSA 密钥会触发如下输出 Issue: DSA key sizes below 1024 bits are considered breakable. Severity: High Confidence: High CWE: CWE-326 (https://cwe.mitre.org/data/definitions/326.html) Location: examples/weak_cryptographic_key_sizes.py:36关键实现细节EC 曲线的长度推导对于 cryptography 库的 EC 密钥B505 并不是直接读取数值型的 key_size 参数而是通过curve参数可以是关键字参数curve或位置参数解析出曲线对象名再查表得到对应位长源码见 bandit/plugins/weak_cryptographic_key.py。内置曲线映射表包含曲线名位长SECT571K1 / SECT571R1571 / 570SECP521R1521BrainpoolP512R1512SECT409K1 / SECT409R1409BrainpoolP384R1 / SECP384R1384SECT283K1 / SECT283R1283BrainpoolP256R1 / SECP256K1 / SECP256R1256SECT233K1 / SECT233R1233SECP224R1224SECP192R1192SECT163K1 / SECT163R2163如果传入的曲线不在映射表中例如动态生成的曲线对象则保守地默认按 224 位处理再交由阈值逻辑判定。参数提取策略关键字参数、位置参数与默认值回退B505 在提取密钥大小时采用了“优先关键字参数、其次位置参数、最后默认值”的回退策略cryptography 库的 DSA/RSA优先读取key_size关键字参数其次读取位置参数DSA 在第 0 位、RSA 在第 1 位因为 RSA 的第 0 位是public_exponent两者都缺失时默认按 2048 位处理源码见 bandit/plugins/weak_cryptographic_key.py。这也意味着调用时若完全省略 key_size 参数B505 不会告警——它假定调用方使用了库的默认安全长度。PyCrypto/PyCryptodome优先读取bits关键字参数其次读取位置参数第 0 位缺失时同样默认 2048 位源码见 bandit/plugins/weak_cryptographic_key.py。EC 曲线curve关键字参数优先于位置参数。检测边界B505 的已知局限从源码与示例文件中可以明确以下检测边界使用时应心中有数变量化的密钥长度不检测_classify_key_size中当key_size为字符串即由变量传入无法静态求值时直接返回不做告警。例如 examples/weak_cryptographic_key_sizes.py 第 64-66 行rsa.generate_private_key(public_exponent65537, key_sizesome_key_size, ...)不会被标记。这体现了静态分析工具的本质局限——无法追踪跨函数或运行时的变量值。动态曲线对象无法解析当曲线通过表达式如curves[self.curve]create传入时映射表查不到该对象B505 会保守地按默认 224 位处理见 examples/weak_cryptographic_key_sizes.py此时告警结论可能不准。不覆盖 PyCrypto/PyCryptodome 的 EC 生成仅 cryptography 库的 EC 曲线被纳入映射表。实战验证用示例文件跑一遍 B505运行方式假设仓库已在本地 clone且 Bandit 已安装可直接在仓库根目录对示例文件运行bandit -f txt examples/weak_cryptographic_key_sizes.pyexamples/weak_cryptographic_key_sizes.py精心构造了三类场景正确用法2048 位及以上、SECP384R1 等安全曲线、弱密钥用法1024 位 RSA/DSA、SECT163R2 等、以及变量化/动态化场景。期望输出按照 tests/functional/test_functional.py 中的功能测试断言对该示例文件运行 B505 应得到16 个告警全部为 High 置信度其中 8 个 High 严重级别、8 个 Medium 严重级别。具体对应关系为8 个 Highdsa.generate_private_key(key_size1024)、dsa.generate_private_key(512, ...)、rsa.generate_private_key(key_size1024)、rsa.generate_private_key(3, 512, ...)、两个ec.generate_private_key(curveec.SECT163R2)变体、pycrypto_*与pycryptodomex_*的 1024 位调用各 1 个8 个 Medium密钥长度介于 high 与 medium 阈值之间如示例中 1024 位 DSA/RSA 实际触发 Medium 档位的场景EC 曲线落在 160~224 区间如 SECT163R2 的 163 位落在 High 档而 192 位 SECP192R1 等落在 Medium 档时的告警。说明功能测试统计的是对示例文件的整体断言8 High 8 Medium16 个告警置信度全为 High具体告警行可结合-v详细输出对照示例文件逐行核对。如需只看 B505 的告警可配合-t B505过滤测试 IDbandit -t B505 -f txt examples/weak_cryptographic_key_sizes.py自定义阈值通过 Bandit 配置文件调优配置机制说明Bandit 1.0 之后配置文件为可选。插件如需配置项必须实现模块级的gen_config函数B505 即如此该函数以插件名为参数返回默认配置字典机制说明见 doc/source/plugins/index.rst 的 Config Generation 一节。当不指定配置文件、或配置文件缺少该插件段落时gen_config的默认值即生效。Bandit 还提供了bandit-config-generator工具可自动为所有已发现的插件生成配置模板块doc/source/config.rst 的 Generating a Config 一节生成的模板中即可看到 B505 的 6 个配置项按需删改即可。自定义配置示例若企业安全基线要求 RSA/DSA 不低于 3072 位、EC 不低于 256 位可创建如下bandit.yamlplugins: weak_cryptographic_key: weak_key_size_dsa_high: 2048 weak_key_size_dsa_medium: 3072 weak_key_size_rsa_high: 2048 weak_key_size_rsa_medium: 3072 weak_key_size_ec_high: 224 weak_key_size_ec_medium: 256运行时通过-c指定配置文件bandit -c bandit.yaml -r .配置文件中的插件配置段落名需与测试方法名即weak_cryptographic_key一致Bandit 才会读取并覆盖gen_config默认值。如何规避 B505 告警正确的修复姿势修复弱密钥告警核心是使用达到安全标准的密钥长度与曲线from cryptography.hazmat import backends from cryptography.hazmat.primitives.asymmetric import dsa, ec, rsa # 正确RSA 2048 位及以上 rsa.generate_private_key(public_exponent65537, key_size2048, backendbackends.default_backend()) # 正确DSA 2048 位及以上 dsa.generate_private_key(key_size2048, backendbackends.default_backend()) # 正确EC 使用安全曲线如 SECP384R1384 位 ec.generate_private_key(curveec.SECP384R1, backendbackends.default_backend())关于# nosec注释B505 只在确认密钥长度不安全时告警因此不推荐用# nosec直接压制此类告警正确做法是提升密钥长度本身。若确因特殊兼容性原因无法立即升级应在注释中说明原因并接受人工复核例如rsa.generate_private_key(public_exponent65537, key_size1024, # nosec B505 - 兼容遗留系统待迁移后升级 backendbackends.default_backend())总结B505 通过匹配 cryptography、PyCrypto、PyCryptodome 三套库的密钥生成调用以 RSA/DSAhigh1024、medium2048与 EChigh160、medium224的默认双档阈值输出 High/Medium 告警并支持通过gen_config暴露的 6 个配置项完全自定义安全基线。其“关键字参数 → 位置参数 → 默认值”的参数提取策略、EC 曲线映射表查长方案以及“变量化密钥长度不检测、动态曲线对象保守默认”的边界处理共同构成了这一插件的完整行为画像。理解这些实现细节能帮助你在真实项目中准确解读 B505 的每一份报告并把安全基线固化到 Bandit 配置中。相关资源插件源码bandit/plugins/weak_cryptographic_key.py测试示例examples/weak_cryptographic_key_sizes.py功能测试断言tests/functional/test_functional.py插件机制与配置生成说明doc/source/plugins/index.rstBandit 配置与bandit-config-generator用法doc/source/config.rst赞分享SAST应用安全【免费下载链接】banditBandit is a tool designed to find common security issues in Python code.项目地址https://gitcode.com/gh_mirrors/ba/bandit点击查看免费下载相关推荐5步掌握React SaaS主题定制从零打造个性化企业级界面5步掌握React SaaS主题定制从零打造个性化企业级界面 想要快速构建专业SaaS应用却苦于界面设计React SaaS Template为你提供了完美Bandit 插件 B507 深度解析检测 Paramiko SSH 主机密钥验证缺失ssh_no_host_key_verificationBandit 插件 B507 深度解析检测 Paramiko SSH 主机密钥验证缺失ssh_no_host_key_verification 导读 B5SAST应用安全小爱音箱接入大语言模型从Docker部署到自定义语音助手的完整教程小爱音箱接入大语言模型从Docker部署到自定义语音助手的完整教程 周五晚上你对客厅的小爱音箱说小爱同学给我讲个睡前故事等回来一句抱歉我没听懂SAST应用安全上一篇猫抓浏览器扩展完整教程3分钟学会网页视频下载神器下一篇SeleniumBase Case Plans 实战指南用 Markdown 表格管理测试用例计划与 case_summary.md 汇总创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
02
RELATED NEWS

相关资讯

更多网站建设与数字化升级内容

03
WHY YAOTU

想打造同款高转化官网?

懂行业、懂生意,从建站到增长一站式陪跑

◈

场景化定制

不做模板站,围绕你的业务场景量身设计,小众不撞款。

◐

营销型架构

以转化目标组织内容与路径,让官网真正带来询盘。

▲

全周期服务

设计、开发、运营、运维一体,上线只是开始。

免费获取你的建站方案

留下需求,专属顾问 24 小时内为你输出方案建议。