Configuring the Adapter for Slack

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish. The Adapter for Slack is in the Social Media group.

Prior to configuring the adapter, you must create an application in Slack.

Configuring an Adapter

    Procedure
  1. From the WebFOCUS Reporting Server browser interface Applications page, click Get Data.

    or

    From the ibi Data Migrator desktop interface, expand the Adapters folder.

    In the WebFOCUS Reporting Server browser interface, the Get Data page opens showing your configured adapters. In the ibi Data Migrator desktop interface, the Adapters folder opens.

  2. In the WebFOCUS Reporting Server browser interface, click the (+) button, and find the adapter on the page or, in the ibi Data Migrator desktop interface, exapnd the Available folder if it is not already expanded.

    In the WebFOCUS Reporting Server browser interface, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.

  3. In the ibi Data Migrator desktop interface, expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Configured list in the WebFOCUS Reporting Server browser interface or in the Adapters list in the ibi Data Migrator desktop interface resources tree.

    In the WebFOCUS Reporting Server browser interface, the adapter remains on the Available Adapters list with an asterisk to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

Configure the Adapter for Slack

    Procedure
  1. From the WebFOCUS Reporting Server browser interface sidebar, click Connect to Data.
  2. Click the New Datasource button on the menu bar, and find the adapter on the page.

    You can select a category of adapter from the drop-down list, or use the search option (magnifying glass) to search for specific characters. The Adapter for Slack is in the Social Media category.

  3. Right-click the adapter name and click Configure.

    The Add Slack to Configuration page opens on which you can configure a connection. You can add additional connections by right-clicking the adapter on the Configured Adapters list and clicking Add Connection.

Connection Attributes for Slack

The Adapter for Slack is under Social Media Adapters. Enter or select values for the following connection parameters to add a connection to the Adapter for Slack.

Connection Name

Is the logical name used to identify this particular set of connection attributes. The default is CON01.

Client ID

Is the client ID defined in the Slack application. To obtain this value, do the following:

  1. Go to https://api.slack.com/apps.
  2. Click the App Name for the previously created Slack application.
Client Secret

Is the Client Secret defined in the Slack application. To obtain this value, do the following:

  1. Go to https://api.slack.com/apps.
  2. Click the App Name for the previously created Slack application.
Workspace ID

Is a unique identifier for the Slack Workspace. To obtain this value, do the following:

  1. Sign on to the desired Workspace within Slack by going to https://slack.com.
  2. Once in the desired Slack Workspace, view the page source and search for "team_id".

    The Workspace ID is the value next to "team_id", for example, "team_id":"TEK21GK63".

Workspace Name

Is the name of the Workspace. The Workspace name is populated automatically after a successful Get Access Token request.

Change OAuth Scope

The following scopes will always be requested as part of Get Access Token:

  • channels:history
  • channels:read
  • users:read
  • chat:write:user

Change OAuth Scope allows you to select or deselect optional scopes, for example, admin.

If the optional scopes have changed, Get Access Token must be rerun.

Access Token

Is the value that identifies the user on whose behalf your Slack application is acting. Click Get Access Token to obtain this token.

In order for Get Access Token to complete successfully, the host name used to bring up the WebFOCUS Reporting Server browser interface must match the host name set up for the Redirect URI in the Slack application.

If an issue arises while obtaining the Access Token, ensure that you are signed out of all Slack Workspaces, and clear the browser cache, including cookies.

Select profile

Is the profile (server, group, user) in which to store these connection attributes. The default is the server profile, edasprof.prf.

Advanced Connection Options

Base URL

Is the URL of the Slack API request. The default value is https://slack.com/api.

Authorization URL

Is the URL used for OAuth Authorization to Slack. The default value is https://slack.com/oauth/authorize.

Token URL

Is the URL used for obtaining an Access Token to Slack. The default value is https://slack.com/oauth/oauth.access.

Advanced HTTP Connection Options

PROXY Server IP Address

Is the IP address of the proxy server.

PROXY Port

Is the port number on which the proxy server listens. The default port number is 80.

PROXY HTTPS Relative Path

When checked, the REST request will send the relative path rather than the absolute path when a proxy server is configured.

SSL Certificate

Is the location of a locally-stored user-provided server x.509 certificates file for SSL authentication. For trusted authentication, the trusted certificate file (trustedcertfile) points to a file of CA certificates in PEM format, as illustrated in the following syntax:

-----BEGIN CERTIFICATE-----
... (CA certificate in base64 encoding) ...
-----END CERTIFICATE-----
SSL Mutual Authentication

When checked, Mutual Authentication is enabled.

SSL Certificate Type

Select one of the following certificate types:

  • Trusted. A trusted certificate file can contain several CA certificates. You can add text before, between, and after any certificate which is typically done to provide descriptions of each certificate.
  • Non-trusted. Adds the parameters Key file, Pass phrase, and Label to the configuration pane. Provide an initial path browse value to the SSL Certificate field before browsing. For example:
    C:\, /abc/abc/...
SSL Certificate Key File

Is the private key used for creating the client X.509 certificate in PEM format. This option is used together with a certificate for a non-trusted connection. Provide an initial value to the SSL certificate key file field before browsing. For example:

C:\, /abc/abc/...
SSL Certificate Pass Phrase

Is the password used to unlock the key file. The value is needed only if the key file is encrypted.

SSL Certificate Label

Identifies a certificate in the file, if the file contains more than one certificate. If the label contains spaces, the label must be enclosed in double-quotes. For example:

"xxx yyy"