API Authentication

Overview

CloudCenter Suite APIs require the following authentication details for each API call:

  • Username
  • API access key

The authentication HTTP header is not required when making standalone REST API calls using the username/API Key credentials.

Authentication Format in CURL Requests

Standalone CURL Request Example:

curl -H "Accept:application/json" -H "Content-Type:application/json" -u writer:BED74F4D9BFE0DA0 -X GET https://<HOST>:<PORT>/v1/users/27


In this CURL request example:

  • writer1 is the username
  • BED74F4D9BFE0DA0 is the API accessKey

Your tenant administrator can retrieve the username and API access key from the UI. See API Key for additional details.

Successful Authentication

On successful authentication, CloudCenter Suite sends a browser cookie to maintain the authentication session. The cookie forwards the information to the server for each API call so you do not need to authenticate each time you make an API call. If you do not want to maintain cookies in your browser, you can send the authentication information for each API request. Once authenticated, you can begin making API calls.

Session Timeout Length

The CloudCenter Suite authentication session times out after 15 minutes. If you use a REST client to make API calls by authenticating through the UI's, this session timeout applies to the REST client as well.

However, if you add and save the REST client authentication headers or if you issue CURL commands with the authentication details, you can circumvent the session timeout restriction.

  • No labels
© 2017-2019 Cisco Systems, Inc. All rights reserved