Skip to main content

Who is this article for?
Find your product plan in the Code42 console on the Account menu.

Incydr Professional and Enterprise
Incydr Basic and Advanced
Other product plans

Incydr Professional and Enterprise, yes.

Incydr Basic and Advanced, yes.

CrashPlan Cloud, no.

Other product plans, yes.

CrashPlan for Small Business, no.

This article applies to Code42 cloud environments.

HOME
GETTING STARTED
RELEASE NOTES
FAQs
APIs
SYSTEM STATUS
Code42 Support

Data Connections reference

Overview

Use the Data Connections page in the Code42 console to add and manage third-party services that are connected to Code42. 

Considerations

Data Connections

To add and manage data connections, go to Administration > Integrations > Data Connections.
Automated integrations (or Incydr Flows) are not available in the Code42 federal environment.

Data connections list

Item Description
a Add data connection Adds and configures a new data connection. For details about adding automated integrations, see Configure Incydr Flows.
b Service

The vendor of the data connection:

  • Business tools
  • Cloud storage
    • Box

    • Google Drive
    • Microsoft OneDrive for Business
  • Email services
    • Google Gmail
    • Microsoft Office 365
  • Automated Integration (Incydr Flows to Jira, Okta, Slack, and so on)
c Service Type Displays the data connection type, either Cloud Storage, Email, or Automated Integration.
d Display Name

Displays the name you use to distinguish between connections. For example, if your organization has two different Google Workspace accounts for US and UK employees, you could name each account's Google Drives to help identify them as such. This name must be unique.

e Status

Displays the status of the connection between Code42 and the data connection. For details, see Data connection statuses.

f

View details View details

Click to view more information about that connection.

Data connection details

For any connection listed in the Data Connections table, click View details View details to view more information.

Cloud storage and email service connections

Cloud storage and email service connection details

Item Description
a Display name

The name given to the data connection when it was set up.

b Service

The cloud storage provider (Box, Google Drive, or Microsoft OneDrive for Business) or email service provider (Google Gmail or Microsoft Office 365).

c Service type The data connection type: Cloud Storage or Email.
d Scoped to

The scope used to identify what to monitor for the connection:

  • For cloud storage, Code42 can monitor the drives for all users, drives of specific users, or drives of users in specific groups. For Google Drive, shared drives are monitored only when at least one member is a user that is monitored by Code42.
  • For Google Gmail, Code42 can monitor all email accounts for all users, only the email accounts for specific users, or only the email accounts of users in specific groups. For the Microsoft Office 365 email service, email accounts for users who have a subscription that includes Microsoft Advanced Audit are monitored.
e Status

The status of the connection between Code42 and the external environment. For details, see Data connection statuses.

f Status history

A brief history of the data connection, including the date the connection was initially added along with the username of the Code42 administrator that configured the connection. The date and time does not update if you deauthorize and then resume monitoring the cloud storage or email service connection.

g Deauthorize / Resume monitoring Click to deauthorize the cloud storage or email service environment, or to resume monitoring a connection that has been deauthorized. Because Code42 removes its connection immediately after you deauthorize the Gmail and Microsoft Office 365 services, the Resume monitoring button is unavailable for these data connections. Instead, set up the service again as a new connection to monitor Gmail or Microsoft Office 365 emails.

This action is not available for cloud storage or email service connections with a status of Searching for drives/email accounts, Maintenance, Deauthorizing, or Deleting. 

Automated Integrations

The details shown for Incydr Flows varies based on the type of connection. For more information, see Configure Incydr Flows

Data connection statuses

The Data Connections table's Status column displays the status of Code42's connection to the external service or integration. For cloud storage connections, more specific drive information appears on the details panel under Status.

Cloud storage and email service connections

Status Description

Searching for drives/email accounts

Code42 has connected to the external environment and is discovering all of the drives that are within scope and all email accounts in your environment.

 

For email services, this initialization process does not index user inboxes. Instead, Code42 discovers all email accounts in your environment and registers them for monitoring.

 

While the email accounts that have completed registration with Code42 begin reporting ongoing attachment activity immediately, the email service connection does not transition to the Monitoring status until all user email accounts in your environment are discovered and have completed registration.

Deauthorization is unavailable for services with this status
You cannot deauthorize a cloud storage or email service's connection when it is in this status. Wait for the status to move to either Monitoring or Monitoring, indexing in progress to deauthorize it.

Monitoring, indexing in progress

(Cloud storage connections only)

Once you complete authorization, Code42 immediately begins monitoring your cloud storage environment for ongoing file activity. At the same time, Code42 indexes all of the files for all discovered drives that are within scope to gather baseline data. File events become available in Code42 soon after they occur. If file activity occurs for an un-indexed file, that file is immediately indexed and subsequent file activity is sent to Code42.

 

This initial indexing does not calculate hash values for files. Instead, hashes are calculated when subsequent activity for that file is detected.

 

The details panel for a cloud storage connection lists the total number of drives that Code42 has discovered in your environment and is monitoring for ongoing activity. Of this total, we then list the number of drives that are currently being indexed along with the number of drives for which indexing is complete. A second section lists similar values for shared or team drives in Google Drive.

 

After all drives have been indexed, the cloud storage connection status transitions to the Monitoring status. As drives are created or added to scope, this status briefly changes back to "Monitoring, indexing in progress" to indicate these new drives are discovered and have started indexing.

Monitoring

Cloud storage connections

Code42 has discovered all in-scope user drives and has completed the initial indexing of those drives. Code42 is monitoring for ongoing file activity while also checking for new files. Any new files discovered during monitoring are hashed. By default Code42 checks the cloud storage environment every 5 minutes for new files and the latest file activity.

 

Code42's discovery of new drives added to your environment depend on the cloud storage provider:

  • New Box drives are discovered within a few minutes of their creation
  • New drives added to Google Drive and OneDrive environments are discovered within 8 hours

All drives are indexed immediately after discovery.

 

Email service connections

Code42 is connected to the email service and is monitoring outbound email activity for file attachments. For Google Gmail, the total number of email accounts that are in scope for montoring is listed. For Microsoft Office 365 email services, Code42 monitors only the email accounts for users who have a subscription that supports Microsoft Advanced Audit. New email accounts are discovered at midnight and are registered for monitoring.

Maintenance Code42 is currently performing maintenance on the data connection. The connection is still being monitored for file or email activity, but these events won't be displayed in Code42 until maintenance completes. After maintenance completes, Code42 displays all file events collected during that maintenance period.
Error

There was an error connecting to the external environment. This typically occurs when a majority of users, user drives, or email accounts are inaccessible to Code42 due to permissions or licensing issues within the environment. This can also occur immediately after a service is authorized if that service is already registered to Code42.

 

To address common errors with most cloud storage services, deauthorize and resume monitoring that data connection. Contact our Customer Champions for support with persistent errors.

Deauthorizing Code42 is removing its authorization to monitor the external environment. For services with a large number of users, drives, or email accounts that are monitored by Code42, this process may take an hour or longer. When this process completes, the status moves to Deauthorized.
Deauthorized

Code42's connection to the external environment has been removed and no new event activity is being collected.

 

For most connections, the connection remains deauthorized and is listed in the table for 90 days following the date of deauthorization. All discovered drives, email accounts, and existing file events remain in Code42 for those 90 days and can be viewed in Forensic Search. Once the 90-day period expires, Code42 deletes this connection along with all information collected. To resume monitoring the connection after deletion, you need to re-authorize it.

 

For Gmail and Microsoft Office 365 email services, Code42 immediately removes the connection from the table (along with its configuration and authorization details) after deauthorization. File events collected from the service before it was deauthorized remain searchable in Forensic Search for up to 90 days. To resume monitoring a Gmail or Microsoft Office 365 email service, add it again as a new connection.

Deleting Code42 is removing its connection to the external environment and deleting any information about that connection, such as initialized drive information and collected file events. For services with a large number of users, drives, or email accounts that are monitored by Code42, this process may take an hour or longer. When this process completes, the connection is removed from the Data Connections table.

Automated Integrations 

Status Description

Connected

The connection is configured and data is flowing to or from Code42, depending on the type of integration. 

Disconnected

The connection is not sending or receiving data. However, the connection remains configured and available. 

 

To disable and remove the connection completely, contact your Customer Success Manager (CSM) to engage the Code42 Professional Services team.  

Add data connection

To add a cloud storage or email service connection, click Add Data Connection.

For automated integrations, Code42 Professional Services adds the connection for you. 

Add data connection

Item Description
a Data Connection

Selects the service to add:

For automated integrations, Code42 Professional Services adds the connection for you. See Configure Incydr Flows for details.

b Display Name The name you use to distinguish between services, for example, for different Google Drive accounts for US employees and UK employees. This name must be unique.
  • Was this article helpful?