- Introduction to Context Management
- Onboarding a Context Table
- Custom Context Tables
- Create a Custom Context Table by Importing a CSV File
- Create a Custom Context Table Using the Add Custom Option
- Working with Filtered Context Tables
- View and Interact with a Custom or Filtered Context Table
- View the Details Panel for a Custom or Filtered Context Table
- Edit the Configuration of Custom or Filtered Context Tables
- Active Directory Context Tables
- Prerequisites to Onboard an Active Directory Context Table
- Create an Active Directory Context Table
- View and Interact with an Active Directory Context Table
- View the Details Panel for an Active Directory Context Table
- Edit the Configuration of an Active Directory Context Table
- Default Active Directory Attribute Mapping
- Microsoft Entra ID Context Tables
- Prerequisites to Onboard a Microsoft Entra ID Context Table
- Create a Microsoft Entra ID Context Table
- View and Interact with a Microsoft Entra ID Context Table
- View the Details Panel for a Microsoft Entra ID Context Table
- Edit the Configuration of a Microsoft Entra ID Context Table
- Default Microsoft Entra ID Attribute Mapping
- Okta Context Tables
- Custom Context Tables
- Add Data to an Existing Context Table
- Using Context Data in Downstream Applications
- Built-In Threat Intelligence Context Tables
- Context Management APIs
- Troubleshooting Context Management
Add Data to a Context Table by Uploading a CSV File
Use this procedure to add data records to either custom or collector-based context tables. Keep in mind, if you add a new record with the same value in the primary key as an existing record, the new record overwrites the old record.
Tip
When you add new records, or overwrite existing records, in a collector-based context table, the icon that displays in the Source column for the new or overwritten record is the custom icon (
) instead of the collector source icon.
Prepare a CSV File
Before you can add data to a context table by importing a CSV file, you must first prepare a CSV file that conforms to the following requirements:
It must be a maximum file size of 300 MB. If the CSV file is larger than 300 MB, compress it as a ZIP file. A compressed ZIP file must contain only one CSV file.
It must include a header row.
Note
A header row with column names is mandatory when uploading a CSV file. Failure to include a header row in the CSV file can result in missing or incorrect data in your context table.
For attributes that represent a list of values, the values must be provided in one of the following ways in the CSV file:
Escape the comma between values by preceding it with a backslash, as in this list:
[email protected]\,[email protected]\,[email protected]Enclose the entire list of values in quotes, as in this list:
"[email protected],[email protected],[email protected]"
Note
List attributes that can be included in a custom context table include:
Direct Reports
Email Addresses
Group Name
Phone Number
Add Data with a CSV File
To add data to a context table by importing a CSV file:
In the Overview tab, click the name of the context table to which you want to add data. The detail page for the table opens.
Click the plus icon (
) at the top of the detail page and select Upload CSV. The Upload CSV dialog box opens.On the left side of the dialog box, under Upload Options, select one of the following options:
Append Data – Appends the CSV file data to any data already existing in the context table.
Replace Data – Replaces any existing data with the CSV file data.
Note
The Replace Data option is only available when uploading CSV data to a custom context table. It is not available for collector-based tables.
On the right side of the dialog box, click Select a CSV and select a CSV file to upload. Ensure that the file conforms to the requirements described in Prepare a CSV File.
Click Review Mapping. A table is displayed listing the columns contained in the CSV file.
In the Target row of the table, click Add Attribute for each CSV column, and do one of the following:
Select one of the Available Attributes to map it to the CSV column.
Note
If you are adding data to a custom context table, you cannot include the following attributes: Thumbnail Photo, User Account Control.
Click Add Custom Attribute and enter a new attribute name. Click the plus icon (
) to map the new attribute to the CSV column.
Note
When adding data to a context table, you cannot modify the Primary Key attribute.
Click Review and review the first few entries in the table to ensure the data is being imported correctly.
Click Add Data. The CSV data is uploaded to the context table.
Click View Your Table to open the context table and view the uploaded data.