Case 6. Custom Protocols / Signatures [Документация VAS Experts]

Case 6. Custom Protocols / Signatures

Protocols/signatures available to the user are divided into the following types:

  1. Built-in (Programmable Cubro) - stored in the DPI engine and updated with each new version of the Cubro SG software.
  2. Cloud-based - periodically updated from the Cubro cloud, ensuring the relevance of popular applications amid changing behaviors.
  3. Custom (User-defined) - created by the user of the system using Cubro Cloud tools through the GUI.

Users can add protocols based on IP, SNI, and AS. Custom protocols override Built-in and Cloud protocols.

Adding a new protocol is done in 3 steps:

Step 1. Adding a New Protocol

On this panel, you can:

  1. Add list item.
    • Fill in the following parameters:
    • Name — a mandatory field. It must contain only letters, numbers, or their combinations. Each name is automatically prefixed with “cp_” (CP stands for Custom Protocol), which is mandatory;
    • Custom Number — a mandatory unique field, limited to the range of 1 to 1024;
    • Port — filled in automatically;
    • Description — an optional field;
    • Main List — if this parameter is ignored, the default list type is “test.” The flags “main” and “test” are used for debugging the protocol (“test”) and subsequently launching it for policing subscribers (“main”). Usually, the test protocol is first uploaded to the DPI test stand, and after debugging is complete, the “main” flag is set, and it is uploaded to all other DPIs.
  2. Enable or disable the protocol.
    Performing any actions with a disabled protocol (step 7) automatically activates it. These changes are also reflected in the main section of the “User Interface” as an activation button next to the “Name” column of each protocol in the list.
  3. Import data from a file.
    To facilitate the completion of the protocol creation fields, a template is provided that can be exported in Excel format, filled out, and uploaded in this window. After uploading the file, the data cannot be changed; only the protocol can be deleted.
  4. Delete an item from the list.
  5. Clear the list.
  6. Refresh the list.
  7. Enable and disable list items.
  8. Modify a list item.
  9. Export the list. Available formats: Excel, CSV, PDF, PNG.

Step 2. Add Resources Defining the Protocol

On this panel, you can:

  1. Add list item.
    Fill in the following parameters:
    • Type — a mandatory field, filled by selecting from the offered list (Auto, IP, SNI, ASN (only external AS can be specified, e.g., Facebook or Google));
    • URI (Uniform Resource Identifier) — a mandatory field, how to fill it depends on the type of resource (IP or SNI);
      Example:
      Type IP — 201.1.1.1.
      Type SNI — google.com.
  2. Enable or disable the resource.
    Performing any actions with a disabled protocol (step 7) automatically activates it. These changes are also reflected in the main section of the “User Interface” as an activation button next to the “Name” column of each protocol in the list.
  3. Import data from a file. and Check resource.
    To facilitate the completion of the protocol creation fields, a template is provided that can be exported in Excel format, filled out, and uploaded in this window. After uploading the file, the data cannot be changed; only the protocol can be deleted.
  4. Delete list items.
  5. Clear the list.
  6. Refresh the list.
  7. Enable and disable list items.
  8. Modify a list item.
  9. Export the list. Available formats: Excel, CSV, PDF, PNG.

Step 3. After Preparing the Protocol, It Needs to Be Uploaded to the DPI Devices from the List.

Adding and removing devices from this list is not allowed.

On this panel, you can:

  1. Refresh the list.
  2. Enable and disable list items.
  3. Edit a list item.
  4. Export the list. Available formats: Excel, CSV, PDF, PNG.

Logs

In this section, you can view all actions performed with protocols. You can delete specific entries, clear the list, refresh, and export it in formats Excel, CSV, PDF, PNG.