823 lines
28 KiB
Python
823 lines
28 KiB
Python
import pytest
|
|
|
|
import stix2
|
|
import stix2.environment
|
|
import stix2.exceptions
|
|
|
|
from .constants import (
|
|
ATTACK_PATTERN_ID, ATTACK_PATTERN_KWARGS, CAMPAIGN_ID, CAMPAIGN_KWARGS,
|
|
FAKE_TIME, IDENTITY_ID, IDENTITY_KWARGS, INDICATOR_ID, INDICATOR_KWARGS,
|
|
LOCATION_ID, MALWARE_ID, MALWARE_KWARGS, RELATIONSHIP_IDS, REPORT_ID,
|
|
REPORT_KWARGS, THREAT_ACTOR_ID, THREAT_ACTOR_KWARGS, TOOL_ID, TOOL_KWARGS,
|
|
VULNERABILITY_ID, VULNERABILITY_KWARGS,
|
|
)
|
|
|
|
|
|
@pytest.fixture
|
|
def ds():
|
|
cam = stix2.v21.Campaign(id=CAMPAIGN_ID, **CAMPAIGN_KWARGS)
|
|
idy = stix2.v21.Identity(id=IDENTITY_ID, **IDENTITY_KWARGS)
|
|
ind = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
mal = stix2.v21.Malware(id=MALWARE_ID, **MALWARE_KWARGS)
|
|
rel1 = stix2.v21.Relationship(ind, 'indicates', mal, id=RELATIONSHIP_IDS[0])
|
|
rel2 = stix2.v21.Relationship(mal, 'targets', idy, id=RELATIONSHIP_IDS[1])
|
|
rel3 = stix2.v21.Relationship(cam, 'uses', mal, id=RELATIONSHIP_IDS[2])
|
|
stix_objs = [cam, idy, ind, mal, rel1, rel2, rel3]
|
|
yield stix2.MemoryStore(stix_objs)
|
|
|
|
|
|
def test_object_factory_created_by_ref_str():
|
|
factory = stix2.ObjectFactory(created_by_ref=IDENTITY_ID)
|
|
ind = factory.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
assert ind.created_by_ref == IDENTITY_ID
|
|
|
|
|
|
def test_object_factory_created_by_ref_obj():
|
|
id_obj = stix2.v21.Identity(id=IDENTITY_ID, **IDENTITY_KWARGS)
|
|
factory = stix2.ObjectFactory(created_by_ref=id_obj)
|
|
ind = factory.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
assert ind.created_by_ref == IDENTITY_ID
|
|
|
|
|
|
def test_object_factory_override_default():
|
|
factory = stix2.ObjectFactory(created_by_ref=IDENTITY_ID)
|
|
new_id = "identity--983b3172-44fe-4a80-8091-eb8098841fe8"
|
|
ind = factory.create(stix2.v21.Indicator, created_by_ref=new_id, **INDICATOR_KWARGS)
|
|
assert ind.created_by_ref == new_id
|
|
|
|
|
|
def test_object_factory_created():
|
|
factory = stix2.ObjectFactory(created=FAKE_TIME)
|
|
ind = factory.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
assert ind.created == FAKE_TIME
|
|
assert ind.modified == FAKE_TIME
|
|
|
|
|
|
def test_object_factory_external_reference():
|
|
ext_ref = stix2.v21.ExternalReference(
|
|
source_name="ACME Threat Intel",
|
|
description="Threat report",
|
|
)
|
|
factory = stix2.ObjectFactory(external_references=ext_ref)
|
|
ind = factory.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
assert ind.external_references[0].source_name == "ACME Threat Intel"
|
|
assert ind.external_references[0].description == "Threat report"
|
|
|
|
ind2 = factory.create(stix2.v21.Indicator, external_references=None, **INDICATOR_KWARGS)
|
|
assert 'external_references' not in ind2
|
|
|
|
|
|
def test_object_factory_obj_markings():
|
|
stmt_marking = stix2.v21.StatementMarking("Copyright 2016, Example Corp")
|
|
mark_def = stix2.v21.MarkingDefinition(
|
|
definition_type="statement",
|
|
definition=stmt_marking,
|
|
)
|
|
factory = stix2.ObjectFactory(object_marking_refs=[mark_def, stix2.v21.TLP_AMBER])
|
|
ind = factory.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
assert mark_def.id in ind.object_marking_refs
|
|
assert stix2.v21.TLP_AMBER.id in ind.object_marking_refs
|
|
|
|
factory = stix2.ObjectFactory(object_marking_refs=stix2.v21.TLP_RED)
|
|
ind = factory.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
assert stix2.v21.TLP_RED.id in ind.object_marking_refs
|
|
|
|
|
|
def test_object_factory_list_append():
|
|
ext_ref = stix2.v21.ExternalReference(
|
|
source_name="ACME Threat Intel",
|
|
description="Threat report from ACME",
|
|
)
|
|
ext_ref2 = stix2.v21.ExternalReference(
|
|
source_name="Yet Another Threat Report",
|
|
description="Threat report from YATR",
|
|
)
|
|
ext_ref3 = stix2.v21.ExternalReference(
|
|
source_name="Threat Report #3",
|
|
description="One more threat report",
|
|
)
|
|
factory = stix2.ObjectFactory(external_references=ext_ref)
|
|
ind = factory.create(stix2.v21.Indicator, external_references=ext_ref2, **INDICATOR_KWARGS)
|
|
assert ind.external_references[1].source_name == "Yet Another Threat Report"
|
|
|
|
ind = factory.create(stix2.v21.Indicator, external_references=[ext_ref2, ext_ref3], **INDICATOR_KWARGS)
|
|
assert ind.external_references[2].source_name == "Threat Report #3"
|
|
|
|
|
|
def test_object_factory_list_replace():
|
|
ext_ref = stix2.v21.ExternalReference(
|
|
source_name="ACME Threat Intel",
|
|
description="Threat report from ACME",
|
|
)
|
|
ext_ref2 = stix2.v21.ExternalReference(
|
|
source_name="Yet Another Threat Report",
|
|
description="Threat report from YATR",
|
|
)
|
|
factory = stix2.ObjectFactory(external_references=ext_ref, list_append=False)
|
|
ind = factory.create(stix2.v21.Indicator, external_references=ext_ref2, **INDICATOR_KWARGS)
|
|
assert len(ind.external_references) == 1
|
|
assert ind.external_references[0].source_name == "Yet Another Threat Report"
|
|
|
|
|
|
def test_environment_functions():
|
|
env = stix2.Environment(
|
|
stix2.ObjectFactory(created_by_ref=IDENTITY_ID),
|
|
stix2.MemoryStore(),
|
|
)
|
|
|
|
# Create a STIX object
|
|
ind = env.create(stix2.v21.Indicator, id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
assert ind.created_by_ref == IDENTITY_ID
|
|
|
|
# Add objects to datastore
|
|
ind2 = ind.new_version(labels=['benign'])
|
|
env.add([ind, ind2])
|
|
|
|
# Get both versions of the object
|
|
resp = env.all_versions(INDICATOR_ID)
|
|
assert len(resp) == 2
|
|
|
|
# Get just the most recent version of the object
|
|
resp = env.get(INDICATOR_ID)
|
|
assert resp['labels'][0] == 'benign'
|
|
|
|
# Search on something other than id
|
|
query = [stix2.Filter('type', '=', 'vulnerability')]
|
|
resp = env.query(query)
|
|
assert len(resp) == 0
|
|
|
|
# See different results after adding filters to the environment
|
|
env.add_filters([
|
|
stix2.Filter('type', '=', 'indicator'),
|
|
stix2.Filter('created_by_ref', '=', IDENTITY_ID),
|
|
])
|
|
env.add_filter(stix2.Filter('labels', '=', 'benign')) # should be 'malicious-activity'
|
|
resp = env.get(INDICATOR_ID)
|
|
assert resp['labels'][0] == 'benign' # should be 'malicious-activity'
|
|
|
|
|
|
def test_environment_source_and_sink():
|
|
ind = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
env = stix2.Environment(source=stix2.MemorySource([ind]), sink=stix2.MemorySink([ind]))
|
|
assert env.get(INDICATOR_ID).indicator_types[0] == 'malicious-activity'
|
|
|
|
|
|
def test_environment_datastore_and_sink():
|
|
with pytest.raises(ValueError) as excinfo:
|
|
stix2.Environment(
|
|
factory=stix2.ObjectFactory(),
|
|
store=stix2.MemoryStore(), sink=stix2.MemorySink,
|
|
)
|
|
assert 'Data store already provided' in str(excinfo.value)
|
|
|
|
|
|
def test_environment_no_datastore():
|
|
env = stix2.Environment(factory=stix2.ObjectFactory())
|
|
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.add(stix2.v21.Indicator(**INDICATOR_KWARGS))
|
|
assert 'Environment has no data sink to put objects in' in str(excinfo.value)
|
|
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.get(INDICATOR_ID)
|
|
assert 'Environment has no data source' in str(excinfo.value)
|
|
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.all_versions(INDICATOR_ID)
|
|
assert 'Environment has no data source' in str(excinfo.value)
|
|
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.query(INDICATOR_ID)
|
|
assert 'Environment has no data source' in str(excinfo.value)
|
|
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.relationships(INDICATOR_ID)
|
|
assert 'Environment has no data source' in str(excinfo.value)
|
|
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.related_to(INDICATOR_ID)
|
|
assert 'Environment has no data source' in str(excinfo.value)
|
|
|
|
|
|
def test_environment_add_filters():
|
|
env = stix2.Environment(factory=stix2.ObjectFactory())
|
|
env.add_filters([INDICATOR_ID])
|
|
env.add_filter(INDICATOR_ID)
|
|
|
|
|
|
def test_environment_datastore_and_no_object_factory():
|
|
# Uses a default object factory
|
|
env = stix2.Environment(store=stix2.MemoryStore())
|
|
ind = env.create(stix2.v21.Indicator, id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
assert ind.id == INDICATOR_ID
|
|
|
|
|
|
def test_parse_malware():
|
|
env = stix2.Environment()
|
|
data = """{
|
|
"type": "malware",
|
|
"spec_version": "2.1",
|
|
"id": "malware--9c4638ec-f1de-4ddb-abf4-1b760417654e",
|
|
"created": "2017-01-01T12:34:56.000Z",
|
|
"modified": "2017-01-01T12:34:56.000Z",
|
|
"name": "Cryptolocker",
|
|
"malware_types": [
|
|
"ransomware"
|
|
],
|
|
"is_family": false
|
|
}"""
|
|
mal = env.parse(data, version="2.1")
|
|
|
|
assert mal.type == 'malware'
|
|
assert mal.spec_version == '2.1'
|
|
assert mal.id == MALWARE_ID
|
|
assert mal.created == FAKE_TIME
|
|
assert mal.modified == FAKE_TIME
|
|
assert mal.malware_types == ['ransomware']
|
|
assert mal.name == "Cryptolocker"
|
|
assert not mal.is_family
|
|
|
|
|
|
def test_creator_of():
|
|
identity = stix2.v21.Identity(**IDENTITY_KWARGS)
|
|
factory = stix2.ObjectFactory(created_by_ref=identity.id)
|
|
env = stix2.Environment(store=stix2.MemoryStore(), factory=factory)
|
|
env.add(identity)
|
|
|
|
ind = env.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
creator = env.creator_of(ind)
|
|
assert creator is identity
|
|
|
|
|
|
def test_creator_of_no_datasource():
|
|
identity = stix2.v21.Identity(**IDENTITY_KWARGS)
|
|
factory = stix2.ObjectFactory(created_by_ref=identity.id)
|
|
env = stix2.Environment(factory=factory)
|
|
|
|
ind = env.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
with pytest.raises(AttributeError) as excinfo:
|
|
env.creator_of(ind)
|
|
assert 'Environment has no data source' in str(excinfo.value)
|
|
|
|
|
|
def test_creator_of_not_found():
|
|
identity = stix2.v21.Identity(**IDENTITY_KWARGS)
|
|
factory = stix2.ObjectFactory(created_by_ref=identity.id)
|
|
env = stix2.Environment(store=stix2.MemoryStore(), factory=factory)
|
|
|
|
ind = env.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
creator = env.creator_of(ind)
|
|
assert creator is None
|
|
|
|
|
|
def test_creator_of_no_created_by_ref():
|
|
env = stix2.Environment(store=stix2.MemoryStore())
|
|
ind = env.create(stix2.v21.Indicator, **INDICATOR_KWARGS)
|
|
creator = env.creator_of(ind)
|
|
assert creator is None
|
|
|
|
|
|
def test_relationships(ds):
|
|
env = stix2.Environment(store=ds)
|
|
mal = env.get(MALWARE_ID)
|
|
resp = env.relationships(mal)
|
|
|
|
assert len(resp) == 3
|
|
assert any(x['id'] == RELATIONSHIP_IDS[0] for x in resp)
|
|
assert any(x['id'] == RELATIONSHIP_IDS[1] for x in resp)
|
|
assert any(x['id'] == RELATIONSHIP_IDS[2] for x in resp)
|
|
|
|
|
|
def test_relationships_no_id(ds):
|
|
env = stix2.Environment(store=ds)
|
|
mal = {
|
|
"type": "malware",
|
|
"name": "some variant",
|
|
}
|
|
with pytest.raises(ValueError) as excinfo:
|
|
env.relationships(mal)
|
|
assert "object has no 'id' property" in str(excinfo.value)
|
|
|
|
|
|
def test_relationships_by_type(ds):
|
|
env = stix2.Environment(store=ds)
|
|
mal = env.get(MALWARE_ID)
|
|
resp = env.relationships(mal, relationship_type='indicates')
|
|
|
|
assert len(resp) == 1
|
|
assert resp[0]['id'] == RELATIONSHIP_IDS[0]
|
|
|
|
|
|
def test_relationships_by_source(ds):
|
|
env = stix2.Environment(store=ds)
|
|
resp = env.relationships(MALWARE_ID, source_only=True)
|
|
|
|
assert len(resp) == 1
|
|
assert resp[0]['id'] == RELATIONSHIP_IDS[1]
|
|
|
|
|
|
def test_relationships_by_target(ds):
|
|
env = stix2.Environment(store=ds)
|
|
resp = env.relationships(MALWARE_ID, target_only=True)
|
|
|
|
assert len(resp) == 2
|
|
assert any(x['id'] == RELATIONSHIP_IDS[0] for x in resp)
|
|
assert any(x['id'] == RELATIONSHIP_IDS[2] for x in resp)
|
|
|
|
|
|
def test_relationships_by_target_and_type(ds):
|
|
env = stix2.Environment(store=ds)
|
|
resp = env.relationships(MALWARE_ID, relationship_type='uses', target_only=True)
|
|
|
|
assert len(resp) == 1
|
|
assert any(x['id'] == RELATIONSHIP_IDS[2] for x in resp)
|
|
|
|
|
|
def test_relationships_by_target_and_source(ds):
|
|
env = stix2.Environment(store=ds)
|
|
with pytest.raises(ValueError) as excinfo:
|
|
env.relationships(MALWARE_ID, target_only=True, source_only=True)
|
|
|
|
assert 'not both' in str(excinfo.value)
|
|
|
|
|
|
def test_related_to(ds):
|
|
env = stix2.Environment(store=ds)
|
|
mal = env.get(MALWARE_ID)
|
|
resp = env.related_to(mal)
|
|
|
|
assert len(resp) == 3
|
|
assert any(x['id'] == CAMPAIGN_ID for x in resp)
|
|
assert any(x['id'] == INDICATOR_ID for x in resp)
|
|
assert any(x['id'] == IDENTITY_ID for x in resp)
|
|
|
|
|
|
def test_related_to_no_id(ds):
|
|
env = stix2.Environment(store=ds)
|
|
mal = {
|
|
"type": "malware",
|
|
"name": "some variant",
|
|
"is_family": False,
|
|
}
|
|
with pytest.raises(ValueError) as excinfo:
|
|
env.related_to(mal)
|
|
assert "object has no 'id' property" in str(excinfo.value)
|
|
|
|
|
|
def test_related_to_by_source(ds):
|
|
env = stix2.Environment(store=ds)
|
|
resp = env.related_to(MALWARE_ID, source_only=True)
|
|
|
|
assert len(resp) == 1
|
|
assert resp[0]['id'] == IDENTITY_ID
|
|
|
|
|
|
def test_related_to_by_target(ds):
|
|
env = stix2.Environment(store=ds)
|
|
resp = env.related_to(MALWARE_ID, target_only=True)
|
|
|
|
assert len(resp) == 2
|
|
assert any(x['id'] == CAMPAIGN_ID for x in resp)
|
|
assert any(x['id'] == INDICATOR_ID for x in resp)
|
|
|
|
|
|
def test_semantic_equivalence_on_same_attack_pattern1():
|
|
ap1 = stix2.v21.AttackPattern(id=ATTACK_PATTERN_ID, **ATTACK_PATTERN_KWARGS)
|
|
ap2 = stix2.v21.AttackPattern(id=ATTACK_PATTERN_ID, **ATTACK_PATTERN_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ap1, ap2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_attack_pattern2():
|
|
ATTACK_KWARGS = dict(
|
|
name="Phishing",
|
|
external_references=[
|
|
{
|
|
"url": "https://example2",
|
|
"source_name": "some-source2",
|
|
},
|
|
],
|
|
)
|
|
ap1 = stix2.v21.AttackPattern(id=ATTACK_PATTERN_ID, **ATTACK_KWARGS)
|
|
ap2 = stix2.v21.AttackPattern(id=ATTACK_PATTERN_ID, **ATTACK_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ap1, ap2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_campaign1():
|
|
camp1 = stix2.v21.Campaign(id=CAMPAIGN_ID, **CAMPAIGN_KWARGS)
|
|
camp2 = stix2.v21.Campaign(id=CAMPAIGN_ID, **CAMPAIGN_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(camp1, camp2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_campaign2():
|
|
CAMP_KWARGS = dict(
|
|
name="Green Group Attacks Against Finance",
|
|
description="Campaign by Green Group against a series of targets in the financial services sector.",
|
|
aliases=["super-green", "some-green"],
|
|
)
|
|
camp1 = stix2.v21.Campaign(id=CAMPAIGN_ID, **CAMP_KWARGS)
|
|
camp2 = stix2.v21.Campaign(id=CAMPAIGN_ID, **CAMP_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(camp1, camp2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_identity1():
|
|
iden1 = stix2.v21.Identity(id=IDENTITY_ID, **IDENTITY_KWARGS)
|
|
iden2 = stix2.v21.Identity(id=IDENTITY_ID, **IDENTITY_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(iden1, iden2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_identity2():
|
|
IDEN_KWARGS = dict(
|
|
name="John Smith",
|
|
identity_class="individual",
|
|
sectors=["government", "critical-infrastructure"],
|
|
)
|
|
iden1 = stix2.v21.Identity(id=IDENTITY_ID, **IDEN_KWARGS)
|
|
iden2 = stix2.v21.Identity(id=IDENTITY_ID, **IDEN_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(iden1, iden2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_indicator():
|
|
ind1 = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
ind2 = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ind1, ind2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_location1():
|
|
LOCATION_KWARGS = dict(latitude=45, longitude=179)
|
|
loc1 = stix2.v21.Location(id=LOCATION_ID, **LOCATION_KWARGS)
|
|
loc2 = stix2.v21.Location(id=LOCATION_ID, **LOCATION_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(loc1, loc2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_location2():
|
|
LOCATION_KWARGS = dict(
|
|
latitude=38.889,
|
|
longitude=-77.023,
|
|
region="northern-america",
|
|
country="us",
|
|
)
|
|
loc1 = stix2.v21.Location(id=LOCATION_ID, **LOCATION_KWARGS)
|
|
loc2 = stix2.v21.Location(id=LOCATION_ID, **LOCATION_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(loc1, loc2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_malware():
|
|
malw1 = stix2.v21.Malware(id=MALWARE_ID, **MALWARE_KWARGS)
|
|
malw2 = stix2.v21.Malware(id=MALWARE_ID, **MALWARE_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(malw1, malw2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_threat_actor1():
|
|
ta1 = stix2.v21.ThreatActor(id=THREAT_ACTOR_ID, **THREAT_ACTOR_KWARGS)
|
|
ta2 = stix2.v21.ThreatActor(id=THREAT_ACTOR_ID, **THREAT_ACTOR_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ta1, ta2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_threat_actor2():
|
|
THREAT_KWARGS = dict(
|
|
threat_actor_types=["crime-syndicate"],
|
|
aliases=["super-evil"],
|
|
name="Evil Org",
|
|
)
|
|
ta1 = stix2.v21.ThreatActor(id=THREAT_ACTOR_ID, **THREAT_KWARGS)
|
|
ta2 = stix2.v21.ThreatActor(id=THREAT_ACTOR_ID, **THREAT_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ta1, ta2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_tool():
|
|
tool1 = stix2.v21.Tool(id=TOOL_ID, **TOOL_KWARGS)
|
|
tool2 = stix2.v21.Tool(id=TOOL_ID, **TOOL_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(tool1, tool2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_vulnerability1():
|
|
vul1 = stix2.v21.Vulnerability(id=VULNERABILITY_ID, **VULNERABILITY_KWARGS)
|
|
vul2 = stix2.v21.Vulnerability(id=VULNERABILITY_ID, **VULNERABILITY_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(vul1, vul2)
|
|
assert round(env) == 100
|
|
|
|
|
|
def test_semantic_equivalence_on_same_vulnerability2():
|
|
VULN_KWARGS1 = dict(
|
|
name="Heartbleed",
|
|
external_references=[
|
|
{
|
|
"url": "https://example",
|
|
"source_name": "some-source",
|
|
},
|
|
],
|
|
)
|
|
VULN_KWARGS2 = dict(
|
|
name="Foo",
|
|
external_references=[
|
|
{
|
|
"url": "https://example2",
|
|
"source_name": "some-source2",
|
|
},
|
|
],
|
|
)
|
|
vul1 = stix2.v21.Vulnerability(id=VULNERABILITY_ID, **VULN_KWARGS1)
|
|
vul2 = stix2.v21.Vulnerability(id=VULNERABILITY_ID, **VULN_KWARGS2)
|
|
env = stix2.Environment().semantically_equivalent(vul1, vul2)
|
|
assert round(env) == 0.0
|
|
|
|
|
|
def test_semantic_equivalence_on_unknown_object():
|
|
CUSTOM_KWARGS1 = dict(
|
|
type="x-foobar",
|
|
id="x-foobar--0c7b5b88-8ff7-4a4d-aa9d-feb398cd0061",
|
|
name="Heartbleed",
|
|
external_references=[
|
|
{
|
|
"url": "https://example",
|
|
"source_name": "some-source",
|
|
},
|
|
],
|
|
)
|
|
CUSTOM_KWARGS2 = dict(
|
|
type="x-foobar",
|
|
id="x-foobar--0c7b5b88-8ff7-4a4d-aa9d-feb398cd0061",
|
|
name="Foo",
|
|
external_references=[
|
|
{
|
|
"url": "https://example2",
|
|
"source_name": "some-source2",
|
|
},
|
|
],
|
|
)
|
|
|
|
def _x_foobar_checks(obj1, obj2, **weights):
|
|
matching_score = 0.0
|
|
sum_weights = 0.0
|
|
if stix2.environment.check_property_present("external_references", obj1, obj2):
|
|
w = weights["external_references"]
|
|
sum_weights += w
|
|
matching_score += w * stix2.environment.partial_external_reference_based(
|
|
obj1["external_references"],
|
|
obj2["external_references"],
|
|
)
|
|
if stix2.environment.check_property_present("name", obj1, obj2):
|
|
w = weights["name"]
|
|
sum_weights += w
|
|
matching_score += w * stix2.environment.partial_string_based(obj1["name"], obj2["name"])
|
|
return matching_score, sum_weights
|
|
|
|
weights = {
|
|
"x-foobar": {
|
|
"external_references": 40,
|
|
"name": 60,
|
|
"method": _x_foobar_checks,
|
|
},
|
|
"_internal": {
|
|
"ignore_spec_version": False,
|
|
},
|
|
}
|
|
cust1 = stix2.parse(CUSTOM_KWARGS1, allow_custom=True)
|
|
cust2 = stix2.parse(CUSTOM_KWARGS2, allow_custom=True)
|
|
env = stix2.Environment().semantically_equivalent(cust1, cust2, **weights)
|
|
assert round(env) == 0
|
|
|
|
|
|
def test_semantic_equivalence_different_type_raises():
|
|
with pytest.raises(ValueError) as excinfo:
|
|
vul1 = stix2.v21.Vulnerability(id=VULNERABILITY_ID, **VULNERABILITY_KWARGS)
|
|
ind1 = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
stix2.Environment().semantically_equivalent(vul1, ind1)
|
|
|
|
assert str(excinfo.value) == "The objects to compare must be of the same type!"
|
|
|
|
|
|
def test_semantic_equivalence_different_spec_version_raises():
|
|
with pytest.raises(ValueError) as excinfo:
|
|
V20_KWARGS = dict(
|
|
labels=['malicious-activity'],
|
|
pattern="[file:hashes.MD5 = 'd41d8cd98f00b204e9800998ecf8427e']",
|
|
)
|
|
ind1 = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
ind2 = stix2.v20.Indicator(id=INDICATOR_ID, **V20_KWARGS)
|
|
stix2.Environment().semantically_equivalent(ind1, ind2)
|
|
|
|
assert str(excinfo.value) == "The objects to compare must be of the same spec version!"
|
|
|
|
|
|
def test_semantic_equivalence_zero_match():
|
|
IND_KWARGS = dict(
|
|
indicator_types=["APTX"],
|
|
pattern="[ipv4-addr:value = '192.168.1.1']",
|
|
pattern_type="stix",
|
|
valid_from="2019-01-01T12:34:56Z",
|
|
)
|
|
weights = {
|
|
"indicator": {
|
|
"indicator_types": (15, stix2.environment.partial_list_based),
|
|
"pattern": (80, stix2.environment.custom_pattern_based),
|
|
"valid_from": (5, stix2.environment.partial_timestamp_based),
|
|
"tdelta": 1, # One day interval
|
|
},
|
|
"_internal": {
|
|
"ignore_spec_version": False,
|
|
},
|
|
}
|
|
ind1 = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
ind2 = stix2.v21.Indicator(id=INDICATOR_ID, **IND_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ind1, ind2, **weights)
|
|
assert round(env) == 0
|
|
|
|
|
|
def test_semantic_equivalence_different_spec_version():
|
|
IND_KWARGS = dict(
|
|
labels=["APTX"],
|
|
pattern="[ipv4-addr:value = '192.168.1.1']",
|
|
)
|
|
weights = {
|
|
"indicator": {
|
|
"indicator_types": (15, stix2.environment.partial_list_based),
|
|
"pattern": (80, stix2.environment.custom_pattern_based),
|
|
"valid_from": (5, stix2.environment.partial_timestamp_based),
|
|
"tdelta": 1, # One day interval
|
|
},
|
|
"_internal": {
|
|
"ignore_spec_version": True, # Disables spec_version check.
|
|
},
|
|
}
|
|
ind1 = stix2.v21.Indicator(id=INDICATOR_ID, **INDICATOR_KWARGS)
|
|
ind2 = stix2.v20.Indicator(id=INDICATOR_ID, **IND_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(ind1, ind2, **weights)
|
|
assert round(env) == 0
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"refs1,refs2,ret_val", [
|
|
(
|
|
[
|
|
{
|
|
"url": "https://attack.mitre.org/techniques/T1150",
|
|
"source_name": "mitre-attack",
|
|
"external_id": "T1150",
|
|
},
|
|
{
|
|
"url": "https://researchcenter.paloaltonetworks.com/2016/09/unit42-sofacys-komplex-os-x-trojan/",
|
|
"source_name": "Sofacy Komplex Trojan",
|
|
"description": "Dani Creus, Tyler Halfpop, Robert Falcone. (2016, September 26). Sofacy's 'Komplex' OS X Trojan. Retrieved July 8, 2017.",
|
|
},
|
|
],
|
|
[
|
|
{
|
|
"url": "https://attack.mitre.org/techniques/T1129",
|
|
"source_name": "mitre-attack",
|
|
"external_id": "T1129",
|
|
},
|
|
{
|
|
"url": "https://en.wikipedia.org/wiki/Microsoft_Windows_library_files",
|
|
"source_name": "Wikipedia Windows Library Files",
|
|
"description": "Wikipedia. (2017, January 31). Microsoft Windows library files. Retrieved February 13, 2017.",
|
|
},
|
|
],
|
|
0.0,
|
|
),
|
|
(
|
|
[
|
|
{
|
|
"url": "https://attack.mitre.org/techniques/T1129",
|
|
"source_name": "mitre-attack",
|
|
"external_id": "T1129",
|
|
},
|
|
],
|
|
[
|
|
{
|
|
"url": "https://attack.mitre.org/techniques/T1129",
|
|
"source_name": "mitre-attack",
|
|
"external_id": "T1129",
|
|
},
|
|
{
|
|
"url": "https://en.wikipedia.org/wiki/Microsoft_Windows_library_files",
|
|
"source_name": "Wikipedia Windows Library Files",
|
|
"description": "Wikipedia. (2017, January 31). Microsoft Windows library files. Retrieved February 13, 2017.",
|
|
},
|
|
],
|
|
1.0,
|
|
),
|
|
(
|
|
[
|
|
{
|
|
"url": "https://example",
|
|
"source_name": "some-source",
|
|
},
|
|
],
|
|
[
|
|
{
|
|
"url": "https://example",
|
|
"source_name": "some-source",
|
|
},
|
|
],
|
|
1.0,
|
|
),
|
|
],
|
|
)
|
|
def test_semantic_equivalence_external_references(refs1, refs2, ret_val):
|
|
value = stix2.environment.partial_external_reference_based(refs1, refs2)
|
|
assert value == ret_val
|
|
|
|
|
|
def test_semantic_equivalence_timestamp():
|
|
t1 = "2018-10-17T00:14:20.652Z"
|
|
t2 = "2018-10-17T12:14:20.652Z"
|
|
assert stix2.environment.partial_timestamp_based(t1, t2, 1) == 0.5
|
|
|
|
|
|
def test_semantic_equivalence_exact_match():
|
|
t1 = "2018-10-17T00:14:20.652Z"
|
|
t2 = "2018-10-17T12:14:20.652Z"
|
|
assert stix2.environment.exact_match(t1, t2) == 0.0
|
|
|
|
|
|
def test_non_existent_config_for_object():
|
|
r1 = stix2.v21.Report(id=REPORT_ID, **REPORT_KWARGS)
|
|
r2 = stix2.v21.Report(id=REPORT_ID, **REPORT_KWARGS)
|
|
assert stix2.Environment().semantically_equivalent(r1, r2) == 0.0
|
|
|
|
|
|
def custom_semantic_equivalence_method(obj1, obj2, **weights):
|
|
return 96.0, 100.0
|
|
|
|
|
|
def test_semantic_equivalence_method_provided():
|
|
# Because `method` is provided, `partial_list_based` will be ignored
|
|
TOOL2_KWARGS = dict(
|
|
name="Random Software",
|
|
tool_types=["information-gathering"],
|
|
)
|
|
|
|
weights = {
|
|
"tool": {
|
|
"tool_types": (20, stix2.environment.partial_list_based),
|
|
"name": (80, stix2.environment.partial_string_based),
|
|
"method": custom_semantic_equivalence_method,
|
|
},
|
|
}
|
|
|
|
tool1 = stix2.v21.Tool(id=TOOL_ID, **TOOL_KWARGS)
|
|
tool2 = stix2.v21.Tool(id=TOOL_ID, **TOOL2_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(tool1, tool2, **weights)
|
|
assert round(env) == 96
|
|
|
|
|
|
def test_semantic_equivalence_prop_scores():
|
|
TOOL2_KWARGS = dict(
|
|
name="Random Software",
|
|
tool_types=["information-gathering"],
|
|
)
|
|
|
|
prop_scores = {}
|
|
|
|
tool1 = stix2.v21.Tool(id=TOOL_ID, **TOOL_KWARGS)
|
|
tool2 = stix2.v21.Tool(id=TOOL_ID, **TOOL2_KWARGS)
|
|
stix2.Environment().semantically_equivalent(tool1, tool2, prop_scores)
|
|
assert len(prop_scores) == 4
|
|
assert round(prop_scores["matching_score"], 1) == 8.8
|
|
assert round(prop_scores["sum_weights"], 1) == 100.0
|
|
|
|
|
|
def custom_semantic_equivalence_method_prop_scores(obj1, obj2, prop_scores, **weights):
|
|
prop_scores["matching_score"] = 96.0
|
|
prop_scores["sum_weights"] = 100.0
|
|
return 96.0, 100.0
|
|
|
|
|
|
def test_semantic_equivalence_prop_scores_method_provided():
|
|
TOOL2_KWARGS = dict(
|
|
name="Random Software",
|
|
tool_types=["information-gathering"],
|
|
)
|
|
|
|
weights = {
|
|
"tool": {
|
|
"tool_types": 20,
|
|
"name": 80,
|
|
"method": custom_semantic_equivalence_method_prop_scores,
|
|
},
|
|
}
|
|
|
|
prop_scores = {}
|
|
|
|
tool1 = stix2.v21.Tool(id=TOOL_ID, **TOOL_KWARGS)
|
|
tool2 = stix2.v21.Tool(id=TOOL_ID, **TOOL2_KWARGS)
|
|
env = stix2.Environment().semantically_equivalent(tool1, tool2, prop_scores, **weights)
|
|
assert round(env) == 96
|
|
assert len(prop_scores) == 2
|
|
assert prop_scores["matching_score"] == 96.0
|
|
assert prop_scores["sum_weights"] == 100.0
|