Cisco Cisco Security Manager 4.10 Guía Del Usuario
Cisco Security Manager 4.10 API Specification (Version 2.2)
Page 2
Table of Contents
1
Overview ............................................................................................................................................................. 15
1.1
Scope ............................................................................................................................................................. 15
1.2
Changes in Revision 1.1 ................................................................................................................................ 16
1.2.1
Unified Access Rules ............................................................................................................................... 16
1.2.2
Security Policy Object ............................................................................................................................. 16
1.2.3
Network object ......................................................................................................................................... 16
1.2.4
Return user/ticket that last modified a config rule ................................................................................... 16
1.2.5
Add device status – up/down as part of the event service ........................................................................ 16
1.2.6
Exec command API call will be supporting custom timeouts .................................................................. 16
1.2.7
API enhancement to return list of all the shared Policies defined in CSM .............................................. 16
1.2.8
Return the Device’s SysObjectID in the Device Object .......................................................................... 16
1.2.9
CSM Audit Logs should differentiate between logins through API and CSM client. ............................. 17
1.2.10
New Firewall Policies .............................................................................................................................. 17
1.3
Changes in Revision 2.0 ................................................................................................................................ 17
1.3.1
Write API ................................................................................................................................................. 17
1.3.2
All CSM Server Mode Support ................................................................................................................ 18
1.3.3
Deployment API ...................................................................................................................................... 18
1.3.4
API to Read Policy Object ....................................................................................................................... 18
1.3.5
Access-Rule Changes ............................................................................................................................... 18
1.4
Changes in Revision 2.1 ................................................................................................................................ 19
1.4.1
CreateSharedPolicy .................................................................................................................................. 19
1.4.2
DeleteSharedPolicy .................................................................................................................................. 19
1.4.3
Renamesharedpolicy ................................................................................................................................ 19
1.4.4
Assignsharedpolicy .................................................................................................................................. 20
1.4.5
Unassignsharedpolicy .............................................................................................................................. 20
1.4.6
Inheritsharedpolicy .................................................................................................................................. 20
1.5
Audience ....................................................................................................................................................... 20
1.6
References ..................................................................................................................................................... 20
1.7
Glossary ......................................................................................................................................................... 20
1.8
Conventions ................................................................................................................................................... 21
1.9
Overview of CSM Message Flows ................................................................................................................ 22
1.10
Licensing ....................................................................................................................................................... 23
1.11
Prerequisites .................................................................................................................................................. 24
1.12
API Administration Settings ......................................................................................................................... 24
1.13
Debug Settings .............................................................................................................................................. 25
2
Common Service API .......................................................................................................................................... 26
2.1
Object Model ................................................................................................................................................. 26
2.1.1
Object Identifier ....................................................................................................................................... 26
2.1.2
Base Object .............................................................................................................................................. 26
2.1.3
Device ...................................................................................................................................................... 27
2.1.4
DeviceGroup ............................................................................................................................................ 30
2.1.5
Port Identifier ........................................................................................................................................... 31
2.1.6
BaseError ................................................................................................................................................. 32
2.2
Methods ......................................................................................................................................................... 34
2.2.1
Common Request & Response ................................................................................................................ 34
2.2.2
Method login ............................................................................................................................................ 35
2.2.3
Method logout .......................................................................................................................................... 40
2.2.4
Method: ping ............................................................................................................................................ 42