dissect.database 1.2.dev3

A Dissect module implementing parsers for various database formats, including Berkeley DB, Microsofts Extensible Storage Engine (ESE) and SQLite3

dissect.database

A Dissect module implementing parsers for various database formats, including:

• Berkeley DB, used for example in older RPM databases
• Microsofts Extensible Storage Engine (ESE), used for example in Active Directory, Exchange and Windows Update
• SQLite3, commonly used by applications to store configuration data

For more information, please see the documentation.

Installation

dissect.database is available on PyPI.

pip install dissect.database

This module is also automatically installed if you install the dissect package.

Tools

Some CLI tools related to specific databases exists. These tools allow you to dump or inspect database content.

Commands	Description
dissect-ntds	Windows NTDS (Active Directory database).
dissect-ual	Windows User Access Logging database.
dissect-sru	Windows System Resources And Usage Monitor database.
dissect-certlog	Windows AD CS database database.
dissect-rpm	Red Hat Package Manager database.
dissect-impacket	Impacket compatibility shim for secretsdump.py.

Impacket compatibility shim for secretsdump.py

Impacket does not (yet) have native support for dissect.database, so in the meantime a compatibility shim is provided. To use this shim, simply install dissect.database using the instructions above, and execute secretsdump.py like so:

dissect-impacket /path/to/impacket/examples/secretsdump.py -h

Impacket secretsdump.py will now use dissect.database for parsing the NTDS.dit file, resulting in a significant performance improvement!

Build and test instructions

This project uses tox to build source and wheel distributions. Run the following command from the root folder to build these:

tox -e build

The build artifacts can be found in the dist/ directory.

tox is also used to run linting and unit tests in a self-contained environment. To run both linting and unit tests using the default installed Python version, run:

tox

For a more elaborate explanation on how to build and test the project, please see the documentation.

Contributing

The Dissect project encourages any contribution to the codebase. To make your contribution fit into the project, please refer to the development guide.

Copyright and license

Dissect is released as open source by Fox-IT (https://www.fox-it.com) part of NCC Group Plc (https://www.nccgroup.com).

Developed by the Dissect Team ([e-mail]) and made available at https://github.com/fox-it/dissect.

License terms: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0). For more information, see the LICENSE file.