Cisco Cisco ASA 5555-X Adaptive Security Appliance

About the ASA REST API v1.3.2
REST API Agent in ASA

• If command authorization is enabled, ensure local user ‘enable_1’ with a privilege level of 15 is available (the

REST API Agent uses this account to communicate with the ASA):

username enable_1 password <pass> encrypted privilege 15

‘rest-api agent’ Command

To enable the REST API Agent after installing a REST API image, use the "rest-api agent" command. To disable the

REST API Agent, use the "no" form of the command.

[no] rest-api agent

agent - Starts the REST API Agent process on the ASA.

Prerequisite: HTTP server must be enabled in order for the REST API Agent to work.

When the REST API Agent is enabled, ‘/api’ URL requests are redirected from the ASA HTTP server to the REST API

Agent.

Supported Modes

single/multiple context, routed/transparent

‘show rest-api agent’ Command

The "show rest-api agent" command shows the current status of the REST API Agent:

ciscoasa(config)# show rest-api agent

The REST API Agent is currently enabled

ciscoasa(config)# show rest-api agent

The REST API Agent is currently disabled

When the REST API Agent is disabled, ‘/api’ URL requests are rejected by the ASA HTTP server with a 404 status code

response.

Supported Modes

single/multiple context, routed/transparent

‘show version’ Command

The version of the REST API Agent is listed in the output of the "show version" command: