Contents

Introduction

Prerequisites

Requirements

Componentes Utilizados

Configurar

1. Criação de grupo de identidade

2. Recuperação de detalhes do grupo de identidade

3. Criação de usuário

4. Recuperação de detalhes do usuário

5. Modificação dos detalhes do usuário

Verificar

Introduction

Este documento descreve como criar e modificar grupos de identidade e usuários usando a API Rest que pode ser usada para automação do gerenciamento de identidade. O procedimento descrito neste capítulo é baseado em exemplo de implantação ISE independente e Rest API Firefox Client (RESTED) no formato JSON.

Prerequisites

Requirements

A Cisco recomenda que você tenha conhecimento destes tópicos:

- Cisco Identity Services Engine (ISE)

- API REST

- JSON

Componentes Utilizados

Este documento não está restrito a versões específicas de software e hardware e é apenas um exemplo de guia de configuração por meio da 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. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Configurar

Estas são as etapas de exemplo para operações através de API que podem ser usadas como referência para criar suas próprias chamadas.

1. Criação de grupo de identidade

Crie um grupo de identidade com a ajuda do método POST.

URL para chamada de API:

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

O cabeçalho da Chamada API:

Cabeçalho 'Content-Type' de HTTP:

aplicativo/json

Cabeçalho 'Accept' HTTP:

aplicativo/json

Código JSON para criação de grupo de identidade

{

"IdentityGroup": {

"name": "

", "description": "

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

Exemplo:

2. Recuperação de detalhes do grupo de identidade

Busque os detalhes do Grupo de Identidade com a ajuda do método GET.

URL para chamada de API:

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

O cabeçalho da Chamada API:

Cabeçalho 'Content-Type' de HTTP:

aplicativo/json

Cabeçalho 'Accept' HTTP:

aplicativo/json

Exemplo:

Note: A ID (recebida em detalhes do Grupo de Identidades) é necessária para criar usuários neste Grupo de Identidades.

3. Criação de usuário

Crie um usuário com a ajuda do método POST.

URL para chamada de API:

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

O cabeçalho da Chamada API:

Cabeçalho do Tipo de Conteúdo HTTP:

aplicativo/json

Cabeçalho HTTP Aceitar:

aplicativo/json

Código JSON para criação de usuário:

{

"InternalUser": {

"name": "

", "email": "

", "enabled": true, "password": "

", "firstName": "

", "lastName": "

", "changePassword": false, "identityGroups": "

", "expiryDateEnabled": false, "enablePassword": "

" } }

Exemplo:

4. Recuperação de detalhes do usuário

Busque detalhes do usuário com a ajuda do método GET.

URL para chamada de API:

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

Note: Este URL pode ser usado para filtrar usuários. O usuário pode ser filtrado usando firstName, lastName, identityGroup, name, description, email, enabled.

Recomenda-se filtrar detalhes do usuário com ID de e-mail, pois a ID de e-mail é exclusiva para cada usuário.

https://<ISE IP>:9060/ers/config/internaluser?filter=<nome do campo usado para filtrar>.CONTAINS.<Valor do campo para filtragem>

O cabeçalho da Chamada API:

Cabeçalho do Tipo de Conteúdo HTTP:

aplicativo/json

Cabeçalho HTTP Aceitar:

aplicativo/json

Exemplo:

Nota:IDe nomeRecebido aqui é necessário para atualizar a senha ou outras informações de um usuário.hrefURL será usado para atualizar as informações do usuário.

5. Modificação dos detalhes do usuário

Modifique a senha do usuário com a ajuda do método PUT.

URL para chamada de API:

https://<ISE IP>:9060/ers/config/internaluser/<ID de usuário recebida usando o processo descrito na etapa 4>

Acima está a URL href recebida usando o processo descrito na Etapa 4.

O cabeçalho da Chamada API:

Cabeçalho do Tipo de Conteúdo HTTP:

aplicativo/json

Cabeçalho HTTP Aceitar:

aplicativo/json

Código JSON para Modificação de credenciais do usuário:

{

"InternalUser": {

"id": "

", "name": "

", "password": "

", "enablePassword": "

" } }

Exemplo:

Verificar

Para verificar se os grupos de identidade, navegue paraAdministração > Gerenciamento de identidades > Grupos > Grupos de identidades > Grupos de identidades de usuários na GUI do ISE.

Para verificar se os usuários navegam paraAdministration > Identity Management > Identities > Usersin ISE GUI (Administração > Gerenciamento de identidade > Identidades > Usuários na GUI do ISE).