The Cisco pxGrid Cloud Demo App is a simple application created to demonstrate pxGrid Cloud connecting Cisco ISE. Cisco Employee, Partners and Integration Developing Partners may use the app to understand the basic pxGrid Cloud connection process and requirements.
There is also an additional Meraki Dashboard section to synchronize security group tags (SGTs) in ISE to adaptive policies. This requires access to a Meraki account. This would be for Cisco Field Employees & Partners to play with. Developing partners SHOULD bypass the Meraki section noted in the exercise. The Meraki dashboard (TBD) is utilizing a different method of connectivity and this is a POC used to showcase this app capabilities. In the future we may have a more generic app better utilized to learning experience.
Access to the Cisco Cloud Demo App
The application service hosted on dCloud will not be shared to use outside of a dCloud environment. This allows us to properly support this effort and to minimize overhead. It is also not used for developing against pxGrid Cloud, there are resources available. See pxGrid Cloud Community Page for more information on developing your own app service.
The Cisco Cloud Demo App is only available in a Cisco dCloud lab. Cisco Field and Partners should be able to schedule this demo themselves. For links to the demo content please visit Selling ISE Demos. Use one of the Cisco ISE Enterprise and Security Ecosystems Integrations demos.
For now if you would like to build your own application, depending on the audience, please contact us below.
Once you have gained access to the Cisco ISE pxGrid Demo Cloud lab in dCloud, you should see it the respective data center under My Hub.
For connection to ISE, it is recommended to access the WebUI directly via direct IP access using your own browser.
Enable direct web access to ISE
Launch WebRDP to WKST1-JUMP
Using any browser (and respective bookmark) to launch ISE UI. (creds are cached)
On ISE go to 𑁔 >Administration > System > Admin Access > Settings > Access > IP Access
Choose Allow all IP addresses to connect (or you may enter your range if you know it)
Click Save
Note: Now you may access the ISE Web UI directly using the Public IP under dCloud Details. IP/creds hidden. See dCloud UI.
Enable pxGrid Cloud in ISE 3.1 Patch 4+
Using the browser shortcut in the demo (or direct access to ISE), Login to ISE using the cached credentials (or info in the dCloud network diagram)
Go to 𑁔 > Administration > System > Deployment
Select the ISE node(s) that you want to run the Cisco pxGrid and pxGrid Cloud services on.
NOTE: this is already enabled but gives you info on how to setup. You may enable pxGrid and pxGrid Cloud on up to 4 ISE nodes
Scroll down and enable pxGrid + Enable pxGrid Cloud Note: pxGrid Cloud requires Advantage licenses.
Select Save (if needed)
Go to 𑁔 > Administration > System > Settings > API Settings to enable the ISE REST APIs so they are available via Cisco pxGrid Cloud - NOTE: this is already enabled in your environment
Select the API Service Settings tab
Enable ERS (Read/Write)
Enable Open API (Read/Write)
Select Save
Go to 𑁔 > Administration > pxGrid Services > Client Management
Select pxGrid Cloud Connection
Select Setup Connection which prompts you for an Authentication Token from the Cisco pxGrid Cloud
You now need to add your ISE node in the Cisco pxGrid Cloud service.
If you cannot login, send any problems you encounter to the dna.cisco.com team: Venkata Rallabhandi (rrallabh@cisco.com) and Ajit Nair (ajitna@cisco.com)
After logging in, find the pxGrid Cloud offer and select Subscribe
Choose the pxGrid Cloud region you want to use (there is only US WEST currently)
Check the box to agree to the Cisco End User License Agreement and acknowledge the Cisco Privacy Statment
Select Subscribe Offer You will now see the summary of your subscribed offers in the Cisco DNA Cloud which should include pxGrid Cloud
You may now select Register Cisco ISE to add your ISE node(s)
Enter your ISE Node Name and Description
Select Register
Copy the generated OTP to enroll your ISE node
Go back to your ISE GUI and enter the One-Time Password from dna.cisco.com and click Connect
You should see the status in ISE change to Status: Connected: ise-node-name
Your ISE now registered with your pxGrid Cloud tenant for use with pxGrid Cloud apps.
Enable pxGrid Cloud Policy on ISE
In ISE, select the Client Management > pxGrid Cloud Policy menu
Under pxGrid Services, select all of the pxGrid topics that you would like to make available to all pxGrid Cloud services. Select all of the topics if you are not sure. Note: For this demo you don't need to choose any of them as it uses ERS APIs
Enable the ERS APIs and choose Read Only or Read/Write depending on what you want to allow
Enable the Open APIs and choose Read Only or Read/Write depending on what you want to allow
Select Save
Your ISE deployment is now registered with your pxGrid Cloud tenant.
Connect the Cisco Cloud Demo App with your pxGrid Cloud Tenant
Setup the pxGrid Cloud Demo App Connector
In the Cisco pxGrid Cloud site, dismiss the OTP dialog and you should see a tile with your registered ISE node
Select 𑁔 > App Store to view the available applications to connect to your ISE node with pxGrid Cloud
In the pxGrid Cloud Demo Application tile, select Connect to App
Copy the OTP token for authentication of your Cisco Cloud Demo App instance (you can search for how to copy/paste into Guacamole to make this easier or open the pxgrid cloud UI inside of your WebRDP)
Connect the pxGrid Cloud Demo App to pxGrid cloud
Navigate to WebRDP WKST1 - Open your instance of the Cisco Cloud Demo App The Cisco Cloud Demo App is hosted on a linux server in the dCloud demo. To view it, simply open a web browser (use a browser shortcut) to http://198.18.134.28:8080
⚠ You must use http and not https !
Select the Configuration button, enter the OTP token, and select Connect Tenant
The pxGrid Cloud Demo App instance is now connected to your pxGrid Cloud tenant.
Activate the pxGrid Cloud Demo App Connector with your ISE deployment
Both your ISE deployment and Cisco Cloud Demo App instance are connected to your pxGrid Cloud tenant so the last step is to connect them.
Go back to pxgridcloud.cisco.com browser window and close the OTP Generated window. Now you should see a page with your product activations,
select your ISE deployment and click Activate for Products
Confirm the app name, region and product(s) then select Next
Choose Product Type: Cisco ISE
Choose Product: your registered Cisco ISE deployment name
Select Next (if you don't see this resize page)
Scopes are not needed since we are using API and not pxGrid topics, click Next
Review the Summary and select Activate App for Products
Select the Check App Details button
In the Product Activation table, you should see that your ISE node is Connected and Activated Validate pxGrid Cloud Demo App is connected and getting data
Validate the operation of the demo app
Via WKST1-RDP > Go to the Cisco Cloud Demo App and reload the page and you should see your ISE node listed in the ISE Enrollment table
Select the radio button next to your ISE node then select Connect. Accept the the warning to establish the connection for the app and tenant.
You should get a Success message that ISE is connected to the Demo App!
In the Cisco Cloud Demo App, select 𑁔 > Overview (or Overview in the header) and you should see the ISE Status update with the counts for your SGTs, ACLs and Egress Policy!
Note: If you don't see the built in SGT (16) and ACL (4) then there is an issue with your connection. Please check your settings, connections, ERS Settings etc.
You were able to demonstrate the app retrieving information from ISE via REST APIs using pxGrid Cloud.
That's the end of the demo Cisco Cloud Demo App using Cisco pxGrid Cloud!
Resources
pxGrid Cloud
Cisco pxGrid Cloud requires ISE 3.1 Patch 4 or later
pxGrid Cloud Devnet Site - use this to get started developing your integration with pxGrid Cloud (this is for developing partners)
Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community: