BinSentry 启动调试反汇编与Python SDK使用入门

微软技术分享 微软技术分享 墨衍会员 · AI 创作全网分发 墨衍智能分发 通过墨衍一键同步至各平台 可同步平台 CSDN微信公众号微博知乎掘金百家号博客园抖音小红书 你的文章也可以这样分发 墨衍会员 ¥399起/年,写一次发全网 我也要 + 加入社区

BinSentry 内置调试引擎,支持两种调试场景:调试 EXE 可执行程序、调试 DLL 动态链接库,两种模式均可通过 Python SDK 脚本进行远程调用控制。启动 BinSentry 服务端后,可以打开控制台窗口查看程序完整执行日志;控制台持续打印日志会带来性能损耗,生产环境建议关闭控制台输出,提升调试执行效率。

通过使用如下方式打开控制台窗口,观察程序的详细执行流程。控制台打开状态下由于持续输出会导致调试变慢,生产环境中建议关闭输出窗口屏蔽输出,提高执行效率。

image

调试命令有两种,一种是debug主要用于附加一个exe可执行程序,另一个是debug_dll主要针对的是dll动态链接库,使用dll调试是通过加载BinLoader32.exe到进程空间内,并通过切入DLL模块实现的。

以EXE调试为例,使用如下代码打开一个调试功能。

from BinSentry import *

if __name__ == "__main__":
    config = Config(
        address="127.0.0.1",
        port=6891,
        api_key="45d3552b12b12cdf2c831344311cf81e"
        )

    client = BinSentryClient(config=config)

    dbg = client.debug("c://win32.exe","","c://")
    print(dbg)

执行后输出如下提示:

{
  "status": "success",
  "result": {
    "state": true,
    "message": "Debugging session started",
    "pid": 1204,
    "tid": 4372,
    "path": "c://win32.exe"
  },
  "timestamp": 3185671
}

同理,后台会看到页面加载执行流程:

image

此时,可以通过这个句柄接口,完成其他功能的调用测试,例如读取寄存器的值,并输出EIP中的内容。

from BinSentry import *
import json

if __name__ == "__main__":
    config = Config(
        address="127.0.0.1",
        port=6891,
        api_key="45d3552b12b12cdf2c831344311cf81e"
    )
    client = BinSentryClient(config=config)
    try:
        client.detach()
    except Exception:
        pass

    raw_dbg_resp = client.debug("c://win32.exe", "", "c://")

    # SDK返回原始JSON字符串,务必loads转dict
    dbg = json.loads(raw_dbg_resp)
    print("Debug session:", dbg)

    if dbg["status"] != "success":
        print("Create debug session failed:", dbg["result"]["message"])
        exit(-1)

    # 读取寄存器值
    raw_reg_resp = client.register()
    resp = json.loads(raw_reg_resp)
    print("Register response: ", resp)

    # 读取EIP寄存器
    if resp["status"] == "success":
        eip_val = resp["result"]["registers"]["eip"]
        eip_hex = resp["result"]["registers"]["eipHex"]
        print(f"EIP decimal = {eip_val}")
        print(f"EIP hex = {eip_hex}")

    # 后续恢复运行
    client.run()

输出内容如下所示:

Debug session:
{
    'status': 'success',
    'result': {
        'state': True,
        'message': 'Debuggingsessionstarted',
        'pid': 17136,
        'tid': 9252,
        'path': 'c: //win32.exe'
    },
    'timestamp': 3602921
}

Register response:
{
    'status': 'success',
    'result': {
        'command': 'Register',
        'registers': {
            'eax': 0,
            'eaxHex': '0x00000000',
            'ebx': 16,
            'ebxHex': '0x00000010',
            'ecx': 12910592,
            'ecxHex': '0x00C50000',
            'edx': 0,
            'edxHex': '0x00000000',
            'esi': 24387496,
            'esiHex': '0x01741FA8',
            'edi': 18706432,
            'ediHex': '0x011D7000',
            'esp': 20312972,
            'espHex': '0x0135F38C',
            'ebp': 20313016,
            'ebpHex': '0x0135F3B8',
            'eip': 2007886279,
            'eipHex': '0x77ADE9C7',
            'eflags': 582,
            'eflagsHex': '0x00000246',
            'cs': 35,
            'csHex': '0x00000023',
            'ss': 43,
            'ssHex': '0x0000002B',
            'ds': 43,
            'dsHex': '0x0000002B',
            'es': 43,
            'esHex': '0x0000002B',
            'fs': 83,
            'fsHex': '0x00000053',
            'gs': 43,
            'gsHex': '0x0000002B',
            'dr0': 0,
            'dr0Hex': '0x00000000',
            'dr1': 0,
            'dr1Hex': '0x00000000',
            'dr2': 0,
            'dr2Hex': '0x00000000',
            'dr3': 0,
            'dr3Hex': '0x00000000',
            'dr6': 0,
            'dr6Hex': '0x00000000',
            'dr7': 0,
            'dr7Hex': '0x00000000',
            'fp_control': 639,
            'fp_status': 0,
            'fp_tag': 65535,
            'mxcsr': 0,
            'xmm': [
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000',
                '0x00000000000000000000000000000000'
            ]
        },
        'state': True
    },
    'timestamp': 3602937
}

EIP decimal = 2007886279
EIP hex = 0x77ADE9C7

拿到EIP的值,就可以继续执行反汇编功能:

from BinSentry import *
import json

if __name__ == "__main__":
    config = Config(
        address="127.0.0.1",
        port=6891,
        api_key="45d3552b12b12cdf2c831344311cf81e"
    )
    client = BinSentryClient(config=config)
    try:
        client.detach()
    except Exception:
        pass

    raw_dbg_resp = client.debug("c://win32.exe", "", "c://")

    # SDK返回原始JSON字符串,务必loads转dict
    dbg = json.loads(raw_dbg_resp)
    print("Debug session:", dbg)

    if dbg["status"] != "success":
        print("Create debug session failed:", dbg["result"]["message"])
        exit(-1)

    # 读取寄存器值
    raw_reg_resp = client.register()
    resp = json.loads(raw_reg_resp)
    eip_hex = resp["result"]["registers"]["eipHex"]
    print(f"EIP hex = {eip_hex}")

    # EIP反汇编
    raw_disasm_resp = client.dissasembler(address=eip_hex,count=5)
    print("Disassemble response: ", raw_disasm_resp)

    # 后续恢复运行
    client.run()

执行反汇编并输出前5行。

Debug session:
{
    'status': 'success',
    'result': {
        'state': True,
        'message': 'Debuggingsessionstarted',
        'pid': 15548,
        'tid': 7616,
        'path': 'c: //win32.exe'
    },
    'timestamp': 4107531
}

EIP hex = 0x77ADE9C7

Disassemble response:
{
  "status": "success",
  "result": {
    "command": "Dissasembler",
    "address": 2007886279,
    "addressHex": "0x77ADE9C7",
    "count": 5,
    "instructions": [
      {
        "address": 2007886279,
        "ad\ndressHex": "0x77ADE9C7",
        "bytes": "EB 07",
        "mnemonic": "jmp",
        "op_str": "0x77ade9d0",
        "module": "ntdll.dll"
      },
      {
        "address": 2007886281,
        "addressHex": "0x77ADE9C9",
        "bytes": "33 C0",
        "mnemonic": "\nxor",
        "op_str": "eax, eax",
        "module": "ntdll.dll"
      },
      {
        "address": 2007886283,
        "addressHex": "0x77ADE9CB",
        "bytes": "40",
        "mnemonic": "inc",
        "op_str": "eax",
        "module": "ntdll.dll"
      },
      {
        "address": 2007886284,
        "addressHex": "0x77ADE9CC",
        "bytes": "C3",
        "mnemonic": "ret",
        "op_str": "",
        "module": "ntdll.dll"
      },
      {
        "address": 2007886285,
        "addressHex": "0x77ADE9CD",
        "bytes": "8B 65 E8",
        "mnemonic": "mov",
        "op_str": "esp, dword ptr [ebp - 0x18]",
        "module": "ntdll.dll"
      }
    ],
    "state": true
  },
  "timestamp": 4107546
}
...全文

相关推荐

政府科技管理者如何提升科技成果转化项目进场交易的备案效率?.docx

政府科技管理者如何提升科技成果转化项目进场交易的备案效率?

BIZKEEN

山区道路边坡落石隐患检测数据集VOC+YOLO格式241张1类别.md

【重要提示】本页面仅为资源介绍,不含外部下载地址 亲爱的 CSDN 用户: 感谢你浏览本资源页面,在这里提前向大家说明相关情况,避免后续产生误解。本资源我设置的初衷是 0 积分免费分享文档介绍,希望可以无偿给到有需要的朋友。但 CSDN 平台存在自动调控机制,系统会根据资源下载热度、文件体积、平台规则等因素,自动修改资源所需下载积分,页面显示为 1 积分、2 积分或更高积分都属于平台自动调整结果,并非我手动修改设置,我没有权限自主锁定积分数值。 如果你打开页面后,发现下载所需积分不为 0,请务必谨慎考虑是否下载。一旦你支付积分完成下载,后续遇到资源内容和描述不符、文件损坏等问题,我无法承担对应的积分损失,也没有渠道为你办理积分退还。在此强烈建议,只有页面明确显示 0 积分的时候,再进行下载操作。 同时特别说明:这份资源介绍文案里,没有附带任何外部下载地址。资源本身是通过 CSDN 官方上传通道上传的附件,正常情况下直接点击页面自带的下载按钮即可获取文件。页面找不到外部下载链接属于正常情况,并非资源缺失。 如果因为平台积分显示异常,导致你被扣取积分,积分退款、积分异常相关问题,请直接联系 CSDN 官方客服咨询处理。平台规则由官方制定,我无法干预积分变动,望各位理解。

fl176831

高空作业栏杆检测数据集VOC+YOLO格式230张3类别.md

【重要提示】本页面仅为资源介绍,不含外部下载地址 亲爱的 CSDN 用户: 感谢你浏览本资源页面,在这里提前向大家说明相关情况,避免后续产生误解。本资源我设置的初衷是 0 积分免费分享文档介绍,希望可以无偿给到有需要的朋友。但 CSDN 平台存在自动调控机制,系统会根据资源下载热度、文件体积、平台规则等因素,自动修改资源所需下载积分,页面显示为 1 积分、2 积分或更高积分都属于平台自动调整结果,并非我手动修改设置,我没有权限自主锁定积分数值。 如果你打开页面后,发现下载所需积分不为 0,请务必谨慎考虑是否下载。一旦你支付积分完成下载,后续遇到资源内容和描述不符、文件损坏等问题,我无法承担对应的积分损失,也没有渠道为你办理积分退还。在此强烈建议,只有页面明确显示 0 积分的时候,再进行下载操作。 同时特别说明:这份资源介绍文案里,没有附带任何外部下载地址。资源本身是通过 CSDN 官方上传通道上传的附件,正常情况下直接点击页面自带的下载按钮即可获取文件。页面找不到外部下载链接属于正常情况,并非资源缺失。 如果因为平台积分显示异常,导致你被扣取积分,积分退款、积分异常相关问题,请直接联系 CSDN 官方客服咨询处理。平台规则由官方制定,我无法干预积分变动,望各位理解。

fl176831

ti-cgt-c2000-22.6.0.LTS-windows-x64-installer

ti-cgt-c2000-22.6.0.LTS-windows-x64-installer

lkq550

光伏板太阳能板尘土灰尘脏污检测数据集VOC+YOLO格式1006张3类别.md

【重要提示】本页面仅为资源介绍,不含外部下载地址 亲爱的 CSDN 用户: 感谢你浏览本资源页面,在这里提前向大家说明相关情况,避免后续产生误解。本资源我设置的初衷是 0 积分免费分享文档介绍,希望可以无偿给到有需要的朋友。但 CSDN 平台存在自动调控机制,系统会根据资源下载热度、文件体积、平台规则等因素,自动修改资源所需下载积分,页面显示为 1 积分、2 积分或更高积分都属于平台自动调整结果,并非我手动修改设置,我没有权限自主锁定积分数值。 如果你打开页面后,发现下载所需积分不为 0,请务必谨慎考虑是否下载。一旦你支付积分完成下载,后续遇到资源内容和描述不符、文件损坏等问题,我无法承担对应的积分损失,也没有渠道为你办理积分退还。在此强烈建议,只有页面明确显示 0 积分的时候,再进行下载操作。 同时特别说明:这份资源介绍文案里,没有附带任何外部下载地址。资源本身是通过 CSDN 官方上传通道上传的附件,正常情况下直接点击页面自带的下载按钮即可获取文件。页面找不到外部下载链接属于正常情况,并非资源缺失。 如果因为平台积分显示异常,导致你被扣取积分,积分退款、积分异常相关问题,请直接联系 CSDN 官方客服咨询处理。平台规则由官方制定,我无法干预积分变动,望各位理解。

fl176831
评论
收藏 已收藏
分享
返回顶部
微软技术分享
微软技术分享 优质创作者: 编程框架技术领域 优质创作者: 编程框架技术领域领域专家: 操作系统技术领域 领域专家: 操作系统技术领域
微软技术社区 8,629 成员 37,312 内容