Cisco Cisco Email Security Appliance C170 User Guide
2
Cisco AsyncOS API for Email - 入门指南
使用 AsyncOS API 的先决条件
使用 AsyncOS API 的先决条件
要使用 AsyncOS API,您需要:
•
运行于 Cisco AsyncOS 9.0 for Email 或更高版本的邮件安全设备。
•
了解以下相关知识:
–
HTTP (用于 API 事务的协议)。
–
通过 TLS 进行的安全通信。
–
JavaScript Object Notation (JSON), API 用来构建资源表述。
•
使用 HTTP 或 HTTPS 启动请求并从 AsyncOS API 接收响应的客户端或编程库,例如 cURL。
该客户端或编程库必须支持 JSON 才能解释来自 API 的响应。
该客户端或编程库必须支持 JSON 才能解释来自 API 的响应。
•
访问 AsyncOS API 的授权。请参阅
•
使用 Web 界面或 CLI 启用 AsyncOS API。请参阅
启用 AsyncOS API
准备工作
确保您已获得授权,可以访问 Web 界面上的 “IP 接口” (IP Interfaces) 页面或者 CLI 上的
interfaceconfig
命令。只有管理员和操作员获得授权,才能访问此页面或命令。
程序
步骤 1
登录 Web 界面。
步骤 2
单击网络 (Network) > IP 接口 (IP Interfaces)。
步骤 3
编辑 Management 接口。
注意
您可以在任意 IP 接口上启用 AsyncOS API。但是,思科建议您在 Management 接口上启用
AsyncOS API。
AsyncOS API。
步骤 4
在 “AsyncOS API (监控)” (AsyncOS API [Monitoring]) 部分下,根据您的要求,选择 HTTP 和/或
HTTPS 以及要使用的端口。
HTTPS 以及要使用的端口。
注意
AsyncOS API 使用 HTTP/1.0 进行通信。
如果您选择了 HTTPS,并且想要使用自己的证书进行安全通信,请参阅
注意
Cisco 建议您在生产环境中始终使用 HTTPS。 HTTP 仅用于故障排除和测试 API。
步骤 5
提交并确认更改。
您还可以在 CLI 中使用
interfaceconfig
命令启用 AsyncOS API。