flashmingo是FireEye最新发布的一个用于自动分析SWF文件的框架。它可以自动对可疑的Flash文件进行分类，并进一步的指导分析过程。Flashmingo可作为独立的工具，也可以作为库的一部分集成到分析工作流中。

安装

安装requirements.txt文件中列出的Python (2.7)。

你可以使用以下命令进行安装：

pip install -r requirements.txt

如果要使用反编译功能，则需要安装Jython。Ubuntu/Debian用户可以使用下面的命令安装：

apt install jython

克隆该项目或下载zip文件。

目的

到目前为止，取证人员和恶意软件分析师仍必须对可疑的SWF文件进行处理。据悉，Adobe Flash将于2020年被弃用，弃用后系统将继续支持不再使用安全补丁更新的旧文件格式。而自动化是解决该问题的最佳方式，这也是FLASHMINGO可以为你提供帮助的地方。FLASHMINGO是一个用于自动处理SWF文件的分析框架，使分析人员能够以最小的努力对可疑的Flash样本进行分类并进一步调查。此外，用户还可通过自定义Python插件来轻松扩展其功能。

架构

FLASHMINGO的设计考虑了简洁性。它读取SWF文件并创建表示其内容和结构的对象（SWFObject）。然后，FLASHMINGO运行一系列插件作用于SWFObject对象，并将其值返回到主程序。

以下是ASCII流程图：

                               +----------+
                                                 |          |
                       +------------+----------->+ PLUGIN 1 +------------+
                       |            |            |          |            |
                       |            |            +----------+            |
                       |            |                                    |
                       |            |            +----------+            |
                       |            |            |          |            |
+---------+            |            +----------->+ PLUGIN 2 +--------+   |
|SWF FILE +----------->+ FLASHMINGO |            |          |        |   |
+---------+            |            |            +----------+        |   |
                       |            |                                |   |
                       |            |                                |   |
                       |            |                                |   |
                       |            |                          +-----v---v-+
                       |            |                          |           |
                       |            |                          |           |
                       +-----+------+------------------------->+ SWFOBJECT |
                             ^                                 |           |
                             |                                 |           |
                             |                                 +-----+-----+
                             |                                       |
                             |                                       |
                             |                                       |
                             +---------------------------------------+

在你自己的项目中使用FLASHMINGO作为库时，你只需处理两种类型的对象：

一个或多个SWFObject(s)，代表样本。

一个Flashmingo对象。主要用作连接插件和SWFObject的线束（harness）。

插件

FLASHMINGO插件存储在它们自己的目录下...你猜对了：插件当Flashmingo对象被实例化时，它会遍历这个目录并处理所有插件的清单（manifests）。如果插件处于启用状态，则会注册该插件以供后续使用。在代码级别，这意味着将一个小的plugin_info字典添加到插件列表中。

通过run_plugin API的两个参数调用插件：

插件的名称

SWFObject实例

（可选）大多数插件允许你传递自己的用户数据。默认插件SuspiciousNames将在所有常量池中，搜索包含可疑字符串（例如：'overflow'，'spray'，'shell'等）的文件。插件中已包含了一个硬编码的常见字符串列表。但你也可以传递自己定义的字符串列表，在本例中为names参数。

代码示例：

fm = Flashmingo()
print fm.run_plugin('DangerousAPIs', swf=swf)
print fm.run_plugin('SuspiciousNames', swf=swf, names=['spooky'])

默认插件

FLASHMINGO还附带了其他一些非常实用的插件：

binary_data

dangerous_apis

decompiler

suspicious_constants

suspicious_loops

suspicious_names

template :)

扩展 FLASHMINGO

为便于开发，flashmingo还为我们提供了一个模板插件。扩展flashmingo非常简单，遵循以下步骤即可：

复制模板

编辑清单

覆盖run方法

添加自定义代码

FLASHMINGO 作为库

API

有关自动生成的文档，请参阅docs目录

有关示例，请参阅FireEye的博客文章

前端

Console

创建文档

$ pip install sphinxcontrib-napoleon

设置Sphinx构建文档后，在Sphinx conf.py文件中启用napoleon：

在conf.py中，将napoleon添加到extensions列表中

extensions = ['sphinxcontrib.napoleon']

使用sphinx-apidoc构建你的API文档：

$ sphinx-apidoc -f -o docs/source projectdir

这将创建.rst文件供Sphinx处理

$ make html

*参考来源：GitHub，FB小编secist编译，转载请注明来自FreeBuf.COM