modelscan

modelscan

开源AI模型安全扫描工具助力高效检测风险

ModelScan是Protect AI开发的开源AI模型安全扫描工具,支持H5、Pickle和SavedModel等多种格式。它可快速识别PyTorch、TensorFlow、Keras等框架中的模型安全风险,有效防范模型序列化攻击。ModelScan易于集成到机器学习流程中,为AI模型全生命周期提供安全保障,保护数据和系统安全。

ModelScan机器学习模型安全扫描序列化攻击开源项目Github

ModelScan横幅 bandit build black mypy tests 支持的版本 pypi版本 许可证:Apache 2.0

ModelScan:防御模型序列化攻击的工具

机器学习(ML)模型在互联网上公开共享,在团队内部和团队之间传播。基础模型的兴起导致公共ML模型越来越多地被用于进一步训练/微调。ML模型越来越多地被用于做出关键决策和支持关键任务应用。

尽管如此,模型还没有像扫描收件箱中的PDF文件那样严格地被扫描。

这种情况需要改变,而适当的工具是第一步。

ModelScan预览

ModelScan是Protect AI的一个开源项目,用于扫描模型以确定它们是否包含不安全的代码。它是第一个支持多种模型格式的模型扫描工具。ModelScan目前支持:H5、Pickle和SavedModel格式。这可以在使用PyTorch、TensorFlow、Keras、Sklearn、XGBoost等框架时保护您,未来还会支持更多。

简介

如果您准备开始扫描您的模型,很简单:

pip install modelscan

安装完成后,扫描一个模型:

modelscan -p /path/to/model_file.pkl

为什么要扫描模型

模型通常由自动化流程创建,有些可能来自数据科学家的笔记本电脑。无论哪种情况,模型都需要在使用前从一台机器转移到另一台机器。将模型保存到磁盘的过程称为序列化。

模型序列化攻击是指在序列化(保存)过程中向模型内容添加恶意代码,然后再分发 —— 这是特洛伊木马的现代版本。

攻击通过利用模型的保存和加载过程来实现。当您使用model = torch.load(PATH)加载模型时,PyTorch会打开文件内容并开始运行其中的代码。一旦加载模型,漏洞就已经执行了。

模型序列化攻击可以用于执行:

  • 凭证盗窃(用于在您的环境中向其他系统写入和读取数据的云凭证)
  • 数据盗窃(发送给模型的请求)
  • 数据污染(模型执行任务后发送的数据)
  • 模型污染(改变模型本身的结果)

这些攻击非常容易执行,您可以在我们的📓notebooks文件夹中查看工作示例。

入门

ModelScan如何工作

如果使用机器学习框架加载模型会自动执行攻击,那么ModelScan如何在不加载恶意代码的情况下检查内容呢?

很简单,它像读取字符串一样一次读取文件内容的一个字节,寻找不安全的代码签名。这使得它非常快速,在大多数情况下只需几秒钟就能扫描完模型(取决于计算机处理磁盘上总文件大小的时间)。它也很安全。

ModelScan将不安全代码分为以下级别:

  • 严重

ModelScan流程图

如果检测到问题,请立即联系模型作者以确定原因。

在某些情况下,代码可能嵌入到模型中以便数据科学家更容易重现,但这会使您面临攻击风险。请自行判断是否适合您的工作负载。

支持哪些模型和框架?

这将不断扩展,所以请关注我们的发布说明中的变化。

目前,ModelScan支持任何Pickle衍生格式和许多其他格式:

ML库API序列化格式modelscan支持
Pytorchtorch.save()和torch.load()Pickle
Tensorflowtf.saved_model.save()Protocol Buffer
Keraskeras.models.save(save_format= 'h5')HD5 (分层数据格式)
keras.models.save(save_format= 'keras')Keras V3 (分层数据格式)
经典ML库 (Sklearn, XGBoost等)pickle.dump(), dill.dump(), joblib.dump(), cloudpickle.dump()Pickle, Cloudpickle, Dill, Joblib

安装

ModelScan作为Python包安装在您的系统上(支持Python 3.9到3.12)。如上所示,您可以在终端中运行以下命令来安装它:

pip install modelscan

要将其包含在项目的依赖项中,使其对所有人可用,请将其添加到您的requirements.txtpyproject.toml文件中,如下所示:

modelscan = ">=0.1.1"

对于Tensorflow或HD5格式的模型扫描器,需要安装额外的依赖:

pip install 'modelscan[ tensorflow, h5py ]'

通过CLI使用ModelScan

ModelScan通过CLI支持以下参数:

用法参数说明
modelscan -h -h 或 --help查看使用帮助
modelscan -v -v 或 --version查看版本信息
modelscan -p /path/to/model_file-p 或 --path扫描本地存储的模型
modelscan -p /path/to/model_file --settings-file ./modelscan-settings.toml--settings-file使用自定义配置扫描本地存储的模型
modelscan create-settings-file-l 或 --location创建可配置的设置文件
modelscan -r-r 或 --reporting-format输出格式。选项包括console、json或custom(在设置文件中定义)。默认为console
modelscan -r reporting-format -o file-name-o 或 --output-file输出报告的可选文件名
modelscan --show-skipped--show-skipped打印扫描过程中被跳过的文件列表

请记住,模型和其他任何形式的数字媒体一样,在使用来自不可信来源的内容之前,您应该对其进行扫描。

CLI退出代码

CLI退出状态代码如下:

  • 0:扫描成功完成,未发现漏洞
  • 1:扫描成功完成,发现漏洞
  • 2:扫描失败,modelscan在扫描过程中抛出错误
  • 3:未向工具传递支持的文件
  • 4:使用错误,CLI传递了无效或不完整的选项

理解结果

一旦扫描完成,如果发现问题,您将看到类似这样的输出:

ModelScan扫描输出

这里我们有一个模型,在其中同时存在ReadFileWriteFile的不安全操作符。 显然,我们不希望我们的模型任意读写文件。我们现在需要联系这个模型的创建者,以确定他们期望它做什么。在这个特定的情况下, 它允许攻击者读取我们的AWS凭证并将其写入另一个位置。

这对于使用来说是坚决不行的。

在您的ML流程和CI/CD流程中集成ModelScan

临时扫描是一个很好的第一步,请让自己、同事和朋友养成习惯,每当他们下载新模型进行探索时都要这样做。但这对于改善生产MLOps流程的安全性还不够。

模型扫描需要多次执行以实现以下目标:

  1. 在加载所有预训练模型进行进一步工作之前对其进行扫描,以防止受损模型影响您的模型构建或数据科学环境。
  2. 训练后扫描所有模型,以检测可能破坏新模型的供应链攻击。
  3. 在部署到端点之前扫描所有模型,以确保模型在存储后未被破坏。

下图中的红色块在传统ML流程中突出显示了这一点。 集成ModelScan的MLOps流程

对于LLM、基础模型或外部模型的微调或任何修改,这些流程都是相同的。

如果在ML流程之外进行模型部署,请在CI/CD系统的部署过程中嵌入扫描,以确保使用安全。

深入探讨

在📓notebooks文件夹中,您可以探索一些展示如何针对各种ML框架(如TensorFlow和PyTorch)执行模型序列化攻击的笔记本。

要深入了解这些攻击的具体工作原理,请查看🖹模型序列化攻击解释器

如果您遇到任何其他在静态上下文中评估模型的方法,请联系我们,我们很乐意了解更多!

许可

版权所有 2023 Protect AI

根据Apache许可证2.0版("许可证")获得许可; 除非符合许可证的规定,否则您不得使用此文件。 您可以在以下位置获取许可证的副本:

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意,否则根据许可证分发的软件 是基于"按原样"的基础分发的,不附带任何明示或暗示的担保或条件。 有关许可证下的特定语言管理权限和限制,请参阅许可证。

致谢

我们受到Matthieu Maitre的极大启发,他构建了PickleScan。 我们感谢这项工作,并在ModelScan中对其进行了重大扩展。ModelScan以与PickleScan类似的精神开源。

贡献

我们非常欢迎您为我们的开源ModelScan项目做出贡献。 如果您想贡献,请遵循贡献页面上的详细说明。

编辑推荐精选

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

下拉加载更多