Lists operational and security restrictions related to Cisco API key usage, emphasizing considerations and limitations that apply when accessing Cisco SD-WAN Cloud APIs.
You can access APIs from Cisco SD-WAN Cloud using your SSO login, but you must follow certain operational and security restrictions. For additional details and documentation, refer to Cisco DevNet.
-
Authentication method
You must specify the Bearer token authentication method in a header field. Use the value you received from your GET request.
-
Cross-site request forgery protection (CSRF or XSRF)
Your API request header must include an X-XSRF-Token header field to protect against cross-site request forgery. Use the value you received from your GET request.
-
API body use
You can include an API body as needed, based on the API call you are making.
-
Rate limit
Real-time APIs and bulk APIs are not available. All other APIs are subject to a rate limit of 10 per second. Cisco SD-WAN Manager enforces an API rate limit of 5 per second.
-
No continuous monitoring
Use this feature only for occasional access. For information about API rate limits, see the Cisco Catalyst SD-WAN Getting Started Guide.
-
Supported categories
API calls are provided only for these categories of operations:
-
Certificate management
-
Configuration
-
Device and device inventory
-
Monitoring
-
Troubleshooting tools
-
-
No NAT configuration
Cisco SD-WAN Cloud does not support NAT configuration using REST APIs.