From ec73ce3ad4c75d4ca628394cb51cee89e68809d8 Mon Sep 17 00:00:00 2001
From: Hannah Ward <Hannah.ward9001@gmail.com>
Date: Wed, 5 Apr 2017 12:00:00 +0100
Subject: [PATCH] new: Added basic binary file taxonomy. Fixes #59

---
 binary-class/README.md       | 25 +++++++++++++++++++++++++
 binary-class/machinetag.json | 30 ++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 binary-class/README.md
 create mode 100644 binary-class/machinetag.json

diff --git a/binary-class/README.md b/binary-class/README.md
new file mode 100644
index 0000000..cb2b59d
--- /dev/null
+++ b/binary-class/README.md
@@ -0,0 +1,25 @@
+# Binary Classification
+
+Custom taxonomy for tagging of known binary files
+
+## type
+
+<dl>
+<dt>good</dt>
+<dd>Known good/safe</dd>
+<dt>bad</dt>
+<dd>Known bad/malicious<dd>
+<dt>unknown</dt>
+<dd>Not yet known</dd>
+</dl>
+
+# Machine-parsable Binary Taxonomy
+
+The repository contains a [JSON file including the machine-parsable tags](machinetag.json)
+along with their human-readable description. The software can use both
+representation on the user-interface and store the tag as machine-parsable.
+
+~~~~
+binary-class:type="good"
+~~~~
+
diff --git a/binary-class/machinetag.json b/binary-class/machinetag.json
new file mode 100644
index 0000000..31a38e1
--- /dev/null
+++ b/binary-class/machinetag.json
@@ -0,0 +1,30 @@
+{
+  "namespace": "binary-class",
+  "description": "Custom taxonomy for types of binary file.",
+  "version": 1,
+  "predicates": [
+    {
+      "value": "type",
+      "expanded": "Binary Type"
+    }
+  ],
+  "values": [
+    {
+      "predicate": "type",
+      "entry": [
+        {
+          "value": "good",
+          "expanded": "Known Good/Safe"
+        },
+        {
+          "value": "malicious",
+          "expanded": "Known Bad/Malicious"
+        },
+        {
+          "value": "unknown",
+          "expanded": "Not yet known"
+        }
+      ]
+    }
+  ]
+}