mcpField
D
defender-easm

defender-easm

github.com/vinayaklattheSecurity17842 installsUpdated 19w ago
Repository

About defender-easm

defender-easm is a skill for using Microsoft Defender External Attack Surface Management to discover and assess an organization's internet-facing assets. It supports security teams with inventory review, risk prioritization, and monitoring workflows.

Key features

  1. 01通过种子发现外部资产
  2. 02管理已批准、候选与依赖资产
  3. 03识别证书、服务与漏洞风险
  4. 04按业务单元和重要性标记资产
  5. 05制定周期性复核与修复流程

Use cases

  1. 01并购尽调时盘点目标公司的互联网资产
  2. 02查找即将过期的 SSL 证书和暴露服务
  3. 03将发现结果整理为资产负责人修复清单

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vinayaklatthe/microsoft-security-skills --skill defender-easm

After installing, type/defender-easmin Claude Code to confirm it loaded.

Details

From the project README

Microsoft Defender EASM

Defender External Attack Surface Management (EASM) builds and maintains a continuous, outside-in inventory of an organization's internet-facing footprint and surfaces risks on those assets — expired SSL certs, exposed admin interfaces, end-of-life web tech, and known CVEs — without any agent or credentials.

When to use

  • You don't have a complete list of internet-facing assets (most orgs don't).
  • M&A: rapid discovery of an acquired company's internet footprint before integration.
  • Subsidiary / shadow IT discovery — assets registered to anyone, deployed anywhere.
  • Continuous monitoring of certificate expiration, exposed services, deprecated software.

Do not use this skill for internal asset posture (defender-for-cloud-hardening), endpoint vulnerability management (defender-for-endpoint), or generic SOC hunting (sentinel-detection-engineering).

How discovery works

EASM starts from seeds — known domains, IPs, ASNs, contacts (WHOIS), or organization names — and walks outward through DNS, WHOIS, certificate transparency logs, ASN data, and web crawling to discover related assets. Findings are placed in:

StateMeaning
Approved InventoryConfirmed yours; counts toward pricing
CandidateDiscovered but unconfirmed; review and approve/dismiss
DependencyUsed by your assets but not owned (CDN, third-party API)
Monitor OnlyTracked but not yours (e.g., a partner)

Rule of thumb: Start with 5–10 high-confidence seeds. Trust the discovery chain; don't try to add every domain manually — you'll miss the unknown unknowns.

Approach

  1. Seed selection. Start with primary brand domains, top-2 ASN numbers, and a few key email-domain WHOIS contacts. Avoid generic CDN domains as seeds (massive false positives).

  2. Initial discovery run (24–72 hours). Review Candidates weekly for the first month. Approve real ones; dismiss false positives with a reason (used to refine discovery).

  3. Label and group. Tag assets by business unit, region, criticality. Without labels, risk views are unactionable.

  4. Attack surface insights — fix high-impact first. Priority order:

    1. Exposed sensitive services (RDP/3389, SMB/445, database ports) on internet IPs.
    2. Expired or expiring SSL certs within 30 days.
    3. End-of-life software (Apache 2.2, IIS 7, OpenSSL 1.0).
    4. High/critical CVEs with known exploits on identified versions.
    5. Unsanctioned cloud — assets in a CSP not in your approved list.
  5. Integrate with the rest of the portfolio.

    • Defender for Cloud (CSPM) — EASM-discovered Azure assets correlate to Azure resources for full inside+outside view.
    • Defender XDR — exposed assets appear under attack-surface insights.
    • Sentinel — pull EASM data via REST API into a watchlist for hunting (e.g., "alert if outbound C2 destination matches an EASM-known dependency owned by us").
  6. M&A workflow. Add target-company seeds during diligence; export the candidate list as a tracked risk register for integration. Don't approve into inventory until close.

  7. Re-baseline quarterly. Brand consolidation, decommissioned subs, divested BUs all change the seed list.

Guardrails

  • Approve carefully — every approval = billed asset. Treat dismiss-with-reason as important as approve; refines future discovery and controls cost.
  • Pricing is per asset/month with a generous monthly free tier; understand the meter before mass-approving CDN dependencies.
  • EASM is detection, not response. It tells you the exposed RDP exists; closing the port is a network/firewall change you must make elsewhere.
  • Do not seed competitor domains "to compare." Discovery walks aggressively; you'll create attribution noise.
  • Don't expect zero-day vuln detection. EASM matches versions to known CVEs from public banners — a stripped banner hides risk. Pair with internal vuln scanning.
  • WHOIS data quality varies by registrar / privacy-shielding. Some assets won't attribute via WHOIS — accept some manual approval workload.
  • Re-discovery cadence is days, not minutes. Don't expect EASM to catch a 1-hour exposure window; that's runtime monitoring's job.

Common anti-patterns

  • "Approved every candidate to be safe" — bill explosion and noise. Approve only yours; dismiss the rest.
  • "Seeds = every domain we've ever owned, including divested ones" — divested assets show up as attack surface forever. Re-baseline.
  • "Used EASM as the only vuln scanner" — banner-based, no auth, misses internal. Combine with MDVM/MDE.
  • "Skipped labelling, dashboards became unusable at 10K assets" — label on day 1.
  • "Treated EASM findings as alerts to triage in the SOC queue" — they're posture, not incidents. Route to asset-owner remediation, not L1 triage.
  • "Used internal asset names as seeds" — they don't resolve externally; no discovery.

Example prompts

  • Set up Defender EASM for a 3-brand global enterprise — seed strategy and labels.
  • Run an EASM discovery for an acquisition target and produce a 30-day risk register.
  • Surface expiring SSL certs in the next 30 days across approved inventory and assign to asset owners.
  • Find exposed RDP/SSH on internet-facing assets and route findings to the network team.
  • Integrate EASM data into Sentinel as a watchlist for hunting outbound C2 to owned dependencies.
  • Identify unsanctioned cloud usage (assets in clouds outside the approved list).
  • Estimate monthly cost for a 50,000-asset external footprint.

Microsoft Learn

Comments

Markdown supported