Skip to content

[M365 Defender] Update documentation as per new template - #16152

Merged
moxarth-rathod merged 10 commits into
elastic:mainfrom
moxarth-rathod:m365-documentation-16130
Dec 9, 2025
Merged

[M365 Defender] Update documentation as per new template#16152
moxarth-rathod merged 10 commits into
elastic:mainfrom
moxarth-rathod:m365-documentation-16130

Conversation

@moxarth-rathod

@moxarth-rathod moxarth-rathod commented Nov 28, 2025

Copy link
Copy Markdown
Contributor

Proposed commit message

m365_defender: update documentation as per new template

The vulnerability data stream now uses the SoftwareVulnerabilitiesExport API
instead of separate vulnerabilities, machines, and software APIs. This change
simplifies the data collection process and aligns with Microsoft's recommended
approach for vulnerability assessment exports.

Also removes "(Recommended)" labels from Event and Incidents data streams.

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.
  • I have verified that any added dashboard complies with Kibana's Dashboard good practices

Related issues

@moxarth-rathod moxarth-rathod self-assigned this Nov 28, 2025
@moxarth-rathod moxarth-rathod added the documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. label Nov 28, 2025
@moxarth-rathod
moxarth-rathod requested a review from a team as a code owner November 28, 2025 08:38
@moxarth-rathod moxarth-rathod added enhancement New feature or request Integration:m365_defender Microsoft Defender XDR Team:Security-Service Integrations Security Service Integrations team [elastic/security-service-integrations] Team:SDE-Crest Crest developers on the Security Integrations team [elastic/sit-crest-contractors] labels Nov 28, 2025
@elasticmachine

Copy link
Copy Markdown

Pinging @elastic/security-service-integrations (Team:Security-Service Integrations)

@moxarth-rathod moxarth-rathod added Integration:microsoft_defender_endpoint Microsoft Defender for Endpoint Integration:m365_defender Microsoft Defender XDR and removed Integration:m365_defender Microsoft Defender XDR Integration:microsoft_defender_endpoint Microsoft Defender for Endpoint labels Nov 28, 2025
@elastic-vault-github-plugin-prod

Copy link
Copy Markdown
Contributor

🚀 Benchmarks report

To see the full report comment with /test benchmark fullreport

Comment thread packages/m365_defender/docs/README.md Outdated
Comment on lines -70 to -71
- [Vulnerabilities API](https://learn.microsoft.com/en-us/defender-endpoint/api/get-all-vulnerabilities) (Last updated On 04/25/2024)
- [Machines API](https://learn.microsoft.com/en-us/defender-endpoint/api/get-machines) (Last updated On 03/01/2025)

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.

It would be good to include in the commit message why these have been removed.

@moxarth-rathod
moxarth-rathod requested a review from efd6 December 1, 2025 11:54

@efd6 efd6 left a comment

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.

I think this needs documentation to be regenerated.

Also suggest this for the commit message:

m365_defender: update vulnerability data stream documentation

The vulnerability data stream now uses the SoftwareVulnerabilitiesExport API
instead of separate vulnerabilities, machines, and software APIs. This change
simplifies the data collection process and aligns with Microsoft's recommended
approach for vulnerability assessment exports.

Also removes "(Recommended)" labels from Event and Incidents data streams.
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/changelog.yml Outdated
Comment thread packages/m365_defender/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md
@moxarth-rathod moxarth-rathod changed the title [M365 Defender] Update documentation for Vulnerability data stream Dec 2, 2025
Comment thread packages/m365_defender/changelog.yml Outdated
Co-authored-by: Dan Kortschak <dan.kortschak@elastic.co>
### How it works

For example, you could use the data from this integration to consolidate and correlate security alerts from multiple sources. Also, by looking into the alert, incident, and vulnerability a user can take an appropriate action in the Microsoft Defender XDR Portal.
The integration works by collecting data from the Microsoft Azure Event Hub, Microsoft Graph Security v1.0 REST API, and the Microsoft Defender Endpoint API. Then visualise that data in Kibana.

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.

Suggested change
The integration works by collecting data from the Microsoft Azure Event Hub, Microsoft Graph Security v1.0 REST API, and the Microsoft Defender Endpoint API. Then visualise that data in Kibana.
The integration works by collecting data from the Microsoft Azure Event Hub, Microsoft Graph Security v1.0 REST API, and the Microsoft Defender Endpoint API.

Doesn't add much context here. You can move this to Supported usecases section.
Example

Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated

@kcreddy kcreddy left a comment

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.

Few nits.

Comment thread packages/m365_defender/_dev/build/docs/README.md
Comment thread packages/m365_defender/_dev/build/docs/README.md Outdated
@elasticmachine

Copy link
Copy Markdown

💚 Build Succeeded

History

cc @moxarth-rathod

@moxarth-rathod
moxarth-rathod merged commit 19c6148 into elastic:main Dec 9, 2025
8 checks passed
@elastic-vault-github-plugin-prod

Copy link
Copy Markdown
Contributor

Package m365_defender - 5.3.0 containing this change is available at https://epr.elastic.co/package/m365_defender/5.3.0/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. enhancement New feature or request Integration:m365_defender Microsoft Defender XDR Team:SDE-Crest Crest developers on the Security Integrations team [elastic/sit-crest-contractors] Team:Security-Service Integrations Security Service Integrations team [elastic/security-service-integrations]

4 participants