ISE ID 그룹, Rest API를 통한 사용자 생성 및 수정
목차
소개
이 문서에서는 ID 관리 자동화에 사용할 수 있는 Rest API를 사용하여 ID 그룹 및 사용자를 만들고 수정하는 방법에 대해 설명합니다. 이 장에서 설명하는 절차는 샘플 독립형 ISE 구축 및 JSON 형식의 Rest API Firefox Client(REST)를 기반으로 합니다.
사전 요구 사항
요구 사항
다음 주제에 대한 지식을 보유하고 있으면 유용합니다.
- Cisco ISE(Identity Services Engine)
- REST API
- JSON
사용되는 구성 요소
이 문서는 특정 소프트웨어 및 하드웨어 버전에 제한되지 않으며 REST API를 통한 샘플 컨피그레이션 가이드일 뿐입니다.
이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.
구성
다음은 API를 통한 작업에 대한 샘플 단계이며, 이는 고유한 호출을 작성하는 데 참조용으로 사용할 수 있습니다.
1. ID 그룹 생성
POST 메서드의 도움을 받아 ID 그룹을 생성합니다.
API 호출용 URL:
https://<ISE IP>:9060/ers/config/identitygroup
API 호출의 헤더:
|
HTTP 'Content-Type' 헤더: |
application/json |
|
HTTP 'Accept' 헤더: |
application/json |
ID 그룹 생성을 위한 JSON 코드
{
"IdentityGroup": {
"name": "",
"description": "",
"parent": "NAC Group:NAC:IdentityGroups:User Identity Groups"
}
} 예:
2. ID 그룹 세부 정보 검색
GET 메서드의 도움으로 ID 그룹 세부 정보를 가져옵니다.
API 호출용 URL:
https://<ISE IP>:9060/ers/config/identitygroup?filter=name.CONTAINS.<ID 그룹 이름 >
API 호출의 헤더:
|
HTTP 'Content-Type' 헤더: |
application/json |
|
HTTP 'Accept' 헤더: |
application/json |
예:
3. 사용자 생성
POST 메서드의 도움으로 사용자를 생성합니다.
API 호출용 URL:
https://<ISE IP>:9060/ers/config/internaluser/
API 호출의 헤더:
|
HTTP Content-Type 헤더: |
application/json |
|
HTTP Accept 헤더: |
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 Content-Type 헤더: |
application/json |
|
HTTP Accept 헤더: |
application/json |
예:
5. 사용자 세부 정보 수정
PUT 메서드의 도움으로 사용자 비밀번호를 수정합니다.
API 호출용 URL:
https://<ISE IP>:9060/ers/config/internaluser/<4단계에서 설명한 프로세스를 사용하여 받은 사용자 ID>
위의 내용은 4단계에서 설명한 프로세스를 사용하여 수신한 href URL입니다.
API 호출의 헤더:
|
HTTP Content-Type 헤더: |
application/json |
|
HTTP Accept 헤더: |
application/json |
사용자 자격 증명 수정을 위한 JSON 코드:
{
"InternalUser": {
"id": "",
"name": " ",
"password": "",
"enablePassword": ""
}
}
예:
다음을 확인합니다.
ID 그룹을 확인하려면 ISE GUI에서 Administration(관리) > Identity Management(ID 관리) > Groups(그룹) > Identity Groups(ID 그룹) > User Identity Groups(사용자 ID 그룹)로 이동합니다.
사용자를 확인하려면 ISE GUI에서 Administration(관리) > Identity Management(ID 관리) > Identities(ID) > User(사용자)로 이동합니다.
피드백