README.md

[PACKAGE]: ../../raw/master/mkp/agent_cisco_ise-0.0.2-20210313.mkp "agent_cisco_ise-0.0.2-20210313.mkp"
# Cisco ISE REST API special agent

This Agent uses die Cisco ISE Monitoring and ERS REST API.

---
Check Info:

* *services*: 	cisco_ise_sessioncounters
* *inventory*: inv_cisco_ise_base

---
### Download

* [Download latest mkp file][PACKAGE]

**Note**: before you update to a newer version, always check the [CHANGELOG](CHANGELOG). There might be incompatible changes.

---                   
### Installation

You can install the package by uploading it to your CheckMK site and as site user run 
```
mkp install PACKAGENAME-VERSION.mkp
```
or beginning with CMK2.2.x
```
mkp add PACKAGENAME-VERSION.mkp
mkp enable PACKAGENAME VERSION
```
In the non RAW editions of CheckMK you can use the GUI to install the package (_Setup_ -> _Extension Packages_ -> _Upload package_)

---
### Want to contribute?

Nice ;-) Have a look at the [contribution guidelines](CONTRIBUTING.md "Contributing")

---
### How to configure:

* enable the ERS API on ISE
* create a adminuser account with ERS Operator and MnT admin privileges
* configure the CheckMK Cisco ISE agent

![wato](img/ise-wato.png?raw=true "wato options")

---
### Sample output

```

<<<cisco_ise_sessioncounters:sep(0)>>>

{
    "activecount": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><sessionCount><count>0</count></sessionCount>", 
    "posturecount": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><sessionCount><count>0</count></sessionCount>", 
    "profilercount": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><sessionCount><count>0</count></sessionCount>", 
    "activelist": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><activeList noOfActiveSession=\"0\"/>",
    "authlist": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><activeList noOfActiveSession=\"0\"/>"
}
<<<cisco_ise_version:sep(0)>>>

{
    "version": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>
    <product name=\"Cisco Identity Services Engine\">
        <version>3.0.0.458</version>
        <type_of_node>0</type_of_node>
    </product>"
}
```