Prerequisites for Creating a Connection

Before you can create a connection with the Slack Adapter, you must satisfy the following prerequisites.

• Sign Up for a Slack Developer Account

• Create an OAuth Application

• Get Your Client ID and Secret

Sign Up for a Slack Developer Account

To integrate, extend, and build applications with the Slack Platform and Oracle Integration, you must have a Slack developer account.

To create an account, visit the Slack Developer website (https://developer.slack.com), click Sign Up, and follow the on-screen instructions.

Don't forget to review the terms and documentation after you get your account.

Create an OAuth Application

To obtain the proper access token to execute the Slack API securely, the Slack Adapter uses the Slack OAuth 2.0 authentication and authorization framework.

For information about OAuth 2.0 supported by Slack, see the documentation on the Slack website:

https://api.slack.com/docs/oauth

To create an OAuth application on the Slack platform and enable this authentication route:

1. Sign in to the Slack Developer console at https://api.slack.com.
2. In the Slack API title bar, click Your Apps to view the apps that you have created.
3. Click Create New App.
   1. Enter a name for your application.
   2. Select the workspace that this application belongs to. Note that your app belongs to the workspace you select. Leaving the workspace will remove your ability to manage your application. You can't change this value later so select the workspace carefully.
   3. Click Create App.
4. Optionally, if you want to add details about the OAuth application, scroll to the Display Information section and enter the information.
5. In the left navigation menu under Features, select OAuth & Permissions.
6. On the OAuth & Permissions page, scroll to the Redirect URLs section.
7. Click Add New Redirect URL, and enter the callback URL of your Oracle Integration instance.

   Note:

   If you don't know the following information, check with your administrator:

   • If your instance is new or upgraded from Oracle Integration Generation 2 to Oracle Integration 3.
   • The complete instance URL with the region included (required for new instances).

   For Connections…	Include the Region as Part of the Redirect URL?	Example of Redirect URL to Specify…
   Created on new Oracle Integration 3 instances	Yes.	https://OIC_instance_URL.region.ocp.oraclecloud.com/icsapis/agent/oauth/callback
   Created on instances upgraded from Oracle Integration Generation 2 to Oracle Integration 3	No. This applies to both: New connections created after the upgrade Existing connections that were part of the upgrade	https://OIC_instance_URL.ocp.oraclecloud.com/icsapis/agent/oauth/callback

8. Click Add, then click Save URLs.
9. Scroll down to the Scopes section.
10. Under User Token Scopes, click Add an OAuth Scope.
11. Add the scopes that you want this application to access. These scopes correspond to the operation supported by the Slack Adapter.

    Valid scopes are:

    • channels:read
    • channels:write
    • chat:write:user
    • files:read
    • files:write
    • files:write:user
    • identity.basic
    • search:read
    • users:read
    • users:read.email
12. Press Enter.

Your OAuth application is now configured and ready to use. You must install your OAuth application on the Slack workspace that you want to work with and use with Oracle Integration.

Get Your Client ID and Secret

When you successfully create the OAuth application, Slack automatically generates a client ID and a client secret. These credentials allow your application to access the Slack API.

To get your client values:

1. Sign in to the Slack Developer console.
2. Open the OAuth application you created.
3. In the navigation pane in the Slack API, select Basic Information.
4. Scroll to the App Credentials section.
5. Copy the values for your client ID and client secret. Click Show to see the client secret before selecting it for copy. You'll need to enter the client ID and client secret in the Credentials dialog when you configure security for your connection in Oracle Integration.