mirror of
https://github.com/mandiant/capa.git
synced 2025-12-20 22:33:04 -08:00
cf3494d427
* initial commit * update changelog * Update CHANGELOG.md * Update pyproject.toml * Apply suggestions from code review: Typos Co-authored-by: Vasco Schiavo <115561717+VascoSch92@users.noreply.github.com> * capa/helpers.py: update if/else statement Co-authored-by: Vasco Schiavo <115561717+VascoSch92@users.noreply.github.com> * loader.py: replace print() statement with log.info() * Update capa/features/extractors/drakvuf/models.py Co-authored-by: Moritz <mr-tz@users.noreply.github.com> * extractors/drakvuf/call.py: yield arguments right to left * extractors/drakvuf/file.py: add a TODO comment for extracting more file features * extractors/drakvuf/global_.py: add arch extraction * extractors/drakvuf/helpers.py: ignore null pids * capa/helpers.py: mention msgspec.json explicitely * capa/helpers.py: generalize empty sandbox reports error logging * capa/loader.py: log jsonl garbage collection into debug * features/extractors/drakvuf/models.py: add documentation for SystemCall class * capa/main.py: fix erroneous imports * drakvuf extractor: fixed faulty type annotations * fix black formatting * fix flake8 issues * drakvuf file extraction: add link to tracking issue * drakvuf reports: add the ability to read gzip-compressed report files * capa/helpers.py: fix mypy issues * apply review comments * drakvuf/helpers.py: add more information about null pid * drakvuf/file.py: remove discovered_dlls file strings extraction * capa/helpers.py: add comments for the dynamic extensions * capa/helpers.py: log bad lines * capa/helpers.py: add gzip support for reading one jsonl line * drakvuf/helpers.py: add comment for sort_calls() * tests/fixtures.py: add TODO for unifying CAPE and Drakvuf tests * drakvuf/models.py: add TODO comment for supporting more drakvuf plugins * tests/fixtures.py: remove obsolete file strings tests * Update capa/main.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * Update capa/features/extractors/drakvuf/models.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * Update capa/features/extractors/drakvuf/models.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * Update capa/features/extractors/drakvuf/call.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * Update CHANGELOG.md Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * Update capa/features/extractors/drakvuf/helpers.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * review comments * Update capa/features/extractors/drakvuf/extractor.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * Update capa/features/extractors/drakvuf/models.py Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> * styling * drakvuf/extractor.py: black linting * drakvuf/models.py: remove need to empty report checking * tests: add drakvuf models test * Update capa/features/extractors/drakvuf/global_.py Co-authored-by: msm-cert <156842376+msm-cert@users.noreply.github.com> * Update tests/test_cape_features.py Co-authored-by: msm-cert <156842376+msm-cert@users.noreply.github.com> * Update capa/features/extractors/drakvuf/models.py Co-authored-by: msm-cert <156842376+msm-cert@users.noreply.github.com> * Apply suggestions from code review: rename Drakvuf to DRAKVUF Co-authored-by: msm-cert <156842376+msm-cert@users.noreply.github.com> * drakvuf/call.py: use int(..., 0) instead of str_to_number() * remove str_to_number * drakvuf/call.py: yield argument memory address value as well * Update call.py: remove verbosity in yield statement * Update call.py: yield missing address as well * drakvuf/call.py: yield entire argument string only * update readme.md * Update README.md: typo * Update CHANGELOG.md Co-authored-by: msm-cert <156842376+msm-cert@users.noreply.github.com> --------- Co-authored-by: Vasco Schiavo <115561717+VascoSch92@users.noreply.github.com> Co-authored-by: Moritz <mr-tz@users.noreply.github.com> Co-authored-by: Willi Ballenthin <willi.ballenthin@gmail.com> Co-authored-by: msm-cert <156842376+msm-cert@users.noreply.github.com>
89 lines
4.1 KiB
Python
89 lines
4.1 KiB
Python
# Copyright (C) 2023 Mandiant, Inc. All Rights Reserved.
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at: [package root]/LICENSE.txt
|
|
# Unless required by applicable law or agreed to in writing, software distributed under the License
|
|
# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and limitations under the License.
|
|
|
|
import fixtures
|
|
|
|
import capa.main
|
|
import capa.features.file
|
|
import capa.features.insn
|
|
import capa.features.common
|
|
|
|
DYNAMIC_DRAKVUF_FEATURE_PRESENCE_TESTS = sorted(
|
|
[
|
|
("93b2d1", "file", capa.features.common.String("\\Program Files\\WindowsApps\\does_not_exist"), False),
|
|
# file/imports
|
|
("93b2d1", "file", capa.features.file.Import("SetUnhandledExceptionFilter"), True),
|
|
# thread/api calls
|
|
("93b2d1", "process=(3564:4852),thread=6592", capa.features.insn.API("LdrLoadDll"), True),
|
|
("93b2d1", "process=(3564:4852),thread=6592", capa.features.insn.API("DoesNotExist"), False),
|
|
# call/api
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.API("LdrLoadDll"), True),
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.API("DoesNotExist"), False),
|
|
# call/string argument
|
|
(
|
|
"93b2d1",
|
|
"process=(3564:4852),thread=6592,call=1",
|
|
capa.features.common.String('0x667e2beb40:"api-ms-win-core-fibers-l1-1-1"'),
|
|
True,
|
|
),
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.common.String("non_existant"), False),
|
|
# call/number argument
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.Number(0x801), True),
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.Number(0x010101010101), False),
|
|
],
|
|
# order tests by (file, item)
|
|
# so that our LRU cache is most effective.
|
|
key=lambda t: (t[0], t[1]),
|
|
)
|
|
|
|
DYNAMIC_DRAKVUF_FEATURE_COUNT_TESTS = sorted(
|
|
[
|
|
("93b2d1", "file", capa.features.common.String("\\Program Files\\WindowsApps\\does_not_exist"), False),
|
|
# file/imports
|
|
("93b2d1", "file", capa.features.file.Import("SetUnhandledExceptionFilter"), 1),
|
|
# thread/api calls
|
|
("93b2d1", "process=(3564:4852),thread=6592", capa.features.insn.API("LdrLoadDll"), 9),
|
|
("93b2d1", "process=(3564:4852),thread=6592", capa.features.insn.API("DoesNotExist"), False),
|
|
# call/api
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.API("LdrLoadDll"), 1),
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.API("DoesNotExist"), 0),
|
|
# call/string argument
|
|
(
|
|
"93b2d1",
|
|
"process=(3564:4852),thread=6592,call=1",
|
|
capa.features.common.String('0x667e2beb40:"api-ms-win-core-fibers-l1-1-1"'),
|
|
1,
|
|
),
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.common.String("non_existant"), 0),
|
|
# call/number argument
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.Number(0x801), 1),
|
|
("93b2d1", "process=(3564:4852),thread=6592,call=1", capa.features.insn.Number(0x010101010101), 0),
|
|
],
|
|
# order tests by (file, item)
|
|
# so that our LRU cache is most effective.
|
|
key=lambda t: (t[0], t[1]),
|
|
)
|
|
|
|
|
|
@fixtures.parametrize(
|
|
"sample,scope,feature,expected",
|
|
DYNAMIC_DRAKVUF_FEATURE_PRESENCE_TESTS,
|
|
indirect=["sample", "scope"],
|
|
)
|
|
def test_drakvuf_features(sample, scope, feature, expected):
|
|
fixtures.do_test_feature_presence(fixtures.get_drakvuf_extractor, sample, scope, feature, expected)
|
|
|
|
|
|
@fixtures.parametrize(
|
|
"sample,scope,feature,expected",
|
|
DYNAMIC_DRAKVUF_FEATURE_COUNT_TESTS,
|
|
indirect=["sample", "scope"],
|
|
)
|
|
def test_drakvuf_feature_counts(sample, scope, feature, expected):
|
|
fixtures.do_test_feature_count(fixtures.get_drakvuf_extractor, sample, scope, feature, expected)
|