Home

Welcome to the DAQ documentation wiki!

DAQ (Device Automated Qualification) is a framework based on the Software Defined Networking (SDN) approach and it uses the Faucet SDN controller for multi table OpenFlow switches to automate network configuration and Internet of Things (IoT) device testing.

At the basis of the DAQ framework there is the idea to apply security principles to IP-based devices installed in the built environment throughout their lifecycle: before, during, and after construction.

Tutorials

Pre-requisites and software dependencies

To get started with DAQ and to do the tutorials you need to have a computer with at least 2GB or RAM and 10GB of free disk storage.

DAQ has many software dependencies, but it simplifies the installation to the end user by providing scripts that automate the installation of its software dependencies for basic and development mode operation.

The most important dependencies are the Faucet SDN controller, Mininet and Open vSwitch. Because Open vSwitch is based on the Linux kernel, DAQ can only run on Linux distributions.

DAQ is developed and tested on Debian GNU/linux 9.4 (Stretch) and can be used in virtual machines with an operating system installation of Debian Linux or derivative distributions such as Ubuntu linux. However, operation in virtual machines is known to have intermittent problems with configuration of network interfaces and is not recommended.

DAQ can be setup to use virtual ethernet interfaces for initial system testing and for learning purposes. For testing hardware devices, one or more ethernet ports/interfaces will be needed. These can be USB ethernet adapters. Hardware OpenFlow compliant switches are also supported for enterprise grade installations in production environments.

List of tutorials

The following list of tutorials will take you through a series of steps to configure and run DAQ.

The tutorials are divided in two sections (qualification and flow testing) and should be done sequentially.

• Device security qualification
  • Getting started with DAQ
  • Set up the DAQ dashboard
  • Using DAQ with an OpenFlow switch
• MUD file specification and flow testing
  • MUD files and ACLs
  • Device specifications and groups
  • BACnet communication testing

Reference documentation

For further information, check the reference documentation that is provided in the DAQ docs folder.

Introduction

• DAQ Readme
• Building DAQ

Configuration

• Configuration options
• Firebase dashboard installation instructions
• Network topologies
• Test lab setup
• MUD files ACL generator
• Device configuration
• Schema validator setup

Usage examples

• DAQ run log
• Packet capture of DAQ startup sequence

Testing

• Testing BACnet
• Adding a runtime test

Questions?

Join the [email protected] mailing list to post a question and participate in the discussions about using DAQ for device testing.

If you would like to report a bug or problem with using DAQ, please file and issue, including information about the context of your problem.

Further readings

• DAQ change log
• Taming the IoT: Operationalized Testing to Secure Connected Devices