{"id":15009880,"url":"https://github.com/falkowich/pyise-ers","last_synced_at":"2025-12-30T15:00:51.500Z","repository":{"id":45024412,"uuid":"101615525","full_name":"falkowich/pyise-ers","owner":"falkowich","description":"Python module to manage Cisco ISE via the ERS API","archived":true,"fork":false,"pushed_at":"2024-09-25T07:17:01.000Z","size":828,"stargazers_count":27,"open_issues_count":9,"forks_count":28,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-09-29T06:02:21.088Z","etag":null,"topics":["api","cisco-ise","ers","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/falkowich.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-28T07:21:36.000Z","updated_at":"2025-03-25T14:04:59.000Z","dependencies_parsed_at":"2023-07-17T02:08:32.869Z","dependency_job_id":"c5ecb694-fb94-4274-8abf-9b4e94a9991c","html_url":"https://github.com/falkowich/pyise-ers","commit_stats":{"total_commits":330,"total_committers":22,"mean_commits":15.0,"dds":0.6272727272727272,"last_synced_commit":"780e22dbf8c391e549e391cd6ac182eb4dadb1b3"},"previous_names":["falkowich/ise"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/falkowich/pyise-ers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falkowich%2Fpyise-ers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falkowich%2Fpyise-ers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falkowich%2Fpyise-ers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falkowich%2Fpyise-ers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/falkowich","download_url":"https://codeload.github.com/falkowich/pyise-ers/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falkowich%2Fpyise-ers/sbom","scorecard":{"id":391818,"data":{"date":"2025-08-11","repo":{"name":"github.com/falkowich/pyise-ers","commit":"02a452076afe4f693afd300079dfdf5185315832"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/falkowich/pyise-ers/codeql-analysis.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/falkowich/pyise-ers/codeql-analysis.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/falkowich/pyise-ers/codeql-analysis.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/falkowich/pyise-ers/codeql-analysis.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/falkowich/pyise-ers/codeql-analysis.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/falkowich/pyise-ers/codeql-analysis.yml/master?enable=pin","Info:   0 out of   5 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":1,"reason":"Found 3/20 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":9,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:29","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:28","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":7,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 0 commits out of 14 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"21 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-48 / GHSA-fj7x-q9j7-g6q6","Warn: Project is vulnerable to: PYSEC-2024-230 / GHSA-248v-346w-9cwc","Warn: Project is vulnerable to: GHSA-3ww4-gg4f-jr7f","Warn: Project is vulnerable to: PYSEC-2024-225 / GHSA-6vqw-3v5j-54x4","Warn: Project is vulnerable to: GHSA-9v9h-cgj8-h64p","Warn: Project is vulnerable to: GHSA-h4gh-qq45-vh27","Warn: Project is vulnerable to: PYSEC-2023-254 / GHSA-jfhm-5ghh-2f97","Warn: Project is vulnerable to: PYSEC-2024-4 / GHSA-2mqj-m65w-jghx","Warn: Project is vulnerable to: PYSEC-2024-60 / GHSA-jjg7-2v4v-x38h","Warn: Project is vulnerable to: GHSA-cpwx-vrp4-4pq7","Warn: Project is vulnerable to: GHSA-gmj6-6f8f-6699","Warn: Project is vulnerable to: GHSA-h5c8-rqwp-cp95","Warn: Project is vulnerable to: GHSA-h75v-3vvj-5mfj","Warn: Project is vulnerable to: GHSA-q2x7-8rv6-6q7h","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-cx63-2mw6-8hw5","Warn: Project is vulnerable to: GHSA-34jh-p97f-mpxf","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: GHSA-jfmj-5v4g-7637"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T17:59:56.506Z","repository_id":45024412,"created_at":"2025-08-18T17:59:56.506Z","updated_at":"2025-08-18T17:59:56.506Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278217052,"owners_count":25950032,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","cisco-ise","ers","python3"],"created_at":"2024-09-24T19:29:01.247Z","updated_at":"2025-10-03T19:30:20.848Z","avatar_url":"https://github.com/falkowich.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# September 2024 - Repository goes into Archive mode\nAs of 2024-09-24 this library goes in to Archive.  \nISE 2.7 are marked as EoL, see » [End of Life Announcement for the Cisco Identity Services Engine Software Version 2.7](https://www.cisco.com/c/en/us/products/collateral/security/identity-services-engine/bulletin-c25-2943876.html)\n\nIf anyone want to continue, just send me a note or fork the repository.\n\n--\nKind Regards Falk\n\n# ISE-ERS API Wrapper\n\nIn September 2024 this repo will be set to archived,  \n[See discussion here »](https://github.com/falkowich/pyise-ers/discussions/231#discussioncomment-7406385)\n\n\nPython module to manage Cisco ISE via the REST API.  \n\n\n## [![Repography logo](https://images.repography.com/logo.svg)](https://repography.com) / Recent activity [![Time period](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_badge.svg)](https://repography.com)\n[![Timeline graph](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_timeline.svg)](https://github.com/falkowich/pyise-ers/commits)\n[![Issue status graph](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_issues.svg)](https://github.com/falkowich/pyise-ers/issues)\n[![Pull request status graph](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_prs.svg)](https://github.com/falkowich/pyise-ers/pulls)\n[![Trending topics](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_words.svg)](https://github.com/falkowich/pyise-ers/commits)\n[![Top contributors](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_users.svg)](https://github.com/falkowich/pyise-ers/graphs/contributors)\n[![Activity map](https://images.repography.com/40318014/falkowich/pyise-ers/recent-activity/8nHerXPThHSoRuaAcaHDP2lLz0EvzfqshE3KB2PqjLE/DZMNQ9aTZI17ApI0hq_AsBj0rIpPrPaxaIE71EwbtZM_map.svg)](https://github.com/falkowich/pyise-ers/commits)\n\n\n\n## Information about the master branch\n\n### As of May 6, 2023\n\nThe master branch is currently being in development.  \nPlease keep this in mind when using the code from this branch.\n\n## History\n\nAll initial work is done by [https://github.com/bobthebutcher](https://github.com/bobthebutcher) and [https://github.com/mpenning](https://github.com/mpenning).  \nI forked from them and updated so it worked with ISE 2.2.x and changed all functions to json calls.  \n\n* 2021-10-01 » All history before 0.2 and the namechange to pyiseers is located [here](#History-before-0.2)\n* 2021-10-01 » Deforked from upstream for simpler handling of PR's as of this [discussion](https://github.com/falkowich/ise/discussions/161)\n* 2021-10-02 » Started work with namechange as of this [issue](https://github.com/falkowich/ise/issues/164) to pyise-ers\n* 2021-10-03 » Pushed pyise-ers 0.2.0-rc to test.pypi.com\n* 2021-10-05 » Pushed pyise-ers 0.2.0.1 to pypi.com\n* 2023-10-27 » Pushed pyise-ers 0.3.0.1 - 0.3.0.3 to pypi-test\n* 2023-10-28 » Pushed pyise-ers 0.3.0.3 to pypi\n\n### Namechange information\n\n#### After 0.2.0.1 information\n\nIn 2021 I tried to publish the library to DevNet and beq modulname was just \"ise\" I had to do a rename on the package, module and repository.  \n\n* Repository is named pyise-ers,\n* The PyPI package is named pyise-ers.\n* The module is named pyiseers (for convenience of imports without dashes in them)\n\nIf you use the \"old 0.1.2.x\" ise packages in PyPi, please update your requirements to pyise-ers to get continued updates.\n(after testing everything in your environment offcourse)\n\n## Status\n\nI am keeping this active until ISE 2.7 is out of support. And for you who have ISE 3.1 and above, I would recommend https://github.com/CiscoISE/ciscoisesdk project.  \nSee this [discussion](https://github.com/falkowich/pyise-ers/discussions/231)\n\nEverything should work on 3.0.x train too, beq a few members uses that version. But in my test I only have access to 2.7.\n\nTested and used in our environment at work. But as usual it's up to you to test this out in a test environment so everything works as intended.\nIf you have any suggestions or find a bug, create a issue and we will try to fix it :)\n\nFeel free to [Join Discord Server](https://discord.gg/CA6FphRgF4) and contact me there too.\nI moved away from slack to Discord to try it out when 0.2.0.1 will be released.\n\n## Testing\n\nThese versions has been tested with pytest.\n\n|pyise-ers|ise|ise patch|python|date|status|\n|---|---|---|---|---|---|\n|0.1.1|2.4.0.357|none|3.7.3|2019|deprecated|\n|0.1.2|2.7.0.356|11|3.7.7|2020|deprecated|\n|0.1.2|2.7.0.356|1|3.7.7|2020|deprecated|\n|0.2.0.1|2.7.0.356|none|3.7.12|2021-10-05|deprecated|\n|0.2.0.1|3.0.0.458|none|3.7.12|2021-10-05|deprecated|\n|0.3.0.3|2.7.0.356|none|3.10.2|2023-10-28|active|\n\nThere are two tests available in tests/ directory.\n\n### Manual test\n\nTo run the \"manual\" tests:\n\n* make a copy of config-DEFAULT.py to config.py\n* edit uri_27, uri_30 and/or uri_31 with settings to your test ise server\n* run python manual_test_ers.py\n\n### Pytest\n\nTo run the testfiles with pytest-recording.  \nThe first time this is runned the directory `cassettes/` are created with saved .yaml files from the test.\nThat is so that the tests can be repeated without contacting ISE everytime.\n\n* make a copy of config-DEFAULT.py to config.py\n  * edit uri with settings to your test ise instance.\n  * in the config.py there are a list where you can set multiple versions if ise instances.\n* to run the tests\n  * pytest --record-mode=rewrite (To rewrite cassettes with live data)\n  * pytest (to reuse the recorded cassetes)\n\nThe plan is to extend the testing with testcoverage on this library.\n\n### Enable REST API\n\n[http://www.cisco.com/c/en/us/td/docs/security/ise/2-0/api_ref_guide/api_ref_book/ise_api_ref_ers1.html#pgfId-1079790](http://www.cisco.com/c/en/us/td/docs/security/ise/2-0/api_ref_guide/api_ref_book/ise_api_ref_ers1.html#pgfId-1079790)\nNeed to add an ISE Administrator with the \"ERS-Admin\" or \"ERS-Operator\" group assignment is required to use the API.\n\n### Installation\n\n#### From PyPi\n\n```bash\npip install pyise-ers\n```\n\n#### From Repository\n\n```bash\nmkdir path/to/parent\ncd path/to/parent\ngit clone https://github.com/falkowich/pyise-ers.git\n```\n\n##### Add to path\n\n```python\nimport sys\nsys.path.append('/path/to/parent/pyise-ers/')\n```\n\n### Usage\n\n```python\nfrom pyiseers import ERS\nise = ERS(ise_node='8.8.8.8', ers_user='ers', ers_pass='supersecret', ers_port=9060, verify=False, disable_warnings=True)\n```\n\nIf ISE is configured to require CSRF for ERS requests for Enhanced Security, you can add the \"use_csrf\" tag:\n\n```python\nfrom pyiseers import ERS\nise = ERS(ise_node='8.8.8.8', ers_user='ers', ers_pass='supersecret', ers_port=9060, verify=False, disable_warnings=True, use_csrf=True)\n```\n\n#### Methods return a result dictionary\n\n```python\n{\n    'success': True/False,\n    'response': 'Response from request',\n    'error': 'Error if any',\n}\n```\n\n#### Get a list of identity groups\n\n```python\nise.get_identity_groups()['response']\n\n[('NetworkAdmin',\n  '5f0b74f0-14e9-11e5-a7a6-00505683258b',\n  'Group for Network Admins with CLI access to network equipment'),\n ('OWN_ACCOUNTS (default)',\n  'cecdab40-8d30-11e5-82ce-005056834dc2',\n  'Default OWN_ACCOUNTS (default) User Group'),\n ('GuestType_Contractor (default)',\n  'c9b6b890-8d30-11e5-82ce-005056834dc2',\n  'Identity group mirroring the guest type '),\n ...]\n```\n\n#### Get details about an identity group\n\n```python\nise.get_identity_group(group='Employee')['response']\n\n{'description': 'Default Employee User Group',\n 'id': 'f80e5ce0-f42e-11e2-bd54-005056bf2f0a',\n 'link': {'href': 'https://8.8.8.8:9060/ers/config/identitygroup/f80e5ce0-f42e-11e2-bd54-005056bf2f0a',\n          'rel': 'self',\n          'type': 'application/xml'},\n 'name': 'Employee',\n 'parent': 'NAC Group:NAC:IdentityGroups:User Identity Groups'}\n\n```\n\n#### Get details about an endpoint\n\n```python\nise.get_endpoint_group(group='Resurs')['response']\n\n {'description': '',\n 'id': 'bf6bdcf0-14ed-11e5-a7a6-00505683258b',\n 'link': {'href': 'https://8.8.8.8:9060/ers/config/endpointgroup/bf6bdcf0-14ed-11e5-a7a6-00505683258b',\n          'rel': 'self',\n          'type': 'application/xml'},\n 'name': 'Resurs',\n 'systemDefined': False}\n\n```\n\n#### Get endpoint identity groups\n\n```python\nise.get_endpoint_groups()['response']\n\n  [('Cisco-IP-Phone',\n    '265079a0-6d8e-11e5-978e-005056bf2f0a',\n    'Identity Group for Profile: Cisco-IP-Phone'),\n   ('Resurs', '32c8eb40-6d8e-11e5-978e-005056bf2f0a', ''),\n   ...]\n\n```\n\n#### Add endpoint\n\n```python\nise.add_endpoint(name='test02', mac='AA:BB:CC:00:11:24', group_id='bf6bdcf0-14ed-11e5-a7a6-00505683258b', description='test02')\n{'response': 'test02 Added Successfully', 'success': True, 'error': ''}\n```\n\n#### Delete endpoint\n\n```python\nise.delete_endpoint(mac='AA:BB:CC:00:11:27')\n{'error': '', 'response': 'AA:BB:CC:00:11:27 Deleted Successfully', 'success': True}\n\n```\n\n#### Get a list of internal users\n\n```python\nise.get_users()['response']\n\n[('test01', '85fd1eb0-c6fa-11e5-b6b6-000c297b78b4'),\n ('test02', '54fd1eb0-c5fb-54e5-b6b6-00204597b28b1'),\n ...]\n\n```\n\n#### Get details about an internal user\n\nBy name\n\n```python\nise.get_user(user_id='test02')['response']\n\n{'changePassword': False,\n 'customAttributes': {},\n 'enablePassword': '*******',\n 'enabled': True,\n 'expiryDateEnabled': False,\n 'id': '54fd1eb0-c5fb-54e5-b6b6-00204597b28b1',\n 'identityGroups': '5f0b74f0-14e9-11e5-a7a6-00505683258b',\n 'link': {'href': 'https://8.8.8.8:9060/ers/config/internaluser/a837bd55-f2b7-41e3-b0ff-c5ddf9af398c',\n          'rel': 'self',\n          'type': 'application/xml'},\n 'name': 'test02',\n 'password': '*******',\n 'passwordIDStore': 'Internal Users'}\n\n```\n\nBy email\n\n```python\nise.get_user(user_email='test02@example.com')['response']\n\n{'changePassword': False,\n 'customAttributes': {},\n 'enablePassword': '*******',\n 'enabled': True,\n 'expiryDateEnabled': False,\n 'id': '54fd1eb0-c5fb-54e5-b6b6-00204597b28b1',\n 'identityGroups': '5f0b74f0-14e9-11e5-a7a6-00505683258b',\n 'link': {'href': 'https://8.8.8.8:9060/ers/config/internaluser/a837bd55-f2b7-41e3-b0ff-c5ddf9af398c',\n          'rel': 'self',\n          'type': 'application/xml'},\n 'name': 'test02',\n 'password': '*******',\n 'passwordIDStore': 'Internal Users'}\n\n```\n\n#### Add an internal user\n\n```python\nise.add_user(user_id='test11', password='TeStInG11', user_group_oid='5f0b74f0-14e9-11e5-a7a6-00505683258b')\n\n{'error': '', 'response': 'test11 Added Successfully', 'success': True}\n\n```\n\n#### Delete an internal user\n\n```python\nise.delete_user(user_id='test11')\n\n{'error': '', 'response': 'test11 Deleted Successfully', 'success': True}\n\n```\n\n#### Get details about an admin user\n\n```python\nise.get_admin_user(user_id='admin')\n\n{\n  \"SearchResult\": {\n    \"total\": 2,\n    \"resources\": [\n      {\n        \"id\": \"c2428e12-105f-4d5f-88ae-5885516d7ac5\",\n        \"name\": \"admin\",\n        \"description\": \"Default Admin User\",\n        \"link\": {\n          \"rel\": \"self\",\n          \"href\": \"https://8.8.8.8:9060/ers/config/adminuser/c2428e12-105f-4d5f-88ae-5885516d7ac5\",\n          \"type\": \"application/json\"\n        }\n      },\n      {\n        \"id\": \"e0884628-8d13-451c-b3f7-117f9d0336ad\",\n        \"name\": \"ers-operator\",\n        \"description\": \"\",\n        \"link\": {\n          \"rel\": \"self\",\n          \"href\": \"https://8.8.8.8:9060/ers/config/adminuser/e0884628-8d13-451c-b3f7-117f9d0336ad\",\n          \"type\": \"application/json\"\n        }\n      }\n    ]\n  }\n}\n\n```\n\n#### Get a list of devices\n\n```python\nise.get_devices()['response']\n\n[('TestDevice01', '6680f410-5277-11e5-9a52-05505683258b'),\n ('TestDevice02', '64d9b32-5c56-11e5-9a52-00502683258b'),\n ...]\n\n```\n\n#### Get details about a device\n\n```python\nise.get_device(device='TestDevice02')['response']\n\n{'NetworkDeviceGroupList': ['Stage#Stage',\n                            'Device Type#All Device Types#Linux',\n                            'Location#All Locations'],\n 'NetworkDeviceIPList': [{'ipaddress': '10.8.1.55', 'mask': 32}],\n 'authenticationSettings': {'enableKeyWrap': False,\n                            'keyInputFormat': 'ASCII',\n                            'networkProtocol': 'RADIUS',\n                            'radiusSharedSecret': '******'},\n 'coaPort': 0,\n 'id': '74d9b830-5c76-11e5-9a52-00505683258b',\n 'link': {'href': 'https://8.8.8.8:9060/ers/config/networkdevice/74d9b830-5c76-11e5-9a52-00505683258b',\n          'rel': 'self',\n          'type': 'application/xml'},\n 'modelName': 'Linux',\n 'name': 'TestDevice02',\n 'profileName': 'Cisco'}\n\n```\n\n#### Get a list of device groups\n\n```python\nise.get_device_groups()['response']\n\n[('Device Type#All Device Types', '526240e0-f42e-11e2-bd54-005056bf2f0a'),\n ('Device Type#All Device Types#Switch', 'e25bd190-14e6-11e5-a7a6-00505683258b'),\n ('Device Type#All Device Types#Wism', 'e6b085b0-14e6-11e5-a7a6-00505683258b'),\n ('IPSEC#Is IPSEC Device', '0d3f19b0-30c1-11e7-88b5-005056834dc2'),\n ('IPSEC#Is IPSEC Device#No', '0dac0c50-30c1-11e7-88b5-005056834dc2'),\n ('IPSEC#Is IPSEC Device#Yes', '0d74f6c0-30c1-11e7-88b5-005056834dc2'),\n ('Location#All Locations', '522b7970-f42e-11e2-bd54-005056bf2f0a'),\n ...]\n\n```\n\n#### Get device group(s) details\n\n```python\n# Provide a device_group_id \nise.get_device_group(device_group_id=\"4b26b5b0-71a6-11eb-b5e0-52cf9299494c\")\n\n{'success': True,\n 'response': {'id': '4b26b5b0-71a6-11eb-b5e0-52cf9299494c',\n  'name': 'Device Type#All Device Types#NXOS',\n  'description': '',\n  'link': {'rel': 'self',\n   'href': 'https://8.8.8.8:9060/ers/config/networkdevicegroup/4b26b5b0-71a6-11eb-b5e0-52cf9299494c',\n   'type': 'application/json'},\n  'othername': 'Device Type'},\n 'error': ''}\n\n\n# Provide a partial group name to look for \nise.get_device_group(name=\"NXOS\")\n\n{'success': True,\n 'response': {'id': '4b26b5b0-71a6-11eb-b5e0-52cf9299494c',\n  'name': 'Device Type#All Device Types#NXOS',\n  'description': '',\n  'link': {'rel': 'self',\n   'href': 'https://8.8.8.8:9060/ers/config/networkdevicegroup/4b26b5b0-71a6-11eb-b5e0-52cf9299494c',\n   'type': 'application/json'},\n  'othername': 'Device Type'},\n 'error': ''}\n\n# If more than one group found with for a name a list is returned\nise.get_device_group(name=\"Device Types\")\n\n[\n  {'success': True,\n  'response': {'id': '70c79c30-8bff-11e6-996c-525400b48521',\n   'name': 'Device Type#All Device Types',\n   'description': 'All Device Types',\n   'link': {'rel': 'self',\n    'href': 'https://8.8.8.8:9060/ers/config/networkdevicegroup/70c79c30-8bff-11e6-996c-525400b48521',\n    'type': 'application/json'},\n   'othername': 'Device Type'},\n  'error': ''},\n {'success': True,\n  'response': {'id': 'ee45c0a0-7fbc-11eb-ac01-36750594a888',\n   'name': 'Device Type#All Device Types#IOS-XE',\n   'description': '',\n   'link': {'rel': 'self',\n    'href': 'https://8.8.8.8:9060/ers/config/networkdevicegroup/ee45c0a0-7fbc-11eb-ac01-36750594a888',\n    'type': 'application/json'},\n   'othername': 'Device Type'},\n  'error': ''},\n {'success': True,\n  'response': {'id': '4b26b5b0-71a6-11eb-b5e0-52cf9299494c',\n   'name': 'Device Type#All Device Types#NXOS',\n   'description': '',\n   'link': {'rel': 'self',\n    'href': 'https://8.8.8.8:9060/ers/config/networkdevicegroup/4b26b5b0-71a6-11eb-b5e0-52cf9299494c',\n    'type': 'application/json'},\n   'othername': 'Device Type'},\n  'error': ''},\n]\n```\n\n#### Add a new device group\n\n```python\nise.add_device_group(name=\"Device Type#All Device Types#Python Device Type\", description=\"From Python\")\n\n{'success': True,\n 'response': 'Device Type#All Device Types#Python Device Type Added Successfully',\n 'error': ''}\n```\n\n#### Update a device group\n\n```python\nise.update_device_group(device_group_oid=group_id, name=\"Device Type#All Device Types#Updated Device Type\", description=\"Update Description\")\n\n{'success': True,\n 'response': 'e7db3e00-a36d-11eb-ac01-36750594a888 Updated Successfully',\n 'error': ''}\n```\n\n#### Remove a device group\n\n```python\nise.delete_device_group(name=\"Device Type#All Device Types#Python Device Type\")\n\n{'success': True,\n 'response': 'Device Type#All Device Types#Python Device Type Deleted Successfully',\n 'error': ''}\n```\n\n#### Add a device\n\n```python\nise.add_device(name='testdevice03',\n               ip_address='8.8.8.8',\n               radius_key='foo',\n               snmp_ro='bar',\n               dev_group='Stage#Stage#Closed',\n               dev_location='Location#All Locations#Site21',\n               dev_type='Device Type#All Device Types#Switch')\n\n{'error': '', 'response': 'testdevice03 Added Successfully', 'success': True}\n```\n\n#### Update a device\n\n```python\nise.update_device(\"PYTHON-DEVICE\", tacacs_shared_secret=\"NEWTACACS\")\n\n{'success': True,\n 'response': {'updatedField': [{'field': 'TacacsSettings.ConnectModeOptions',\n    'oldValue': '',\n    'newValue': 'ON_LEGACY'},\n   {'field': 'TacacsSettings.SharedSecret', 'newValue': 'NEWTACACS'}]},\n 'error': ''}\n```\n\n#### Delete a device\n\n```python\nise.delete_device(device='testdevice03')\n\n{'error': '', 'response': 'testdevice03 Deleted Successfully', 'success': True}\n```\n\n#### Get all Security Groups (SGTs)\n\n```python\nise.get_sgts()\n\n{'success': True, 'response': [('Contractors', '4f9c8050-8f9f-11ea-b8e4-ca18718347e2'), ('Employees', 'a34ae530-59a2-11ea-a6b9-26b516ce162b'), ('Guest', '440dd8b0-7da7-11ea-bb75-261e6ff61f42'), ('IoT_Devices', '55bd68f0-8f9f-11ea-b8e4-ca18718347e2'), ('IoT_Servers', '36369eb0-8fa0-11ea-b8e4-ca18718347e2'), ('Servers', '385cbd90-8fa1-11ea-b8e4-ca18718347e2'), ('TrustSec_Devices', '947832a0-8c01-11e6-996c-525400b48521'), ('Unknown', '92adf9f0-8c01-11e6-996c-525400b48521')], 'error': '', 'total': 8}\n```\n\n#### Get Specific SGT\n\n```python\nise.get_sgt(\"Unknown\")\nise.get_sgt(0)\nise.get_sgt(\"92adf9f0-8c01-11e6-996c-525400b48521\")\n\n{'success': True, 'response': {'id': '92adf9f0-8c01-11e6-996c-525400b48521', 'name': 'Unknown', 'description': 'Unknown Security Group', 'value': 0, 'generationId': '1', 'propogateToApic': False, 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/sgt/92adf9f0-8c01-11e6-996c-525400b48521', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Add a SGT\n\n```python\nise.add_sgt(\"Python_Users\", \"Group used for all Python Users\", 56789, return_object=True)\n\n{'success': True, 'response': {'id': 'd4696690-97ba-11ea-9614-caf56bcd6712', 'name': 'Python_Users', 'description': 'Group used for all Python Users', 'value': 56789, 'generationId': '0', 'propogateToApic': False, 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/sgt/d4696690-97ba-11ea-9614-caf56bcd6712', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Update a SGT\n\n```python\nise.update_sgt(\"d4696690-97ba-11ea-9614-caf56bcd6712\", \"Python_Tests\", \"Testing for Python Users\", 45678, return_object=True)\n\n{'success': True, 'response': {'id': 'd4696690-97ba-11ea-9614-caf56bcd6712', 'name': 'Python_Tests', 'description': 'Testing for Python Users', 'value': 45678, 'generationId': '0', 'propogateToApic': False, 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/sgt/d4696690-97ba-11ea-9614-caf56bcd6712', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Delete a SGT\n\n```python\nise.delete_sgt(\"d4696690-97ba-11ea-9614-caf56bcd6712\")\n\n{'success': True, 'response': 'd4696690-97ba-11ea-9614-caf56bcd6712 Deleted Successfully', 'error': ''}\n```\n\n#### Get all Security Groups ACLs (SGACLs)\n\n```python\nise.get_sgacls()\n\n{'success': True, 'response': [('Block_All', '7c9b4a80-8fa1-11ea-b8e4-ca18718347e2'), ('Deny IP', '92919850-8c01-11e6-996c-525400b48521'), ('Deny_ICMP', 'c21dfa60-59a2-11ea-a6b9-26b516ce162b'), ('Deny_IP_Log', '0e6d3830-0684-11ea-ace5-42a6b55c5ca6'), ('Permit IP', '92951ac0-8c01-11e6-996c-525400b48521'), ('Permit_FTP', '761b9e50-7e01-11ea-bb75-261e6ff61f42'), ('Permit_IP_Log', '0e6aee40-0684-11ea-ace5-42a6b55c5ca6'), ('Permit_MQTT', '1470fa00-5a85-11ea-a6b9-26b516ce162b')], 'error': '', 'total': 8}\n```\n\n#### Get Specific SGACL\n\n```python\nise.get_sgacl(\"Permit IP\")\nise.get_sgacl(\"92951ac0-8c01-11e6-996c-525400b48521\")\n\n{'success': True, 'response': {'id': '92951ac0-8c01-11e6-996c-525400b48521', 'name': 'Permit IP', 'description': 'Permit IP SGACL', 'generationId': '0', 'aclcontent': 'permit ip', 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/sgacl/92951ac0-8c01-11e6-996c-525400b48521', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Add a SGACL\n\n```python\nise.add_sgacl(\"Python_ACL\", \"Access List for Python Access\", \"IP_AGNOSTIC\", [\"permit tcp dst eq 80\"], return_object=True)\n\n{'success': True, 'response': {'id': '7a820000-97bb-11ea-9614-caf56bcd6712', 'name': 'Python_ACL', 'description': 'Access List for Python Access', 'generationId': '0', 'aclcontent': 'permit tcp dst eq 80', 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/sgacl/7a820000-97bb-11ea-9614-caf56bcd6712', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Update a SGACL\n\n```python\nise.update_sgacl(\"7a820000-97bb-11ea-9614-caf56bcd6712\", \"Python_Access_List\", \"Python Access List\", \"IPV4\", [\"permit tcp src eq 80\"], return_object=True)\n\n{'success': True, 'response': {'id': '7a820000-97bb-11ea-9614-caf56bcd6712', 'name': 'Python_Access_List', 'description': 'Python Access List', 'generationId': '1', 'ipVersion': 'IPV4', 'aclcontent': 'permit tcp src eq 80', 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/sgacl/7a820000-97bb-11ea-9614-caf56bcd6712', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Get all TrustSec Egress Matrix Cells (Policies)\n\n```python\nise.get_egressmatrixcells()\n\n{'success': True, 'response': [('ANY-ANY', '92c1a900-8c01-11e6-996c-525400b48521'), ('Contractors-Servers', '5251ca60-8fa1-11ea-b8e4-ca18718347e2'), ('Contractors-IoT_Devices', 'de7859b0-8fa0-11ea-b8e4-ca18718347e2'), ('Employees-Servers', '5fb81e71-8fa1-11ea-b8e4-ca18718347e2'), ('Employees-Employees', 'd2d88280-59a2-11ea-a6b9-26b516ce162b'), ('Employees-IoT_Devices', 'e18ac9d1-8fa0-11ea-b8e4-ca18718347e2'), ('Employees-TrustSec_Devices', 'ee035030-59a2-11ea-a6b9-26b516ce162b'), ('Guest-IoT_Devices', 'e4d49da1-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-IoT_Devices', 'b0eccdf0-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-IoT_Servers', 'b7e6d880-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-Contractors', 'c82308e0-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-Employees', 'cb276f40-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-Guest', 'ce1e4110-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-TrustSec_Devices', 'd1e33851-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Devices-Unknown', 'd68d3860-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Servers-IoT_Devices', 'bc784780-8fa0-11ea-b8e4-ca18718347e2'), ('IoT_Servers-IoT_Servers', 'c069f410-8fa0-11ea-b8e4-ca18718347e2'), ('TrustSec_Devices-IoT_Devices', 'e94bcde1-8fa0-11ea-b8e4-ca18718347e2'), ('Unknown-IoT_Devices', 'f3e9da31-8fa0-11ea-b8e4-ca18718347e2')], 'error': '', 'total': 19}\n```\n\n#### Get Specific Egress Matrix Cell\n\n```python\nise.get_egressmatrixcell(\"Default egress rule\")\nise.get_egressmatrixcell(None, src_sgt=\"92bb1950-8c01-11e6-996c-525400b48521\", dst_sgt=\"92bb1950-8c01-11e6-996c-525400b48521\")\n\n{'success': True, 'response': {'id': '92c1a900-8c01-11e6-996c-525400b48521', 'name': 'ANY-ANY', 'description': 'Default egress rule', 'sourceSgtId': '92bb1950-8c01-11e6-996c-525400b48521', 'destinationSgtId': '92bb1950-8c01-11e6-996c-525400b48521', 'matrixCellStatus': 'ENABLED', 'defaultRule': 'PERMIT_IP', 'sgacls': ['92951ac0-8c01-11e6-996c-525400b48521'], 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/egressmatrixcell/92c1a900-8c01-11e6-996c-525400b48521', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Add a Egress Matrix Cell\n\n```python\nise.add_egressmatrixcell(source_sgt=\"Unknown\", destination_sgt=\"TrustSec_Devices\", default_rule=\"PERMIT_IP\", return_object=True)\n\n{'success': True, 'response': {'id': '6f76b621-97bf-11ea-9614-caf56bcd6712', 'name': 'Unknown-TrustSec_Devices', 'sourceSgtId': '92adf9f0-8c01-11e6-996c-525400b48521', 'destinationSgtId': '947832a0-8c01-11e6-996c-525400b48521', 'matrixCellStatus': 'ENABLED', 'defaultRule': 'PERMIT_IP', 'sgacls': ['92951ac0-8c01-11e6-996c-525400b48521'], 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/egressmatrixcell/6f76b621-97bf-11ea-9614-caf56bcd6712', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Update a Egress Matrix Cell\n\n```python\nise.update_egressmatrixcell(\"6f76b621-97bf-11ea-9614-caf56bcd6712\", source_sgt=\"Unknown\", destination_sgt=\"TrustSec_Devices\", default_rule=\"NONE\", acls=[\"Deny IP\"], description=\"Description\", return_object=True)\n\n{'success': True, 'response': {'id': '6f76b621-97bf-11ea-9614-caf56bcd6712', 'name': 'Unknown-TrustSec_Devices', 'description': 'Description', 'sourceSgtId': '92adf9f0-8c01-11e6-996c-525400b48521', 'destinationSgtId': '947832a0-8c01-11e6-996c-525400b48521', 'matrixCellStatus': 'ENABLED', 'defaultRule': 'DENY_IP', 'sgacls': ['92919850-8c01-11e6-996c-525400b48521'], 'link': {'rel': 'self', 'href': 'https://10.102.172.125:9060/ers/config/egressmatrixcell/6f76b621-97bf-11ea-9614-caf56bcd6712', 'type': 'application/json'}}, 'error': ''}\n```\n\n#### Delete a Egress Matrix Cell\n\n```python\nise.delete_egressmatrixcell(\"6f76b621-97bf-11ea-9614-caf56bcd6712\")\n\n{'success': True, 'response': '6f76b621-97bf-11ea-9614-caf56bcd6712 Deleted Successfully', 'error': ''}\n```\n\n# History before namechange » 0.2.0\n\n* Merged back from the work that [https://github.com/karrots](https://github.com/karrots) has done efter I paused the updates.  \n* Converted to pipenv packages instead of requirements.txt\n* Updated to ISE 2.4.x\n* Merged back from the work that [https://github.com/msom](https://github.com/msom) has done with some good device fixes.\n  * *One big thing is that module is now renamed from ise.cream to just ise.*\n* First publish to PyPi with the help of [https://github.com/JonasKs](https://github.com/JonasKs).\n* Add support for ISE CSRF and some TrustSec objects (SGT, SGACL, Egress Policy Matrix) [https://github.com/joshand](https://github.com/joshand).\n* Merged [Enhancement to Device Group and Device Functions](https://github.com/falkowich/ise/pull/152) with a big thanks to [https://github.com/hpreston](https://github.com/hpreston)\n  * New functions for devicegroups where added » add_device_group, update_device_group, delete_device_group.\n  * New function to update devices where added » update_device\n  * Updated get_device_group for looking up names\n  * Updated add_device with new parameters and device_payload\n* Updated dependensies for dev and prod, created new manual testcases, cleaned up the code with black.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffalkowich%2Fpyise-ers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffalkowich%2Fpyise-ers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffalkowich%2Fpyise-ers/lists"}