| 2023 Update - Cisco introduced a new API architecture on Mar 1, 2023. Any API applications registered prior to March 1, 2023 will expire on September 30, 2023. Please see Cisco's article here: https://apiconsole.cisco.com/docs/read/overview/Migrating_Applications regarding how to migrate existing applications. LCI now supports both legacy and new Cisco application registrations. |
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:
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 Element | Required | Description |
| Cisco Integration Active | No | When checked, LCI will perform Cisco lookups during your nightly build |
| Cisco Client ID/Key | Yes | Cisco Client ID/Key from SNTC Application |
| Cisco Secret | Yes | Cisco secret from SNTC Application |
| Load EOL Data from Cisco | No | When selected, we will load EOL data (if exists) from the Cisco API |
| Cisco EOL Attribute | No | This 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 Cisco | No | When 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. |
| Use Latest version of Cisco API (apix) | No | If you registered your Cisco application on or after Mar 1, 2023 you must check this box in order for us to pull your Cisco SNTC data. |
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:
- 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.
- 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
- 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:
- The asset has a valid serial number
- The asset make contains 'cisco'
- 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.