ISE Identity-Group, creación y modificación de usuarios mediante API de descanso

Introducción

Este documento describe cómo crear y modificar grupos de identidad y usuarios usando la API Rest que se puede utilizar para la automatización de la administración de identidades. El procedimiento descrito en este capítulo se basa en la implementación de ISE independiente de ejemplo y en el cliente Firefox de API de descanso (RESTED) en formato JSON.

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Cisco Identity Services Engine (ISE)
• API REST
• JSON

Componentes Utilizados

Este documento no se limita a versiones específicas de software y hardware y es sólo una guía de configuración de ejemplo a través de la API REST.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Configurar

Estos son los pasos de ejemplo para las operaciones a través de la API que se pueden utilizar como referencia para crear sus propias llamadas.

1. Creación de grupos de identidad 

Cree un grupo de identidad con la ayuda del método POST.

URL para llamada de API:

https://<ISE IP>:9060/ers/config/identitygroup

El encabezado para la llamada de API:

Encabezado HTTP 'Content-Type':	Aplicación/JSON
Encabezado HTTP 'Aceptar':	Aplicación/JSON

Código JSON para la creación de grupos de identidad

{

      "IdentityGroup": {

            "name": "
     
     
       ", "description": " 
      
        ", "parent": "NAC Group:NAC:IdentityGroups:User Identity Groups" } } 
       
     

Ejemplo:

2. Recuperación de detalles de grupo de identidad

Obtenga los detalles del grupo de identidad con la ayuda del método GET.

URL para llamada de API:

https://<ISE IP>:9060/ers/config/identitygroup?filter=name.CONTAINS.<Identity Group Name >

El encabezado para la llamada de API:

Encabezado HTTP 'Content-Type':	Aplicación/JSON
Encabezado HTTP 'Aceptar':	Aplicación/JSON

Ejemplo:

Nota: Se requiere ID (recibido en los detalles del grupo de identidad) para crear usuarios en este grupo de identidad.

3. Creación de usuarios

Cree un usuario con la ayuda del método POST.

URL para llamada de API:

https://<ISE IP>:9060/ers/config/internaluser/

El encabezado para la llamada de API:

Encabezado HTTP Content-Type:	Aplicación/JSON
Encabezado HTTP Accept:	Aplicación/JSON

Código JSON para la creación del usuario:

{

  "InternalUser": {

    "name": "
     
     
       ", "email": " 
      
        ", "enabled": true, "password": " 
       
         ", "firstName": " 
        
          ", "lastName": " 
         
           ", "changePassword": false, "identityGroups": " 
          
            ", "expiryDateEnabled": false, "enablePassword": " 
           
             " } } 
            
           
          
         
        
       
     

Ejemplo:

4. Recuperación de detalles de usuario

Obtener detalles del usuario con la ayuda del método GET.

URL para llamada de API:

https://<ISE IP>:9060/ers/config/internaluser

Nota: Esta URL se puede utilizar para filtrar usuarios. El usuario se puede filtrar utilizando firstName, lastName, identityGroup, name, description, email, enabled.

Se recomienda filtrar los detalles del usuario con ID de correo electrónico, ya que la ID de correo electrónico es única para cada usuario.

https://<ISE IP>:9060/ers/config/internaluser?filter=<nombre del campo utilizado para el filtrado>.CONTIENE.<valor del campo para el filtrado>

El encabezado para la llamada de API:

Encabezado HTTP Content-Type:	Aplicación/JSON
Encabezado HTTP Accept:	Aplicación/JSON

Ejemplo:

Nota: Se requiere ID y Namereceped aquí para actualizar la contraseña u otra información para un usuario.hrefURL se utilizará para actualizar la información del usuario.

5. Modificación de los detalles del usuario

Modifique la contraseña de usuario con la ayuda del método PUT.

URL para llamada de API:

https://<ISE IP>:9060/ers/config/internaluser/<ID de usuario recibido mediante el proceso descrito en el paso 4>

Arriba se encuentra la URL href recibida utilizando el proceso descrito en el Paso 4.

El encabezado para la llamada de API:

Encabezado HTTP Content-Type:	Aplicación/JSON
Encabezado HTTP Accept:	Aplicación/JSON

Código JSON para modificación de credenciales de usuario:

{

  "InternalUser": {

    "id": "
     
     
       ", "name": " 
      
        ", "password": " 
       
         ", "enablePassword": " 
        
          " } } 
         
        
       
     

Ejemplo:

Verificación

Para verificar los grupos de identidad, navegue aAdministration > Identity Management > Groups > Identity Groups > User Identity Group en la GUI de ISE.

Para verificar que los usuarios naveguen aAdministration > Identity Management > Identities > Usersen ISE GUI.