We are excited to announce that Cisco Smart Net API integration is now available!   


Cisco Smart Net API integration will allow for the following:

  • We will pull warranty expiration dates for your Cisco assets
  • Optional:  We can pull device End of Life dates for your Cisco assets.   If selecting this option, you may choose one of several EoX dates provided by Cisco to determine LCI End of Life Date
  • Optional: We can pull Cisco model information


Cisco SNTC Configuration

Our approach will be to leverage Cisco's Support APIs.  In order to call the Cisco Support API's you will need to generate a client id/key and client secret, then enter those credentials into LCI.


The following information is provided to help you set up your API keys.  In order to generate the keys, you will need establish a user in the SNTC portal with the appropriate access level.  Information regarding User Onboarding can be found here:

https://developer.cisco.com/docs/support-apis/#!user-onboarding-process


Once you have set up the User, you will need to go thru the Application Registration process.  It is during this process that you will generate the client id/key and client secret.  Information regarding this set up can be found here:

https://developer.cisco.com/docs/support-apis/#!application-registration/registering-your-first-application..


Important Information when setting up your Application

  • Name is required.  Use Lifecycle Insights or similar
  • Under OAuth2.0 Credentials, make sure ONLY Client Credentials is checked.
  • You NEED to select each of the following APIs
    • EOX V5 API
    • Product Info API 1.0
    • Serial Number to Information API Version 2

If you do not see the three APIs above, the SNTC user you are creating the application for does not have the appropriate level of access.   Please contact your Cisco rep if you have any questions.  Alternatively, you can check out this link: https://www.cisco.com/c/dam/en/us/support/docs/services/sntc/Guide-to-Assigning-Customer-API-Roles.pdf 




Lifecycle Insights Configuration

In the left navigation pane, click on Integrations under Administration.   Next, scroll down at the bottom of the main content page and you will see a tile for Cisco Smart Net- click on that tile.



You will be prompted with a form that will allow you to enter your Cisco SNTC credentials and also specify optional options for the integration.




Form ElementRequiredDescription
Cisco Integration ActiveNoWhen checked, LCI will perform Cisco lookups during your nightly build
Cisco Client ID/KeyYesCisco Client ID/Key from SNTC Application
Cisco SecretYesCisco secret from SNTC Application
Load EOL Data from CiscoNoWhen selected, we will load EOL data (if exists) from the Cisco API
Cisco EOL AttributeNoThis will only show if Load EOL Data from Cisco is checked.  If checked, select the Cisco EoX attribute that you want us to use when setting the EOL date in LCI
Load Model Number from CiscoNoWhen selected, we will load the model information from the Cisco API into LCI/Model Number.  Note that we will treat this as you overwriting the Model information in Asset Edit.  



When you are done entering your settings, please click Save Settings.


Turning Off Syncs

You may turn off the Cisco SNTC Integration for all of your by unchecking the Cisco Integration Active checkbox at the top of the page.  Note, turning off the integration does not mean we will revert any data that has previously been looked up. If you want to revert any data, please contact support.



Questions/Troubleshooting

Question:  I have some assets in Cisco that are not getting updated.  Why not?

There are three things to look at here:

  1. Check your log or Data Sync Manager to ensure you don't have any issues with the integration.   Both places will show if the job failed for any reason, or if successful, stats on number of assets updated, ignored, etc.
  2. We perform all look ups using the serial number.  If the serial number in LCI is not valid, we will not be able to look up the asset in Cisco
  3. If you are missing updates for an entire company/organization... please make sure the SNTC user that created the application has access to the company/organization of the asset.

Question:  Why am I seeing the warranty expiration date from my PSA/IT Glue, and not the warranty expiration date from Cisco?

The decision to display Warranty expiration date from your PSA/IT Glue vs what we received from Cisco is determined based on your settings in Warranty Lookup settings.  If you want to force LCI to always use the value from Cisco, please make sure the Warranty Expiration Date Display Criteria  is set to Always use Vendor Lookup date if it exists.  Note - this setting applies to all vendors (IE. Dell, Lenovo, etc) - not just Cisco.


Question: How do you determine what assets to look up via Smart Net API?

We will attempt to look up any asset that meets the following criteria:

  1. The asset has a valid serial number
  2. The asset make contains 'cisco'
  3. The asset make does NOT contain 'meraki'


Question:  How often does LCI check for updates to warranty expiration date?

The Cisco lookup criteria will follow what is set in the Warranty Lookup settings page.  Specifically, look at the questions - "How often would you like to check assets with warranties that are expired or will expire in next 6 months?" and "When would you like to start re-checking assets with warranties in good standing...?"


If no warranty expiration date is returned via the API, we will attempt to pull it again the next time warranty lookups run.


Question:  Can LCI pull purchase date from Cisco?

At this point, we cannot pull purchase date information from Cisco.   It is not exposed in the Support APIs we are hitting.