配置 REST API
可以使用层次结构级别下 [edit system services rest] 可用的命令在 Junos OS 设备上配置 REST API。配置后,REST API 将变为服务 rest ,这是一个基于 REST 的接口,允许您从远程位置向设备提交 rpc 命令,并支持 GET 和 POST 请求。
要在设备上启用 REST API,需要配置:
控制参数 — 这些参数允许您选择性地指定允许的源 IP 地址和 HTTP 和 HTTPS 连接通用的连接限制。
REST API 资源管理器 — REST API 提供了一个名为 REST API 资源管理器的 GUI,可让您轻松快速地学习如何使用 REST API。默认情况下处于禁用状态,可以通过指定
set system services rest enable-explorer启用 。要了解有关 REST API 资源管理器的更多信息,请参阅 示例:使用 REST API 资源管理器。HTTP 访问 — 您可以为传入连接指定地址和 TCP 端口列表。HTTP 连接不安全,因为它们以明文形式交换凭据和数据,因此我们建议使用 HTTPS。
HTTPS 访问(推荐)— 您可以指定传入连接的地址和 TCP 端口列表、首选密码套件列表、传输层安全性 (TLS) 相互身份验证和服务器证书。HTTPS 连接是安全的,对凭据和信息都进行加密。
追踪选项 — 您可以为 lighttpd 和/或用户界面脚本环境 (juise) 启用跟踪。lighttpd 的跟踪信息存储在 /var/chroot/rest-api/var/log/lighttpd 中,juise 的跟踪信息存储在 /var/chroot/rest-api/var/log/juise 中。默认情况下,跟踪处于禁用状态。
要为 HTTP 和 HTTPS 连接通用的设置配置可选控制参数:
- 指定
set system services rest control allowed-sources [ value-list ]为两个 HTTP 和 HTTPS 连接设置允许的 IP 地址。使用空格作为值之间的分隔符。 - 指定
set system services rest control connection-limit limit以设置 HTTP 和 HTTPS 连接允许的最大同时连接数。可以分配一个从 1 到 1024 的值(默认值为 64)。
要配置 HTTP 访问,请执行以下作:
指定
set system services rest http addresses [ addresses ]以设置服务器侦听传入 HTTP 连接的地址。指定
set system services rest http port port-number以设置传入 HTTP 连接的 TCP 端口。可以分配一个从 1024 到 65535 的值(默认值为 3000)。
要配置 HTTPS 访问,请执行以下作:
指定
set system services rest https addresses [ addresses ]以设置服务器侦听传入 HTTPS 连接的地址。指定
set system services rest https port port-number以设置传入 HTTPS 连接的 TCP 端口。可以分配一个介于 1024 到 65535 之间的值(默认值为 3443)。指定
set system services rest https cipher-list[cipher-1 cipher-2 cipher-3 ... ]以配置 SSH 服务器可用于执行加密和解密功能的密码套件集。指定
set system services rest https server-certificate local-certificate-identifier以配置服务器证书。有关创建本地证书的信息,请参阅 请求安全 PKI generate-certificate-request 。您可以将 REST API 配置为要求服务器身份验证而不使用客户端身份验证,也可以通过指定
set system services rest https mutual-authentication certificate-authority certificate-authority-profile-name在服务器和客户端上配置 TLS 相互身份验证。
要为 lighttpd 和/或 juise 配置跟踪选项,请将 Set flag 指定set system services rest traceoptions flag flag.为 lighttpd、 juise或 all。指定追踪选项时,命令将覆盖之前的任何追踪选项设置。
systemd 在 ACX7100 系列上的 CPU 使用率升高 – 在运行 Junos EVO ACX7100平台上, systemd 该进程在正常情况下可能会显示高于预期的 CPU 使用率。即使禁用某些服务(例如 REST、syslog),也会发生这种情况。没有观察到功能影响。