Skip to main content

Who is this article for?

Incydr
Code42 for Enterprise
CrashPlan for Enterprise

Incydr, yes.

CrashPlan for Enterprise, no.

Code42 for Enterprise, yes.

CrashPlan for Small Business, no.

This article applies to Code42 cloud environments.

HOME
GETTING STARTED
RELEASE NOTES
FAQs
APIs
SYSTEM STATUS
Code42 Support

Configure Code42 for use with Amazon WorkSpaces

Overview

Code42 supports Amazon WorkSpaces that run one of the currently supported Windows operating systems. To monitor these Amazon WorkSpaces, some additional configuration is required. This article identifies system and networking requirements for Amazon WorkSpaces and has the steps you need to take to configure Code42 to monitor them.

Considerations

Before you begin

Verify that your WorkSpaces meet Amazon and Code42 system and networking requirements.

Group Amazon WorkSpace users into their own organization

After verifying system and networking requirements, we recommend you create a new organization to group all Amazon WorkSpaces users and their devices together, and then move those users into that organization. By grouping Amazon WorkSpaces users into their own organization, you can configure File Metadata Collection and backup file selection settings for that organization only without impacting any current settings for existing users with physical endpoints.

For details on how to create a child organization and add users to it, see these articles:

Adding Amazon WorkSpaces users to existing organizations impacts current settings
You can choose to add Amazon WorkSpaces users to your existing organization structure. However, keep in mind that if you do so, the configuration steps below to update the File Metadata Collection file paths and backup file selection for Amazon WorkSpaces users also affects your existing users and devices.

This may result in unexpected file event reporting or unnecessary (or unwanted) backups of files on any D:\ drives that currently exist on users' physical devices.

Enable File Metadata Collection on the D:\ drive

Because Amazon WorkSpaces store user files on the D:\ drive, you need to configure the organization that houses these users to enable File Metadata Collection on that drive. This is a two-step process:

  1. Locate the OrgID of the organization containing your Amazon WorkSpaces users in the Code42 console.
  2. Use that OrgID in the API command that adds the D:\ drive to the file paths watched by Code42's File Metadata Collection for that organization.

Step 1: Locate the numeric OrgID

  1. Sign in to the Code42 console.
  2. Select Administration > Environment > Organizations.
  3. Select the organization that contains your Amazon WorkSpaces users.
  4. In the web browser's address bar, note the numeric ID in the URL after "organization" but before any query or token parameters. In this example, the OrgID is 123456: https://console.us.code42.com/console/#/organization/123456?t=78910

Step 2: Add the D:\ drive to the File Metadata Collection file paths

Run the following command to add the D:\ drive to the file paths watched by Code42's File Metadata Collection.

Copied!
curl -X PUT \
    '<RequestURL>/api/OrgSettings/<OrgID>' \
    -u 'username' \
    -H 'cache-control: no-cache' \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -d '{
          "packets": [
            {
                "key": "device_fileForensics_watchPaths_included",
                "value": [ "'\'':main'\''", "'\''D:'\''" ],
                "locked": true
           }
           ]
        }'

In the example above:

  • Replace <requestURL> with the address of your Code42 environment (do not include the brackets in your request).
    • United States:
      • If you sign in to the Code42 console at https://console.us.code42.com/console, use: 
        https://console.us.code42.com
      • If you sign in to the Code42 console at https://www.crashplan.com/console, use:
        https://www.crashplan.com
      • If you sign in to the Code42 console for the Code42 federal environment at https://console.gov.code42.com/console, use: 
        https://console.gov.code42.com
    • Ireland: https://console.ie.code42.com
  • Replace <OrgID> with the numeric identifier of the new organization, identified in Step 1.
  • Replace username with your Code42 Customer Cloud Admin username.

Execute the curl command in your command-line tool of choice. When prompted, enter your password. This command does not return any messages if it executes successfully, but will notify you if any errors occur.

Verify the File Metadata Collection file paths

To verify that the new path was added correctly, run this command, using the correct address, organization ID, and username (as above). When prompted, enter your password.

Copied!
curl -X GET \
  '<requestURL>/api/OrgSettings/<OrgID>?keys=device_fileForensics_watchPaths_included' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -u 'username'

The results show the locations included in the File Metadata Collection file paths. In the example below, the included locations are :main (\u0027:main\u0027) and D:\ (\u0027D:\u0027).

{"metadata":{"timestamp":"2021-04-07T14:28:56.833Z","params":{"keys":"device_fileForensics_watchPaths_included"}},"data":{"device_fileForensics_watchPaths_included":{"scope":"ORG","value":"[\u0027:main\u0027, \u0027D:\u0027]","locked":true,"id": 123456}}}C02Z

Add the D:\ drive to the backup file selection

To preserve files that users create on their Amazon WorkSpace virtual machines, add the D:\ drive to the backup file selection.

  1. Sign in to the Code42 console.
  2. Select Administration > Environment > Organizations.
  3. Select the organization that contains your Amazon WorkSpaces users.
  4. Select action menu > Device Backup Defaults.
  5. Select the Backup tab.
  6. If needed, unlock the File selection settings on the Backup tab.
  7. Enter D:\Users\ in the Included files box and click Add Add icon.
    The new path is added to the Included files list. We recommend adding the D:\Users\ directory to the backup file selection, but you can customize this as needed for your organization.
  8. Click Push setting to devices Push setting icon to update the backup file selection on endpoints.
  9. If needed, lock the File selection settings again to prevent changes.
  10. Click Save.

Related topics

  • Was this article helpful?