From 873794825c22c1ba000d746770e6f2a73a2642ca Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 11:28:41 -0400 Subject: [PATCH 01/26] OASIS-ifying Added boilerplate to make valid OASIS working document --- glossary.md | 154 +++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 153 insertions(+), 1 deletion(-) diff --git a/glossary.md b/glossary.md index 64463a3..a0ddbe4 100644 --- a/glossary.md +++ b/glossary.md @@ -1,3 +1,5 @@ +delete next few lines once others in place + Other than these first few lines, the document below is the same as the document appoved by the OpenC2 forum. For OASIS OpenC2 TC, this will be considered version 0.1.0 @@ -5,6 +7,142 @@ and considered the baseline. ------ +put in logo + +Version 0.1.2 (centered) + +OpenC2 Glossary + +# 0. Preface + +25-August-2017 (update once 0.1.2 stable) + +## 0.1 Technical Committee: +OASIS OpenC2 Technical Committee +Chair: + * Joe Brule (jmbrule@nsa.gov), National Security Agency + * Sounil Yu (sounil.yu@bankofamerica.com), Bank of America + +## 0.2 Editors: + * Duncan Sparrell (duncan@sfractal.com), sFractal Consulting LLC + +## 0.3 Related Work: +This glossary is related to: + * TODO: reference language spec + * TODO: reference profiles + * TODO: reference implementation docs + +## 0.4 Abstract: + +This Glossay is non-normative and is to inform readers +of the OpenC2 specifications. + +Cyberattacks are increasingly sophisticated, less expensive to execute, +dynamic and automated. +The provision of cyberdefense via statically configured products +operating in isolation is no longer tenable. +Standardized interfaces, protocols and data models +will facilitate the integration of the functional blocks +within a system or enterprise. +Open Command and Control (OpenC2) is a concise and extensible language +to enable the command and control of cyber defense components, +subsystems and/or systems in a manner +that is agnostic of the underlying products, +technologies, transport mechanisms or other aspects of the implementation. +The motivation behind OpenC2 was to enable +command and control of cyber defense and recognizes it should +be understood that a language such as OpenC2 is necessary +but insufficient to enable coordinated cyber response. +Other aspects of coordinated cyber response such as sensing, +analytics, and selecting appropriate +courses of action are beyond the scope of OpenC2. + +## 0.5 Status: + +This Working Draft (WD) has been produced by one or more TC Members; +it has not yet been voted on by the TC +or approved as a Committee Draft +(Committee Specification Draft or a Committee Note Draft). +The OASIS document Approval Process begins officially with a +TC vote to approve a WD as a Committee Draft. +A TC may approve a Working Draft, revise it, +and re-approve it any number of times as a Committee Draft. + + +## 0.6 URI patterns: + +Initial publication URI: + +Permanent “Latest version” URI: + +## 0.7 Copyright +(Managed by OASIS TC Administration; please don’t modify.) +Copyright © OASIS Open 2017. All Rights Reserved. +All capitalized terms in the following text have the meanings assigned to them in the +OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). +The full Policy may be found at the OASIS website. +This document and translations of it may be copied and furnished to others, +and derivative works that comment on or otherwise explain it +or assist in its implementation may be prepared, copied, published, and distributed, +in whole or in part, without restriction of any kind, +provided that the above copyright notice and this section are included +on all such copies and derivative works. However, this document itself +may not be modified in any way, including by removing the copyright notice +or references to OASIS, except as needed for the purpose of developing any +document or deliverable produced by an OASIS Technical Committee +(in which case the rules applicable to copyrights, +as set forth in the OASIS IPR Policy, must be followed) +or as required to translate it into languages other than English. +The limited permissions granted above are perpetual +and will not be revoked by OASIS or its successors or assigns. +This document and the information contained herein is provided on an +"AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION +HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF +MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +------ +put in table of contents +------ + +------ +put in table of Figures +------ + +# 1. Introduction + +blah + +## 1.1 Goal + +blah + +## 1.2 Purpose and Scope + +blah + +## 1.3 Terminology + +blah + +## 1.4 Normative References + +## 1.5 Non-normative References + +## 1.6 Conformance + +## 1.7 Acknoledgments + +# 2. Context + +# 3. Glossary + + + + + + + This is the OpenC2 dictionary/glossary. It is in very draft form - don’t look at it yet @@ -38,6 +176,7 @@ Need style guide for glossary Should it be wiki instead of google doc? +## 3.1 A-E **Action** - (A) In context of openC2, “action” is sometime used as part of normal english e.g. @@ -105,6 +244,9 @@ In the example below the firewall is told to block (action=deny) an ip. **Enterprise** - +## 3.2 F-I + + **Firewall** -in the context of openC2, firewall denotes the firewall functionality of an actuator ie hardware and/or software system that monitors incoming and outgoing network traffic and controls that traffic (eg logs, blocks, allows) based on security policy defined by a set of rules. **Hacker** - White or Black Hat, Red/Blue/Purple Team @@ -126,6 +268,8 @@ See https://secwww.jhuapl.edu/iacdcommunityday/Resources/IACD%20Baseline%20Refer **ITU** - +## 3.3 J-N + **JADN** - **JAEN** - @@ -150,6 +294,8 @@ compiler, linkage editor, or executive routine. **NIST** - National Institute of Standards - an agency of the US federal government +## 3.4 O-R + **OASIS** - duh? **Ocas** - link to a particular openC2 simulator implemented in erlang @@ -179,6 +325,9 @@ that enable computer hardware to perform computational or control functions.” **Response** - + +## 3.5 S-Z + **SDN** - Software Defined Network **Security** - ? @@ -222,4 +371,7 @@ ISO/IEC 24765:2009 defines software as: **Yuuki** - - +# 4. Bibliography & Endnotes3. Bibliography & Endnotes + 1. make this a list of anything referenced + 1. and any endnotes + 1. will need to keep in sync unless MD can do it automagically From eebdfb2fdb163d8e8b41520f56087bd7d094ba65 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 11:38:05 -0400 Subject: [PATCH 02/26] Add table of contents generated using http://doctoc.herokuapp.com --- glossary.md | 33 ++++++++++++++++++++++++++++++--- 1 file changed, 30 insertions(+), 3 deletions(-) diff --git a/glossary.md b/glossary.md index a0ddbe4..a1ca5f9 100644 --- a/glossary.md +++ b/glossary.md @@ -101,9 +101,36 @@ INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ------- -put in table of contents ------- +## 0.8 Table of Contents + +**Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)* + +- [0. Preface](#) + - [0.1 Technical Committee:](#) + - [0.2 Editors:](#) + - [0.3 Related Work:](#) + - [0.4 Abstract:](#) + - [0.5 Status:](#) + - [0.6 URI patterns:](#) + - [0.7 Copyright](#) + - [put in table of contents](#) + - [put in table of Figures](#) +- [1. Introduction](#) + - [1.1 Goal](#) + - [1.2 Purpose and Scope](#) + - [1.3 Terminology](#) + - [1.4 Normative References](#) + - [1.5 Non-normative References](#) + - [1.6 Conformance](#) + - [1.7 Acknoledgments](#) +- [2. Context](#) +- [3. Glossary](#) + - [3.1 A-E](#) + - [3.2 F-I](#) + - [3.3 J-N](#) + - [3.4 O-R](#) + - [3.5 S-Z](#) +- [4. Bibliography & Endnotes3. Bibliography & Endnotes](#) ------ put in table of Figures From 6efb3e53b1a91c5f42747a8659ca8dd0ac75eb2e Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 11:54:59 -0400 Subject: [PATCH 03/26] experimenting --- glossary.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/glossary.md b/glossary.md index a1ca5f9..b74c992 100644 --- a/glossary.md +++ b/glossary.md @@ -103,6 +103,8 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ## 0.8 Table of Contents +[ToC] + **Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)* - [0. Preface](#) @@ -122,7 +124,7 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - [1.4 Normative References](#) - [1.5 Non-normative References](#) - [1.6 Conformance](#) - - [1.7 Acknoledgments](#) + - [1.7 Acknowledgments](#) - [2. Context](#) - [3. Glossary](#) - [3.1 A-E](#) @@ -158,7 +160,7 @@ blah ## 1.6 Conformance -## 1.7 Acknoledgments +## 1.7 Acknowledgments # 2. Context From 4f076667a128213de058640fc85ebcd287e735aa Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 12:00:04 -0400 Subject: [PATCH 04/26] another toc experiment --- glossary.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/glossary.md b/glossary.md index b74c992..2b61619 100644 --- a/glossary.md +++ b/glossary.md @@ -103,8 +103,6 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ## 0.8 Table of Contents -[ToC] - **Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)* - [0. Preface](#) @@ -131,8 +129,8 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - [3.2 F-I](#) - [3.3 J-N](#) - [3.4 O-R](#) - - [3.5 S-Z](#) -- [4. Bibliography & Endnotes3. Bibliography & Endnotes](#) + - [3.5 S-Z](#35S-Z) +- [4. Bibliography and Endnotes(#4bibliographyandendnotes) ------ put in table of Figures @@ -400,7 +398,7 @@ ISO/IEC 24765:2009 defines software as: **Yuuki** - -# 4. Bibliography & Endnotes3. Bibliography & Endnotes +# 4. Bibliography and Endnotes 1. make this a list of anything referenced 1. and any endnotes 1. will need to keep in sync unless MD can do it automagically From 6d289ba031ffb22ae0ad5c9bb692941ab5859ae0 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 12:11:02 -0400 Subject: [PATCH 05/26] trivial edits --- glossary.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/glossary.md b/glossary.md index 2b61619..c526ee3 100644 --- a/glossary.md +++ b/glossary.md @@ -1,17 +1,14 @@ -delete next few lines once others in place - -Other than these first few lines, the document below is the same -as the document appoved by the OpenC2 forum. -For OASIS OpenC2 TC, this will be considered version 0.1.0 -and considered the baseline. - ------ put in logo +------ Version 0.1.2 (centered) -OpenC2 Glossary +------ +

+#OpenC2 Glossary +

# 0. Preface From 4014894b6f4662fe855b6217b68ffbebc099a2df Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:05:19 -0400 Subject: [PATCH 06/26] formatting --- glossary.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/glossary.md b/glossary.md index c526ee3..e130a73 100644 --- a/glossary.md +++ b/glossary.md @@ -1,13 +1,14 @@ ------- - put in logo ------ -Version 0.1.2 (centered) ------

-#OpenC2 Glossary +**OpenC2 Glossary** +

+ +

+Version 0.1.2

# 0. Preface From fec986ffb6b58343029b9a9393106dd71c0adcd8 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:12:18 -0400 Subject: [PATCH 07/26] logo --- glossary.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/glossary.md b/glossary.md index e130a73..5bc0f26 100644 --- a/glossary.md +++ b/glossary.md @@ -1,8 +1,6 @@ -put in logo +![OASIS Logo](https://www.oasis-open.org/sites/www.oasis-open.org/files/logo.png) ------- -------

**OpenC2 Glossary**

From 739770fb890614977c36740c856dbf97280e1754 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:14:28 -0400 Subject: [PATCH 08/26] trivial format edits --- glossary.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/glossary.md b/glossary.md index 5bc0f26..6c1b181 100644 --- a/glossary.md +++ b/glossary.md @@ -1,8 +1,10 @@ +

![OASIS Logo](https://www.oasis-open.org/sites/www.oasis-open.org/files/logo.png) +

-**OpenC2 Glossary** +**OpenC2 Glossary**

From 1b78a171cb3331b4b7e5e06fd24ed228ee112603 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:18:40 -0400 Subject: [PATCH 09/26] formatting --- glossary.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/glossary.md b/glossary.md index 6c1b181..8af7524 100644 --- a/glossary.md +++ b/glossary.md @@ -1,11 +1,9 @@

-![OASIS Logo](https://www.oasis-open.org/sites/www.oasis-open.org/files/logo.png) +

-

-**OpenC2 Glossary** -

+# OpenC2 Glossary

Version 0.1.2 From 1b106e83d117b1340e6a784a3720551cbee5127a Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:23:59 -0400 Subject: [PATCH 10/26] format edits --- glossary.md | 57 +++++++++++++++++++++++++---------------------------- 1 file changed, 27 insertions(+), 30 deletions(-) diff --git a/glossary.md b/glossary.md index 8af7524..e74bf18 100644 --- a/glossary.md +++ b/glossary.md @@ -4,31 +4,28 @@ # OpenC2 Glossary - -

Version 0.1.2 -

-# 0. Preface +## 0. Preface 25-August-2017 (update once 0.1.2 stable) -## 0.1 Technical Committee: +### 0.1 Technical Committee: OASIS OpenC2 Technical Committee Chair: * Joe Brule (jmbrule@nsa.gov), National Security Agency * Sounil Yu (sounil.yu@bankofamerica.com), Bank of America -## 0.2 Editors: +### 0.2 Editors: * Duncan Sparrell (duncan@sfractal.com), sFractal Consulting LLC -## 0.3 Related Work: +### 0.3 Related Work: This glossary is related to: * TODO: reference language spec * TODO: reference profiles * TODO: reference implementation docs -## 0.4 Abstract: +### 0.4 Abstract: This Glossay is non-normative and is to inform readers of the OpenC2 specifications. @@ -53,7 +50,7 @@ Other aspects of coordinated cyber response such as sensing, analytics, and selecting appropriate courses of action are beyond the scope of OpenC2. -## 0.5 Status: +### 0.5 Status: This Working Draft (WD) has been produced by one or more TC Members; it has not yet been voted on by the TC @@ -65,13 +62,13 @@ A TC may approve a Working Draft, revise it, and re-approve it any number of times as a Committee Draft. -## 0.6 URI patterns: +### 0.6 URI patterns: Initial publication URI: Permanent “Latest version” URI: -## 0.7 Copyright +### 0.7 Copyright (Managed by OASIS TC Administration; please don’t modify.) Copyright © OASIS Open 2017. All Rights Reserved. All capitalized terms in the following text have the meanings assigned to them in the @@ -97,7 +94,7 @@ INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. -## 0.8 Table of Contents +### 0.8 Table of Contents **Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)* @@ -125,40 +122,40 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - [3.2 F-I](#) - [3.3 J-N](#) - [3.4 O-R](#) - - [3.5 S-Z](#35S-Z) -- [4. Bibliography and Endnotes(#4bibliographyandendnotes) + - [3.5 S-Z](#35s-z) +- [4. Bibliography and Endnotes](#4bibliographyandendnotes) ------ put in table of Figures ------ -# 1. Introduction +## 1. Introduction blah -## 1.1 Goal +### 1.1 Goal blah -## 1.2 Purpose and Scope +### 1.2 Purpose and Scope blah -## 1.3 Terminology +### 1.3 Terminology blah -## 1.4 Normative References +### 1.4 Normative References -## 1.5 Non-normative References +### 1.5 Non-normative References -## 1.6 Conformance +### 1.6 Conformance -## 1.7 Acknowledgments +### 1.7 Acknowledgments -# 2. Context +## 2. Context -# 3. Glossary +## 3. Glossary @@ -199,7 +196,7 @@ Need style guide for glossary Should it be wiki instead of google doc? -## 3.1 A-E +### 3.1 A-E **Action** - (A) In context of openC2, “action” is sometime used as part of normal english e.g. @@ -267,7 +264,7 @@ In the example below the firewall is told to block (action=deny) an ip. **Enterprise** - -## 3.2 F-I +### 3.2 F-I **Firewall** -in the context of openC2, firewall denotes the firewall functionality of an actuator ie hardware and/or software system that monitors incoming and outgoing network traffic and controls that traffic (eg logs, blocks, allows) based on security policy defined by a set of rules. @@ -291,7 +288,7 @@ See https://secwww.jhuapl.edu/iacdcommunityday/Resources/IACD%20Baseline%20Refer **ITU** - -## 3.3 J-N +### 3.3 J-N **JADN** - @@ -317,7 +314,7 @@ compiler, linkage editor, or executive routine. **NIST** - National Institute of Standards - an agency of the US federal government -## 3.4 O-R +### 3.4 O-R **OASIS** - duh? @@ -349,7 +346,7 @@ that enable computer hardware to perform computational or control functions.” **Response** - -## 3.5 S-Z +### 3.5 S-Z **SDN** - Software Defined Network @@ -394,7 +391,7 @@ ISO/IEC 24765:2009 defines software as: **Yuuki** - -# 4. Bibliography and Endnotes +## 4. Bibliography and Endnotes 1. make this a list of anything referenced 1. and any endnotes 1. will need to keep in sync unless MD can do it automagically From 7654a19413c8b7c9d37c80673110bdaf8e5b793d Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:27:08 -0400 Subject: [PATCH 11/26] formatting --- glossary.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/glossary.md b/glossary.md index e74bf18..907d41b 100644 --- a/glossary.md +++ b/glossary.md @@ -6,10 +6,10 @@ # OpenC2 Glossary Version 0.1.2 -## 0. Preface - 25-August-2017 (update once 0.1.2 stable) +## 0. Preface + ### 0.1 Technical Committee: OASIS OpenC2 Technical Committee Chair: @@ -122,8 +122,8 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - [3.2 F-I](#) - [3.3 J-N](#) - [3.4 O-R](#) - - [3.5 S-Z](#35s-z) -- [4. Bibliography and Endnotes](#4bibliographyandendnotes) + - [3.5 S-Z](#-35s-z) +- [4. Bibliography and Endnotes](#-4bibliographyandendnotes) ------ put in table of Figures From 49a3cca34ef1b38e499e34849cfda4bda461486e Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sat, 26 Aug 2017 16:29:40 -0400 Subject: [PATCH 12/26] formatting --- glossary.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glossary.md b/glossary.md index 907d41b..c90f6d8 100644 --- a/glossary.md +++ b/glossary.md @@ -122,8 +122,8 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - [3.2 F-I](#) - [3.3 J-N](#) - [3.4 O-R](#) - - [3.5 S-Z](#-35s-z) -- [4. Bibliography and Endnotes](#-4bibliographyandendnotes) + - [3.5 S-Z](#35-s-z) +- [4. Bibliography and Endnotes](#4-bibliography-and-endnotes) ------ put in table of Figures From 67175861cd46da1f33de0ec5962bd95e58235708 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 10:57:39 -0400 Subject: [PATCH 13/26] Footnote experiment --- glossary.md | 127 +++++++++++++++++++++++++++++++--------------------- 1 file changed, 75 insertions(+), 52 deletions(-) diff --git a/glossary.md b/glossary.md index c90f6d8..fcc3e35 100644 --- a/glossary.md +++ b/glossary.md @@ -21,6 +21,7 @@ Chair: ### 0.3 Related Work: This glossary is related to: + * OASIS OpenC2 Language Specification[1](#footnote01) * TODO: reference language spec * TODO: reference profiles * TODO: reference implementation docs @@ -50,7 +51,13 @@ Other aspects of coordinated cyber response such as sensing, analytics, and selecting appropriate courses of action are beyond the scope of OpenC2. -### 0.5 Status: +### 0.5 Version: +The versioning pattern for this document will be T.L.C where: + * T - incremented each time the OpenC2 Technical Committee approves this document as a Committee Note Draft (editorial note - or is this a specification draft?) + * L - incremented each time the OpenC2 Language Subcommittee reviews this document and agrees to the content + * C - incremented each time the OpenC2 + +### 0.6 Status: This Working Draft (WD) has been produced by one or more TC Members; it has not yet been voted on by the TC @@ -62,13 +69,13 @@ A TC may approve a Working Draft, revise it, and re-approve it any number of times as a Committee Draft. -### 0.6 URI patterns: +### 0.7 URI patterns: Initial publication URI: Permanent “Latest version” URI: -### 0.7 Copyright +### 0.8 Copyright (Managed by OASIS TC Administration; please don’t modify.) Copyright © OASIS Open 2017. All Rights Reserved. All capitalized terms in the following text have the meanings assigned to them in the @@ -94,40 +101,42 @@ INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. -### 0.8 Table of Contents +### 0.9 Tables of Contents and Figures **Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)* -- [0. Preface](#) - - [0.1 Technical Committee:](#) - - [0.2 Editors:](#) - - [0.3 Related Work:](#) - - [0.4 Abstract:](#) - - [0.5 Status:](#) - - [0.6 URI patterns:](#) - - [0.7 Copyright](#) - - [put in table of contents](#) - - [put in table of Figures](#) -- [1. Introduction](#) - - [1.1 Goal](#) - - [1.2 Purpose and Scope](#) - - [1.3 Terminology](#) - - [1.4 Normative References](#) - - [1.5 Non-normative References](#) - - [1.6 Conformance](#) - - [1.7 Acknowledgments](#) -- [2. Context](#) +- [0. Preface](#0-preface) + - [0.1 Technical Committee:](#01-technical-committee) + - [0.2 Editors:](#02-editors) + - [0.3 Related Work:](#03-related-work) + - [0.4 Abstract:](#04-abstract) + - [0.5 Status:](#05-status) + - [0.6 URI patterns:](#06-uri-patterns) + - [0.7 Copyright](#07-copyright) + - [0.8 Table of Contents](#08-table-of-contents) + - [0.9 Table of Figures](#09-table-of-figures) +- [1. Introduction](#1-introduction) + - [1.1 Goal](#11-goal) + - [1.2 Purpose and Scope](#12-purpose-and-scope) + - [1.3 Terminology](#13-terminology) + - [1.4 Normative References](#14-normative-references) + - [1.5 Non-normative References](#15-non-normative-references) + - [1.6 Conformance](#16-conformance) + - [1.7 Acknowledgments](#17-acknowledgments) +- [2. Context](#2-context) - [3. Glossary](#) - - [3.1 A-E](#) - - [3.2 F-I](#) - - [3.3 J-N](#) - - [3.4 O-R](#) + - [3.1 A-E](#31-a-e) + - [3.2 F-I](#32-f-i) + - [3.3 J-N](#33-j-n) + - [3.4 O-R](#34-o-r) - [3.5 S-Z](#35-s-z) - [4. Bibliography and Endnotes](#4-bibliography-and-endnotes) ------- -put in table of Figures ------- +(Editor's note - remember to update ToC and ToF with each version TODO) + +**Table of Figures** + +add tof here TODO ## 1. Introduction @@ -146,8 +155,25 @@ blah blah ### 1.4 Normative References +This glossary is non-normative and there are no normative references. ### 1.5 Non-normative References +This Glossary attempts to make use of definintions from other sources where possible. +The [Endnotes](#4-bibliography-and-endnotes) contain the full reference and +endnotes are used when a definition is quoted from another source. + +References cited in this glossary: + + * Webster + * IEEE Dictionary - http://ieeexplore.ieee.org/xpls/dictionary.jsp + * ISO + * IETF + * ITU + * NIST + * NISTIR 7298 Revision 2 + * OASIS + * OpenC2 specs + ### 1.6 Conformance @@ -157,32 +183,10 @@ blah ## 3. Glossary - - - - - - -This is the OpenC2 dictionary/glossary. - -It is in very draft form - don’t look at it yet - - Some caveat about definitions in context of openc2 Mixed definitions and abbreviations -Reference other definitions where possible - * Webster - * IEEE - http://ieeexplore.ieee.org/xpls/dictionary.jsp - * ISO - * IETF - * ITU - * NIST - * NISTIR 7298 Revision 2 - * OASIS - * OpenC2 specs - Mark each definition whether normative (ie for openc2 this matters) or informative (might help with reading explanatory information). @@ -392,6 +396,25 @@ ISO/IEC 24765:2009 defines software as: **Yuuki** - ## 4. Bibliography and Endnotes +1: Footnote content goes here + 1. Working Draft of OASIS OpenC2 Language Specification + * hotlink to draft + * this will be updated as LS moves thru standardization + 1. Working Draft of OASIS OpenC2 Actuator Profiles + * hotlink to draft + * this will be updated as profiles move thru standardization + 1. Working Draft of OASIS OpenC2 Implementation Considerations + * hotlink to draft + * this will be updated as IC moves thru standardization + 1. =*=*=*=*=*=*=*=*=*=*=*=* 1. make this a list of anything referenced 1. and any endnotes 1. will need to keep in sync unless MD can do it automagically + 1. Webster + 1. IEEE Dictionary - http://ieeexplore.ieee.org/xpls/dictionary.jsp + 1. ISO + 1. IETF + 1. ITU + 1. NIST + * NISTIR 7298 Revision 2 + 1. OASIS From e0c7a75ce03089cab4bad0fbafbfbfc310c4f595 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 11:02:44 -0400 Subject: [PATCH 14/26] footnote experiment again --- glossary.md | 43 +++++++++++++++++++++---------------------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/glossary.md b/glossary.md index fcc3e35..fba3f2a 100644 --- a/glossary.md +++ b/glossary.md @@ -396,25 +396,24 @@ ISO/IEC 24765:2009 defines software as: **Yuuki** - ## 4. Bibliography and Endnotes -1: Footnote content goes here - 1. Working Draft of OASIS OpenC2 Language Specification - * hotlink to draft - * this will be updated as LS moves thru standardization - 1. Working Draft of OASIS OpenC2 Actuator Profiles - * hotlink to draft - * this will be updated as profiles move thru standardization - 1. Working Draft of OASIS OpenC2 Implementation Considerations - * hotlink to draft - * this will be updated as IC moves thru standardization - 1. =*=*=*=*=*=*=*=*=*=*=*=* - 1. make this a list of anything referenced - 1. and any endnotes - 1. will need to keep in sync unless MD can do it automagically - 1. Webster - 1. IEEE Dictionary - http://ieeexplore.ieee.org/xpls/dictionary.jsp - 1. ISO - 1. IETF - 1. ITU - 1. NIST - * NISTIR 7298 Revision 2 - 1. OASIS +1. Working Draft of OASIS OpenC2 Language Specification + * change this to proper reference format + * hotlink to draft + * this will be updated as LS moves thru standardization +1. Working Draft of OASIS OpenC2 Actuator Profiles + * hotlink to draft + * this will be updated as profiles move thru standardization +1. Working Draft of OASIS OpenC2 Implementation Considerations + * hotlink to draft + * this will be updated as IC moves thru standardization +1. =*=*=*=*=*=*=*=*=*=*=*=* +1. make this a list of anything referenced +1. and any endnotes +1. will need to keep in sync unless MD can do it automagically +1. Webster +1. IEEE Dictionary - http://ieeexplore.ieee.org/xpls/dictionary.jsp +1. ISO +1. IETF +1. ITU +1. NIST + * NISTIR 7298 Revision 2 From 9b19e812e6a9dcf1fc731e36d552699083f1d0d4 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 11:05:03 -0400 Subject: [PATCH 15/26] more footnote --- glossary.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/glossary.md b/glossary.md index fba3f2a..d8ee208 100644 --- a/glossary.md +++ b/glossary.md @@ -396,10 +396,7 @@ ISO/IEC 24765:2009 defines software as: **Yuuki** - ## 4. Bibliography and Endnotes -1. Working Draft of OASIS OpenC2 Language Specification - * change this to proper reference format - * hotlink to draft - * this will be updated as LS moves thru standardization +1. Working Draft of OASIS OpenC2 Language Specification ;change this to proper reference format; hotlink to draft; this will be updated as LS moves thru standardization 1. Working Draft of OASIS OpenC2 Actuator Profiles * hotlink to draft * this will be updated as profiles move thru standardization From 981bae43d46667bec0a3a83b4cd8dd98627a4640 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 14:28:16 -0400 Subject: [PATCH 16/26] more boilerplate --- glossary.md | 57 ++++++++++++++++++++++++++++++++++------------------- 1 file changed, 37 insertions(+), 20 deletions(-) diff --git a/glossary.md b/glossary.md index d8ee208..3cba6e5 100644 --- a/glossary.md +++ b/glossary.md @@ -22,9 +22,16 @@ Chair: ### 0.3 Related Work: This glossary is related to: * OASIS OpenC2 Language Specification[1](#footnote01) - * TODO: reference language spec - * TODO: reference profiles - * TODO: reference implementation docs + * OASIS OpenC2 Firewall Acutator Profile[2](#footnote02) + * OASIS OpenC2 SDN Acutator Profile[3](#footnote03) + * OASIS OpenC2 Information Assurance Implementation Considerations[4](#footnote04) + +Because of the use of OpenC2 in the STIX Course of Action (CoA), this glossary is also related to: + * OASIS STIX-v2.0-Pt1-Core[5](#footnote05) + * OASIS STIX-v2.0-Pt2-Objects[6](#footnote06) + * OASIS STIX-v2.0-Pt3-Cyb-Core[7](#footnote07) + * OASIS STIX-v2.0-Pt4-Cyb-Objects[8](#footnote08) + * OASIS STIX-v2.0-Pt5-Patterning[9](#footnote09) ### 0.4 Abstract: @@ -69,13 +76,20 @@ A TC may approve a Working Draft, revise it, and re-approve it any number of times as a Committee Draft. -### 0.7 URI patterns: +### 0.7 URI patterns Initial publication URI: +* TODO Permanent “Latest version” URI: +* TODO + +### 0.8 Citation format +When referencing this specification the following citation format should be used: +[OpenC2 Glossary] +OpenC2 Glossary. Edited by Duncan Sparrell and TODO. Date-TODO. OASIS TODO. link TODO. -### 0.8 Copyright +### NOTICES (Managed by OASIS TC Administration; please don’t modify.) Copyright © OASIS Open 2017. All Rights Reserved. All capitalized terms in the following text have the meanings assigned to them in the @@ -101,8 +115,6 @@ INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. -### 0.9 Tables of Contents and Figures - **Table of Contents** *generated with [DocToc](http://doctoc.herokuapp.com/)* - [0. Preface](#0-preface) @@ -110,11 +122,11 @@ MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - [0.2 Editors:](#02-editors) - [0.3 Related Work:](#03-related-work) - [0.4 Abstract:](#04-abstract) - - [0.5 Status:](#05-status) - - [0.6 URI patterns:](#06-uri-patterns) - - [0.7 Copyright](#07-copyright) - - [0.8 Table of Contents](#08-table-of-contents) - - [0.9 Table of Figures](#09-table-of-figures) + - [0.5 Version:](#05-version) + - [0.6 Status:](#06-status) + - [0.7 URI patterns:](#07-uri-patterns) + - [0.8 Citation format](#08-citation-format) + - [Notices](#notices) - [1. Introduction](#1-introduction) - [1.1 Goal](#11-goal) - [1.2 Purpose and Scope](#12-purpose-and-scope) @@ -152,7 +164,9 @@ blah ### 1.3 Terminology -blah +The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, +“RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in +RFC2119[1](#footnote01). ### 1.4 Normative References This glossary is non-normative and there are no normative references. @@ -397,13 +411,16 @@ ISO/IEC 24765:2009 defines software as: ## 4. Bibliography and Endnotes 1. Working Draft of OASIS OpenC2 Language Specification ;change this to proper reference format; hotlink to draft; this will be updated as LS moves thru standardization -1. Working Draft of OASIS OpenC2 Actuator Profiles - * hotlink to draft - * this will be updated as profiles move thru standardization -1. Working Draft of OASIS OpenC2 Implementation Considerations - * hotlink to draft - * this will be updated as IC moves thru standardization -1. =*=*=*=*=*=*=*=*=*=*=*=* +2. Working Draft of OASIS OpenC2 Firewall Acutator Profile ;change this to proper reference format; hotlink to draft; this will be updated as profile moves thru standardization +3. Working Draft of OASIS OpenC2 SDN Acutator Profile ;change this to proper reference format; hotlink to draft; this will be updated as profile moves thru standardization +4. Working Draft of OASIS OpenC2 Information Assurance Implementation Considerations ;change this to proper reference format; this will be updated as profile moves thru standardization; hotlink to https://www.oasis-open.org/apps/org/workgroup/openc2-imple/download.php/61449/OpenC2%20IA%20Implementation%20Considerations_RCv1.0.pdf +5. STIX-v2.0-Pt1-Core - STIX™ Version 2.0. Part 1: STIX Core Concepts. Edited by Rich Piazza, John Wunder, and Bret Jordan. 03 May 2017. OASIS Committee Specification Draft 02 / Public Review Draft 02. http://docs.oasis-open.org/cti/stix/v2.0/csprd02/part1-stix-core/stix-v2.0-csprd02-part1-stix-core.html. Latest version: http://docs.oasis-open.org/cti/stix/v2.0/stix-v2.0-part1-stix-core.html. +6. STIX-v2.0-Pt2-Objects - STIX™ Version 2.0. Part 1: STIX Core Concepts. Edited by Rich Piazza, John Wunder, and Bret Jordan. 03 May 2017. OASIS Committee Specification Draft 02 / Public Review Draft 02. http://docs.oasis-open.org/cti/stix/v2.0/csprd02/part1-stix-core/stix-v2.0-csprd02-part1-stix-core.html. Latest version: http://docs.oasis-open.org/cti/stix/v2.0/stix-v2.0-part1-stix-core.html +7. STIX-v2.0-Pt3-Cyb-Core - STIX™ Version 2.0. Part 3: Cyber Observable Core Concepts. Edited by Trey Darley and Ivan Kirillov. 03 May 2017. OASIS Committee Specification Draft 02 / Public Review Draft 02. http://docs.oasis-open.org/cti/stix/v2.0/csprd02/part3-cyber-observable-core/stix-v2.0-csprd02-part3-cyber-observable-core.html. Latest version: http://docs.oasis-open.org/cti/stix/v2.0/stix-v2.0-part3-cyber-observable-core.html. +8. STIX-v2.0-Pt4-Cyb-Objects - STIX™ Version 2.0. Part 4: Cyber Observable Objects. Edited by Trey Darley and Ivan Kirillov. 03 May 2017. OASIS Committee Specification Draft 02 / Public Review Draft 02. http://docs.oasis-open.org/cti/stix/v2.0/csprd02/part4-cyber-observable-objects/stix-v2.0-csprd02-part4-cyber-observable-objects.html. Latest version: http://docs.oasis-open.org/cti/stix/v2.0/stix-v2.0-part4-cyber-observable-objects.html. +9. STIX-v2.0-Pt5-Patterning - STIX™ Version 2.0. Part 5: STIX Patterning. Edited by Trey Darley and Ivan Kirillov. 03 May 2017. OASIS Committee Specification Draft 02 / Public Review Draft 02. http://docs.oasis-open.org/cti/stix/v2.0/csprd02/part5-stix-patterning/stix-v2.0-csprd02-part5-stix-patterning.html. Latest version: http://docs.oasis-open.org/cti/stix/v2.0/stix-v2.0-part5-stix-patterning.html. +10. RFC2119 - “Key words for use in RFCs to Indicate Requirement Levels”. S Bradner, BCP 14, RFC 2119, March 1997. [Online]. Available: http://www.ietf.org/rfc/rfc2119.txt +1. =*=*=*=*=*=*=*=*=*=*=*=* need to fill in after this as refs added to document 1. make this a list of anything referenced 1. and any endnotes 1. will need to keep in sync unless MD can do it automagically From 6c664f880e8008e2d4540b5b0059b5e47db8d93c Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 15:10:28 -0400 Subject: [PATCH 17/26] cleanup --- glossary.md | 37 +++++++++++++++++++------------------ 1 file changed, 19 insertions(+), 18 deletions(-) diff --git a/glossary.md b/glossary.md index 3cba6e5..0e6732d 100644 --- a/glossary.md +++ b/glossary.md @@ -64,6 +64,11 @@ The versioning pattern for this document will be T.L.C where: * L - incremented each time the OpenC2 Language Subcommittee reviews this document and agrees to the content * C - incremented each time the OpenC2 +This document is a draft of 0.1.1 - ie: +* T=0 ie no drafts have yet been approved by the OpenC2 TC +* L=1 ie based on the baseline 0.1 draft imported from openc2 forum at OpenC2 TC startup +* C=1 ie this draft contains changes to the 0.1 version + ### 0.6 Status: This Working Draft (WD) has been produced by one or more TC Members; @@ -166,7 +171,7 @@ blah The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in -RFC2119[1](#footnote01). +RFC2119[10](#footnote10). ### 1.4 Normative References This glossary is non-normative and there are no normative references. @@ -190,29 +195,25 @@ References cited in this glossary: ### 1.6 Conformance +This document is informational only and is intended to help in the +understanding of the other OpenC2 specifications. +As such, it does not play a direct role in conformance. ### 1.7 Acknowledgments +TODO ## 2. Context +TODO text +* prose to help understand terms in context. +* Chicken and egg on understanding terms in context of other terms. +* Not intended to be requirements style use cases but instead just explanations to help in understanding of the words ## 3. Glossary -Some caveat about definitions in context of openc2 - -Mixed definitions and abbreviations - -Mark each definition whether normative -(ie for openc2 this matters) -or informative (might help with reading explanatory information). -Btw normative defintions need to be in a normative document -and copied here since this will be an informative document (I assume). -Mark normative with *. - -Make in html and filterable (eg only IACD or only normative or only “keyword”) - -Need style guide for glossary - -Should it be wiki instead of google doc? +TODO text +* Some caveat about definitions in context of openc2 +* Mixed definitions and abbreviations +* endnotes contain references when text is adapted from another standard ### 3.1 A-E @@ -222,7 +223,7 @@ Should it be wiki instead of google doc? (B) the first field of the openC2 command. The ACTUATOR executes the ACTION on the TARGET. The action is the verb that is what the command is to do. -See LDD Section 3.3 for the ?36? actions in openC2. +See Language Specification Section 3.3 (TODO check still that number) for the ?36? actions in openC2. In the example below the firewall is told to block (action=deny) an ip. ```` { From 08dd441f201b594a254a2ce5f204fbd6c7edc00e Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 22:10:47 -0400 Subject: [PATCH 18/26] fill in boilerplate --- glossary.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/glossary.md b/glossary.md index 0e6732d..8fac7b5 100644 --- a/glossary.md +++ b/glossary.md @@ -69,6 +69,8 @@ This document is a draft of 0.1.1 - ie: * L=1 ie based on the baseline 0.1 draft imported from openc2 forum at OpenC2 TC startup * C=1 ie this draft contains changes to the 0.1 version +Note versions can be compared on github. + ### 0.6 Status: This Working Draft (WD) has been produced by one or more TC Members; @@ -210,10 +212,16 @@ TODO text ## 3. Glossary -TODO text -* Some caveat about definitions in context of openc2 -* Mixed definitions and abbreviations -* endnotes contain references when text is adapted from another standard +The words being defined are in alphabetical order, and are in **bold**. +Where possible, definitions from other sources will be used and cited. +But the purpose of this glossary is to define terms in the context of OpenC2 +and some overloading of meanings may be necessary. +The glossary will attempt to explain the context +- ie when OpenC2 meaning may differ from meanings in other contexts. +Acronyms will be treated like words to define. +I.e. acronyms will not be in a separate list. +When other glossary words are used in a defintion, they will be hotlinked to the glossary definition. + ### 3.1 A-E From d1156d3ff97d941191e735e0111e555df26175e5 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 22:23:46 -0400 Subject: [PATCH 19/26] boilerplate --- glossary.md | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/glossary.md b/glossary.md index 8fac7b5..4fea7dc 100644 --- a/glossary.md +++ b/glossary.md @@ -4,9 +4,9 @@ # OpenC2 Glossary -Version 0.1.2 +Version 0.1.01 -25-August-2017 (update once 0.1.2 stable) +27-August-2017 ## 0. Preface @@ -58,16 +58,18 @@ Other aspects of coordinated cyber response such as sensing, analytics, and selecting appropriate courses of action are beyond the scope of OpenC2. +This glossary is an informative, non-normative document to aid in the understanding of OpenC2 specifications. + ### 0.5 Version: The versioning pattern for this document will be T.L.C where: - * T - incremented each time the OpenC2 Technical Committee approves this document as a Committee Note Draft (editorial note - or is this a specification draft?) + * T - incremented each time the OpenC2 Technical Committee approves this document as a Committee Note Draft * L - incremented each time the OpenC2 Language Subcommittee reviews this document and agrees to the content - * C - incremented each time the OpenC2 + * C - incremented each time the OpenC2 GitHub as a commit to it, ie the wording is changed. -This document is a draft of 0.1.1 - ie: +This document is a draft of 0.1.01 - ie: * T=0 ie no drafts have yet been approved by the OpenC2 TC * L=1 ie based on the baseline 0.1 draft imported from openc2 forum at OpenC2 TC startup -* C=1 ie this draft contains changes to the 0.1 version +* C=1 ie this draft contains the first set of changes to the 0.1 version Note versions can be compared on github. @@ -159,15 +161,24 @@ add tof here TODO ## 1. Introduction -blah +This glossary is an informative, non-normative document to aid in the understanding +of the OpenC2 specifications. ### 1.1 Goal -blah +The goal of this glossary is to contain definitions for all words that +have specific meanings in the context of OpenC2. +This goal can be considered met if all of the terms in any of the OpenC2 Specifications or Documents +can be found in this glossary. ### 1.2 Purpose and Scope -blah +The purpose of this document is solely informational. +The following two sections approach defining the terms from different perspectives. +Section 2 provides context in prose form since many of the words are defined with respect to each other. +Section 3 contains a list of every word in the glossary with it's definition. +Whenever a word from the glossary is used in either Section 2 or Section 3, +it is hotlinked to it's definiton in Section 3. ### 1.3 Terminology From 0d4a6cee473775d6969522f2c7c11f09d3a3d318 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Sun, 27 Aug 2017 22:28:24 -0400 Subject: [PATCH 20/26] edit --- glossary.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/glossary.md b/glossary.md index 4fea7dc..b25b09c 100644 --- a/glossary.md +++ b/glossary.md @@ -177,8 +177,15 @@ The purpose of this document is solely informational. The following two sections approach defining the terms from different perspectives. Section 2 provides context in prose form since many of the words are defined with respect to each other. Section 3 contains a list of every word in the glossary with it's definition. + Whenever a word from the glossary is used in either Section 2 or Section 3, it is hotlinked to it's definiton in Section 3. +Where possible, the definitions in Section 3 will mention which OpenC2 documents the term is used in. + +Where possible, the definitions in Section 3 will contain +both the OpenC2 definition as well as alternative definitions when used in other contexts. +For example the term **Action** contains both the Webster Dictionary definition +as well the very specific OpenC2 meaning as a field in an OpenC2 command. ### 1.3 Terminology From 48dde1aeadceda4ca5edda36f9aa5171192962c0 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Wed, 30 Aug 2017 13:17:09 -0400 Subject: [PATCH 21/26] test for Dave --- glossary.md | 1 + 1 file changed, 1 insertion(+) diff --git a/glossary.md b/glossary.md index b25b09c..2bf922e 100644 --- a/glossary.md +++ b/glossary.md @@ -3,6 +3,7 @@

+ # OpenC2 Glossary Version 0.1.01 From 68e1c5251a5070e51ce9413565ea57267f3e292a Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Wed, 30 Aug 2017 23:10:24 -0400 Subject: [PATCH 22/26] Context - producer --- glossary.md | 5 +++++ images/producer.png | Bin 0 -> 36234 bytes 2 files changed, 5 insertions(+) create mode 100644 images/producer.png diff --git a/glossary.md b/glossary.md index 2bf922e..d506f46 100644 --- a/glossary.md +++ b/glossary.md @@ -229,6 +229,11 @@ TODO text * Chicken and egg on understanding terms in context of other terms. * Not intended to be requirements style use cases but instead just explanations to help in understanding of the words +_**OpenC2**_(hotlink) _**commands**_(hotlink) are set from a _**producer**_(hotlink) to a _**consumer**_(hotlink) +as shown in Figure X(TODO). + +put figure here + ## 3. Glossary The words being defined are in alphabetical order, and are in **bold**. diff --git a/images/producer.png b/images/producer.png new file mode 100644 index 0000000000000000000000000000000000000000..e2bf1c998f957f6ee1048c7b0a016bf07f9a48b5 GIT binary patch literal 36234 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 RMK{|DDPkYE4+ literal 0 HcmV?d00001 From 1835aa2edf188b0df026ebceb84bbe7560c7fa79 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Wed, 30 Aug 2017 23:50:54 -0400 Subject: [PATCH 23/26] producer def --- glossary.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/glossary.md b/glossary.md index d506f46..bc01690 100644 --- a/glossary.md +++ b/glossary.md @@ -229,10 +229,15 @@ TODO text * Chicken and egg on understanding terms in context of other terms. * Not intended to be requirements style use cases but instead just explanations to help in understanding of the words -_**OpenC2**_(hotlink) _**commands**_(hotlink) are set from a _**producer**_(hotlink) to a _**consumer**_(hotlink) +_**OpenC2**_[definition](#openc2) +_**commands**_ [definition](#command) +are set from a _**producer**_[definition](#producer) + to a _**consumer**_[definition](#consumer) as shown in Figure X(TODO). -put figure here +![Producer Consumer](https://github.com/sparrell/openc2-glossary/raw/Context/images/producer.png) + +Figure X ## 3. Glossary @@ -244,7 +249,8 @@ The glossary will attempt to explain the context - ie when OpenC2 meaning may differ from meanings in other contexts. Acronyms will be treated like words to define. I.e. acronyms will not be in a separate list. -When other glossary words are used in a defintion, they will be hotlinked to the glossary definition. +When other glossary words are used in a defintion, +they will be _**bold-italics**_ and hotlinked to the glossary definition. ### 3.1 A-E @@ -382,6 +388,8 @@ in the context of openC2 the word orchestrator is defined more narrowly to mean **Point2Point** - +**Producer** - The entity that produces an OpenC2 command. See section 2 for example. + **Program** - “A combination of computer instructions and data definitions that enable computer hardware to perform computational or control functions.” (The IEEE Standards Dictionary: Glossary of Terms & Definitions, IEEE Std 610.12-1990 ) From d02abdd43e0a57a85cab975f8a8ff7f44fba5a75 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Wed, 30 Aug 2017 23:56:05 -0400 Subject: [PATCH 24/26] nit editorial --- glossary.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/glossary.md b/glossary.md index bc01690..1d57e34 100644 --- a/glossary.md +++ b/glossary.md @@ -229,10 +229,10 @@ TODO text * Chicken and egg on understanding terms in context of other terms. * Not intended to be requirements style use cases but instead just explanations to help in understanding of the words -_**OpenC2**_[definition](#openc2) -_**commands**_ [definition](#command) -are set from a _**producer**_[definition](#producer) - to a _**consumer**_[definition](#consumer) +_**OpenC2**_[def](#openc2) +_**commands**_ [def](#command) +are sent from a _**producer**_[def](#producer) + to a _**consumer**_[def](#consumer) as shown in Figure X(TODO). ![Producer Consumer](https://github.com/sparrell/openc2-glossary/raw/Context/images/producer.png) @@ -250,7 +250,8 @@ The glossary will attempt to explain the context Acronyms will be treated like words to define. I.e. acronyms will not be in a separate list. When other glossary words are used in a defintion, -they will be _**bold-italics**_ and hotlinked to the glossary definition. +they will be _**bold-italics**_ and hotlinked to the glossary definition by a superscript "def". +Some extremely common terms (eg. OpenC2) will not be highlighted/linked beyong the first use. ### 3.1 A-E From ffe44d6562d01822ba2bb18f50c1a8b6b28a4aa1 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Thu, 31 Aug 2017 07:35:34 -0400 Subject: [PATCH 25/26] more context --- glossary.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/glossary.md b/glossary.md index 1d57e34..0a3fc37 100644 --- a/glossary.md +++ b/glossary.md @@ -224,10 +224,15 @@ As such, it does not play a direct role in conformance. TODO ## 2. Context -TODO text -* prose to help understand terms in context. -* Chicken and egg on understanding terms in context of other terms. -* Not intended to be requirements style use cases but instead just explanations to help in understanding of the words +Section 3 is organized similar to a typical dictionary +with the terms to be defined listed alphabetically. +Sometimes it is also helpful to understand the terms in context of other terms. +This section is an attempt to use the terms +as they would be used in the OpenC2 context. +It is not intended to be requirements style use cases +but instead just explanations to help in understanding of the words. +However it does attempt to be accurate. +I.e. the examples used should be valid. _**OpenC2**_[def](#openc2) _**commands**_ [def](#command) @@ -310,7 +315,9 @@ In the example below the firewall is told to block (action=deny) an ip. **COA** - see Course of Action -**Command** - in openc2 see link +**Command** - From the Language Specification[1](#footnote01), "The OpenC2 Command communicates an action to be performed on a target and may include the entity that is to execute the action." See section 2 for example. + +**Consumer** - The entity that receives an OpenC2 command. See section 2 for example. **CTI** - @@ -378,7 +385,7 @@ compiler, linkage editor, or executive routine. **Ocas** - link to a particular openC2 simulator implemented in erlang -**OpenC2** - duh? +**OpenC2** - In the context of the OASIS OpenC2 Specifications[1](#footnote01),[2](#footnote02),[3](#footnote03),[4](#footnote04), OpenC2 used alone is generally shorthand for the OpenC2 Language. OpenC2 used as an adjective can usually be inferred by context to mean the some aspect from the collection of the specifications. **Orchestrator - In IT and security there are many types of orchestrators. in the context of openC2 the word orchestrator is defined more narrowly to mean “what goes here” @@ -389,7 +396,7 @@ in the context of openC2 the word orchestrator is defined more narrowly to mean **Point2Point** - -**Producer** - The entity that produces an OpenC2 command. See section 2 for example. +**Producer** - The entity that sends an OpenC2 command. See section 2 for example. **Program** - “A combination of computer instructions and data definitions that enable computer hardware to perform computational or control functions.” From 17e971adbfb2591e48afd08ec6bbf19291ef1d33 Mon Sep 17 00:00:00 2001 From: Duncan Sparrell Date: Thu, 31 Aug 2017 07:43:27 -0400 Subject: [PATCH 26/26] typo --- glossary.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary.md b/glossary.md index 0a3fc37..cd1f9e8 100644 --- a/glossary.md +++ b/glossary.md @@ -234,7 +234,7 @@ but instead just explanations to help in understanding of the words. However it does attempt to be accurate. I.e. the examples used should be valid. -_**OpenC2**_[def](#openc2) +_**OpenC2**_[def](#oc2) _**commands**_ [def](#command) are sent from a _**producer**_[def](#producer) to a _**consumer**_[def](#consumer)