Activate Multi Tenant Cloud Partner Apps

Cisco Spaces - Partner App Center showcases apps created by partners. The Cisco Spaces - Partner App Center allows Customers to browser through the available partner apps, activate the desired apps, and leverage the power of the available partner apps. You activate the app in two ways:

  • The partner must first activate the app in the App Activation sandbox and then submit it for approval. After the submitted app is approved by the Cisco DNA Spaces Support team, the administrator or you can choose to publish the app and make it available on the Cisco Spaces - Partner App Center.

  • Your customers can choose to activate your apps from the Cisco Spaces - Partner App Center.

To activate the multi tenant cloud partner app on Cisco Spaces - Partner Dashboard:

Procedure

Step 1

Login 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.

Note

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. Depending on your selection of events related to IoT services configured during app creation, either the Next or Select & Activate button appears.

  • If the Next button appears, go to Step 9.

  • If the Select & Activate button appears, go to Step 10.

Step 9

Click Next.

This Next button and the Choose Groups page appear 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.

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

The Choose Groups page appears.

Step 10

Click Select & Activate to activate the App.

The customer is redirected to your site.

It is recommended that you allow your customers to sign up for a trial account if they do not have an account. After signing up and logging in, the customer is redirected back to Cisco Spaces.

If your app does not have an authentication site configured for App activation, then you can choose to use the Cisco Authentication site for App activation. Click on Select & Activate to be redirected to the Trigue Login Page. Log in to the Trigue site by entering admin@trigue.proximitymx.io as User name and admin as the Password. Log in to the site and provide the Partner tenant ID and Submit the app gets activated

Step 11

If the OAuth login authentication integration is implemented by your application, Cisco DNA Spaces retrieves details of the account from your application, and setups a mapping between Cisco DNA Spaces Tenant ID and your account identifier.

Step 12

Your application is now activated. It is added as a panel under Cisco DNA Spaces Home page. Customer can click on this panel to access your application from Cisco DNA Spaces dashboard.

Cisco Spaces - Partner App Center uses the OAuth login authentication mechanism to allow partners to validate their Customer App before allowing them to activate and use their Apps.