目录

简介

本文档介绍如何利用JSON或XML数据格式和API调用在Cisco ISE中配置内部用户。

先决条件

- ISE 3.0或更高版本。

- API客户端软件。

使用的组件

- ISE 3.3

- Insominia 9.3.2

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

网络图

常规拓扑

GET和POST是API（应用编程接口）调用中最常用的HTTP方法。它们用于与服务器上的资源交互，通常用于检索数据或提交数据以进行处理。

获取API调用

GET方法用于从指定资源请求数据。GET请求是API和网站中最常见且最广泛使用的方法。当您访问网页时，您的浏览器正在向托管该网页的服务器发出GET请求。

API调用后

POST方法用于将数据发送到服务器以创建或更新资源。POST请求通常用于提交表单数据或上传文件。

配置

我们需要从API客户端软件向ISE节点发送确切信息以创建内部用户。

ISE配置

启用ERS功能。

1.定位至“管理”>“系统”>“设置”>“API设置”>“API服务设置”。

2.启用ERS（读/写）选项。

API设置

JSON请求。

1. 开放式失眠。

2. 在左侧添加新的HTTPS请求。

JSON请求

3. 您需要选择POST以将信息发送到ISE节点。

您需要输入的URL取决于ISE节点的IP地址。

URL:https://x.x.x.x/ers/config/internaluser

JSON文章

4. 然后单击Body并选择JSON

JSON正文

5. 您可以粘贴语法并根据需要更改参数。

JSON语法

JSON语法

{

"InternalUser": {

"name": "name",

"description": "description",

"enabled": true,

"email": "email@domain.com",

"accountNameAlias": "accountNameAlias",

"password": "password",

"firstName": "firstName",

"lastName": "lastName",

"changePassword": true,

"identityGroups": "identityGroups",

"passwordNeverExpires": false,

"daysForPasswordExpiration": 60,

"expiryDateEnabled": false,

"expiryDate": "2016-12-11",

"enablePassword": "enablePassword",

"dateModified": "2015-12-20",

"dateCreated": "2015-12-15",

"customAttributes": {

"key1": "value1",

"key2": "value3"

},

"passwordIDStore": "Internal Users"

}

}

6. 点击Auth并选择Basic。

JSON身份验证

7. 输入ISE GUI凭证。

管理员JSON凭证

8. 点击Headers以添加以下方法：

- 内容类型:application/json

- 接受：application/json

JSON报头

9. 最后，单击“发送”。

注意：如果要将身份组分配给新用户帐户，需要使用身份组的ID。有关详细信息，请查看故障排除部分。

验证

1. 发送POST请求后，您将看到状态“201 Created”。这意味着已成功完成该过程。

成功的JSON请求

2. 打开ISE GUI并导航到管理>身份管理>身份>用户>网络访问用户

JSON用户帐户

XML请求

1. 开放式失眠。

2. 在左侧添加新的HTTPS请求。

XML请求

3. 您需要选择POST以将信息发送到ISE节点。

您需要输入的URL取决于ISE节点的IP地址。

URL:https://x.x.x.x/ers/config/internaluser

XML文章

4. 然后单击“正文”并选择“XML”。

XML正文

5. 您可以粘贴语法并根据需要更改参数。

XML文章

XML语法

6. 点击Auth并选择Basic

XML身份验证

7. 输入ISE GUI凭证。

XML凭证

8. 点击Headers以添加以下方法：

- 内容类型:应用/xml

- 接受：应用/xml

XML报头

9. 最后，单击“发送”。

注意：如果要将身份组分配给新用户帐户，需要使用身份组的ID。有关详细信息，请查看故障排除部分。

验证

1. 发送POST请求后，您将看到状态“201 Created”。这意味着已成功完成该过程。

成功的XML请求

2. 打开ISE GUI并导航到管理>身份管理>身份>用户>网络访问用户

用户帐户验证

故障排除

1.标识身份组的ID。

使用GET和https://X.X.X.X/ers/config/identitygroup查询。

GET option

JSON输出。

确定说明旁边的ID。

ID身份组01

XML输出。

确定说明旁边的ID。

ID身份组02

2. 401未授权错误。

401 个错误

解决方案：检查Auth部分中配置的访问凭证

3.错误：无法连接到服务器

连接错误

解决方案：检查在失眠中配置的ISE节点的IP地址或验证连接。

4. 400错误请求。

400 个错误

面临此错误的原因有多种，最常见的原因包括：

- 与安全密码策略不匹配

- 某些参数配置错误。

- Sintaxis错误。

- 信息重复。

5.错误：SSL对等证书或SSH远程密钥不正常

SSL证书错误

解决方案：

1. 点击Disable SSL Validation。

2. 在Request / Response下，禁用Validate Certificates选项。

Validate certificates选项

6. CSCwh71435   缺陷.

使能口令是随机配置的，但您尚未配置它。当启用密码语法被删除或保留为空值时会发生此行为。有关详细信息，请查看下一个链接：

https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwh71435

API调用引用。

您可以查看有关ISE支持的API调用的所有信息。

1.定位至“管理”>“系统”>“设置”>“API设置”。

2.单击ERS API信息链接。

API设置

3.然后单击API文档。

API 文档