Skip to content

Commit 1e6880b

Browse files
committed
Updates from Mike Pomraning comments
1 parent 2dcd1f1 commit 1e6880b

File tree

2 files changed

+11
-11
lines changed

2 files changed

+11
-11
lines changed

docs/search/search-query-language/search-operators/threatlookup.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Where:
2828
If there's still a tie at this point, the system picks the indicator the back-end database returned first.
2929

3030
* `source` is the source to search for the threat intelligence indicator. If `source` is not specified, all sources are searched.
31-
* `include` includes either all, only active, or only expired threat intelligence indicators. If `include` is not specified, all matching indicators are returned.
31+
* `include` includes either all, only active, or only expired threat intelligence indicators. If `include` is not specified, only active matching indicators are returned.
3232
* `<indicator_value_field>` is the indicator to look up.
3333
* `<optional_indicator_value_field>` is used to add more indicators to look up.
3434

@@ -114,7 +114,7 @@ You can run the `threatlookup` search operator with the [`cat` search operator](
114114
cat sumo://threat-intel | where _threatlookup.indicator = "192.0.2.0"
115115
```
116116
```
117-
cat sumo://threat-intel | where _threatlookup.source = "FreeTAXII" and _threatlookup.indicator = "192.0.2.0"
117+
cat sumo://threat-intel | where _threatlookup.source = "TAXII2Source" and _threatlookup.indicator = "192.0.2.0"
118118
```
119119
120120
In the `cat` output, timestamp fields (like `valid_until`) will appear as integers. You can use the `formatDate()` function to convert them back to timestamps. For example:

docs/security/threat-intelligence/upload-formats.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Following is an example threat indicator file in normalized JSON format. (For an
2828
"id": "0001",
2929
"indicator": "192.0.2.0",
3030
"type": "ipv4-addr:value",
31-
"source": "FreeTAXII",
31+
"source": "TAXII2Source",
3232
"validFrom": "2023-03-21T12:00:00.000Z",
3333
"validUntil": "2025-03-21T12:00:00.000Z",
3434
"confidence": 30,
@@ -44,7 +44,7 @@ Following is an example threat indicator file in normalized JSON format. (For an
4444
"id": "0002",
4545
"indicator": "192.0.2.1",
4646
"type": "ipv4-addr:value",
47-
"source": "FreeTAXII",
47+
"source": "TAXII2Source",
4848
"validFrom": "2023-03-21T12:00:00.000Z",
4949
"validUntil": "2025-03-21T12:00:00.000Z",
5050
"confidence": 30,
@@ -77,7 +77,7 @@ The following attributes are required:
7777
* `process`. Process name. (Entity type in Cloud SIEM is `_process`.)
7878
* `url`. URL. (Entity type in Cloud SIEM is `_url`.)
7979
* `user-account`. User ID. (Entity type in Cloud SIEM is `_username`.)
80-
* **source** (string). User-provided text to identify the source of the indicator. For example, `FreeTAXII`.
80+
* **source** (string). User-provided text to identify the source of the indicator. For example, `TAXII2Source`.
8181
* **validFrom** (string [date-time]). Beginning time this indicator is valid. Timestamp in UTC in RFC3339 format. For example, `2023-03-21T12:00:00.000Z`.
8282
* **confidence** (integer [ 1 .. 100 ]). Confidence that the creator has in the correctness of their data, where 100 is highest (as [defined by the confidence scale in STIX 2.1](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html#_1v6elyto0uqg)). For example, `75`.
8383
* **threatType** (string). Type of indicator (as [defined by indicator_types in STIX 2.1](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html#_cvhfwe3t9vuo)). For example, `malicious-activity`. (This attribute can result in a special label appearing next to Entities in the Cloud SIEM UI. See [View threat indicators in the Cloud SIEM UI](/docs/security/threat-intelligence/threat-indicators-in-cloud-siem/#view-threat-indicators-in-the-cloud-siem-ui).) <br/>Following are valid values:
@@ -111,8 +111,8 @@ Comma-separated value (CSV) is a standard format for data upload.
111111
If uploading a CSV file with the UI, the format should be the same as used for a standard CSV file:
112112

113113
```
114-
0001,192.0.2.0,ipv4-addr:value,FreeTAXII,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,30,malicious-activity,,
115-
0002,192.0.2.1,ipv4-addr:value,FreeTAXII,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,30,malicious-activity,actor3,reconnaissance
114+
0001,192.0.2.0,ipv4-addr:value,TAXII2Source,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,30,malicious-activity,,
115+
0002,192.0.2.1,ipv4-addr:value,TAXII2Source,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,30,malicious-activity,actor3,reconnaissance
116116
```
117117

118118
#### Upload with the API
@@ -121,8 +121,8 @@ If uploading a CSV file using the API, the file should be contained in a JSON ob
121121

122122
```
123123
{
124-
"csv": "0001,192.0.2.0,ipv4-addr,FreeTAXII,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,3,malicious-activity,,\n
125-
0002,192.0.2.1,ipv4-addr,FreeTAXII,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,3,malicious-activity,actor3,reconnaissance\n"
124+
"csv": "0001,192.0.2.0,ipv4-addr,TAXII2Source,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,3,malicious-activity,,\n
125+
0002,192.0.2.1,ipv4-addr,TAXII2Source,2023-02-21T12:00:00.00Z,2025-05-21T12:00:00.00Z,3,malicious-activity,actor3,reconnaissance\n"
126126
}
127127
```
128128

@@ -145,7 +145,7 @@ Columns for the following attributes are required in the upload file:
145145
* `process`. Process name. (Entity type in Cloud SIEM is `_process`.)
146146
* `url`. URL. (Entity type in Cloud SIEM is `_url`.)
147147
* `user-account`. User ID. (Entity type in Cloud SIEM is `_username`.)
148-
* **source** (string). User-provided text to identify the source of the indicator. For example, `FreeTAXII`.
148+
* **source** (string). User-provided text to identify the source of the indicator. For example, `TAXII2Source`.
149149
* **validFrom** (string [date-time]). Beginning time this indicator is valid. Timestamp in UTC in RFC3339 format. For example, `2023-03-21T12:00:00.000Z`.
150150
* **validUntil** (string [date-time]). Ending time this indicator is valid. If not set, the indicator never expires. Timestamp in UTC in RFC3339 format. For example, `2024-03-21T12:00:00.000Z`.
151151
* **confidence** (integer [ 1 .. 100 ]). Confidence that the creator has in the correctness of their data, where 100 is highest. For example, `75`.
@@ -260,7 +260,7 @@ As shown in the following example, if uploading via the API you must add the `so
260260

261261
```json
262262
{
263-
"source": "FreeTAXII",
263+
"source": "TAXII2Source",
264264
"indicators": [
265265
{
266266
"type": "indicator",

0 commit comments

Comments
 (0)