Skip to content

docs: Defender for Containers binary-drift suppression for interactive debugging - #102

Open
Matthew Chan (matt-chan) wants to merge 1 commit into
microsoft:mainfrom
matt-chan:docs-defender-drift-suppression
Open

docs: Defender for Containers binary-drift suppression for interactive debugging#102
Matthew Chan (matt-chan) wants to merge 1 commit into
microsoft:mainfrom
matt-chan:docs-defender-drift-suppression

Conversation

@matt-chan

Copy link
Copy Markdown
Contributor

What

Adds customer guidance + deployable IaC for suppressing the expected Microsoft Defender for Containers "binary drift" alerts that occur when using Microsoft Discovery's interactive container debugging (VS Code tunnel).

To attach a debugger, Discovery downloads the VS Code CLI into the target container at runtime and runs it (plus the VS Code server it fetches on first connect). Binary drift detection flags any process started from a binary that wasn't in the container image, so these runtime-fetched binaries trigger the alert. It is expected and benign.

Contents (docs/discovery-services/defender-drift-suppression/)

  • README.md — what the alerts are, why they occur, and how to apply/verify/remove the rules
  • defender-drift-suppression.json (ARM) and .bicepaz deployment sub create
  • set-drift-suppression.sh / .ps1az rest scripts

Two subscription-scoped alert-suppression rules, scoped by the debug process command line so unrelated workloads are unaffected:

Rulecommand line containscovers
Binary-drift-vscode-cli-downloadvscode-cli.tar.gzVS Code CLI download + tar extract
Binary-drift-vscode-cli-tunnel/tmp/_debug_cVS Code CLI + server tunnel processes

All apply methods are idempotent.

Microsoft Discovery's interactive container debugging (VS Code tunnel) downloads
the VS Code CLI into the target container at runtime, which triggers expected
Microsoft Defender for Containers "binary drift" alerts. Add customer guidance
plus deployable IaC (ARM template, Bicep, and PowerShell/Bash scripts) that
create two subscription-scoped alert-suppression rules, scoped by the debug
process command line so unrelated workloads are unaffected.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@github-actionsgithub-actionsBot added update-branch PR branch is behind base — please update needs-human-review Awaiting human approval 1p-contribution Authored by Microsoft (party='1p' in metadata) pr-validation-passed The pr-review workflow's validator passed. Other status checks report separately. labels Jul 13, 2026
@github-actions

Copy link
Copy Markdown

✅ Automated Check Results — All checks passed

All structural, schema, content, documentation, and secret scan checks passed.

This PR is ready for human review. The maintainers have been automatically requested.

Reminder: 1 approval from a CODEOWNERS reviewer is required before this PR can be merged.

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

Labels

1p-contributionAuthored by Microsoft (party='1p' in metadata)needs-human-reviewAwaiting human approvalpr-validation-passedThe pr-review workflow's validator passed. Other status checks report separately.update-branchPR branch is behind base — please update

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@matt-chan