322 lines
11 KiB
Python
322 lines
11 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
import datetime as dt
|
|
|
|
import pytest
|
|
import pytz
|
|
|
|
import stix2
|
|
from stix2.v21 import TLP_WHITE
|
|
|
|
from .constants import IDENTITY_ID, MARKING_DEFINITION_ID
|
|
|
|
EXPECTED_TLP_MARKING_DEFINITION = """{
|
|
"type": "marking-definition",
|
|
"spec_version": "2.1",
|
|
"id": "marking-definition--613f2e26-407d-48c7-9eca-b8e91df99dc9",
|
|
"created": "2017-01-20T00:00:00.000Z",
|
|
"definition_type": "tlp",
|
|
"definition": {
|
|
"tlp": "white"
|
|
}
|
|
}"""
|
|
|
|
EXPECTED_STATEMENT_MARKING_DEFINITION = """{
|
|
"type": "marking-definition",
|
|
"spec_version": "2.1",
|
|
"id": "marking-definition--613f2e26-407d-48c7-9eca-b8e91df99dc9",
|
|
"created": "2017-01-20T00:00:00Z",
|
|
"definition_type": "statement",
|
|
"definition": {
|
|
"statement": "Copyright 2016, Example Corp"
|
|
}
|
|
}"""
|
|
|
|
EXPECTED_CAMPAIGN_WITH_OBJECT_MARKING = """{
|
|
"type": "campaign",
|
|
"spec_version": "2.1",
|
|
"id": "campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
"created_by_ref": "identity--311b2d2d-f010-4473-83ec-1edf84858f4c",
|
|
"created": "2016-04-06T20:03:00.000Z",
|
|
"modified": "2016-04-06T20:03:00.000Z",
|
|
"name": "Green Group Attacks Against Finance",
|
|
"description": "Campaign by Green Group against a series of targets in the financial services sector.",
|
|
"object_marking_refs": [
|
|
"marking-definition--613f2e26-407d-48c7-9eca-b8e91df99dc9"
|
|
]
|
|
}"""
|
|
|
|
EXPECTED_GRANULAR_MARKING = """{
|
|
"marking_ref": "marking-definition--613f2e26-407d-48c7-9eca-b8e91df99dc9",
|
|
"selectors": [
|
|
"abc",
|
|
"abc.[23]",
|
|
"abc.def",
|
|
"abc.[2].efg"
|
|
]
|
|
}"""
|
|
|
|
EXPECTED_CAMPAIGN_WITH_GRANULAR_REF_MARKINGS = """{
|
|
"type": "campaign",
|
|
"spec_version": "2.1",
|
|
"id": "campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
"created_by_ref": "identity--311b2d2d-f010-4473-83ec-1edf84858f4c",
|
|
"created": "2016-04-06T20:03:00.000Z",
|
|
"modified": "2016-04-06T20:03:00.000Z",
|
|
"name": "Green Group Attacks Against Finance",
|
|
"description": "Campaign by Green Group against a series of targets in the financial services sector.",
|
|
"granular_markings": [
|
|
{
|
|
"marking_ref": "marking-definition--613f2e26-407d-48c7-9eca-b8e91df99dc9",
|
|
"selectors": [
|
|
"description"
|
|
]
|
|
}
|
|
]
|
|
}"""
|
|
|
|
|
|
EXPECTED_CAMPAIGN_WITH_GRANULAR_LANG_MARKINGS = u"""{
|
|
"type": "campaign",
|
|
"spec_version": "2.1",
|
|
"id": "campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
"created_by_ref": "identity--311b2d2d-f010-4473-83ec-1edf84858f4c",
|
|
"created": "2016-04-06T20:03:00.000Z",
|
|
"modified": "2016-04-06T20:03:00.000Z",
|
|
"name": "Bank Attack",
|
|
"description": "Weitere Informationen über Banküberfall",
|
|
"lang": "en",
|
|
"granular_markings": [
|
|
{
|
|
"lang": "de",
|
|
"selectors": [
|
|
"description"
|
|
]
|
|
}
|
|
]
|
|
}"""
|
|
|
|
|
|
def test_marking_def_example_with_tlp():
|
|
assert str(TLP_WHITE) == EXPECTED_TLP_MARKING_DEFINITION
|
|
|
|
|
|
def test_marking_def_example_with_statement_positional_argument():
|
|
marking_definition = stix2.v21.MarkingDefinition(
|
|
id=MARKING_DEFINITION_ID,
|
|
created="2017-01-20T00:00:00.000Z",
|
|
definition_type="statement",
|
|
definition=stix2.StatementMarking(statement="Copyright 2016, Example Corp"),
|
|
)
|
|
|
|
assert str(marking_definition) == EXPECTED_STATEMENT_MARKING_DEFINITION
|
|
|
|
|
|
def test_marking_def_example_with_kwargs_statement():
|
|
kwargs = dict(statement="Copyright 2016, Example Corp")
|
|
marking_definition = stix2.v21.MarkingDefinition(
|
|
id=MARKING_DEFINITION_ID,
|
|
created="2017-01-20T00:00:00.000Z",
|
|
definition_type="statement",
|
|
definition=stix2.StatementMarking(**kwargs),
|
|
)
|
|
|
|
assert str(marking_definition) == EXPECTED_STATEMENT_MARKING_DEFINITION
|
|
|
|
|
|
def test_marking_def_invalid_type():
|
|
with pytest.raises(ValueError):
|
|
stix2.v21.MarkingDefinition(
|
|
id=MARKING_DEFINITION_ID,
|
|
created="2017-01-20T00:00:00.000Z",
|
|
definition_type="my-definition-type",
|
|
definition=stix2.StatementMarking("Copyright 2016, Example Corp"),
|
|
)
|
|
|
|
|
|
def test_campaign_with_markings_example():
|
|
campaign = stix2.v21.Campaign(
|
|
id="campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
created_by_ref=IDENTITY_ID,
|
|
created="2016-04-06T20:03:00Z",
|
|
modified="2016-04-06T20:03:00Z",
|
|
name="Green Group Attacks Against Finance",
|
|
description="Campaign by Green Group against a series of targets in the financial services sector.",
|
|
object_marking_refs=TLP_WHITE,
|
|
)
|
|
assert str(campaign) == EXPECTED_CAMPAIGN_WITH_OBJECT_MARKING
|
|
|
|
|
|
def test_granular_example():
|
|
granular_marking = stix2.v21.GranularMarking(
|
|
marking_ref=MARKING_DEFINITION_ID,
|
|
selectors=["abc", "abc.[23]", "abc.def", "abc.[2].efg"],
|
|
)
|
|
|
|
assert str(granular_marking) == EXPECTED_GRANULAR_MARKING
|
|
|
|
|
|
def test_granular_example_with_bad_selector():
|
|
with pytest.raises(stix2.exceptions.InvalidValueError) as excinfo:
|
|
stix2.v21.GranularMarking(
|
|
marking_ref=MARKING_DEFINITION_ID,
|
|
selectors=["abc[0]"], # missing "."
|
|
)
|
|
|
|
assert excinfo.value.cls == stix2.v21.GranularMarking
|
|
assert excinfo.value.prop_name == "selectors"
|
|
assert excinfo.value.reason == "must adhere to selector syntax."
|
|
assert str(excinfo.value) == "Invalid value for GranularMarking 'selectors': must adhere to selector syntax."
|
|
|
|
|
|
def test_campaign_with_granular_markings_example():
|
|
campaign = stix2.v21.Campaign(
|
|
id="campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
created_by_ref=IDENTITY_ID,
|
|
created="2016-04-06T20:03:00Z",
|
|
modified="2016-04-06T20:03:00Z",
|
|
name="Green Group Attacks Against Finance",
|
|
description="Campaign by Green Group against a series of targets in the financial services sector.",
|
|
granular_markings=[
|
|
stix2.v21.GranularMarking(
|
|
marking_ref=MARKING_DEFINITION_ID,
|
|
selectors=["description"],
|
|
),
|
|
],
|
|
)
|
|
assert str(campaign) == EXPECTED_CAMPAIGN_WITH_GRANULAR_REF_MARKINGS
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"data", [
|
|
EXPECTED_TLP_MARKING_DEFINITION,
|
|
{
|
|
"id": MARKING_DEFINITION_ID,
|
|
"spec_version": "2.1",
|
|
"type": "marking-definition",
|
|
"created": "2017-01-20T00:00:00Z",
|
|
"definition": {
|
|
"tlp": "white",
|
|
},
|
|
"definition_type": "tlp",
|
|
},
|
|
],
|
|
)
|
|
def test_parse_marking_definition(data):
|
|
gm = stix2.parse(data, version="2.1")
|
|
|
|
assert gm.type == 'marking-definition'
|
|
assert gm.spec_version == '2.1'
|
|
assert gm.id == MARKING_DEFINITION_ID
|
|
assert gm.created == dt.datetime(2017, 1, 20, 0, 0, 0, tzinfo=pytz.utc)
|
|
assert gm.definition.tlp == "white"
|
|
assert gm.definition_type == "tlp"
|
|
|
|
|
|
@stix2.v21.CustomMarking(
|
|
'x-new-marking-type', [
|
|
('property1', stix2.properties.StringProperty(required=True)),
|
|
('property2', stix2.properties.IntegerProperty()),
|
|
],
|
|
)
|
|
class NewMarking(object):
|
|
def __init__(self, property2=None, **kwargs):
|
|
if "property3" in kwargs and not isinstance(kwargs.get("property3"), int):
|
|
raise TypeError("Must be integer!")
|
|
|
|
|
|
def test_registered_custom_marking():
|
|
nm = NewMarking(property1='something', property2=55)
|
|
|
|
marking_def = stix2.v21.MarkingDefinition(
|
|
id="marking-definition--00000000-0000-4000-8000-000000000012",
|
|
created="2017-01-22T00:00:00.000Z",
|
|
definition_type="x-new-marking-type",
|
|
definition=nm,
|
|
)
|
|
|
|
assert marking_def.type == "marking-definition"
|
|
assert marking_def.id == "marking-definition--00000000-0000-4000-8000-000000000012"
|
|
assert marking_def.created == dt.datetime(2017, 1, 22, 0, 0, 0, tzinfo=pytz.utc)
|
|
assert marking_def.definition.property1 == "something"
|
|
assert marking_def.definition.property2 == 55
|
|
assert marking_def.definition_type == "x-new-marking-type"
|
|
|
|
|
|
def test_registered_custom_marking_raises_exception():
|
|
with pytest.raises(TypeError) as excinfo:
|
|
NewMarking(property1='something', property3='something', allow_custom=True)
|
|
|
|
assert str(excinfo.value) == "Must be integer!"
|
|
|
|
|
|
def test_not_registered_marking_raises_exception():
|
|
with pytest.raises(ValueError) as excinfo:
|
|
# Used custom object on purpose to demonstrate a not-registered marking
|
|
@stix2.v21.CustomObject(
|
|
'x-new-marking-type2', [
|
|
('property1', stix2.properties.StringProperty(required=True)),
|
|
('property2', stix2.properties.IntegerProperty()),
|
|
],
|
|
)
|
|
class NewObject2(object):
|
|
def __init__(self, property2=None, **kwargs):
|
|
return
|
|
|
|
no = NewObject2(property1='something', property2=55)
|
|
|
|
stix2.v21.MarkingDefinition(
|
|
id="marking-definition--00000000-0000-4000-8000-000000000012",
|
|
created="2017-01-22T00:00:00.000Z",
|
|
definition_type="x-new-marking-type2",
|
|
definition=no,
|
|
)
|
|
|
|
assert str(excinfo.value) == "definition_type must be a valid marking type"
|
|
|
|
|
|
def test_marking_wrong_type_construction():
|
|
with pytest.raises(ValueError) as excinfo:
|
|
# Test passing wrong type for properties.
|
|
@stix2.v21.CustomMarking('x-new-marking-type2', ("a", "b"))
|
|
class NewObject3(object):
|
|
pass
|
|
|
|
assert str(excinfo.value) == "Must supply a list, containing tuples. For example, [('property1', IntegerProperty())]"
|
|
|
|
|
|
def test_campaign_add_markings():
|
|
campaign = stix2.v21.Campaign(
|
|
id="campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
created_by_ref=IDENTITY_ID,
|
|
created="2016-04-06T20:03:00Z",
|
|
modified="2016-04-06T20:03:00Z",
|
|
name="Green Group Attacks Against Finance",
|
|
description="Campaign by Green Group against a series of targets in the financial services sector.",
|
|
)
|
|
campaign = campaign.add_markings(TLP_WHITE)
|
|
assert campaign.object_marking_refs[0] == TLP_WHITE.id
|
|
|
|
|
|
def test_campaign_with_granular_lang_markings_example():
|
|
campaign = stix2.v21.Campaign(
|
|
id="campaign--8e2e2d2b-17d4-4cbf-938f-98ee46b3cd3f",
|
|
created_by_ref=IDENTITY_ID,
|
|
created="2016-04-06T20:03:00Z",
|
|
modified="2016-04-06T20:03:00Z",
|
|
name="Bank Attack",
|
|
lang="en",
|
|
description="Weitere Informationen über Banküberfall",
|
|
granular_markings=[
|
|
stix2.v21.GranularMarking(
|
|
lang="de",
|
|
selectors=["description"],
|
|
),
|
|
],
|
|
)
|
|
|
|
# In order to provide the same representation, we need to disable escaping
|
|
# in json.dumps(). https://docs.python.org/3/library/json.html#json.dumps
|
|
# or https://docs.python.org/2/library/json.html#json.dumps
|
|
assert campaign.serialize(pretty=True, ensure_ascii=False) == EXPECTED_CAMPAIGN_WITH_GRANULAR_LANG_MARKINGS
|