使用Insominia通过ISE 3.3中的JSON或XML和API调用配置内部用户

下载选项

PDF (1.9 MB)
在各种设备上使用 Adobe Reader 查看

已更新: 2024 年 7 月 25 日

文档 ID:222212

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

简介

本文档介绍通过结合使用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请求。

POST API调用

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

配置

我们需要将来自API客户端软件的确切信息发送到ISE节点以创建内部用户。

ISE配置

启用ERS功能。

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

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

API设置

JSON请求。

开放式失眠。
在左侧添加新的HTTPS请求。

JSON请求

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

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

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

JSON发布

然后点击Body并选择JSON

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"

  }

}

点击Auth并选择Basic。

JSON身份验证

输入ISE GUI凭证。

管理员JSON凭证

点击Headers以添加以下方法：
- 内容类型：application/json
- 接受：application/json

JSON报头

最后，单击“发送”。

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

验证

发送POST请求后，您将看到状态“201 Created”。这表示该过程已成功完成。

成功的JSON请求

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

JSON用户帐户

XML请求

开放式失眠。
在左侧添加新的HTTPS请求。

XML请求

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

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

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

XML文章

然后单击“正文”，然后选择“XML”。

XML正文

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

XML文章

XML语法

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

<ns0:internaluser xmlns:ns0="identity.ers.ise.cisco.com" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ns1="ers.ise.cisco.com" xmlns:ers="ers.ise.cisco.com" description="description" name="name">

   <accountNameAlias>accountNameAlias</accountNameAlias>

   <changePassword>true</changePassword>

   <customAttributes>

      <entry>

         <key>key1</key>

         <value>value1</value>

      </entry>

      <entry>

         <key>key2</key>

         <value>value3</value>

      </entry>

   </customAttributes>

   <dateCreated>2015-12-15</dateCreated>

   <dateModified>2015-12-20</dateModified>

   <daysForPasswordExpiration>60</daysForPasswordExpiration>

   <email>email@domain.com</email>

   <enablePassword>enablePassword</enablePassword>

   <enabled>true</enabled>

   <expiryDate>2016-12-11</expiryDate>

   <expiryDateEnabled>false</expiryDateEnabled>

   <firstName>firstName</firstName>

   <identityGroups>identityGroups</identityGroups>

   <lastName>lastName</lastName>

   <password>password</password>

   <passwordIDStore>Internal Users</passwordIDStore>

   <passwordNeverExpires>false</passwordNeverExpires>

</ns0:internaluser>