Ingesting Slack Data

Before you begin

When using these methods, some of the configurable parameters required by the connector must be retrieved manually.

Store Slack credentials

To store your Slack credentials for repeated use with the Slack Connector, you first need to retrieve a Slack temporary authorization code.

To retrieve a Slack temporary authorization code:

1. Visit the following URL in a browser:

   https://slack.com/oauth/v2/authorize?client_id=2180091967.2328427641221&scope=&user_scope=discovery:read&redirect_uri=https://connector-auth.nuix.com/slack/

2. Enter your Slack workspace URL if not already logged in, then click Continue.

3. Complete the authentication process using one of the methods provided within the sign in dialog.

4. After signing in, the Nuix Connector for Slack will request permission to access the workspace. To grant permissions to a different area, expand the selection menu to add or choose a different organization.

5. Review the permissions that are being granted, then click Allow.

6. Copy the authorization code that appears in the redirected page.

   The copied code can now be used in the configuration of the connector.

To store the Slack authorization code using the Nuix Scripting API:

1. Create a Slack location using the temporary authorization code generated in the previous steps.

   location = utilities.location_factory.make_slack_location(
   "1480901445888.2693925365041.615be671ede48f902482deb10f57969b247e0e6830345549a14c82ecacd73cc0".to_java().to_char_array()
   ) 
   

   Permanent credentials are now created and ready to be stored for repeated use.

2. Save the Slack location to the Slack stored credentials.

   credentialsStore = $utilities.getCredentialsStore()
   credentialsStore.store_credentials("my-slack-credentials-name", location)
   

   In this example, the credentials are now stored as “my-slack-credentials-name” and can be retrieved from the store.

3. (Optional) Load the stored credentials.

   storedLocation = credentialsStore.get_location_with_credentials("SLACK", "my-slack-credentials-name")
   

Perform a basic ingestion

The following examples show the same basic ingestion request using both a temporary authorization code and stored credentials.

See the reference documentation for the endpoint to learn more about available parameters.

curl --location --request POST 'http://localhost:8089/nuix-restful-service/svc/v1/cases/b0ba1d3f58824928bc3a2bd90c32ea26/evidence/slack' \--header 'nuix-auth-token: 5bfed703-dac6-4880-81ee-9fad21b36850' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--data-raw '{   "processorSettings": {    "storeBinary": true   },   "target": {    "tempAuthCode" : "1480901445888.3421472659971.d3d53482e8445dbd0e487368ee1745b94b80c78b722718d72bc02784585247ad",    "storedCredentialName":null,    "from": "2021-01-01",    "to":"2021-08-02",    "userIds":null
  }}
'

curl --location --request POST 'http://localhost:8089/nuix-restful-service/svc/v1/cases/b0ba1d3f58824928bc3a2bd90c32ea26/evidence/slack' \--header 'nuix-auth-token: 5bfed703-dac6-4880-81ee-9fad21b36850' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--data-raw '{   "processorSettings": {    "storeBinary": true   },   "target": {    "tempAuthCode" : null,    "storedCredentialName":"my-slack-credentials-name",    "from": "2021-01-01",    "to":"2021-08-02",    "userIds":null
  }}
'