Enabling External Actions with TIBCO Cloud™ Integration

You can create external actions that start flows in TIBCO Cloud™ Integration (TCI) apps.

To be able to create and use external actions with TCI (TCI actions), you must make sure that Spotfire can access TIBCO Cloud™. Depending on your Spotfire environment, you might have to make some configurations. In this article, you learn how to do the steps necessary to enable TCI actions.

Prerequisites

• You must have an active subscription to TCI.

• Your TCI subscription must be in one of the following TIBCO Cloud regions:

• AWS – United States

• AWS – Europe

• AWS – Australia

• Microsoft Azure - United States

Note: If you are running Spotfire Analyst without a server, external actions with TCI are not supported.

TIBCO Cloud­™ Spotfire

If you use TIBCO Cloud™ Spotfire, you can create and use external actions with TCI without making any configurations.

Your subscriptions for TCI and TIBCO Cloud Spotfire must be in the same organization and region on TIBCO Cloud.

On-premises environments

If you have an on-premises installation of Spotfire, you must make the following preparations to enable the full use of TCI actions:

• To configure and create TCI actions. Add the TIBCO Cloud™ region where you have TIBCO Cloud™ Integration to the preference setting Application > OAuth2Preferences > OAuth2IdentityProviders.
  
  See Adding TIBCO Cloud™ regions for external actions on this page.

• To use TCI actions in Spotfire web clients. Register your Spotfire Server as a client in TIBCO Cloud™, and add the OAuth2 credentials to the Web Player service configuration.
  
  See Registering your Spotfire Web Clients as a TIBCO Cloud OAuth2 client.

Adding TIBCO Cloud regions for external actions

When you configure a TCI action, you must select the TIBCO Cloud region where you have your TCI subscription. The preference OAuth2IdentityProviders controls which TIBCO Cloud regions you can select when you configure a TCI action.

For user groups who should be able to configure TCI actions, you must make sure that the preference is configured with the TIBCO Cloud region where you have your TCI subscription.

1. Start Spotfire Analyst, and log in as a user with administrator privileges.

2. On the menu bar, select Tools > Administration manager.

3. In the Administration Manager dialog, on the Preferences tab, click to select the user group you want to edit preferences for.

4. On the Preferences tab, click Edit.

5. In the Edit Preferences dialog, navigate to the preference Application > OAuth2Preferences > OAuth2IdentityProviders.

6. To edit the OAuth2IdentityProviders preference, select the preference and click the edit button .

7. In the String Collection Editor dialog, enter the information for the regions you want to add.
   
   For example, to add only the region Amazon AWS - United States, enter the following:
   
   [
    {
      issuer: "https://account.cloud.tibco.com",
      displayName: "TIBCO Cloud (AWS - United States)",
    }
   ]
   
   For information about the different regions, see the example further down on this page.

8. To save your changes, click OK.

Example with all TIBCO Cloud™ regions

Below is an example value for the OAuth2IdentityProviders preference with 4 different TIBCO Cloud regions added. With this configuration, you can select from all the regions in the drop-down menu when you configure a TCI action.

[

   {

      issuer: "https://account.cloud.tibco.com",

      displayName: "TIBCO Cloud™ (AWS - United States)"

   },

   {

      issuer: "https://eu.account.cloud.tibco.com",

      displayName: "TIBCO Cloud™ (AWS - Europe)"

   },

   {

      issuer: "https://au.account.cloud.tibco.com",

      displayName: "TIBCO Cloud™ (AWS - Australia)"

   },

   {

      issuer: "https://account.us.azure.cloud.tibco.com",

      displayName: "TIBCO Cloud™ (Azure - United States)"

   }

]