Tech Details

2-June-2022 DC CAW

Tech Details

OpenC2 Transfer Specifications

The mechanisms for exchanging OpenC2 Request (i.e., command) and Response messages are defined in transfer specifications. The OpenC2 TC has published two transfer specifications as OASIS Committee Specifications, documenting the use of HTTPS and MQTT version 5.0.

Here are links to the currently published specifications:

  At OASIS At GitHub
MQTT HTML Markdown
HTTPS HTML Markdown

Due to the complexities of establishing certificate-based mutual authentication for HTTPS, MQTT is the preferred transfer protocol for interoperability testing at the CAW. Participants should become familiar with the transfer specification’s requirements, especially the topic structure. However, flexibility in the use of topics is also potentially helpful during the plugfest (e.g., if there’s a need to create separate communities using a single message broker) so configurability is a desirable feature when implementing MQTT for OpenC2.

MQTT

MQTT is a message transfer protocol standardized under OASIS. The MQTT Transfer Specification uses MQTT version 5.0, as features added in that version of the protocol address OpenC2 needs. The HiveMQ website has an excellent collection of material about MQTT, addressing both versions 3.1.1 and 5.0.

Message Brokers

HII has established MQTT and OpenDXL message brokers on Google Cloud Platform for use by CAW participants. Access details for these brokers is available in a pinned message on our Discord #plugfest channel. If you are not a member of our Discord, contact one of the HII participants for an invitation or to be sent the information directly.

Specifics for the process of connecting to the brokers is on the following pages:

Device and Attribute Repository

DoD has established a device information and security attribute repository on Amazon Web Services.

Connection process:

return to Home