Skip to content

Latest commit

 

History

History
25 lines (19 loc) · 1.71 KB

README.md

File metadata and controls

25 lines (19 loc) · 1.71 KB

Debird

Deobfuscating/decrypting various drivers, one at a time. Debird deobfuscates a variety of binaries including CLIPSP.SYS and SPSYS.SYS.

Important

Debird is currently in alpha. That means support is experimental and issues are abound. Additionally, Debird requires manual source code tweaking to use.

What happened to Declipt?

The scope of Declipt, previously pertaining solely to CLIPSP.SYS, was too narrow, so Debird was born.

Special Thanks

…to WitherOrNot for researching and cracking Warbird.

Usage

To use Debird, clone the Git repository, create a folder called emu64 in the project root, and put <driver>.sys into emu64. Make sure you adjust the addresses in declipt::constants to match your version of <driver>.sys.

Important

For ClipSp.sys

You must patch ClipSp.sys's true main entrypoint (you can find this in IDA Pro using CTRL+E) to return 1. The patched bytes are available in declipt::hook::CANCEL_DRIVER_ENTRY. Then, you need to create fake kernel imports for NTOSKRNL.EXE, FLTMGR.SYS, HAL.DLL, and KSECDD.SYS. Next, put the fake kernel imports in emu64. Finally, set the 0x2000 (File is a DLL) flag in ClipSp.sys. You can use PE Bear for this.

Specialized Support for Miscellaneous Drivers

Debird also offers support for deobfuscating other drivers. In particular, the following are supported:

  • SPSYS.SYS

It is up to the user to ensure that the driver is in the correct state and is correctly patched to be emulated.