Skip to content

Latest commit

 

History

History
54 lines (39 loc) · 2.42 KB

README.md

File metadata and controls

54 lines (39 loc) · 2.42 KB
Raw

MUD Aggregator

This repository contains the MUD Aggregator, a Home Assistant integration capable of merging together a set of MUD snippets to generate a consolidated gateway-level MUD file. The snippets should be provided by plug-in developers and have to be written in a MUD-like format.

An example of MUD snippet is available in the examples folder.

Note: this is a preliminary version. This is an on-going research activity.

How to use it

The first thing to do for using the MUD Aggregator is to copy the mud_aggregator folder inside config/custom_components folder of your Home Assistant.

The MUD Aggregator is configurable as a button integration. Once configured, you can generate and expose the gateway-level MUD file pressing the related button.

The parameter that you have to confire are the followings:

  • name [optional]: to give a custom name to the button;
  • interface [optional]: specify the network interface used by your HAss instance (default is eth0);
  • deploy [optional]: specify if Home Assistant is running in a core/devcontainer (core) or on a board or virtual machine (custom). Default value is core.

Here you can find a confiration example to copy and paste inside configuration.yaml file of Home Assistant.

button:
  - platform: mud_aggregator
    name: MUD Aggregator
    interface: eth0
    deploy: core

Citing related papers

This PoC was originally presented to SpliTech 2023. For citing the paper you can import the following BibTex:

@inproceedings{CornoMannella2023GWMUD,
  title={A Gateway-based MUD Architecture to Enhance Smart Home Security},
  author={Corno, Fulvio and Mannella, Luca},
  booktitle={Proceedings of the 8th International Conference on Smart and Sustainable Technologies--SpliTech 2023},
  pages={1--6},
  year={2023}, month={June},
  organization={Institute of Electrical and Electronics Engineers (IEEE)},
  keywords = {Cybersecurity, Gateways, Home Assistant, Internet of Things, Manufacturer Usage Description, Smart Home},
  doi = {10.23919/SpliTech58164.2023.10193747}
}

You can access the paper at the following links: