HexraysToolbox

HexRaysツールボックス

Hexrays Toolbox（HXTB）は、基礎となるプロセッサアーキテクチャから独立した、バイナリのコードパターンを見つけて見つけるために使用できるIdapythonスクリプトの強力なセットです。

ユースケース

• 脆弱性とバリアントのバイナリファイルをスキャンします
• 新しく逆コンパイルされたコードで、以前にリバースエンジニアリングした実行可能ファイルからコードパターンを見つける
• マルウェアバリアント分析
• いくつかのバイナリでコードの類似点を見つけます（つまり、「コード盗難」、ライセンス違反などを証明するために...）
• アーキテクチャAのためにコンパイルされたバイナリからコードパターンを見つけますアーキテクチャ用にコンパイルされたバイナリで
• おそらくもっと...

以下のアニメーションに示されているクエリは、AndroidのWhatsAppに影響を与えた脆弱性（CVE-2019-3568、libwhatsApp.SO）をHexRays Toolboxを使用してどのように配置できるかの例です。これは、iDapython lambda関数を使用して配置する目的のコードパターンを策定することによって行われます。例のスクリプトを見つけます。

要件

有効なIDAライセンスと、ターゲットアーキテクチャごとに有効なヘキサレイ逆コンパイラライセンスが必要です。

使用法

HexRaysツールボックスを使用する方法はいくつかあり、それぞれに柔軟性の程度がさまざまです。

• インタラクティブなGUIであるhxtb_shellに代わってクエリを実行します
• カスタムidapythonスクリプト
• interactive.py 、IDAコマンドラインインターフェイスで使用する便利な関数を追加するスクリプト
• automation.py 、バッチモードの特定のファイルセットでHXTBクエリを処理および実行するスクリプト

hxtb-shell

IDA内から付属のhxtb_shell.pyスクリプトを実行すると、HXTBクエリの開発、ロード、実行に使用できるGUIウィンドウが開きます。下のスクリーンショットは、HXTB-Shellでロードされたクエリがどのように見えるかを示しています。

HXTB-Shellは、Hrdevhelperプラグインのコンテキストビューアーによって作成されたPython式を受け入れます。それらからコピーして、hxtb-shell guiに直接貼り付けることができます。

---

HXTB-SHELLでロードできるさらなる例のクエリは、HEXRAYSツールボックスに含まれるhxtbshell_queriesサブフォルダーにあります。

スクリプト

hxtb.pyをIDA（alt-f7）でロードすると、Idapython CLIとスクリプトインタープリター（Shift-F2）の両方がfind_expr()やfind_item()などの要素を使用できます。とりわけ、これらの機能を使用して、現在ロードされているIDAデータベースでクエリを実行できます。以下に示す例のいくつかをご覧ください。

    find_item(ea, q)
    find_expr(ea, q)

    Positional arguments:
        ea:         address of a valid function within
                    the current database
        q:          lambda function
                    custom lambda function with the following arguments:
                    1. cfunc: cfunc_t
                    2. i/e:   cinsn_t/cexpr_t
    Returns:
        list of query_result_t objects

    Example:
        find_expr(here(), lambda cf, e: e.op is cot_call)
    
        -> finds and returns all function calls within a current function.
        The returned data is a list of query_result_t objects (see hxtb.py).

        The returned list can be passed to an instance of the ic_t class,
        which causes the data to be displayed by a chooser as follows:

        from idaapi import *
        import hxtb
        hxtb.ic_t(find_expr(here(), lambda cf,e:e.op is cot_call))


    Please find the cfunc_t, citem_t, cinsn_t and cexpr_t structures
    within hexrays.hpp for further help and details.

例

何でもゼロと比較する式を一覧表示します（ "x == 0"）

         cot_eq
         /   
      x /      y
(anything)  cot_num --- n.numval() == 0

 from idaapi import *
from hxtb import find_expr
query = lambda cfunc , e : e . op is cot_eq and e . y . op is cot_num and e . y . numval () == 0
r = find_expr ( here (), query )
for e in r :
    print ( e )

リスト（直接）関数呼び出し

        cot_call
         / 
      x /
 cot_obj

 from idaapi import *
from hxtb import find_expr
query = lambda cfunc , e : e . op is cot_call and e . x . op is cot_obj
r = find_expr ( here (), query )
for e in r :
    print ( e )

「DST」引数がスタック上にある場合、MEMCPY呼び出しをリストします

        cot_call --- arg1 is cot_var
         /           arg1 is on stack
      x /
 cot_obj --- name(obj_ea) == 'memcpy'

 from idaapi import *
from hxtb import find_expr
r = []
query = lambda cfunc , e : ( e . op is cot_call and
           e . x . op is cot_obj and
           get_name ( e . x . obj_ea ) == 'memcpy' and
           len ( e . a ) == 3 and
           e . a [ 0 ]. op is cot_var and
           cfunc . lvars [ e . a [ 0 ]. v . idx ]. is_stk_var ())
for ea in Functions ():
    r += find_expr ( ea , query )
for e in r :
    print ( e )

FMTには「％s」が含まれているsprintf（str、fmt、...）への呼び出しをリストします

        cot_call --- arg2 ('fmt') contains '%s'
         /
      x /
 cot_obj --- name(obj_ea) == 'sprintf'

 from idaapi import *
from hxtb import find_expr
r = []
query = lambda cfunc , e : ( e . op is cot_call and
    e . x . op is cot_obj and
    get_name ( e . x . obj_ea ) == 'sprintf' and
    len ( e . a ) >= 2 and
    e . a [ 1 ]. op is cot_obj and
    is_strlit ( get_flags ( get_item_head ( e . a [ 1 ]. obj_ea ))) and
    b'%s' in get_strlit_contents ( e . a [ 1 ]. obj_ea , - 1 , 0 , STRCONV_ESCAPE ))
for ea in Functions ():
    r += find_expr ( ea , query )
for e in r :
    print ( e )

リストビューに署名された演算子を使用してすべての指示を表示する

 from idaapi import *
from hxtb import ic_t
query = lambda cfunc , e : ( e . op in
            [ cot_asgsshr , cot_asgsdiv ,
            cot_asgsmod , cot_sge ,
            cot_sle , cot_sgt ,
            cot_slt , cot_sshr ,
            cot_sdiv , cot_smod ])
ic_t ( query )

リストビューにすべての「if」ステートメントを表示します

 from idaapi import *
from hxtb import ic_t
ic_t ( lambda cf , i : i . op is cit_if )

現在のdb内ですべてのループステートメントを見つける、表示結果ビューが表示されます

 from idaapi import *
from hxtb import ic_t , query_db
ic_t ( query_db ( lambda cf , i : is_loop ( i . op )))

リストビューに潜在的なメモリコピー操作を表示します

 from hxtb import ic_t , query_db , find_child_expr
from ida_hexrays import *


find_copy_query = lambda cfunc , i : ( i . op is cot_asg and
                                i . x . op is cot_ptr and
                                i . y . op is cot_ptr )

find_loop_query = lambda cfunc , i : ( is_loop ( i . op ) and
                            find_child_expr ( cfunc , i , find_copy_query ))


ic_t ( query_db ( find_loop_query ))