Additional Configurations and Setups

LAST UPDATED: NOV 28, 2024

Commands

Application Integration

1. Open the Settings popup.

   

   1. Click into a Slack channel of interest.

   2. Click on the vertical ellipsis button on the top right corner.

   3. Click on the Edit settings menu option.

2. Click on the Integrations tab, then click on the Add an App button.

   

3. Click on the Add button for your application.

   

4. Test the Send Messages command in D3 vSOC.

   

   1. Select your configured connection.

   2. Enter the channel ID or user ID.
      Channel ID
      If the channel ID is unknown, execute the List Channels command to retrieve it.

      

      i. Select your configured connection.
      ii. Click on the Test Command button.
      iii. Copy and paste the channel ID into the Channel or User ID input parameter of the Send Messages or Send Interactivity command.
      
      Alternatively, users may find the Channel ID in Slack:

      

      1. Right click on your channel of choice.
      2. Click on on the View channel details option.

      

      3. Copy and paste the Channel ID into the Channel or User ID input parameter of the Send Messages or Send Interactivity command.
      
      User ID
      If the user ID is unknown, execute the List Users command to retrieve it.

      

      i. Select your configured connection.
      ii. Click on the Test Command button.
      iii. Copy and paste the User ID into the Channel or User ID input parameter for the Send Messages or Send Interactivity command. The IDs in the UserIDs list correspond to the users in the UserNames list, with each ID matching the user at the same position in the respective lists.
      
      Alternatively, users may find the User ID in Slack:

      

      1. Open the Direct Messages accordion.
      2. Click on your user of choice.
      3. Click on the large user icon.
      4. Click on the vertical ellipsis button within the Profile section.
      5. Click on the Copy member ID button, then paste the User ID into the Channel or User ID input parameter for the Send Messages or Send Interactivity command.

   3. Enter a message.

   4. Click on the Test Command button.

   5. Ensure that the command have executed successfully.

5. Verify that the message appears in Slack.

   

   If the message is sent to a user, a new chat with the bot user will appear for that individual under the Apps accordion.

   

Enabling Interactivity

Slack's Block Kit is a UI framework that enables the creation and use of interactive elements within messages, such as buttons, dropdowns, and checkboxes. To use interactive elements, an interactivity URL must be configured in the app settings; interactivity is not supported by default.

Follow the steps below to enable interactivity:

1. Toggle on Interactivity.

   

   1. Navigate to the Interactivity & Shortcuts page.

   2. Click on the toggle.

2. Enter the Request URL in the following format:

   TEXT

   https://<domain>/<path>/VSOC/api/TaskResponse/slack/interactivity

   

3. Click on the Save Changes button at the bottom right corner.

4. Implement a Send Interactivity playbook task in D3 vSOC.

   1. Input a Channel or User ID. See the instructions on retrieving these.

   2. Let us use the following code for the Message Blocks input parameter:

      JSON

      [
          {
              "type": "input",
              "element": {
                  "type": "datetimepicker",
                  "action_id": "datetimepicker-action"
              },
              "hint": {
                  "type": "plain_text",
                  "text": "This is some hint text",
                  "emoji": true
              },
              "label": {
                  "type": "plain_text",
                  "text": "Start date",
                  "emoji": true
              }
          }
      ]

   3. Set the Wait for Response parameter is set to True.

5. Click on the Test Playbook button in the playbook UI, then click on the Run Test button in the popup.

READER NOTE

If the Wait for Response parameter was set to True, the Send Interactivity command should be in a Paused state.

6. Navigate to Slack and submit a response.

   

   1. Select a date using the dropdown menu.

   2. Click on the Submit your response button.

   3. Click on the Submit button in the Information popup.

      

READER NOTE

Following the initial submission, no further changes or submissions will be processed by the D3 playbook task.

7. Navigate back to D3 vSOC and verify the completion of the Send Interactivity task.

   

Application Reinstallation

Reinstallation of a Slack application is warranted for various application configuration changes, such as Scopes.

Removing the Application

1. Navigate to the page containing all of your installed apps.

   

   1. Click on your workspace dropdown menu.

   2. Click on the Tools & settings menu option.

   3. Click on the Manage apps sub-menu option.

2. Click on the ellipsis button next to your application, then click on the Uninstall option within the popup.

   

   An Uninstall <application name> from your team popup will render.

   

3. Click on the I want to uninstall <application name> from my team checkbox.

4. Click on the Uninstall button.

Reinstalling the Application

Authenticating with a User OAuth Token (API token):

1. Navigate to https://<workspace-name>.slack.com/marketplace/<app-id>-<app-name>

   • To obtain your <app-id>, navigate to Slack API: Applications | Slack > your application > Basic Information > App ID

2. Click on the Add to Slack button.

3. Click on the Allow button.

   

4. Click on the Install to <application name> button.

   

5. Click on the Copy button to copy to Bot User OAuth Token.

   

6. Test and save the connection.

   

   1. Paste in the Bot User OAuth Token into the API Token field in D3 vSOC.

   2. Click on the Test Connection button.

   3. Click on the OK button, then click on the Save button.

7. Save the new connection, then add the Slack application to the chosen Slack channels. Refer to steps 1-3 for the Application Integration command.

Authenticating with an OAuth 2.0 Authorization Code:

1. Click on the Add to Slack button.

   

2. Click on the Allow button.

   

3. Click on the Copy button.

4. Navigate to D3 vSOC.

ALERT

Do not click the Get Authorization button.

Paste the content within the Authorization Code field.

5. Click on the Get Refresh Token button to automatically populate the Refresh Token and Authorization Code fields.

   

6. Save the new connection, then add the Slack application to the chosen Slack channels. Refer to steps 1-3 for the Application Integration command.

Enabling Slash Commands

1. Navigate into your application, then click on the Basic Information menu item.

2. Copy the App ID.

   

   Paste the App ID into the API ID field in D3 vSOC.

3. Copy the Channel ID of for the channel you wish to be able to use the slash command (step 4b of the Application Integration section) and paste it into the Channel ID field in D3 vSOC.

   

4. Click on the Slash Commands menu item.

5. Click on the Create New Command button.

CAUTION

Do not check the Escape channels, users, and links sent to you app option, as it will prevent email addresses or any text containing "@" or "#" from being passed as parameters.

6. Input the slash command. The slash command adheres to the following structure: /<System name of a D3 utility command>.

Finding the system name

For playbook commands:

For system (built-in) and Python commands:

7. Input the Request URL.

READER NOTE

• The Request URL adheres to the following structure:
  https://<your D3 domain>/<path>/VSOC/api/slack/slashcommand

• The https://<your D3 domain>/<path>/VSOC/ portion of the Request URL is located in the URL of your D3 vSOC login page.

8. Enter a short description for this slash command.

9. (Recommended) Enter a usage hint for your slash command.

READER NOTE

Slash commands require the exact number of parameters defined by the D3 utility command, regardless of whether the parameters are optional or mandatory when executed in D3 vSOC. It is recommended to list all parameters as a reference. See the example beneath.

How to add utility command input parameters

For playbook commands:

For Python commands:

10. Preview the autocomplete entry.

11. Click on the Save button.

12. Verify that the slash command has been created.

    

13. Verify the created slash command on Slack.

    

READER NOTE

The slash command name and parameters must be separated by one or more spaces.