Authentication

The Crosswork Network Automation APIs can be accessed through an authenticated and authorized account. Only accounts with proper authorization can submit requests to API operations. All API communication must be made over a secure HTTPS connection.

When you authenticate using the login API, you will receive an authorization token, which you must then include in the request of each subsequent API operation.

Individual user management is provided by the Crosswork Network Controller solution. There is a single API gateway that exists in the Crosswork Network Controller solution and all APIs are consumed via this API gateway. As such, authenticating using the Crosswork authentication API (described in Getting Started) is sufficient to use all available APIs.

Crosswork Network Automation API supports multiple users, each with their own user-specific authorization and set of privileges based on their role. A user can be associated with specific roles for access based on their function and REST endpoints can be restricted based on the user’s role. The admin user has unrestricted access. For more information on creating and managing users and their roles, see the Cisco Crosswork Network Controller Administration Guide for your release.