Insominia를 사용하는 ISE 3.3에서 JSON 또는 XML 및 API 호출을 통해 내부 사용자 구성

다운로드 옵션

PDF (1.9 MB)
다양한 디바이스에서 Adobe Reader로 보기

업데이트:2024년 7월 25일

문서 ID:222212

편견 없는 언어

본 제품에 대한 문서 세트는 편견 없는 언어를 사용하기 위해 노력합니다. 본 설명서 세트의 목적상, 편견 없는 언어는 나이, 장애, 성별, 인종 정체성, 민족 정체성, 성적 지향성, 사회 경제적 지위 및 교차성에 기초한 차별을 의미하지 않는 언어로 정의됩니다. 제품 소프트웨어의 사용자 인터페이스에서 하드코딩된 언어, RFP 설명서에 기초한 언어 또는 참조된 서드파티 제품에서 사용하는 언어로 인해 설명서에 예외가 있을 수 있습니다. 시스코에서 어떤 방식으로 포용적인 언어를 사용하고 있는지 자세히 알아보세요.

이 번역에 관하여

Cisco는 전 세계 사용자에게 다양한 언어로 지원 콘텐츠를 제공하기 위해 기계 번역 기술과 수작업 번역을 병행하여 이 문서를 번역했습니다. 아무리 품질이 높은 기계 번역이라도 전문 번역가의 번역 결과물만큼 정확하지는 않습니다. Cisco Systems, Inc.는 이 같은 번역에 대해 어떠한 책임도 지지 않으며 항상 원본 영문 문서(링크 제공됨)를 참조할 것을 권장합니다.

소개

이 문서에서는 API 호출과 함께 JSON 또는 XML 데이터 형식을 활용하여 Cisco ISE의 내부 사용자 구성에 대해 설명합니다.

사전 요구 사항

ISE 3.0 이상
API 클라이언트 소프트웨어.

사용되는 구성 요소

ISE 3.3
인소미니아 9.3.2

이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.

네트워크 다이어그램

일반 토폴로지

GET 및 POST는 API(Application Programming Interface) 호출에 사용되는 가장 일반적인 HTTP 메서드 중 두 가지입니다. 일반적으로 서버의 리소스와 상호 작용하여 데이터를 검색하거나 처리를 위해 데이터를 제출하는 데 사용됩니다.

API 호출 가져오기

GET 메서드는 지정된 리소스에서 데이터를 요청하는 데 사용됩니다. GET 요청은 API 및 웹 사이트에서 가장 흔하고 널리 사용되는 방법입니다. 웹 페이지를 방문하면 브라우저가 웹 페이지를 호스팅하는 서버에 GET 요청을 합니다.

POST API 호출

POST 메서드는 서버에 데이터를 보내 리소스를 만들거나 업데이트하는 데 사용됩니다. POST 요청은 양식 데이터를 제출하거나 파일을 업로드할 때 자주 사용됩니다.

설정

내부 사용자를 생성하려면 API 클라이언트 소프트웨어에서 ISE 노드로 정확한 정보를 전송해야 합니다.

ISE 컨피그레이션

ERS 기능을 활성화합니다.

1. Administration(관리) > System(시스템) > Settings(설정) > API Settings(API 설정) > API Service Settings(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 protected]",

    "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(헤더)를 클릭하여 다음 방법을 추가합니다.
- Content-Type(콘텐츠 유형): application/json
- 수락: application/json

JSON 헤더

마지막으로 Send(보내기)를 클릭합니다.

참고: 새 사용자 계정에 ID 그룹을 할당하려면 ID 그룹의 ID를 사용해야 합니다. 자세한 내용은 Troubleshooting(문제 해결) 섹션을 참조하십시오.

검증

POST 요청을 전송하면 상태가 "201 Created"로 표시됩니다. 이는 프로세스가 성공적으로 완료되었음을 의미합니다.

JSON 요청 성공

ISE GUI를 열고 Administration > Identity Management > Identities > Users > Network Access Users로 이동합니다

JSON 사용자 계정

XML 요청

불면증을 열어라.
왼쪽에 새 HTTPS 요청을 추가합니다.

XML 요청

POST를 선택하여 ISE 노드로 정보를 전송해야 합니다.

입력해야 하는 URL은 ISE 노드의 IP 주소에 따라 달라집니다.

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

XML 게시물

Body(본문)를 클릭하고 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 protected]</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>