Configure inSync to protect Slack data
Overview
You can configure inSync to integrate with Slack so that inSync connects with your Slack Org workspace and accesses the Slack data for backup.
Before you begin
Ensure that the Slack Discovery API is enabled before you begin the configuration. For more information, see Slack's Discovery API.
Before you initiate inSync configuration to protect Slack Org data, ensure that you have the following accounts created.
-
You must have Slack Org owner account details for the Org that you want to configure for backup.
-
You must have an inSync Cloud administrator account created.
Configure inSync to protect Slack Org data
Configuration of inSync is a 2-step procedure:
Step 1: Add a Slack Org in inSync Management Console
Step 2: Set the backup and storage settings for the added Slack Org
Step 1: Add a Slack Org in inSync Management Console
To protect and backup Slack Org data, inSync requires authorization from Slack. Also, the inSync Cloud administrator must accept the Slack app permissions to access Slack Org data.
inSync uses OAuth 2.0 to communicate with services like Slack. OAuth is an open protocol for token-based authentication and authorization on the internet. For more information on OAuth 2.0, see the OAuth website.
Adding a new Slack Org involves the following:
- Grant inSync permissions to access Slack data
Procedure
To grant inSync permissions to access Slack data, log in as an inSync Cloud administrator and perform the following steps:
- On the inSync Management Console menu bar, click the
icon to access the global navigation panel. - Click SaaS Apps.
- Click Slack.
If there are no Slack Orgs added to inSync, the following page appears.
If you have already added Slack Orgs to inSync, an existing list of Slack Orgs that are added and configured for backup in inSync is displayed.
4. Click Add Slack Org to add a new Slack Org for backup. Click Continue on the confirmation dialog box. You are redirected to the Slack console for authorization and access to Slack Org data.
5. On the top right corner, the dropdown displays a list of existing Slack Orgs, if any, that you are already signed into. If you are not already signed in to any of the Slack Orgs, click Sign in to another workspace. The Sign in to your workspace page appears.
6. Enter the Slack Org domain in the Enter your workspace’s Slack URL field and click Continue. The Sign in page for Org owners appears.
For example, if your Slack Org domain URL is https://qa-slackworkspace.slack.com , enter qa-slackworkspace .
O Authorization fails with team_not_authorized error if you enter the workspace domain URL.
7. Click Sign in as Org owner option.
8. Enter the Org owner email and password for the Slack Org, and then click Sign in. You are displayed with the list of permissions that inSync requires to access Slack data.
If the Two-factor authentication (2FA) is enabled for the Slack Org that you want to configure in inSync, you are prompted to enter the authentication code to proceed with the sign-in action. This is an ask from Slack and not from inSync.
9. Read the permissions and click Allow to grant inSync the permissions to access Slack data. For more information about the required permissions, see Required roles and permissions for inSync to access Slack data.
10. inSync now tries to install inSync app for Slack in your Slack environment.
Your Slack Org is added within inSync and appears on the Slack Org listing page.
By default, the App Status is Storage Not Assigned. You must configure the added Slack org to assign storage and start protecting Slack data.
Step 2: Set the backup and storage settings for the added Slack Org
When you add your Slack Org in inSync, inSync just gets connected to your Slack Org with required permissions. To start backup, you must configure the registered Slack Org for backup.
Procedure
To configure the added Slack Org for backup, perform the following steps:
- On the inSync Management Console menu bar, click the icon to access the global navigation panel.
- Click SaaS Apps.
- Click Slack. A list of existing Slack Orgs registered for backup is displayed. By default, the App Status is Storage Not Assigned.
-
Click on the Org ID for which you want to configure and schedule backup. A Configure Backup Settings window appears. Enter the following details and click Save.
| Field | Action |
|---|---|
| Backup Frequency | Select how frequently you want inSync to back up Slack data. By default, inSync performs the backup operation once a day. |
| Storage |
Select the Slack storage in your region, where inSync should backup your Slack data. Storage once assigned cannot be changed later. |
| Retention |
By default, data retention is set to Forever i.e unlimited retention. |
Reconfigure Slack Org in inSync
Overview
As an administrator, you can reconfigure any Slack Org that is configured in inSync for backup.
Reconfiguration is required in the following scenarios:
-
A service or permission-related upgrade is required for protecting Slack.
-
inSync is not able to connect to Slack service.
Note: When you reconfigure a Slack Org, inSync stops all the ongoing Slack backups.
Procedure
To reconfigure a Slack Org, perform the following steps:
- On the inSync Management Console menu bar, click the icon to access the global navigation panel.
- Click SaaS Apps.
- Click Slack. An existing list of Slack Orgs, that are registered for backup in inSync is displayed.
-
Select the Slack Org that you want to reconfigure, and click Configure. A confirmation dialog box appears.
-
Read the message on the confirmation dialog box, and click Yes to proceed with the configuration. You are redirected to the login page of the Slack Cloud environment that you have selected for backup.
Note: Reconfiguring a Slack Org will cause all backups in progress to terminate for the Org.
6. Enter the Slack administrator's username and password for the Slack Org, and then click Sign in. You are displayed with a list of permissions that inSync requires to access Slack data.
7. Read the permissions and click Allow to grant inSync the permissions to access Slack data.
Your Slack Org is added within inSync.
Well done! You have completed the configuration successfully.
Related articles:
- On-demand or manual of Slack data
- Download Slack data
- Data Governance and Legal Hold for Slack data
- Manage Slack: To edit Slack Org settings, enable or disable backup for Slack Org, delete Slack Org from inSync.
- Monitor Slack: To configure alerts, view ongoing backup and download activities, and view audit trails.
- inSync Management Console: To learn more about the UI elements of inSync for Slack.