anyrun/anyrun-sdk

GitHub: anyrun/anyrun-sdk

ANY.RUN 官方 Python SDK,封装了交互式沙箱分析、威胁情报查询和 IOC Feeds 的 REST API,帮助安全团队以编程方式实现恶意软件分析与威胁狩猎的自动化。

Stars: 11 | Forks: 4

ANY.RUN logo

[![PyPI version](https://badge.fury.io/py/anyrun-sdk.svg)](https://badge.fury.io/py/anyrun-sdk) [![Downloads](https://pepy.tech/badge/anyrun-sdk)](https://peppy.tech/project/anyrun-sdk) [![Coverage](https://anyrun.github.io/anyrun-sdk/badges/coverage.svg)](https://github.com/anyrun/anyrun-sdk/actions) [![欢迎贡献](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/anyrun/anyrun-sdk/blob/main/CONTRIBUTING.md) # ANY.RUN SDK 这是 [ANY.RUN](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun) 的

ANY.RUN logo

[![PyPI version](https://badge.fury.io/py/anyrun-sdk.svg)](https://badge.fury.io/py/anyrun-sdk) [![Downloads](https://pepy.tech/badge/anyrun-sdk)](https://peppy.tech/project/anyrun-sdk) [![Coverage](https://anyrun.github.io/anyrun-sdk/badges/coverage.svg)](https://github.com/anyrun/anyrun-sdk/actions) [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/anyrun/anyrun-sdk/blob/main/CONTRIBUTING.md) # ANY.RUN SDK 这是 [ANY.RUN](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun) 的官方 Python 客户端库,支持 Interactive Sandbox、TI Lookup 和 TI Feeds 等网络安全解决方案。 使用该库,您可以与 ANY.RUN REST API 进行交互,快速高效地实现工作流的自动化。 # 可用功能 * 内置对象迭代器和异常处理 * 同步和异步接口 * 支持 Python [3.5](https://github.com/anyrun/anyrun-sdk/tree/legacy)-3.13 ### Sandbox API [ANY.RUN Sandbox](https://app.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=appanyrun) 是一个用于恶意软件分析的在线交互式沙箱,是一个用于实时检测、监控和研究网络威胁的工具。 * 提交文件和 URL 进行分析 * 实时监控分析进度 * 获取详细报告 * 管理任务 ### TI Lookup API 和 YARA Search TI Lookup 是一个用于威胁狩猎的 IOC、IOA、IOB 和事件的[可搜索数据库](https://intelligence.any.run/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-lookup) 以及一个用于按内容浏览恶意文件的[服务](https://intelligence.any.run/analysis/yara/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-yara)。 执行深度搜索,在线查找威胁,并丰富您的安全解决方案。 * 查找 URL 和文件哈希 * 使用 YARA 规则搜索 IOC * 获取威胁情报数据 * 实时监控搜索进度 * 获取详细的分析结果 ### TI Feeds API [Threat Intelligence Feeds](https://intelligence.any.run/feeds/?utm_source=sdk_projects&utm_medium=integration&utm_campaign=intelligence-feeds) 提供关于已知失陷指标的数据:恶意 IP、URL、域名 支持 [TAXII](https://oasis-open.github.io/cti-documentation/taxii/intro.html) STIX feed 格式。 ### 注意: 您可以使用无前缀的 API 密钥访问 ANY.RUN 服务。出于向后兼容性的考虑,仍支持旧版访问方法,但将在未来的版本中移除。 ``` API key format: WmNfqnpo...2Sjon7mtvm8e ``` # 库公共接口概述 ``` import os from anyrun.connectors import SandboxConnector def main(): with SandboxConnector.android(api_key) as connector: # Initialize the url analysis analysis_id = connector.run_url_analysis('https://any.run') print(f'Analysis successfully initialized. Analysis uuid: {analysis_id}') # View analysis status in real time for status in connector.get_task_status(analysis_id): print(status) # Get analysis verdict verdict = connector.get_analysis_verdict(analysis_id) if verdict in ('Suspicious', 'Malicious'): # Get analysis report connector.get_analysis_report(analysis_id, report_format='html', filepath='.') # Remove the analysis from history connector.delete_task(analysis_id) if __name__ == '__main__': # Setup ANY.RUN api key api_key = os.getenv('ANY_RUN_Sandbox_API_KEY') main() ``` 您可以在[这里](https://github.com/anyrun/anyrun-sdk/tree/main/examples)找到更多的使用示例 # 安装指南 #### 您可以使用 pip 或任何其他包管理器来安装该 SDK ``` $ pip install anyrun-sdk ``` #### 此外,您也可以使用 pyproject.toml 手动安装该 SDK ``` $ git clone git@github.com:anyrun/anyrun-sdk.git $ cd anyrun-sdk $ python -m pip install . ``` # 有用的链接 [TI Lookup 查询指南](https://intelligence.any.run/TI_Lookup_Query_Guide_v4.pdf) [ANY.RUN API 文档](https://any.run/api-documentation/#api-Request-Request) # 联系我们 销售、演示和试用咨询 - [sales@any.run](mailto:sales@any.run) 技术支持 - [techsupport@any.run](mailto:techsupport@any.run) 公共关系与合作 – [pr@any.run](mailto:pr@any.run])
标签:ANY.RUN, DAST, IOC, Python, REST API, TI Feeds, TI Lookup, URL检测, YARA, 云资产可视化, 交互式沙箱, 威胁情报, 开发者工具, 开源库, 异步编程, 恶意软件分析, 搜索引擎爬虫, 文件分析, 无后门, 沙箱, 网络威胁检测, 网络安全, 网络调试, 自动化, 计算机取证, 运行时安全, 逆向工具, 隐私保护