Endpoint Security allowlist and blocklist

The Coro Endpoint Security allowlist and blocklist enable admin users with sufficient permissions to manage the access of files and folders deemed safe and block the execution of unsafe processes on a device. This allows admin users more control over what Coro monitors by:

  • Suppressing possible false positive detections of files and folders considered safe by your organization.
  • Excluding folders from being scanned by the Coro Agent in order to improve the Agent's performance.
  • Blocking identified malicious processes from executing.

This article discusses the following topics:

Managing Endpoint Security and EDR allowlists and blocklists

Coro Endpoint Security and Endpoint Detection and Response (EDR) use separate allowlists and blocklists. The EDR allowlist prevents EDR tickets from triggering by marking non-system processes and folders as safe, stopping process and telemetry collection for them. The Endpoint Security allowlist excludes specific files or folders from Coro Agent scanning to prevent Endpoint Security ticket triggers. Both EDR and Endpoint Security blocklists actively block the execution of unsafe or non-trusted processes.

The following table outlines the differences between adding records to the Endpoint Security allowlist and blocklist, and adding records to the Endpoint Detection and Response (EDR) allowlist and blocklist:

Record type Add to Endpoint Security allowlist Add to Endpoint Security blocklist Add to EDR allowlist Add to EDR blocklist
File Prevents Endpoint Security tickets from triggering by excluding the file from Coro Agent scanning N/A N/A N/A
Folder Prevents Endpoint Security tickets from triggering by excluding the folder from Coro Agent scanning N/A Prevents process execution and telemetry collection for the folder N/A
Process N/A Blocks unsafe process execution Prevents EDR tickets from triggering by marking the non-system process as safe. Related process information is not collected in the EDR Telemetry and Process tabs Blocks unsafe process execution

You can add records to the allowlist and blocklist individually, or as a list contained in a CSV file.

Accessing the Endpoint Security allowlist and blocklist

To access the Endpoint Security allowlist and blocklist:

  1. Sign into the Coro console .
  2. Select Control Panel :

    Control Panel

  3. Select Endpoint Security :

    Endpoint Security

  4. Select the Allow/Block tab:

    Endpoint Security Allow/Block tab

    The Allow/Block page appears:

    Endpoint Security Allow/Block page

    The Allow/Block page displays a list of allowed file and folder records as well as blocked process records. The list contains the following columns:

    • Symbol : Specifies the record type:
      • File symbol : Process image file path record.
      • Folder symbol : Process image folder record.
      • Process symbol : Process hash record.
    • Value : The value of the record, based on the record type above. This value must be one of the following:
      • File path
      • Folder path
      • Process file hash
      note

      A process file hash is a fixed-size alphanumeric string representing file content, generated using cryptographic functions. Coro supports:

      • SHA-256 : A cryptographic hash function that generates a 256-bit hash from any input, commonly used for data integrity, digital signatures, and encryption.
      • CDHash : A cryptographic hash function specific to Apple's code signing, derived from an app's Code Directory, often using SHA-256. It ensures executable files haven't been altered.
    • List : Specifies whether the record is displayed on the allowlist or blocklist.
    • Description ( optional ): A short description of the record. When no value is specified, "N/A" is displayed.

Adding allowlist and blocklist records

You can add allowlist or blocklist records individually or import them in bulk from a CSV file.

Using environment variables

The Coro Agent enables admin users to use environment variables when they add file and folder records to the allowlist or blocklist, either individually or through CSV import.

Environment variables act as placeholders for user or system-specific directories, automatically resolving to the correct paths. By using these variables, admin users can avoid manually entering file paths, reducing manual input and ensuring accurate path application across different users and devices.

note

The Coro Agent supports environment variables on Windows devices.

Coro supports the following environment variables:

  • USERPROFILE : The profile folder of the current user.
    • Example without environment variable : C:\Users\JohnDoe\Documents\Projects
    • Example with environment variable : __USERPROFILE__\Documents\Projects

    __USERPROFILE__\Documents\Projects dynamically references each user's profile folder, eliminating the need to create separate entries for different users.

  • TEMP : The temporary files directory for the current user.
    • Example without environment variable : C:\Users\JohnDoe\AppData\Local\Temp\TestFolder
    • Example with environment variable : __TEMP__\TestFolder

    __TEMP__\TestFolder dynamically references the current user's temporary folder on the device, eliminating the need to create separate entries for different users.

Adding records individually

To add an allowlist or blocklist record to the list:

  1. Select + ADD from the Allow/Block page.
  2. Select the type of record to add:

    Add allow/block list record

  3. After adding records, enable the following options to apply the rules to all child workspaces:
    • Apply allow/block rules for files and folders to all child workspaces : Applicable to file and folder records.
    • Apply allow/block rules for processes to all child workspaces : Applicable to process records.

    Apply to all child workspaces

    note

    The Apply allow/block rules for files and folders to all child workspaces and Apply allow/block rules for processes to all child workspaces options apply to channel workspaces only.

Adding a file record

To add a file record to the allowlist or blocklist:

  1. Select + ADD > Add file record :

    Add file record

    The Add new file record dialog appears:

    Add new file record dialog

  2. Enter a file path value into the Add file path field.
    note

    Coro supports the use of environment variables in file paths on Windows devices.

  3. ( Optional ) Enter a description for the file record into the Add description field.
  4. Select SAVE .

    Coro creates the file record, adds it to the allowlist, and attaches a timestamp indicating when the file was allowed:

    File added

    After a file is added to the allowlist, Coro stops creating tickets related to that file.

    note

    Admin users can add file and folder records to the allowlist.

    note

    Admin users can also add a file to the allowlist directly from Malware on Endpoint tickets using the Approve this file action. For further information, see Malware on endpoint

Adding a folder record

To add a folder record to the allowlist:

  1. Select + ADD > Add folder record :

    Add folder record

    The Add new folder record dialog appears:

    Add new folder record dialog

  2. Enter a folder path value into the Add folder field.
    note

    Coro supports the use of environment variables in folder paths on Windows devices.

  3. ( Optional ) Enter a description for the folder record into the Add description field.
  4. Select SAVE .

    Coro creates the folder record, adds it to the allowlist, and attaches a timestamp indicating when the folder was allowed:

    Folder added

    After an admin user adds the folder to the allowlist, Coro stops creating tickets for the folder.

    note

    Folder records cannot be added to the blocklist. Admin users can only add folder records to the allowlist.

Adding a process record

To add a process record to the blocklist:

  1. Select + ADD > Add process record :

    Add process record

    The Add new process record dialog appears:

    Add new process record dialog

  2. Enter a valid SHA-256 hash or CDHash value into the Add hash box.
  3. ( Optional ) Enter a description for the process record into the Add description field.
  4. Select SAVE .

    Coro creates the process record, adds it to the blocklist, and attaches a timestamp indicating when the process was blocked:

    Process added

    After an admin user adds the process to the blocklist, Coro blocks the execution of the process.

    note

    Process records cannot be added to the allowlist. Admin users can only add process records to the blocklist.

    info

    If you have the EDR module enabled, you can also block a process from the EDR Processes page using the Block Process action. Process entries are shared between the blocklists of EDR and Endpoint Security.

Importing records from a csv file

Admin users are able to add records to the allowlist or blocklist by importing a CSV file containing a list of records.

Entries in your CSV file must follow the pattern:

<Type>,<Value>,<List>,<Description>

Each entry must be on a separate line, with the following possible values in each field:

Field Description Allowed values
<Type> The item type. File or Folder or Process
<Value> A file/folder path or a process hash. Examples: c:\users\downloads\test.txt, c:\dev\ or 986e27a1e6a4cbae373d28337ac3759325163ffb
<List> Specifies whether to allow or block the item. Allowed or Blocked
<Description> (Optional) A short description of the record. When no value is provided, a default value of N/A is applied during file upload. A test file or An allowed process
note

Coro supports the use of environment variables in file and folder path records on Windows devices.

Files must abide by the following rules:

  • You must specify valid values in all four columns. Coro ignores entries with extra columns or invalid values.
  • The maximum file size is 10 MB.
  • The CSV import filename must be in lowercase.
  • A single CSV import file can contain a maximum of 500 records.
  • When Type is Process :
    • Value must be a valid SHA-256 hash or CDHash.
    note

    CDHash values have a maximum string length of 40 characters.

    SHA-256 hash values have a maximum string length of 64 characters.

  • When Type is File or Folder :
    • Value must be a valid file or folder path.
    • Value must not contain "'", "?", "//", or "|".
    • Value must not contain ":" if it contains "/".
    • Value has no character limitation.
  • Apply Allowed when Type is Folder or File .
  • Apply Blocked when Type is Process .

To import records to the Endpoint Security allowlist or blocklist from a CSV file:

  1. Select + ADD :

    Add record

  2. Select Import from CSV :

    Import from CSV

    The Import CSV to allow / block list dialog appears:

    Import CSV dialog

  3. (Optional) If you haven't created a valid CSV file, select Download our template to avoid invalid entries :

    CSV template file link

    Use the downloaded template to ensure all required columns are completed.

  4. Select Click to upload :

    Click to upload

    Alternatively, drag and drop the selected CSV file into the Import CSV to allow / block list dialog.

  5. Select a valid CSV file:

    Select CSV file

    After you select the CSV file, the filename appears in the file area of the Import CSV to allow / block list dialog:

    Selected CSV file

    • (Optional) Select Remove to discard the selected CSV file and choose an alternative file:

      Remove CSV file

  6. Select IMPORT :

    Import CSV file

    Coro processes the CSV file.

    After Coro completes the import process, a summary appears that displays the number of successfully imported records:

    Successfully imported records

    If any records fail to import, the summary displays the number of invalid records out of the total number of records in the CSV file:

    Invalid records

  7. Select Try again to restart the import process, else select CLOSE .

    The imported records are added to the Endpoint Security allowlist/blocklist:

    Import success

Deleting allowlist and blocklist records

To delete a record from the allowlist or blocklist:

  1. Select the three-dot menu to the right of the record:
  2. Select Delete record .

    Delete record

    The record is deleted from the allowlist or blocklist.

Searching and filtering allowlist and blocklist records

You can filter and search the EDR allowlist and blocklist to find specific entries. The Type filter allows you to filter allowlist and blocklist records by:

  • Folder
  • Process
  • File

Type filter

You can also perform a free text search search across the Value and Description columns:

Search Allow/Block list