Intersight Mobile app and Demo

Fabio Di Niro
Technical Solution Architect
February 5, 2020
Cisco Intersight™ provides intelligent cloud-based
infrastructure management for the Cisco Unified
Computing System™ (Cisco UCS®) and Cisco
HyperFlex® platforms. Intersight offers an intelligent
level of management that enables IT organizations to
analyze, simplify, and automate their environments.

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Intersight Mobile App

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Step 1: find and download Intersight app
• Open your favorite app store
• Search for “cisco intersight”
• Download and install it

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Step 2: access the app
• Choose Demo Mode to quickly
access and use the app
• You will be prompted to choose a
PIN to access again the app
• If you already have an Intersight
account you can login with your
Cisco ID instead of the Demo
Mode

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Step 3: enjoy Intersight from your mobile!
• Browse through the Dashboard
• Check the status of your servers,
clusters and UCS hardware
• Access Alarms and Warnings
• Review Advisory information such
as new releases or vulnerability
bulletin

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Intersight API Demo

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Lab Overview
• How do I leverage the extensive information that is provided by
Intersight without have to browse through multiple screens and lots
of data?
• Use Application Programming Interfaces (ReST, Python, and
directions to others) to access specific information directly
• This lab leverages the production Cisco Intersight environment – you
will need your CEC or CCO ID to login
• Because these are Read-Only lab exercises, access to the
environment will continue after the SEVT

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Getting into the Lab

• Each user will log into https://intersight.com with their

own CEC or CCO ID
• This presentation is the documentation for the lab and
Intersight Real includes screenshots of the contents that should be
World expected
Automation via • 90 minutes have been allocated for the labs and
should be ample time to complete everything
API
• Raise your hand if you have a question

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Key Steps

Step 1 Step 2 Step 3 Step 4

a) Become familiar with the a) Get familiar with Chrome a) Access Intersight via Postman a) Access Intersight via Python
Intersight API Reference REST Inspector
b) Create Header values b) Install Python SDK
Client
b) Review Network tab to see
c) Create X-Starship-Token cookie c) Create api-settings.json using
b) Review GET, POST and DELETE calls made to implement
Intersight API key
operations different operations d) Get values for BIOS Policy and
Users d) Get values for Users
c) Verify account access c) Review Applications tab to
get X-Starship-Token

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
1. Get familiar with Intersight
API Reference Tool on the
web

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
https://developer.cisco.com/site/intersight/

Open Intersight in another tab

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select API Reference

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select biosPolicy

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Review capabilities, then select
Sign in

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Sign in

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Select newly created entry or
other account you may have
access to

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Click here to start configuring your
service policy for 'bios'

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 First, select Server Policies

Then, select Create Server Policy

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 First, Select BIOS

Then, Select Next

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 First, specify your policy name
and description

Then, select Next

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Create

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Your service policy was
successfully created

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Return to browser tab for
developer.cisco.com/site/intersig
ht

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 First, click Send

Then, check if your policy name

and description are correctly
shown

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
2. Get familiar with Chrome
Inspector (to get the cookie
value of X-Starship-Token)

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 https://intersight.com/apidocs/bios/Policies/get/

Click Send to confirm the REST-

API is correctly accepted.

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Right click on the browser pane
to show the menu, and select
Inspect

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Notice API calls required to
complete GET biosPolicy request

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 First, select Application

Second select Cookies

Finally select
https://intersight.com to retrieve
X-Starship-Token value

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
3. REST-API access via
Postman

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Install Postman
https://www.getpostman.com/docs/v6/post
man/launching_postman/installation_and_
updates

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select X to remove the pop-up

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Enter the biosPolicy GET URL

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Enter the necessary Header
KEY/VALUE parameters for
getPolicies
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Cookies, enter
intersight.com

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Enter the information above as a
placeholder for X-Startship-
Token acquired earlier

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Copy X-Starship-Token value

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 First, paste Token value into
cookie

Then click Save

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select X to remove the pop-up

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Send to retrieve
biosPolicies value

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Try another GET for Users

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
4. REST-API access via
Intersight Python SDK

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Install Python
https://www.python.org/downloads/release/
python-2715/

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
https://developer.cisco.com/site/intersight/

Select Intersight Python SDK

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Clone or download to
retrieve Python SDK
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Uncompress intersight-
python-master.zip to your
Documents folder

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Execute Python SDK setup

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Settings from Intersight
menu

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select API Keys to define new
key for this session

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Generate API Key

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Provide a description and select
Generate

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Save API Key ID to
Clipboard
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Select Save Secret Key to text
file
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
https://techzone.cisco.com/t5/UCS-Cisco-Intersight-
Discussions/Getting-started-with-Intersight-API/ta-p/1158366

Scroll down to “Generate New

API Key”

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Copy/Paste to create api-
settings.json

Then, Copy/Paste to create get-

users.py

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Create api-settings.json file and
paste API Key from clipboard into
api_key_id value

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 Execute the Python script to
retrieve User values

© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
© 2017 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
 • We have seen how to
leverage APIs to interact with
Intersight
• There are exercises that
leverage the REST API via
native Intersight capability as
Summary well as via Postman, the
Python SDK, and Powershell
as well
• Become familiar with
https://developer.cisco.com/
site/intersight

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential
Additional Resources
• https://developer.cisco.com/site/intersight/
• https://techzone.cisco.com/t5/UCS-Cisco-Intersight-
Discussions/Getting-started-with-Intersight-API/ta-p/1158366
• https://github.com/CiscoUcs
• https://github.com/CiscoUcs/intersight-rest
• https://github.com/CiscoUcs/intersight-python
• https://github.com/CiscoUcs/intersight-powershell
• https://github.com/CiscoUcs/intersight-ansible

© 2018 Cisco and/or its affiliates. All rights reserved. Cisco Confidential