diff --git a/iep2-policy-reference/machinetag.json b/iep2-policy-reference/machinetag.json new file mode 100644 index 0000000..35c10d7 --- /dev/null +++ b/iep2-policy-reference/machinetag.json @@ -0,0 +1,51 @@ +{ + "namespace": "iep2-policy-reference", + "description": "Forum of Incident Response and Security Teams (FIRST) Information Exchange Policy (IEP) framework v2.0 policy reference", + "version": 1, + "predicates": [ + { + "value": "id_ref", + "expanded": "POLICY ID REFERENCE", + "description": "Refers to a unique IEP Policy ID to identify a specific IEP policy at a remote location." + }, + { + "value": "url", + "expanded": "URL", + "description": "This is the remote URL specifying the IEP Policy File that contains the IEP Policy you wish to use." + }, + { + "value": "iep_version", + "expanded": "IEP POLICY VERSION", + "description": "States the version of the IEP framework that has been used. Must be set to 2.0." + } + ], + "values": [ + { + "predicate": "id_ref", + "entry": [ + { + "value": "$text", + "expanded": "An id_ref value is required" + } + ] + }, + { + "predicate": "url", + "entry": [ + { + "value": "$text", + "expanded": "A URL value is required" + } + ] + }, + { + "predicate": "iep_version", + "entry": [ + { + "value": "2.0", + "expanded": "The IEP version value must be 2.0" + } + ] + } + ] +} diff --git a/iep2-policy/machinetag.json b/iep2-policy/machinetag.json new file mode 100644 index 0000000..123414c --- /dev/null +++ b/iep2-policy/machinetag.json @@ -0,0 +1,239 @@ +{ + "namespace": "iep2-policy", + "description": "Forum of Incident Response and Security Teams (FIRST) Information Exchange Policy (IEP) framework v2.0 policy", + "version": 1, + "predicates": [ + { + "value": "id", + "expanded": "POLICY ID", + "description": "Provides a unique ID to identify a specific IEP policy." + }, + { + "value": "name", + "expanded": "POLICY NAME", + "description": "This statement can be used to provide a name for an IEP policy." + }, + { + "value": "description", + "expanded": "POLICY DESCRIPTION", + "description": "This statement can be used to provide more details as a background for an IEP policy." + }, + { + "value": "iep_version", + "expanded": "IEP POLICY VERSION", + "description": "States the version of the IEP framework that has been used. Must be set to 2.0." + }, + { + "value": "start_date", + "expanded": "POLICY START DATE", + "description": "States the UTC date that the IEP is effective from." + }, + { + "value": "end_date", + "expanded": "POLICY END DATE", + "description": "States the UTC date that the IEP is effective until." + }, + { + "value": "encrypt_in_transit", + "expanded": "ENCRYPT IN TRANSIT", + "description": "States whether the received information has to be encrypted when it is retransmitted by the recipient." + }, + { + "value": "permitted_actions", + "expanded": "PERMITTED ACTIONS", + "description": "States the permitted actions that Recipients can take upon information received." + }, + { + "value": "affected_party_notifications", + "expanded": "AFFECTED PARTY NOTIFICATIONS", + "description": "Recipients are permitted notify affected third parties of a potential compromise or threat." + }, + { + "value": "tlp", + "expanded": "TRAFFIC LIGHT PROTOCOL", + "description": "Recipients are permitted to redistribute the information received within the redistribution scope as defined by the enumerations." + }, + { + "value": "attribution", + "expanded": "ATTRIBUTION", + "description": "Recipients could be required to attribute or anonymize the Provider when redistributing the information received." + }, + { + "value": "unmodified_resale", + "expanded": "UNMODIFIED RESALE", + "description": "States whether the recipient MAY or MUST NOT resell the information received unmodified or in a semantically equivalent format." + }, + { + "value": "external_reference", + "expanded": "EXTERNAL REFERENCE", + "description": "This statement can be used to convey a description or reference to any applicable licenses, agreements, or conditions between the producer and receiver." + } + ], + "values": [ + { + "predicate": "id", + "entry": [ + { + "value": "$text", + "expanded": "An id value is required" + } + ] + }, + { + "predicate": "name", + "entry": [ + { + "value": "$text", + "expanded": "A name value is required" + } + ] + }, + { + "predicate": "description", + "entry": [ + { + "value": "$text", + "expanded": "A description value is required" + } + ] + }, + { + "predicate": "iep_version", + "entry": [ + { + "value": "2.0", + "expanded": "The IEP version value must be 2.0" + } + ] + }, + { + "predicate": "start_date", + "entry": [ + { + "value": "$text", + "expanded": "A start_date value is required" + } + ] + }, + { + "predicate": "end_date", + "entry": [ + { + "value": "$text", + "expanded": "An end_date value is required" + } + ] + }, + { + "predicate": "encrypt_in_transit", + "entry": [ + { + "value": "MUST", + "expanded": "Recipients MUST encrypt the information received when it is retransmitted or redistributed." + }, + { + "value": "MAY", + "expanded": "Recipients MAY encrypt the information received when it is retransmitted or redistributed." + } + ] + }, + { + "predicate": "permitted_actions", + "entry": [ + { + "value": "NONE", + "expanded": "Recipients MUST contact the Providers before acting upon the information received." + }, + { + "value": "CONTACT FOR INSTRUCTION", + "expanded": "Recipients MUST contact the Providers before acting upon the information received." + }, + { + "value": "INTERNALLY VISIBLE ACTIONS", + "expanded": "Recipients MAY conduct actions on the information received that are only visible on the Recipients internal networks and systems, and MUST NOT conduct actions that are visible outside of the Recipients networks and systems, or visible to third parties." + }, + { + "value": "EXTERNALLY VISIBLE INDIRECT ACTIONS", + "expanded": "Recipients MAY conduct indirect, or passive, actions on the information received that are externally visible and MUST NOT conduct direct, or active, actions." + }, + { + "value": "EXTERNALLY VISIBLE DIRECT ACTIONS", + "expanded": "Recipients MAY conduct direct, or active, actions on the information received that are externally visible." + } + ] + }, + { + "predicate": "affected_party_notifications", + "entry": [ + { + "value": "MAY", + "expanded": "Recipients MAY notify affected parties of a potential compromise or threat." + }, + { + "value": "MUST NOT", + "expanded": "Recipients MUST NOT notify affected parties of potential compromise or threat." + } + ] + }, + { + "predicate": "tlp", + "entry": [ + { + "value": "RED", + "expanded": "Personal for identified recipients only." + }, + { + "value": "AMBER", + "expanded": "Limited sharing on the basis of need-to-know." + }, + { + "value": "GREEN", + "expanded": "Community wide sharing." + }, + { + "value": "WHITE", + "expanded": "Unlimited sharing." + } + ] + }, + { + "predicate": "attribution", + "entry": [ + { + "value": "MAY", + "expanded": "Recipients MAY attribute the Provider when redistributing the information received." + }, + { + "value": "MUST", + "expanded": "Recipients MUST attribute the Provider when redistributing the information received." + }, + { + "value": "MUST NOT", + "expanded": "Recipients MUST NOT attribute the Provider when redistributing the information received." + } + ] + }, + { + "predicate": "unmodified_resale", + "entry": [ + { + "value": "MAY", + "expanded": "Recipients MAY resell the information received." + }, + { + "value": "MUST NOT", + "expanded": "Recipients MUST NOT resell the information received unmodified or in a semantically equivalent format." + } + ] + }, + { + "predicate": "external_reference", + "entry": [ + { + "value": "$text", + "expanded": "An external_reference value is a link to an external " + } + ] + } + ] +}