IMC API接口

iMC（Intelligent Management Center）的REST API使用的是基于Token的鉴权方式，在调用任何业务接口前，需要先通过指定的鉴权接口获取Token。

该接口的详细信息如下：

请求体中需要包含iMC平台的用户名和密码，你需要根据实际情况替换下方JSON中的账号信息:

请注意：该方法要求密码以明文形式传输，务必确保客户端与iMC服务器之间的连接已启用HTTPS，以保障信息安全。

鉴权成功后，服务器会返回一个token。在后续调用其他业务接口时，需要将其添加在HTTP请求的Header中，格式如下：
Authorization: Bearer <你的Token>

 如何查阅完整文档

iMC提供了内置的接口文档，这是最权威的参考，你可以通过以下两种路径访问：

• Web页面直接查看：访问 http://<iMC服务器IP>:8080/imcrs 或 https://<iMC服务器IP>:8443/imcrs。

• 查阅本地部署文件：在iMC服务器的安装目录下，找到 C:\Program Files\iMC\client\web\apps\imcrs\userguide 目录。

iMC提供了第三方接口可供第三方系统进行对接开发，所有接口可通过以下两种方式查看

A.通过访问iMC软件自己页面查看说明

http://IP_ADDR:PORT/imcrs/

说明：

IP_ADDR  ：IMC前台页面的登录地址

PORT       ：登录前台页面的端口号，默认http的端口号为8080，https的端口号为8443

如  http://192.168.255.1:8080/imcrs

B.压缩包的路径

压缩包的路径，包含所有组件的 ：  H3C_iMC_PLAT_7.3_E0506_Standard-Windows\windows\install\components\iMC-PLAT\client\client.zip\client\web\apps\imcrs\userguide

部署后的路径：C:\Program Files\iMC\client\web\apps\imcrs\userguide

iMC v7 API 鉴权（认证）接口

1. 基础信息

• 根地址：http://<iMC-IP>:8080/imcrs（HTTP）/ https://<iMC-IP>:8443/imcrs（HTTPS）。
• 鉴权方式：HTTP Basic Authentication（账号密码直接编码在请求头）。
• 必要条件：账号需具备 “RESTful Web Services 调用权限”（iMC 用户管理中勾选）。

2. 核心鉴权接口与用法

（1）会话模式（先建立会话，后续带 COOKIE）

• 登录（建立会话，获取 COOKIE）
  • 方法：POST /imcrs
  • 请求头：Authorization: Basic <base64(用户名:密码)>
  • 响应：返回JSESSIONID COOKIE，后续接口携带此 COOKIE 即可保持会话。
• 注销（销毁会话）
  • 方法：DELETE /imcrs/logout
  • 请求头：携带JSESSIONID COOKIE。

（2）直接调用模式（每次请求带 Basic 头）

• 无需显式登录，每个接口请求都携带 Basic 认证头，适合简单调用场景。
• 示例（获取用户列表）：
  plaintext

  GET /imcrs/uam/acmUser/acmUserList Authorization: Basic YWRtaW46UHdkQDEyMzQ1（base64编码的账号密码）

3. 文档入口（查所有接口含鉴权）

1. 浏览器访问：http://<iMC-IP>:8080/imcrs。
2. 输入有 API 权限的账号密码登录。
3. 进入 REST API 浏览器，可查看 ** 所有接口（含鉴权、EIA 相关）** 并在线测试。
   

4. 关键说明

• 无独立 token 接口：iMC 用 Basic+COOKIE，非 OAuth2.0 的 token 模式。
• EIA 相关接口：在文档的 “用户接入管理（EIA）” 分类下，含用户认证、在线用户查询等。
• 权限配置：iMC→用户→用户管理→编辑用户→勾选 “RESTful Web Services 调用”。