Skip to content

Conversation

@AmudaPalani
Copy link

Device Health Dashboard Implementation

Overview

This PR introduces a new Python script that creates an interactive device health dashboard using data from the Microsoft Defender for Endpoint API. The dashboard combines device health metrics and detailed device information in a single HTML view.

Key Features

  • Interactive dashboard showing 5 key device health metrics:
    • Overall Health Status
    • Sensor Status
    • Sensor Communication
    • Sensor Data Collection
    • Cloud Connectivity
  • Comprehensive device table with important details including:
    • Computer DNS Name
    • OS Platform
    • Version
    • Health Status
    • Onboarding Status
    • IP Addresses
    • Last Seen Time
  • Secure credential handling using environment variables and user prompts
  • Auto-generated HTML output with interactive visualizations

Implementation Details

  • Uses plotly for interactive visualizations
  • Implements secure OAuth2 authentication for API access
  • Organizes data in a two-row layout:
    • Top row: Five donut charts showing health metrics
    • Bottom row: Detailed device information table
  • Automatically opens the dashboard in the default web browser

Security Considerations

  • No hardcoded credentials
  • Secure credential input using getpass
  • Environment variable support for automated scenarios

Testing

The script has been tested with:

  • Live data from Microsoft Defender for Endpoint API
  • Various device health states

Documentation

The code includes comprehensive docstrings and comments explaining the functionality of each component.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant