topic Re: Complete API documentation in PDF with sample responses in Network Security

Complete API documentation in PDF with sample responses

AhmerAh19806 — Mon, 10 Feb 2020 10:25:05 GMT

Hi, everyone

I work in a company as a developer where we just decided to use Cisco ASAv as firewall. It will take i guess two or more weeks(i am not sure as I don't see this part of company) for deployment of ASAv but I am assigned task of developing scripts to talk to ASAv for internal purposes. I saw two documents(links attached) but they seem to be missing complete information and recommend ASA's UI API documentation. For now, I don't have access to UI doc and I want to develop scripts before deployment. Is there complete API documentation online. E.g I want to block IP on ASA,, what would be the path? Will I use "/api/access"? Plus, is there sample responses for every REST API endpoint available?

#https://www.cisco.com/c/dam/en/us/td/docs/security/asa/api/asapedia_rest_api_132.pdf

#https://www.cisco.com/c/en/us/td/docs/security/asa/api/qsg-asa-api.htm

Re: Complete API documentation in PDF with sample responses

Ben Walters — Mon, 10 Feb 2020 20:05:28 GMT

Unfortunately the complete documentation is on the ASA itself, I went through the same thing a while ago and haven't found anything online that offers anything near the API documentation that is on the device. Fortunately we have a dev ASA handy that I can always reference.

That being said the on-board API documentation is very comprehensive. With samples and you can even run queries from the GUI.

Re: Complete API documentation in PDF with sample responses

AhmerAh19806 — Tue, 11 Feb 2020 03:55:53 GMT

OK. Is there something like demo trial of ASAv?

Re: Complete API documentation in PDF with sample responses

nspasov — Tue, 11 Feb 2020 04:29:18 GMT

The ASAv will have all of the features enabled when you deploy it without a license. However, your traffic is going to be rate-limited to 100 kbps.

Thank you for rating helpful posts!

Re: Complete API documentation in PDF with sample responses

AhmerAh19806 — Tue, 11 Feb 2020 06:40:25 GMT

Where and how can I get demo of ASAv?

Re: Complete API documentation in PDF with sample responses

nspasov — Tue, 11 Feb 2020 16:11:55 GMT

The ASAv can be downloaded at the following link:

https://software.cisco.com/download/home/286119613/type

If your cisco.com account does not have the permissions to download it, you will need to reach out to you local Cisco account team and they should be able to publish the image with the desired version for you.

Thank you for rating helpful posts!

Re: Complete API documentation in PDF with sample responses

AhmerAh19806 — Wed, 12 Feb 2020 05:23:33 GMT

It requires service contract. I guess we can't download ASAv for trial period with or without free Cisco account, even with limitations. Correct?

Re: Complete API documentation in PDF with sample responses

nspasov — Wed, 12 Feb 2020 05:52:47 GMT

That is correct, but as I mentioned, your local Cisco team or Cisco reseller can help you get this sorted out.

Thank you for rating helpful posts!