Skip to content

Lateral movement detection package #4833

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 19 commits into from
Dec 20, 2022

Conversation

sodhikirti07
Copy link
Contributor

@sodhikirti07 sodhikirti07 commented Dec 15, 2022

What does this PR do?

This PR adds Lateral movement detection assets to the integration packages list.

Checklist

  • I have reviewed tips for building integrations and this pull request is aligned with them.
  • I have verified that all data streams collect metrics or logs.
  • I have added an entry to my package's changelog.yml file.
  • I have verified that Kibana version constraints are current according to guidelines.

Author's Checklist

  • [ ]

How to test this PR locally

Related issues and docs

elastic/security-ml#167
elastic/security-team#2933
https://docs.google.com/document/d/1aGB55YGVvIhMaa52uLr2CErTiifsRfb7gp2EZAJ1efQ/edit#heading=h.kgcaafk0hh1h
https://docs.google.com/document/d/14qliB7-hevPVNKX5SM1z6_gKhzVrbgb6G8wHZvMBNXs/edit

Screenshots

@sodhikirti07
Copy link
Contributor Author

Tested the package and following are some screenshots for the assets working as expected:

  • Package added as an integration

image

  • ML jobs installed and started successfully

image

image

  • Detection rules are successfully imported

image

@elasticmachine
Copy link

elasticmachine commented Dec 15, 2022

💚 Build Succeeded

the below badges are clickable and redirect to their specific view in the CI or DOCS
Pipeline View Test View Changes Artifacts preview preview

Expand to view the summary

Build stats

  • Start Time: 2022-12-20T19:51:17.951+0000

  • Duration: 13 min 46 sec

🤖 GitHub comments

Expand to view the GitHub comments

To re-run your PR in the CI, just comment with:

  • /test : Re-trigger the build.

@sodhikirti07
Copy link
Contributor Author

I have kept the version of release as experimental based on the discussion I had with Jake yesterday. The idea is to release the package in technical review first to investigate if the rules create a lot of noise. This can be done by tracking the alerts telemetry. Please let me know your thoughts.

conditions:
kibana.version: "^8.0.0"
screenshots:
- src: /img/sample-screenshot.png
Copy link
Member

Choose a reason for hiding this comment

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

I think we don't need this placeholder Elastic logo screenshot anymore since we have any actual screenshot?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, thanks for pointing it out. I meant to delete it earlier.

@cla-checker-service
Copy link

cla-checker-service bot commented Dec 16, 2022

💚 CLA has been signed

Copy link
Contributor

@szeitlin szeitlin left a comment

Choose a reason for hiding this comment

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

suggested change - someone who knows more about product stuff should also review it and make sure it's ok to use direct instructions, rather than this very soft optional language that was there before.

Co-authored-by: Sam Zeitlin <samantha.zeitlin@elastic.co>
@sodhikirti07
Copy link
Contributor Author

sodhikirti07 commented Dec 16, 2022

@szeitlin Can we ask Sourin about this when he is back? Should we wait for his feedback?

@szeitlin
Copy link
Contributor

@szeitlin Can we ask Sourin about this when he is back? Should we wait for his feedback?

I don't know that we want to wait that long. Maybe @approksiu or @MikePaquette can give us their expert opinion so we can get unblocked sooner?

Copy link
Contributor

@ajosh0504 ajosh0504 left a comment

Choose a reason for hiding this comment

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

@sodhikirti07 Overall, looks great! 🥇

Left some suggestions. Could you also paste screenshots:

  • To show that the ML job module shows up as expected based on the query in the module json
  • To show that the ML module is installed successfully without errors
  • To show that runtime mappings are being added and working as expected
  • To show that rules are enabled without errors

sodhikirti07 and others added 4 commits December 19, 2022 12:02
Co-authored-by: Apoorva Joshi <30438249+ajosh0504@users.noreply.github.com>
Co-authored-by: Apoorva Joshi <30438249+ajosh0504@users.noreply.github.com>
Co-authored-by: Apoorva Joshi <30438249+ajosh0504@users.noreply.github.com>
Co-authored-by: Apoorva Joshi <30438249+ajosh0504@users.noreply.github.com>
@MikePaquette
Copy link

suggested change - someone who knows more about product stuff should also review it and make sure it's ok to use direct instructions, rather than this very soft optional language that was there before.

I prefer the more direct language, but let's get the opinion of our tech documentation team, since they are experts in ensuring we use consistent style and language.

@jmikell821 can you or a member of your team review/edit the instructions mentioned above #4833 (review) ? Thanks in advance.

@sodhikirti07
Copy link
Contributor Author

Left some suggestions. Could you also paste screenshots:

To show that the ML job module shows up as expected based on the query in the module json
To show that the ML module is installed successfully without errors
To show that runtime mappings are being added and working as expected
To show that rules are enabled without errors

@ajosh0504 I think I've already covered the 1,2,4 screenshots here. Will do the screenshot of runtime mappings. Please let me know if you're implying something else here.

@sodhikirti07
Copy link
Contributor Author

  • ML module and jobs working properly:

image
image

  • Detection rules started without any warnings:

image

  • Mapping for file_directory working as expected in the datafeed

image

@sodhikirti07
Copy link
Contributor Author

@ajosh0504 made changes as suggested. Please have a look.

Copy link
Contributor

@ajosh0504 ajosh0504 left a comment

Choose a reason for hiding this comment

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

Few more minor nits. Sorry! 😬

@approksiu
Copy link
Contributor

@szeitlin Can we ask Sourin about this when he is back? Should we wait for his feedback?

I don't know that we want to wait that long. Maybe @approksiu or @MikePaquette can give us their expert opinion so we can get unblocked sooner?

I like the strong language - I see that our users look up to us for recommendations how should they set things up. Let's also see what the docs team thinks.

Copy link
Contributor

@ajosh0504 ajosh0504 left a comment

Choose a reason for hiding this comment

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

Awesome! 🚢

@szeitlin
Copy link
Contributor

@sodhikirti07 do you know who/where to ask re: having the docs team review this?

Copy link
Contributor

@benironside benironside left a comment

Choose a reason for hiding this comment

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

Overall the README looks good. Made a couple of minor suggestions. No problems with the imperative language, that's standard for instructions.

sodhikirti07 and others added 2 commits December 20, 2022 14:42
Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
@sodhikirti07
Copy link
Contributor Author

Shipping this package as experimental for 8.6. Below are a couple of things to do before moving it to ga in 8.7:

  • Add dashboard in the package spec
  • Attach a blog-post for lateral movement

@sodhikirti07 sodhikirti07 merged commit ee5b7a7 into main Dec 20, 2022
@elasticmachine
Copy link

Package lmd - 0.0.1 containing this change is available at https://epr.elastic.co/search?package=lmd

@CyberTaoFlow
Copy link

seems like zeek and/or suricata SMB traffic could be useful for providing the network viewpoint independent of agent telemetry.
One point to consider is there will be a need to perform correlation with kerberos or ntlm logs from these same tools to obtain the user information used as an influencing attribute in the current jobs.

@andrewkroh andrewkroh added Integration:lmd Lateral Movement Detection New Integration Issue or pull request for creating a new integration package. labels Aug 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Integration:lmd Lateral Movement Detection New Integration Issue or pull request for creating a new integration package.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants