Cisco Cisco Identity Services Engine 1.2 产品宣传页

思科身份服务引擎 API 参考指南，版本 1.4

第 5 章      ERS API 简介

  外部 RESTful 服务 API 状态

注意

所有 REST 操作均要经过审核，并且在系统日志中记录日志。

相关主题

外部 RESTful 服务 API 状态

您可以在 GUI 的 Administration > Settings > ERS Settings 页面上验证是否为主节点和辅助节点
启用了外部 RESTful 服务 API。

默认情况下，外部 RESTful 服务 API 处于未启用状态。如果您在启用外部 RESTful 服务 API 调用
之前尝试调用这些 API，将会收到错误响应。

外部 RESTful 服务 API 具有调试日志记录类别，您可以从 Cisco ISE GUI 的调试日志记录页面启
用此类别。

注意

有关详细信息，请参阅

思科身份服务引擎管理员指南，版本 1.4 的

部分。

数据验证

发送到服务器的 CRUD 数据使用与 Cisco ISE 用于 GUI 的相同验证规则进行验证。所有验证在验
证层集中进行。所要发布的所有 XML 数据都会根据架构进行验证。

系统会执行以下两种类型的验证：数据验证和结构验证。数据验证会验证数据是否符合 ISE 要
求，例如，强制字段、字段长度及类型等。而结构验证会根据架构进行验证，例如，字段顺序、
名称等。

命名空间

您必须在资源名称和 URI 中遵守严格的命名空间要求，如下所述：

内部用户、终端、终端组和身份组的身份

SGA 的 SGT

所有其他对象资源的外部 RESTful 服务，如显示在响应消息中的搜索结果（客户端确实需要
在请求中发送 ERS 命名空间）

Accept/Content-Type 标头必须包含以下命名空间：

application/vnd.com.cisco.ise.<resource-namespace>.<resource-type>.<major 

version>.<minor version>+xml

例如：

application/vnd.com.cisco.ise.identity.internaluser.1.0+xml

请求 XML 应包含如下命名空间定义：

identity.ers.ise.cisco.com

sga.ers.ise.cisco.com

例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<ns:endpoint xmlns:ns="identity.ers.ise.cisco.com" id="id">