/api/v1/token 这个接口返回404，说明认证接口的路径可能不正确。

H3C V7平台防火墙的RESTful API认证接口通常是 /api/aaa/login。

⚙️ 防火墙后台配置步骤

API对接不成功，很可能是因为防火墙上的相关功能未开启或权限不足。请按以下步骤检查和配置：

1. 开启RESTful功能（关键）
   H3C防火墙的RESTful功能默认是关闭的，需要手动开启。

   bash

   system-view restful http enable # 开启HTTP方式（测试可用） restful https enable # 开启HTTPS方式（生产环境推荐）

2. 创建或配置API管理用户
   需要为API调用创建一个专门的用户，并赋予足够的权限。

   bash

   local-user apiuser class manage password simple YourPassword123 # 设置一个强密码 service-type web # 服务类型必须包含web authorization-attribute user-role network-admin # 赋予网络管理员权限 quit

3. 确认接口地址和端口

   • 认证接口：/api/aaa/login。

   • 业务接口：前缀通常为 /api/v1.0/ 或 /api/，具体请以设备版本为准。

   • 端口：

     • HTTP默认端口：8080

     • HTTPS默认端口：8443

   • 可以在命令行中使用 display restful 命令查看当前配置和状态。

🔑 正确的认证与调用流程

1. 获取Token

   • 请求方式：POST

   • URL：http://<防火墙IP>:8080/api/aaa/login 或 https://<防火墙IP>:8443/api/aaa/login

   • 请求头：Content-Type: application/json

   • 请求体 (Body)：

     json

     { "username": "apiuser", "password": "YourPassword123" }

2. 调用业务接口

   • 在后续所有业务API请求的请求头中，都必须携带从登录接口获取的Token。

   • 请求头：X-Auth-Token: <登录接口返回的token值>。

❓ 为什么返回404？

• RESTful功能未开启：这是最常见的原因，请务必检查第一步的配置。

• 接口路径错误：再次确认你使用的URL路径是否正确。

• IP或端口错误：检查防火墙的管理地址，以及是否使用了正确的端口（HTTP 8080 / HTTPS 8443）。

• 用户权限不足：确认用于API调用的用户拥有 network-admin 或包含REST API访问权限的角色。

SecPath V7 防火墙 RESTful API 报 404，/api/v1/token不存在问题

重点：V7 防火墙（F1000‑AK 系列）没有 /api/v1/token 这个接口！ 6W100 文档里的/api/v1/token是交换机 / AC 控制器的 token 接口；防火墙 V7 不使用 token 获取接口，采用 HTTP Basic Auth（基础认证），所以 POST 访问/api/v1/token直接返回 404 资源不存在H3C。

一、防火墙 V7 RESTful 正确认证方式

1. 没有单独获取 token 接口，所有 API 请求 Header 携带 Basic 认证；
2. 请求 URL 格式：https://设备IP/api/v1/资源路径
3. 请求头：

示例：账号admin，密码123456，base64 编码为YWRtaW46MTIzNDU2

❌不要调用/api/v1/token，防火墙 V7 不存在该路径，必然 404。

二、防火墙后台必须配置（缺一不可）

1、开启 RESTful HTTPS 服务

默认 restful https 是关闭状态，关闭的话所有 api 请求 404 / 拒绝连接H3C。

2、创建 RESTful 本地管理用户（class manage）

⚠️关键点：

• 用户必须是class manage管理类用户；
• 必须配置service‑type https，没有这个，即使账号密码正确也认证失败；
• 角色：network‑operator只读；network‑admin读写配置。

3、可选：限制 API 访问源 IP（https acl）

如果配置了 acl，调用 API 的客户端 IP 不在 acl 允许列表，会直接拒绝，返回 404 / 连接失败H3C。

三、测试验证 curl 命令（直接复制修改 IP 账号密码）

• 成功：返回设备信息 JSON；
• 返回 401：账号密码错误、service‑type https 未配置；
• 返回 404：restful https 未开启、url 路径写错；
• 返回 403：用户角色权限不足；
• 返回连接拒绝：restful https 未开启。

四、常见踩坑

1. 混淆文档：6W100 文档是通用文档，区分设备类型

• 交换机 / WX 无线 AC：支持/api/v1/token获取 token；
• SecPath 防火墙 V7：不支持 token 接口，只支持 Basic Auth，不要照搬交换机的示例代码。

2. 不要使用 HTTP（80 端口），生产环境建议使用 HTTPS；
3. 防火墙开启了 FIPS 模式时，密码策略会严格，本地用户密码需要满足复杂度；
4. 部分版本，修改完 restful 配置，建议undo restful https enable再restful https enable重新加载服务。

五、接口文档区分

• 防火墙 V7 RESTful 接口文档：在设备 Web 页面，系统管理 → RESTful API 文档，不要拿交换机的 6W100 文档直接照抄，文档内的 token 接口是交换机产品的。

六、排查命令

官网有API相关手册