ISE身份组，通过REST API创建和修改用户
简介
本文档介绍如何使用可用于身份管理自动化的Rest API创建和修改身份组和用户。本章中介绍的过程基于JSON格式的示例独立ISE部署和Rest API Firefox客户端(RES)。
先决条件
要求
Cisco 建议您了解以下主题：
- 思科身份服务引擎(ISE)
- REST API
- JSON
使用的组件
本文档不限于特定软件和硬件版本，只是通过REST API提供的示例配置指南。
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。
配置
这些是通过API执行操作的示例步骤，可用作构建您自己的调用的参考。
1.身份组创建
在POST方法的帮助下创建身份组。
API调用的URL:
https://<ISE IP>:9060/ers/config/identitygroup
API调用的报头：
| HTTP“Content-Type”报头： |
application/json |
| HTTP“接受”报头： |
application/json |
用于创建身份组的JSON代码
{
"IdentityGroup": {
"name": "
", "description": "
", "parent": "NAC Group:NAC:IdentityGroups:User Identity Groups" } }
示例：
2.身份组详细信息检索
借助GET方法获取身份组详细信息。
API调用的URL:
https://<ISE IP>:9060/ers/config/identitygroup?filter=name.CONTAINS.<身份组名称>
API调用的报头：
| HTTP“Content-Type”报头： |
application/json |
| HTTP“接受”报头： |
application/json |
示例：
3.用户创建
借助POST方法创建用户。
API调用的URL:
https://<ISE IP>:9060/ers/config/internaluser/
API调用的报头：
| HTTP内容类型报头： |
application/json |
| HTTP接受报头： |
application/json |
用于用户创建的JSON代码：
{
"InternalUser": {
"name": "
", "email": "
", "enabled": true, "password": "
", "firstName": "
", "lastName": "
", "changePassword": false, "identityGroups": "
", "expiryDateEnabled": false, "enablePassword": "
" } }
示例：
4.用户详细信息检索
借助GET方法获取用户详细信息。
API调用的URL:
https://<ISE IP>:9060/ers/config/internaluser
建议使用邮件ID过滤用户详细信息，因为邮件ID对每个用户都是唯一的。
https://<ISE IP>:9060/ers/config/internaluser?filter=<用于过滤的字段的名称>.CONTAINS.<过滤字段的值>
API调用的报头：
| HTTP内容类型报头： |
application/json |
| HTTP接受报头： |
application/json |
示例：
5.用户详细信息修改
在PUT方法的帮助下修改用户密码。
API调用的URL:
https://<ISE IP>:9060/ers/config/internaluser/<使用步骤4>中描述的过程接收的用户ID
以上是使用步骤4中描述的流程收到的href URL。
API调用的报头：
| HTTP内容类型报头： |
application/json |
| HTTP接受报头： |
application/json |
用户凭证修改的JSON代码：
{
"InternalUser": {
"id": "
", "name": "
", "password": "
", "enablePassword": "
" } }
示例：
验证
要验证身份组，请导航至ISE GUI中的Administration > Identity Management > Groups > Identity Groups > User Identity Group。
要验证用户，请导航至Administration > Identity Management > Identities > Users in ISE GUI。
反馈