Activate On-Prem Partner App

After you create the On-Prem partner app, the next step is activating the On-Prem Partner app by generating and using the activation (JWT) token.

Procedure

Step 1

Log in to the Cisco Spaces - Partner Dashboard.

Step 2

Click on the App Activation Sandbox tile.

Note

If you have previously activated an app but have subscribed to a new event on this app, you will see the New Permissions Required notification on the app tile. Click the specific app tile to review and Accept Permission for the new event.

Once you Accept Permission, you are subscribed to the new event on the selected app and this event will also be sent over the Cisco Spaces - Partner Firehose API.

Step 3

Click the Get Partner Apps tile under the EXTEND section.

Note

The App Activation Sandbox only showcases the apps that you created.

Step 4

Click on the desired app to view the associated details.

Step 5

Click Activate App.

The app activation wizard appears.

Step 6

Depending on whether you have an account with the Partner, choose the appropriate option under Sign Up & Onboarding and click Continue.

The Permissions page appears.

Step 7

Click Accept Permission to continue.

The information displayed on the Permissions page varies based on the Event Types and the Event Settings that you selected during app creation. As a Customer, you must approve access to Location and Telepresence data and agree to share the MAC address of your device, if the application requires MAC addresses for its operation.

On the Permissions page, the Telepresence section appears only if you have selected the Telepresence Event Type option during app creation. Refer to the Supported Event Types section for details.

The Choose Locations page appears.

Step 8

Select the locations for which you wish to enable and activate this app in order to receive the Event data and click Next.

Depending on your selection of events related to IoT services configured during app creation, either the Choose Groups page appears or the Activate dialog box appears.

  • If the Choose Groups page appears, go to Step 9.

    The Choose Groups page appears in the App Activation wizard only if you have selected at least one of the IoT services-related events among IoT Telemetry and IoT User Action, under the Events tab, during app creation. Refer to the Supported Event Types section for details.

  • If the Activate dialog box appears, go to Step 10.

Step 9

Select the groups you wish to enable for this app and click Next.

The information displayed on the Choose Groups page varies based on the selection of the above IoT services-related events during app creation.

The Activate dialog box appears.

Step 10

Under the Generate App Activation Token section, click Generate to obtain the Activation (JWT) Token.

Step 11

Click Copy Token to copy the displayed Activation Token.

Step 12

Under the Activation Instructions section. As displayed in Step 1 of the Activation Instruction section, click the hyperlink <click here> text to open the Partner App site. For this example, the https://trigue.dnaspaces.io/auth/home page displays as the Partner App Site. This URL will vary for each partner app.

Step 13

Click the Activate On Premise App button. The Setup wizard displays.

Note

The steps in the wizard may vary for each partner app.

Step 14

Click Next. The Activate section displays.

Step 15

Paste the Activation Token that you copied, earlier.

Step 16

Click Activate App. The App activation successful message displays.

Step 17

Close the browser window to navigate back to the Partner Dashboard section.

Step 18

Click the App Activation Sandbox.

Step 19

Click the Settings link on the App tile The activate partner app displays under the Partner Apps section.

Step 20

Click Activate to activate the app for that particular partner tenant ID.

Step 21

If required, click New Activation and complete the steps to activate the app for another partner tenant ID.

Step 22

If required, click Remove app to remove the partner app from the dashboard.

What to do next