Skip to main content

Context ManagementContext Management Administration Guide

Create a Custom Context Table Using the Add Custom Option

tile-add-custom.png

The Add Custom option, provides greater flexibility for creating and configuring new custom context tables. When using this option, available on the Context Library tab, creating a custom table and uploading data are separate procedures so that you can create the table without uploading data immediately.

You can also use the Add Custom option to create a user-based context table that is connected to other context tables with a filtered set of user attributes. This functionality is useful when you want to display user information from multiple context tables and filter the display by a specific set of conditions. For more information about filtered context tables, see Working with Filtered Context Tables.

If you prefer a more streamlined approach to creating custom context tables, and plan to upload data from a CSV file, use the Import CSVCreate a Custom Context Collector by Importing a CSV File option on the Context Library tab instead.

Note

  • A total of 200 custom context tables can be created.

  • A custom context table can contain up to a maximum of 500,000 records.

To create a custom table using the Add Custom option:

  1. Log into the Exabeam Security Operations Platform with your registered credentials.

  2. Find the Security Management tab and click the Context Management tile.

  3. Navigate to the Context Library tab and click Add Custom. The Custom Context Table panel opens.

  4. In the Configuration section, complete the Definition step by entering the following information:

    • Context Table Name – A name for the new custom context table you're creating.

    • Context Type – Select the type of context data the new table will contain. Options include Other and User. If you select User, additional options are displayed that allow you to connect the new context table to existing context tables with a filtered set of attributes.

    • Create Connection? – This option is displayed if you select User for the Context Type. Click Yes, Create Connection to display the Source Context Table dropdown field. Select one or more existing context tables from the list to serve as sources for data in the new custom context table.

  5. Click Next.

  6. In the Attributes tab, click Add Attributes. The Add Columns/Attributes dialog box opens.

  7. To add attributes as columns in the custom context table, do one of the following:

    • Select an existing attribute – In the Available Attributes panel on the left, locate an attribute that already exists in the system. Click the plus icon (icon-add-attribute.png) on the attribute, or click and drag, to add it to the Columns panel on the right.

      The available attributes are arranged in two categories:

      • Commonly Used – Attributes that are most frequently used. This category is listed first for convenience.

      • Others – Attributes that are either less frequently used or are custom attributes that already exist in your environment.

      You can click the drop down arrow on many of the available attributes to view both a short description of the attribute and an example value. You can also use the Search field if necessary to find a specific attribute.

      Note

      You cannot include the following attributes in a custom context table: Thumbnail Photo, User Account Control.

    • Add a new attribute – In the Columns panel on the right, click Add Custom Attributes. Enter a new column name and click the plus icon (icon-add-attribute.png), or click and drag, to add the new column to the list.

    Repeat this step until all of the necessary attributes are listed in the Columns panel.

  8. Click the key icon (icon-key.png) next to one of the columns to designate it as the key attribute for the context table. Only a single attribute can be designated as the key.

  9. When you're satisfied with the attributes, click Apply. The Add Columns/Attributes dialog box closes.

  10. Review the custom context table configuration and do one of the following:

    • If you are creating a User context table, and you opted in Step 4 to create connections with existing context tables, click Next and continue with Step 11 where you will define conditions.

    • If you are not creating a context table with connections to existing context tables, skip to Step 12.

  11. In the Conditions step, define the filter conditions you want to use to filter the data that will be displayed from the source context tables. You can add conditions in one group or in multiple groups, depending on the complexity required. For information about defining filter conditions, follow the steps in Working with Filtered Context Tables.

  12. Click Create. The new context table is created but does not yet contain any data. In the Context Management Overview tab, custom context tables are displayed with the following icon: icon-custom.png.

    However, if you created a custom context table that filters data from existing context tables, it displays with the following icon: icon-filtered.png.

  13. If you want to add data to the custom context table, follow the procedure at one of the links below:

    • Upload CSV – Import data via a CSV file that you have prepared with the necessary columns.

    • Add Data Manually – Manually add data one data entity at a time.