Skip to content

Commit 9905772

Browse files
authored
Add hash to upload formats for threat intel beta (#5055)
* Add hash to upload formats * Update docs/platform-services/threat-intelligence-indicators.md
1 parent 6baf5d6 commit 9905772

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

docs/platform-services/threat-intelligence-indicators.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ To search logs that contain correlations to threat intelligence indicators, you
4848
* [ZeroFox Threat Intel Source](/docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/zerofox-intel-source)
4949
* **The API**. See the following APIs in the [Threat Intel Ingest Management](https://api.sumologic.com/docs/#tag/threatIntelIngest) API resource:
5050
* [uploadNormalizedIndicators API](https://api.sumologic.com/docs/#operation/uploadNormalizedIndicators)
51-
* [uploadCsvIndicators API](https://api.sumologic.com/docs/#operation/uploadCsvIndicators)
51+
<!-- * [uploadCsvIndicators API](https://api.sumologic.com/docs/#operation/uploadCsvIndicators) -->
5252
* [uploadStixIndicators API](https://api.sumologic.com/docs/#operation/uploadStixIndicators)
5353

5454
See [Upload formats](#upload-formats) for the format to use when uploading indicators using the Threat Intelligence tab or APIs.
@@ -374,6 +374,7 @@ The following attributes are required:
374374
* `domain-name`. Domain name. (Entity type in Cloud SIEM is `_domain`.)
375375
* `email-addr`. Email address. (Entity type in Cloud SIEM is `_email`.)
376376
* `file`. File name. (Entity type in Cloud SIEM is `_file`.)
377+
* `file:hashes`. File hash. (Entity type in Cloud SIEM is `_hash`.)<br/>If you want to add the hash algorithm, enter `file:hashes.'<HASH-TYPE>'`. For example, `[file:hashes.'SHA-256' = '4bac393bdd']`.
377378
* `ipv4-addr`. IPv4 IP address. (Entity type in Cloud SIEM is `_ip`.)
378379
* `ipv6-addr`. IPv6 IP address. (Entity type in Cloud SIEM is `_ip`.)
379380
* `mac-addr`. Mac address name. (Entity type in Cloud SIEM is `_mac`.)
@@ -429,11 +430,11 @@ If uploading a CSV file using the API, the file should be contained in a JSON ob
429430
}
430431
```
431432

432-
For other examples for uploading CSV files using the API, see the [uploadCsvIndicators API](https://api.sumologic.com/docs/#operation/uploadCsvIndicators) and the [uploadBlobIndicators API](https://api.sumologic.com/docs/#operation/uploadBlobIndicators).
433+
<!-- For other examples for uploading CSV files using the API, see the [uploadCsvIndicators API](https://api.sumologic.com/docs/#operation/uploadCsvIndicators) and the [uploadBlobIndicators API](https://api.sumologic.com/docs/#operation/uploadBlobIndicators). -->
433434

434435
#### Required attributes
435436

436-
For information about the attributes to use, see ["Indicator" in the STIX 2.1 specification](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html#_muftrcpnf89v), and the [uploadCsvIndicators API](https://api.sumologic.com/docs/#operation/uploadCsvIndicators) in the [Threat Intel Ingest Management](https://api.sumologic.com/docs/#tag/threatIntelIngest) API resource.
437+
For information about the attributes to use, see ["Indicator" in the STIX 2.1 specification](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html#_muftrcpnf89v). <!-- Also see the [uploadCsvIndicators API](https://api.sumologic.com/docs/#operation/uploadCsvIndicators) in the [Threat Intel Ingest Management](https://api.sumologic.com/docs/#tag/threatIntelIngest) API resource. -->
437438

438439
Columns for the following attributes are required in the upload file:
439440
* **id** (string). ID of the indicator. For example, `indicator--d81f86b9-975b-4c0b-875e-810c5ad45a4f`.
@@ -442,6 +443,7 @@ Columns for the following attributes are required in the upload file:
442443
* `domain-name`. Domain name. (Entity type in Cloud SIEM is `_domain`.)
443444
* `email-addr`. Email address. (Entity type in Cloud SIEM is `_email`.)
444445
* `file`. File name. (Entity type in Cloud SIEM is `_file`.)
446+
* `file:hashes`. File hash. (Entity type in Cloud SIEM is `_hash`.)<br/>If you want to add the hash algorithm, enter `file:hashes.'<HASH-TYPE>'`. For example, `[file:hashes.'SHA-256' = '4bac393bdd']`.
445447
* `ipv4-addr`. IPv4 IP address. (Entity type in Cloud SIEM is `_ip`.)
446448
* `ipv6-addr`. IPv6 IP address. (Entity type in Cloud SIEM is `_ip`.)
447449
* `mac-addr`. Mac address name. (Entity type in Cloud SIEM is `_mac`.)
@@ -623,10 +625,10 @@ The following attributes are required:
623625
* **id** (string). ID of the indicator. For example, `indicator--d81f86b9-975b-4c0b-875e-810c5ad45a4f`.
624626
* **created** (string [date-time]). The time at which the object was originally created. Timestamp in UTC in RFC3339 format. For example, `2016-05-01T06:13:14.000Z`.
625627
* **modified** (string [date-time]). When the object is modified. Timestamp in UTC in RFC3339 format. For example, `2023-05-01T06:13:14.000Z`. This property is only used by STIX Objects that support versioning and represents the time that this particular version of the object was last modified.
626-
* **pattern** (string). The pattern of this indicator (as defined by [pattern in STIX 2.1](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html#_me3pzm77qfnf)). <br/>For example, `[ file:hashes.'SHA-256' = '4bac393bdd' ]`. Following are valid values:
628+
* **pattern** (string). The pattern of this indicator (as defined by [pattern in STIX 2.1](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html#_me3pzm77qfnf)). Following are valid values:
627629
* `domain-name:value`. Domain name. (Entity type in Cloud SIEM is `_domain`.)
628630
* `email-addr:value`. Email address. (Entity type in Cloud SIEM is `_email`.)
629-
* `file:hashes`. File hash. (Entity type in Cloud SIEM is `_hash`.)
631+
* `file:hashes`. File hash. (Entity type in Cloud SIEM is `_hash`.)<br/>If you want to add the hash algorithm, enter `file:hashes.'<HASH-TYPE>'`. For example, `[file:hashes.'SHA-256' = '4bac393bdd']`.
630632
* `file:name`. File name. (Entity type in Cloud SIEM is `_file`.)
631633
* `ipv4-addr:value`. IPv4 IP address. (Entity type in Cloud SIEM is `_ip`.)
632634
* `ipv6-addr:value`. IPv6 IP address. (Entity type in Cloud SIEM is `_ip`.)

0 commit comments

Comments
 (0)