akheron proxyダウンロード - akheron proxyソースコードのダウンロード

アクヘロンプロキシ

導入

akheronツールは Python で書かれており、UART チップ間通信を可視化し、それらの通信の理解、反転、操作を支援してデバイスの機能 (意図されたものと意図しないものの両方) を識別できるように設計されています。これは、いくつかの動作モードをサポートすることで実現されます。

ブリッジング通信 - データの可視性を提供しながら、デバイス間でデータをプロキシします。
通信のキャプチャ - UART 通信データを調査および再生のためにファイルに保存します
通信の再生 - キャプチャしたデータをファイルからロードし、UART 接続で再生します。
- ユーザー指定のパターン一致および置換値による再生をサポート
- チェックサムの再計算とメッセージの更新による再生をサポート

物理的なセットアップ

UART を介したチップ間通信は、依然として多くのデバイスで見られる一般的な設計選択であり、次のようになります。

 +------------+                           +------------+
|        TXD +-------------------------->+ RXD        |
| CHIP A     |                           |     CHIP B |
|        RXD +<--------------------------+ TXD        |
+------------+                           +------------+

この例では、チップ A はチップ A の送信 (TX) ピンからデータを送信することでチップ B にデータを送信し、チップ B は受信 (RX) ピンでその受信データを受信します。チップ B は、チップ A の受信 (RX) ピンでチップ A によって受信されるように、その送信 (TX) ピンからデータを送信します。

しかし、彼らは正確に何を相互にやり取りしているのでしょうか?

自分自身を物理的な中間マシンにすれば、それを知ることができます。

akheronツールは、2 つのシリアルポート (システムの OS がサポートしている限り、USB シリアルアダプターでも問題ありません) を備えたシステム上で実行されるように設計されており、これら 2 つのポート間でトラフィックを送信するプロキシとして機能します。次のようなもの:

    ^     +             ^     +
    |     v             |     v
+---------------------------------+
| |TXD1 RXD1|         |TXD2 RXD2| |
| +---------+         +---------+ |
|   UART  1             UART  2   |
|                                 |
|     Machine-in-the-Middle       |
|    (running Akheron Proxy)      |
|                                 |
+---------------------------------+

チップ A とチップ B の間の通信トレースを物理的に切断し、それらを中間マシンのシリアルポートにルーティングすると、これらのチップがakheronとの UART 通信を介して相互に送信している内容を確認できるようになります。

 +------------+                               +------------+
|        TXD +--------+             +------->+ RXD        |
| CHIP A     |        |             |        |     CHIP B |
|        RXD +<-+     |             |     +--+ TXD        |
+------------+  |     |             |     |  +------------+
                |     |             |     |
                |     v             |     v
            +---------------------------------+
            | |TXD1 RXD1|         |TXD2 RXD2| |
            | +---------+         +---------+ |
            |   UART  1             UART  2   |
            |                                 |
            |     Machine-in-the-Middle       |
            |    (running Akheron Proxy)      |
            |                                 |
            +---------------------------------+

このようにセットアップすると、 akheron使用する準備が整います。

コマンドラインツール

akheronバージョン 0.1 は、この取り組みの最初の反復であり、概念実証コードから生まれました。これはコマンドラインツールであり、対話に標準 REPL を使用します。

要件

akheronツールには Python 3.6 以降が必要で、システムのシリアルポートとのインターフェースにpyserialライブラリを使用します。 macOS 10.15 と Ubuntu 18.04 の両方でテストされました。

インストール要件

 pip install -r requirements.txt

ツールの起動

リポジトリの最上位ディレクトリにあるターミナルウィンドウからakheron起動できます。

./akheron.py

多くのシステムでは、シリアルデバイスへのアクセスが制限されています。昇格した権限でakheron実行しないようにするには、ユーザーアカウントが使用するデバイスと同じグループに属していることを確認してください。 Linux では、シリアルデバイスはdialoutグループのメンバーである可能性があります。ユーザーアカウントをそのグループに追加すると (例: sudo usermod -a -G dialout $USER )、デバイスにアクセスできるようになります。変更を確認するには、ログアウトしてアカウントに再度ログインするか、システムを再起動する必要がある場合があります。

実行すると、バナーと>プロンプトが表示されます。

 $ ./akheron.py

######################################################
Akheron Proxy, UART proxy tool for inter-chip analysis
                     version 0.1
######################################################

>

このプロンプトでは多くのコマンドが使用でき、 helpと入力してアクセスできます。

 > help

Documented commands (type help <topic>):
========================================
capturedump   checksumget  delimset  portget     replaceset  stop
capturestart  checksumset  help      portset     replay      watch
capturestop   delimget     list      replaceget  start

Undocumented commands:
======================
exit  quit  version

help <command>と入力すると、特定のコマンドに関する詳細なヘルプが表示されます。

例

利用可能なシリアルポートをリストする

 > list
/dev/ttyS0
/dev/ttyUSB0
/dev/ttyUSB1
/dev/ttyUSB2
/dev/ttyUSB3

詳細なリストを取得することもできます。

 > list -v
/dev/ttyS0
    desc: ttyS0
    hwid: PNP0501
/dev/ttyUSB0
    desc: Quad RS232-HS
    hwid: USB VID:PID=0403:6011 LOCATION=1-1:1.0
/dev/ttyUSB1
    desc: Quad RS232-HS
    hwid: USB VID:PID=0403:6011 LOCATION=1-1:1.1
/dev/ttyUSB2
    desc: Quad RS232-HS
    hwid: USB VID:PID=0403:6011 LOCATION=1-1:1.2
/dev/ttyUSB3
    desc: Quad RS232-HS
    hwid: USB VID:PID=0403:6011 LOCATION=1-1:1.3

トラフィックを転送して監視する

次の手順では、ポート間でトラフィックを転送し、それを「監視」してから、トラフィックの転送を停止します。

 > portset A /dev/ttyUSB1 115200
> portset B /dev/ttyUSB2 115200
> start
Data now PASSING between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2"...
> watch
Watching data passed between ports. Press CTRL-C to stop...
A -> B: 0x61 0x61 0x73 0x73 0x64 0x64 
B -> A: 0x31 0x32 0x33 ^C
Watch mode exited.
> stop
Data now BLOCKED between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2".
>

メッセージ開始区切り文字あり

これは同じフローですが、メッセージ開始区切り文字が0x37に設定されています。

 > portset A /dev/ttyUSB1 115200
> portset B /dev/ttyUSB2 115200
> delimset start 0x37
> start
Data now PASSING between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2"...
> watch
Watching data passed between ports. Press CTRL-C to stop...
A -> B: 0x37 0x71 0x77 0x65 0x65 0x72 
        0x37 0x64 0x66 0x61 0x64 
        0x37 0x73 
        0x37 0x68 0x68 
B -> A: 0x37 0x6e 0x6d 0x62 
        0x37 0x69 0x69 
A -> B: 0x37 0x61 0x73 0x64 ^C
Watch mode exited.
> stop
Data now BLOCKED between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2".
>

トラフィックの転送とキャプチャ (および監視)

次の手順では、ポート間でトラフィックを転送し、トラフィックをファイルにキャプチャして監視し、キャプチャの内容を停止してダンプしてから、トラフィック転送を停止します。

 > portset A /dev/ttyUSB1 115200
> portset B /dev/ttyUSB2 115200
> start
Data now PASSING between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2"...
> capturestart mycap.out
Saving captured traffic to "mycap.out"...
> watch
Watching data passed between ports. Press CTRL-C to stop...
A -> B: 0x31 0x32 0x33 
B -> A: 0x33 0x32 0x31 
A -> B: 0x20 0x20 0x20 
B -> A: 0x36 0x36 0x37 0x38 0x39 ^C
Watch mode exited.
> capturestop
Capture stopped
> capturedump mycap.out
    1: A -> B: 0x31 0x32 0x33
    2: B -> A: 0x33 0x32 0x31
    3: A -> B: 0x20 0x20 0x20
    4: B -> A: 0x36 0x36 0x37 0x38 0x39
> stop
Data now BLOCKED between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2".
>

トラフィックの転送と再生、パターン置換による再生、パターン置換による再生とチェックサムの再計算

次の手順は、この順序でデータ (この例では 1 行を含むキャプチャファイル) を再生してポート間でトラフィックを転送する方法を示しています。

キャプチャされたデータを最初にキャプチャされたとおりに (つまり、変更なしで) 再生します。
0x64 0x61シーケンスを0x99 0x91と交換し、再生するように置換操作を設定します (出力内の置換されたデータに注意してください)
メッセージの最後のバイトをその前のバイトのChecksum8Modulo256Plus1で更新し、再生するようにチェックサムメソッドを設定します。

 > portset A /dev/ttyUSB1 115200
> portset B /dev/ttyUSB2 115200
> start
Data now PASSING between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2"...
> replay /tmp/aaa
Replaying data from A -> B, press CTRL-C to exit watch mode...
A -> B: 0x61 0x73 0x64 0x61 0x73 0x64 ^C
Watch mode exited.
> replaceset A 0x64 0x61 -> 0x99 0x91
> replaceget
Replace port A pattern X -> pattern Y:
  0x64 0x61 -> 0x99 0x91
Replace port B pattern X -> pattern Y:
> replay /tmp/aaa
Replaying data from A -> B, press CTRL-C to exit watch mode...
A -> B: 0x61 0x73 0x99 0x91 0x73 0x64 ^C
Watch mode exited.
> checksumset A 3
> checksumget
Replace on port A using checksum 'Checksum8Modulo256Plus1'
No replace checksum specified on port B
> replay /tmp/aaa
Replaying data from A -> B, press CTRL-C to exit watch mode...
A -> B: 0x61 0x73 0x99 0x91 0x73 0x72 ^C
Watch mode exited.
> stop
Data now BLOCKED between ports "/dev/ttyUSB1" <-> "/dev/ttyUSB2".
>

拡大する