Skip to content

[Docs]7.7 SIEM doc updates#63951

Merged
benskelker merged 3 commits intoelastic:masterfrom
benskelker:7.7_siem_doc_updates
Apr 21, 2020
Merged

[Docs]7.7 SIEM doc updates#63951
benskelker merged 3 commits intoelastic:masterfrom
benskelker:7.7_siem_doc_updates

Conversation

@benskelker
Copy link
Copy Markdown
Contributor

Summary

Updates the SIEM section of the Kibana docs for 7.7.

Checklist

Delete any items that are not applicable to this PR.

  • Documentation was added for features that require explanation or tutorials. This is the docs.

[skip-ci]

@benskelker benskelker added release_note:skip Skip the PR/issue when compiling release notes v7.7.0 labels Apr 20, 2020
@benskelker
Copy link
Copy Markdown
Contributor Author

benskelker commented Apr 20, 2020

@andrew-goldstein can you review the advanced settings update? Thanks

@benskelker benskelker mentioned this pull request Apr 20, 2020
10 tasks
`siem:defaultAnomalyScore`:: The threshold above which Machine Learning job anomalies are displayed in the SIEM app.
`siem:defaultIndex`:: A comma-delimited list of Elasticsearch indices from which the SIEM app collects events.
`siem:ipReputationLinks`:: A JSON array containing links for verifying an IP
address’s reputation. The links are displayed on
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IP address's reputation > the reputation of an IP address?

Comment thread docs/siem/siem-ui.asciidoc Outdated

[float]
[[cases-ui]]
=== Cases (Beta)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggest removing Beta from the title and using this in the first line:

beta:[] Cases are used to open...

That way, you will get a definition of what it means for a feature to be in beta. If you do that, you'll also have to make the change for Detections earlier in the page.

If you keep beta in the title, we use beta (lower case b)

Comment thread docs/siem/siem-ui.asciidoc Outdated
[[cases-ui]]
=== Cases (Beta)

Cases are used to open and track security issues directly in the {siem-app}.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We try to avoid using the word app in the Kibana docs and use the name alone, in this case, SIEM.

Comment thread docs/siem/siem-ui.asciidoc Outdated
=== Cases (Beta)

Cases are used to open and track security issues directly in the {siem-app}.
They list the original reporter and all users who contribute to a case
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They > Cases ?

Comment thread docs/siem/siem-ui.asciidoc Outdated

Cases are used to open and track security issues directly in the {siem-app}.
They list the original reporter and all users who contribute to a case
(`participants`). Case comments support markdown syntax, and allow linking to
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

markdown > Markdown

@benskelker
Copy link
Copy Markdown
Contributor Author

@gchaps
thanks - corrected

Copy link
Copy Markdown
Contributor

@gchaps gchaps left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few minor nits. Otherwise, LGTM.

Comment thread docs/siem/siem-ui.asciidoc Outdated
[[cases-ui]]
=== Cases (beta)

Cases are used to open and track security issues directly in the SIEM.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the SIEM > SIEM.

Comment thread docs/siem/siem-ui.asciidoc Outdated
[[cases-ui]]
=== Cases (beta)

Cases are used to open and track security issues directly in the SIEM.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the SIEM > SIEM

Comment thread docs/siem/siem-ui.asciidoc Outdated
Cases list the original reporter and all users who contribute to a case
(`participants`). Case comments support Markdown syntax, and allow linking to
saved Timelines. Additionally, you can send cases to external systems from
within the {siem-app} (currently ServiceNow).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should also replace {siem-app} here with SIEM.

Copy link
Copy Markdown
Contributor

@KOTungseth KOTungseth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Copy Markdown
Contributor

@andrew-goldstein andrew-goldstein left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for these additions @benskelker!
LGTM 🚀

@benskelker benskelker merged commit b7aab69 into elastic:master Apr 21, 2020
@benskelker benskelker deleted the 7.7_siem_doc_updates branch April 21, 2020 17:14
benskelker added a commit to benskelker/kibana that referenced this pull request Apr 21, 2020
* SIEM section doc updates

* corrections

* more corrections
benskelker added a commit to benskelker/kibana that referenced this pull request Apr 21, 2020
* SIEM section doc updates

* corrections

* more corrections
benskelker added a commit that referenced this pull request Apr 21, 2020
* SIEM section doc updates

* corrections

* more corrections
benskelker added a commit that referenced this pull request Apr 21, 2020
* SIEM section doc updates

* corrections

* more corrections
gmmorris added a commit to gmmorris/kibana that referenced this pull request Apr 22, 2020
* master: (29 commits)
  [Dashboard] Deangularize navbar, attempt nr. 2 (elastic#61611)
  refactor action filter creation utils (elastic#62969)
  Refresh index pattern list before redirecting (elastic#63329)
  [APM]fixing custom link unit tests (elastic#64045)
  [Ingest] EPM & Fleet are enabled when Ingest is enabled (elastic#64103)
  [Alerting] Fixed bug with no possibility to edit the index name after adding (elastic#64033)
  [Maps] Map settings: min and max zoom (elastic#63714)
  [kbn-storybook] Use raw loader for text files (elastic#64108)
  [EPM] /packages/{package} endpoint to support upgrades (elastic#63629)
  [SIEM] New Platform Saved Objects Registration (elastic#64029)
  [Endpoint] Hook to handle events needing navigation via Router (elastic#63863)
  Fixed small issue in clone functionality (elastic#64085)
  [Endpoint]EMT-146: use ingest agent for status info (elastic#63921)
  [SIEM] Server NP Followup (elastic#64010)
  Register uiSettings on New Platform (elastic#64015)
  [Reporting] Integration polling config with client code (elastic#63754)
  [Docs]7.7 SIEM doc updates (elastic#63951)
  [SIEM] [Cases] Tags suggestions (elastic#63878)
  Include datasource UUID in agent config yaml, adjust overflow height of yaml view (elastic#64027)
  [DOCS] Add file size setting for Data Visualizer (elastic#64006)
  ...
gmmorris added a commit to gmmorris/kibana that referenced this pull request Apr 22, 2020
…ana into task-manager/cancel-logging

* 'task-manager/cancel-logging' of github.com:gmmorris/kibana: (28 commits)
  [Dashboard] Deangularize navbar, attempt nr. 2 (elastic#61611)
  refactor action filter creation utils (elastic#62969)
  Refresh index pattern list before redirecting (elastic#63329)
  [APM]fixing custom link unit tests (elastic#64045)
  [Ingest] EPM & Fleet are enabled when Ingest is enabled (elastic#64103)
  [Alerting] Fixed bug with no possibility to edit the index name after adding (elastic#64033)
  [Maps] Map settings: min and max zoom (elastic#63714)
  [kbn-storybook] Use raw loader for text files (elastic#64108)
  [EPM] /packages/{package} endpoint to support upgrades (elastic#63629)
  [SIEM] New Platform Saved Objects Registration (elastic#64029)
  [Endpoint] Hook to handle events needing navigation via Router (elastic#63863)
  Fixed small issue in clone functionality (elastic#64085)
  [Endpoint]EMT-146: use ingest agent for status info (elastic#63921)
  [SIEM] Server NP Followup (elastic#64010)
  Register uiSettings on New Platform (elastic#64015)
  [Reporting] Integration polling config with client code (elastic#63754)
  [Docs]7.7 SIEM doc updates (elastic#63951)
  [SIEM] [Cases] Tags suggestions (elastic#63878)
  Include datasource UUID in agent config yaml, adjust overflow height of yaml view (elastic#64027)
  [DOCS] Add file size setting for Data Visualizer (elastic#64006)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release_note:skip Skip the PR/issue when compiling release notes v7.7.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants