Create custom CEF fields in

uses the Common Event Format (CEF). CEF is a system of key-value pairs for important pieces of information about an artifact.

An artifact might have several key pieces of information such as sourceAddress, sourcePort, destinationAddress, destinationPort, and a timestamp. Each of these is stored in a field.

You can only have one of each CEF field per artifact. For example, you cannot have more than one sourceAddress per artifact. If you have a data set that includes multiple sourceAddress entries, separate those into multiple artifacts. Each of those artifacts can be placed in the same container.

You can extend or customize CEF to meet your organization's needs by adding custom CEF fields, and then using these fields in Investigation, add them to artifacts with the REST API, or using them in playbooks.

When an artifact is edited from Investigation, values set for a custom CEF appear as indicators. You can view these indicators by selecting Indicators in the Home menu.

You can add, delete, or modify a custom CEF using the REST API.

Create a custom CEF field

Perform the following steps to create a custom CEF field:

1. From the Home menu, select Administration.
2. Select Administration Settings > CEF.
3. Click + CEF.
4. Type a name for your customized CEF.
5. (Optional) Select a data type for the field from the dropdown list.

Available choices are prepopulated with all enabled Apps actions. You can add your own data type or leave the data type blank.

1. Click Save.

Modify a custom CEF field

Perform the following steps to modify a custom CEF field:

1. From the Home menu, select Administration.
2. Select Administration Settings > CEF.
3. Click the edit icon to the right of the CEF name.
4. Make the desired changes.
5. Click Save.

Delete a custom CEF field

Perform the following steps to delete a custom CEF field:

1. From the Home menu, select Administration.
2. Select Administration Settings > CEF.
3. Click the ⓧ icon to the right of the custom CEF field name.

Deleting a custom CEF does not remove it from existing artifacts that have the field applied.