Create and Upload an Encrypted EDM Data Set 3.5 and Earlier

1. Create a Service Account for EDM Dataset Uploads.
2. Set Up the EDM CLI App.
3. Create a Service Account for EDM Dataset Uploads.

   You must provide the service account Client ID and Client Secret to successfully authenticate the EDM CLI app and upload EDM datasets.

   (EDM CLI app 6.0 and later) If you encrypted your Client ID and Client Secret, you must provide the 32-byte AES encryption key for each to successfully authenticate the EDM CLI app and upload EDM datasets.
4. Configure EDM CLI App Connectivity to Enterprise DLP.

   This is required to successfully upload hashed and encrypted EDM datasets.
5. Review the Supported EDM Data Set Formats and prepare the EDM dataset for upload to Enterprise DLP.
6. Enter Interactive mode in the EDM CLI app to begin the EDM dataset upload.

   1. Open the terminal and navigate to the package-edm-secure-cli-<version>-<platform> directory where the EDM CLI app is located.
   2. Enter Interactive mode in the EDM CLI app.

      • Windows

        admin: edm-secure-cli.bat interactive

      • Linux

        admin: ./edm-secure-cli.sh interactive

      Entering this command begins the interactive upload process for EDM datasets to Enterprise DLP.

7. Enter the path of the EDM dataset for upload.

8. Enter the delimiter used to specify boundaries between values in the EDM dataset.

   Enterprise DLP supports the "," and "t" (tab) delimiters for CSV or TSV files. The EDM CLI app uses the delimiter "," by default. The EDM dataset might only use one delimiter.

9. Enter the EDM dataset file encoding method.

10. Enter the error threshold percentage for the EDM dataset.

    The EDM CLI app does not create an encrypted version of the EDM dataset if it encounters errors exceeding the specified error threshold percentage.

11. Specify whether the EDM dataset has a header row.

12. Specify whether to allow uploads of EDM datasets that include empty or blank cells.

    Enter true to allow rows that include empty or blank cells in an EDM dataset.

    Enter false to reject rows that include empty or blank cells in an EDM dataset.

13. Specify whether the EDM CLI app should abort the EDM dataset upload if the EDM dataset includes more than the maximum number of cells supported.

    Enter true to upload the maximum number of dataset cells supported.

    Enter false to abort the EDM CLI app if the EDM dataset has more than the maximum number of dataset cells supported.

14. Enter the number of columns in your EDM dataset.

    Map your CSV or TSV columns to the supported data types to allow Enterprise DLP to correctly ingest your EDM dataset.

15. Map each column in your EDM dataset to a specific Data Type using the supported Data Types Values.

    The EDM CLI app presents a table with each Data Type Name and the corresponding Data Type Value. You can also view this table in the README.txt file packaged with the EDM CLI app.

    When you create a data profile on Strata Cloud Manager, you are required to add at least one column where the column values occur up to 12 times in the selected EDM dataset for the Primary Field.

    When mapping your columns to a specific Data Type, be sure to include at least one column with up to 12 occurrences across the entire EDM dataset. Otherwise, Enterprise DLP is unable to match traffic against the EDM data profile you create using this EDM dataset.

16. Specify whether to upload the EDM dataset to Enterprise DLP. Enter y to continue uploading the EDM dataset or n to upload the EDM dataset later.

    Entering n creates a secured copy of the EDM dataset in the package-edm-secure-cli-<version>-<platform> directory for you to review.

    You can skip the remaining steps below and Upload an Encrypted EDM Data Set to Enterprise DLP later.

17. Enter y to create a new EDM dataset and enter the dataset name.

    If you enter n and are uploading to Enterprise DLP, you are still prompted to enter an EDM dataset name. This updates the existing EDM dataset you previously uploaded to Enterprise DLP.

18. Specify the authentication mechanism used to upload the EDM dataset to Enterprise DLP.

    1. When prompted whether you have access and refresh token, enter n.

       Enterprise DLP requires you to enter the Client ID and Client Secret to upload EDM datasets.
    2. Enter the Client ID and Client Secret.

19. (Proxy server only) When prompted, enter y if the local device from which you are uploading requires a proxy server to connect to the internet.

    Enterprise DLP supports basic proxy authentication only. Kerberos authentication is not supported.

    You are required to provide the following information for your proxy server.

    • Proxy hostname
    • Proxy port number
    • Proxy username
    • Proxy password
20. Enter Y or y to confirm the EDM dataset upload configuration is correct and begin uploading to Enterprise DLP.

    The EDM CLI app creates a secured copy of the EDM dataset in the package-edm-secure-cli-<version>-<platform> directory. Within that directory, the EDM CLI app creates a new folder named after the EDM dataset, appended with the date and time the EDM CLI app created it. This folder contains the encrypted output.zip file of your EDM dataset that was uploaded to Enterprise DLP.

    The EDM CLI app displays a progress bar and success message to notify you whether the upload is successful.

    During the upload process, the EDM CLI app connects to Enterprise DLP to verify that you created the output.zip file using a supported EDM CLI app version. The upload to Enterprise DLP fails if you created the output.zip file using an unsupported EDM CLI app version.

21. Monitor the upload status of the EDM dataset.

    The time it takes for an EDM dataset uploaded to Enterprise DLP to be available on Strata Cloud Manager depends on the EDM dataset size and internet connectivity speed. For example, a 4GB EDM dataset upload typically takes about 30 minutes to display on Strata Cloud Manager and be usable in a data profile.

    1. Log in to Strata Cloud Manager.
    2. Select ConfigurationData Loss PreventionDetection MethodsExact Data Matching.
    3. The EDM dataset upload is complete when the Indexing Status column displays Complete.