火绒小问答——「企业版」API接口如何使用

尊敬的用户，您好！

火绒终端安全管理系统2.0开放API接口能力，支持第三方系统对接联动，可实现终端数据查询、安全任务下发、自动化管理等功能，有效打破系统壁垒，提升企业整体安全运维效率。现将API接口使用规范、认证方式、操作流程及相关注意事项说明如下。

火绒终端安全管理系统2.0的API接口允许第三方系统（如准入系统）调用其内部数据和功能，实现产品联动与自动化管理。

一、概述

• 核心价值：打破信息孤岛，开放数据与功能，实现第三方系统（如准入系统、运维平台）与火绒的安全协作，综合提升企业防御体系。
• 开放信息：通过API可查询终端地址、名称、版本、分组策略、在线状态、病毒库版本等。随着产品迭代，将开放更多功能。

二、认证与签名准备（调用前提）

调用任何API接口前，必须完成身份认证。认证基于AccessKey包括AccessKey ID和AccessKey Secret，并需计算签名。

1.获取密钥：在火绒控制中心，进入 【中心管理】→【中心设置】→【通用设置】→【API接口】。

2.管理密钥：点击【管理密钥】，可添加、禁用、编辑、删除API接口密钥。每个密钥包含唯一的API ID和API Key。

3.签名计算：调用请求时，需使用AccessKey对请求参数进行签名计算，以确保请求的合法性。

三、支持的API接口类别及功能

当前支持第三方软件调用的主要接口如下，涵盖分组管理、终端信息查询与操作、安全任务下发等：

四、管理密钥操作步骤

1.登录火绒控制中心。

2.导航至【中心管理】→【中心设置】→【通用设置】。

3.找到【API接口】部分，点击【管理密钥】按钮。

4.在弹出窗口中，点击【添加】以生成新的API接口密钥对（ID和Key）。

5.已添加的密钥会显示在列表中，您可对其进行禁用、编辑或删除操作。6.启用“记录API接口调用日志”后，所有通过该密钥发起的API调用行为将被记录，可在【事件日志】→【系统管理日志】→【系统事件日志】中查看。

五、API调用流程与注意事项

1.调用流程：

o 第三方系统使用AccessKey ID和AccessKey Secret，按照接口文档中定义的签名算法，对请求参数进行签名。

o 向火绒中心发起HTTP请求，携带认证信息和业务参数。

o 中心验证签名和参数合法性，返回JSON格式的统一响应结构数据。

2.关键注意事项：

o 严格遵循规范：必须严格按照API文档中的认证机制、参数名称、类型和顺序进行调用，否则会调用失败。

o 参数规则：注意必填与选填参数、参数值的有效范围（如终端名称长度限制等）。

o 响应解析：统一的响应结构包含code（状态码）和data（业务数据）等字段，需正确解析以判断调用结果。

o 安全保管：AccessKey Secret等同于管理权限，必须严格保密，切勿泄露。定期轮换密钥是良好的安全实践。

o 日志审计：建议在中心开启API调用日志记录，以便追溯和审计第三方系统的所有API行为。使用火绒API的核心流程是 “在中心管理密钥 → 第三方系统按规范签名 → 发起请求调用具体接口 → 解析响应” 。务必妥善保管密钥并严格遵循调用文档，以实现安全、稳定的系统集成。

尊敬的用户：

若您有其他产品使用问题，可通过以下方式联系我们~

微信公众号：主界面---常见问题---人工客服

火绒官方论坛：https://bbs.huorong.cn/

火绒官方服务热线：400-998-3555（法定工作日8:30-20:30，法定节假日9:30-18:30）