Skip to content

[DOCS-11464] doc for new Users explorer #30842

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 11 commits into from
Aug 7, 2025

Conversation

michaelcretzman
Copy link
Contributor

DOCS-11464

New topic covering the new Users explorer for App and API Protection.

Merge instructions

Merge readiness:

  • Ready for merge

@michaelcretzman michaelcretzman self-assigned this Jul 31, 2025
@michaelcretzman michaelcretzman requested a review from a team as a code owner July 31, 2025 22:33
@michaelcretzman michaelcretzman added the editorial review Waiting on a more in-depth review label Jul 31, 2025
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Jul 31, 2025
Copy link
Contributor

github-actions bot commented Jul 31, 2025

📝 Documentation Team Review Required

This pull request requires approval from the @DataDog/documentation team before it can be merged.

Please ensure your changes follow our documentation guidelines and wait for a team member to review and approve your changes.

Copy link
Contributor

Preview links (active after the build_preview check completes)

New or renamed files


## Overview

Datadog App and API Protection identifies users as risks when one or more signals is associated with a user ID, email, or name.
Copy link
Contributor

Choose a reason for hiding this comment

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

The Users explorer includes all users that are associated with security traces, not signals. There are multiple ways customers can associate a user to a trace: https://docs.datadoghq.com/security/application_security/how-it-works/add-user-info/?tab=java#adding-authenticated-user-information-to-traces-and-enabling-user-blocking-capability

Copy link
Contributor

Choose a reason for hiding this comment

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

Users are identified by the @usr.id. When they are available, we also display the user name and e-mail.

Copy link
Contributor

Choose a reason for hiding this comment

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

Users aren't a risk in themselves, or at least not generally. Some risks are about the user being under attack (for instance, attempts to compromise them) where they're the victim

Copy link
Contributor

Choose a reason for hiding this comment

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

Also, if we're tracking traces, then any login attempt will cause a user to show up in there. In this case, the explorer becomes a user inventory (we then want to discourage a heavy handed approach to block any user in the explorer)

Copy link
Contributor

@brett0000FF brett0000FF left a comment

Choose a reason for hiding this comment

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

Looks good! Just left a few minor suggestions. 🚀

@@ -0,0 +1,178 @@
---
title: Users Explorer
Copy link
Contributor

Choose a reason for hiding this comment

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

Just a general note that there is inconsistent capitalization for these explorers. For example, Attackers Explorer is all uppercase on its dedicated page.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@michaelcretzman michaelcretzman merged commit 690ff73 into master Aug 7, 2025
13 of 15 checks passed
@michaelcretzman michaelcretzman deleted the mcretzman/DOCS-11464-aap-users-explorer branch August 7, 2025 20:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants