Cisco Cisco ASA 5555-X Adaptive Security Appliance
About the ASA REST API v1.1.1
Write memory API
Write memory API
34
Request payload is empty and user information should be in basic authentication header. The response could be as
follows.
Reason
HTTP Status Code
AAA validation failure/ Invalid token
401 Unauthorized
Success
204 No Content
Can’t get username/password from the
header or any other sanity check failures
400 Bad Request.
Notes:
The existing syslogs 605004 and 605005 will be used for create/delete a token.
Existing syslog 109033 will also be used for the case where “Challenge” is requested by the authentication server to
inform the user that it is “unsupported.”
inform the user that it is “unsupported.”
When a REST API request is received, first it checks for 'X-Auth-Token' header and if it not present then it will fall back
to basic authentication.
The token authentication will not conform to Oauth 2.0
specification.
The generated token database will be in the memory on ASA and will not be replicated across failover pair or clustering.
What this means is that, if in within a failover pair, failover happens or cluster master device changes, the authentication
needs to be performed again.
For a multi-context device the token is received for admin context, and it can be used for configuring any other context
as well.
Write memory API
Changes to the ASA configuration made by REST API calls are not persisted to the startup configuration; that is, changes
are assigned only to the running configuration. This 'Wirte Memory API' can be used to save the current running
are assigned only to the running configuration. This 'Wirte Memory API' can be used to save the current running
configuration to the startup configuration.
POST URL: /api/commands/writemem
Request payload is empty.
REST-API Online Documentation
The on-line documentation interface (Doc-UI) combines the functionality of a user interface with all the information
contained in the embedded API documentation. The Doc-UI can be run in any of the following browsers: Chrome
(current), Firefox (current), Internet Explorer 9+, Safari 5.1+, Opera (current). Older versions may work, but Internet
Explorer 8 and below will not.
Explorer 8 and below will not.