[ti_anomali] Rebrand Integration Name and Normalize Event Severity#17442
[ti_anomali] Rebrand Integration Name and Normalize Event Severity#17442mohitjha-elastic wants to merge 2 commits intoelastic:mainfrom
Conversation
|
Pinging @elastic/security-service-integrations (Team:Security-Service Integrations) |
Vale Linting ResultsSummary: 8 warnings, 4 suggestions found
|
| File | Line | Rule | Message |
|---|---|---|---|
| packages/ti_anomali/_dev/build/docs/README.md | 42 | Elastic.Latinisms | Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'. |
| packages/ti_anomali/_dev/build/docs/README.md | 45 | Elastic.DontUse | Don't use 'Please'. |
| packages/ti_anomali/_dev/build/docs/README.md | 118 | Elastic.DontUse | Don't use 'Very'. |
| packages/ti_anomali/docs/README.md | 42 | Elastic.Latinisms | Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'. |
| packages/ti_anomali/docs/README.md | 45 | Elastic.DontUse | Don't use 'Please'. |
| packages/ti_anomali/docs/README.md | 118 | Elastic.DontUse | Don't use 'Very'. |
| packages/ti_anomali/docs/README.md | 168 | Elastic.DontUse | Don't use 'very'. |
| packages/ti_anomali/docs/README.md | 217 | Elastic.DontUse | Don't use 'very'. |
💡 Suggestions (4)
| File | Line | Rule | Message |
|---|---|---|---|
| packages/ti_anomali/_dev/build/docs/README.md | 95 | Elastic.WordChoice | Consider using 'can, might' instead of 'may', unless the term is in the UI. |
| packages/ti_anomali/_dev/build/docs/README.md | 95 | Elastic.WordChoice | Consider using 'can, might' instead of 'may', unless the term is in the UI. |
| packages/ti_anomali/docs/README.md | 95 | Elastic.WordChoice | Consider using 'can, might' instead of 'may', unless the term is in the UI. |
| packages/ti_anomali/docs/README.md | 95 | Elastic.WordChoice | Consider using 'can, might' instead of 'may', unless the term is in the UI. |
The Vale linter checks documentation changes against the Elastic Docs style guide.
To use Vale locally or report issues, refer to Elastic style guide for Vale.
|
The dashboard screenshots will be updated in a subsequent PR under the separate dashboard improvement ticket that is currently in progress. |
🚀 Benchmarks reportPackage
|
| Data stream | Previous EPS | New EPS | Diff (%) | Result |
|---|---|---|---|---|
intelligence |
6944.44 | 5524.86 | -1419.58 (-20.44%) | 💔 |
To see the full report comment with /test benchmark fullreport
💚 Build Succeeded
|
| - [http_endpoint](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-http_endpoint) | ||
| - [cel](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-cel) |
There was a problem hiding this comment.
| - [http_endpoint](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-http_endpoint) | |
| - [cel](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-cel) | |
| - [HTTP Endpoint](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-http_endpoint) | |
| - [CEL](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-cel) |
|
|
||
| ### Validation | ||
|
|
||
| #### Dashboards populated |
There was a problem hiding this comment.
@alaudazzi Can you offer suggestions for this heading and the one below?
|
|
||
| ## Requirements | ||
| The Anomali ThreatStream integration is compatible with Anomali ThreatStream REST API V2.This integration also supports Anomali ThreatStream Elastic Extension. But it is **DEPRECATED** and not recommended to use. |
There was a problem hiding this comment.
| The Anomali ThreatStream integration is compatible with Anomali ThreatStream REST API V2.This integration also supports Anomali ThreatStream Elastic Extension. But it is **DEPRECATED** and not recommended to use. | |
| The Anomali ThreatStream integration is compatible with Anomali ThreatStream REST API V2. This integration also supports Anomali ThreatStream Elastic Extension. But it is **DEPRECATED** and not recommended to use. |
| - Anomali ThreatStream username | ||
| - Anomali ThreatStream API key | ||
|
|
||
| #### DEPRECATED: Collect data from Anomali ThreatStream via the Elastic Extension |
There was a problem hiding this comment.
Please include suggestions from Vale Linting Results comment
| Elastic Agent must be installed. For more details, check the Elastic Agent [installation instructions](docs-content://reference/fleet/install-elastic-agents.md). You can install only one Elastic Agent per host. | ||
|
|
||
| ## Setup | ||
| **NOTE:** The Anomali ThreatStream API's intelligence endpoint is the preferred source of indicators. This data will be accessible using the alias `logs-ti_anomali_latest.intelligence`. |
There was a problem hiding this comment.
Although this note is useful, it doesn't fit under Setup section. Can you move into How it works
| | Anomali `severity` | Severity Name | | ||
| | -------------------|---------------| | ||
| | 0 - 19 | info | | ||
| | 20 - 39 | low | | ||
| | 40 - 59 | medium | | ||
| | 60 - 79 | high | | ||
| | 80 - 100 | critical | |
There was a problem hiding this comment.
Another column with event.severity here is applicable because we derived Severity Name and can add event.severity?
|
|
||
| This source of indicators is deprecated. New users should instead use the API source above. This source requires additional software, the _Elastic_ _Extension,_ to connect Anomali ThreatStream to this integration. It's available on the [ThreatStream download page](https://ui.threatstream.com/downloads). |
There was a problem hiding this comment.
Lets add that it is deprecated here as well. So users don't overlook.
| @@ -1,5 +1,17 @@ | |||
| { | |||
| "attributes": { | |||
| "controlGroupInput": { | |||
There was a problem hiding this comment.
Regarding this comment and the current updates here: what are the changes to dashboards here?
| @@ -50,11 +50,11 @@ policy_templates: | |||
| team: security-service-integrations | |||
| inputs: | |||
| - type: cel | |||
| title: "Anomali ThreatStream API" | |||
| description: Retrieves indicators from the intelligence endpoint of the Anomali ThreatStream API | |||
| title: Collect Anomali events via the Anomali ThreatStream API | |||
There was a problem hiding this comment.
| title: Collect Anomali events via the Anomali ThreatStream API | |
| title: Collect Anomali threat indicators using the Anomali ThreatStream API |
Use using instead of via. See Vale linting comment
| - type: http_endpoint | ||
| title: "DEPRECATED: Anomali ThreatStream via the Elastic Extension software" | ||
| description: Receives Anomali ThreatStream indicators from the Elastic Extension, which is additional software | ||
| title: DEPRECATED - Collect Anomali events from ThreatStream via the Elastic Extension software |
There was a problem hiding this comment.
| title: DEPRECATED - Collect Anomali events from ThreatStream via the Elastic Extension software | |
| title: DEPRECATED - Collect Anomali threat indicators from ThreatStream via the Elastic Extension software |
Proposed commit message
Checklist
changelog.ymlfile.How to test this PR locally
Related Issues