P4wnP1 A.L.O.A.

P4wnP1 A.L.O.A. by MaMe82 は、Raspberry Pi Zero W を、ペネトレーションテスト、レッドチーミング、物理的関与のための柔軟で低コストなプラットフォームに、または「A Little Offensive Appliance」（小さな攻撃用アプライアンス）に変えるフレームワークです。

0. インストール方法

最新のイメージはリリースタブにあります。

新規インストールしたP4wnP1 A.L.O.A.にアクセスする最も簡単な方法は、生成されたWiFi（PSKはMaMe82-P4wnP1、URLはhttp://172.24.0.1:8000）またはSSH（デフォルトパスワードtoor）を介してWebクライアントを使用することです。

1. 機能

Plug&Play USBデバイスエミュレーション

• USB機能：
  • USB Ethernet (RNDIS and CDC ECM)
  • USB Serial
  • USB Mass Storage (Flashdrive or CD-Rom)
  • HID Keyboard
  • HID Mouse
• USBスタックの実行時再構成（再起動不要）
• 接続/切断の検出により、P4wnP1 A.L.O.A.を電源投入状態（外部電源）に保ち、エミュレートされたUSBデバイスが新しいホストに接続された場合にアクションをトリガーすることが可能
• CDC ECMとRNDISは仮想ブリッジに接続されているため、異なる内部イーサネットインターフェースを扱う必要がない
• USB設定の構成テンプレートの永続的な保存と読み込み

HIDScript

• 制限のあるDuckyScriptの代替
• キーボードとマウスを自動化する洗練されたスクリプト言語
• 最大8つのHIDScriptジョブを並行して実行可能（マウスをジグルするジョブを維持しながら、他のジョブをオンデマンドで起動し、任意のマウス操作やキーストローク注入をシームレスに行う）
• HIDScriptはJavaScriptベースで、一般的なライブラリが利用可能であり、より複雑なスクリプト（関数呼び出し、マウス計算のためのMathの使用など）が可能
• キーボード
  • UTF-8ベースのため、ASCII文字に制限されない
  • NUMLOCK、CAPSLOCK、SCROLLLOCKのLED状態変化を読み取ることで、ホストの実際のキーボードからのフィードバックに反応可能（ターゲットOSが接続されているすべてのキーボードでLED状態を共有する場合。OSXでは異なる）
  • LEDフィードバックに基づいてHIDScriptで分岐判断を行う
• マウス
  • 相対移動（高速だが精度は低い）
  • ステップ相対移動（低速だが正確... 1DPI単位でマウスを動かす）
  • Windows上での絶対位置指定（ターゲットの画面寸法がわかればピクセル単位で正確）
• キーボードとマウスは同じスクリプト言語で制御されるだけでなく、同じスクリプト内で両方を使用できる。これにより、キーボードまたはマウスのみでは達成できない目標を達成するために組み合わせることが可能。
• 現在の言語レイアウト: br, de, es, fr, gb, it, ru, us

Bluetooth

• Bluezスタックへの完全なインターフェース（現在リモートデバイスの発見/接続はサポートされていません）
• Bluetoothネットワークアクセスポイント（NAP）の実行を許可
• カスタマイズ可能なペアリング（PINベースのレガシーモードまたはSSP）
• 高速サポート（802.11フレームを使用してWiFiのような転送レートを実現）
• Bluetoothスタックの実行時再構成
• 注意: PANUも可能ですが、現在はサポートされていません（リモートデバイス接続なし）
• Bluetooth設定の構成テンプレートの永続的な保存と読み込み

WiFi

• 修正済みファームウェア（Nexmonフレームワークでビルド）
  • KARMAの許可（リモートデバイスがプローブするアクセスポイントに対して有効な応答を偽装し、関連付けを許可）
  • 追加のビーコンをブロードキャストして複数のSSIDをエミュレート
  • WiFi隠蔽チャネル
  • 注意: Nexmonのレガシーモニターモードは含まれていますが、P4wnP1ではサポートされていません。モニターモードはまだバグが多く、設定変更時にファームウェアがクラッシュする可能性があります。
• 簡単なアクセスポイント設定
• 簡単なステーションモード設定（既存のAPに接続）
• フェイルオーバーモード（ターゲットのアクセスポイントに接続できない場合、独自のアクセスポイントを立ち上げる）
• WiFiスタックの実行時再構成
• WiFi設定の構成テンプレートの永続的な保存と読み込み

ネットワーキング

• 以下のための簡単なイーサネットインターフェース設定
  • Bluetooth NAPインターフェース
  • USBインターフェース（RNDIS/CDC ECMが有効な場合）
  • WiFiインターフェース
• インターフェースごとに専用のDHCPサーバーをサポート
• DHCPクライアントモードのサポート
• 手動設定
• 各インターフェースの構成テンプレートの永続的な保存と読み込み

ツール

ここで言うことはあまりありません。P4wnP1 A.L.O.A.はKALI Linuxをベースとしているため、すべてが手元にあるはずです（またはaptを使用してインストールできます）。

CLIによる設定と制御、必要に応じてリモートでも

• これまでに述べたすべての機能は、CLIクライアントを使用して設定可能
• P4wnP1コアサービスは単一のバイナリであり、systemdユニットとして実行され、ランタイム状態を保持
• CLIクライアントは、RPC（具体的にはgRPC）を介してこのサービスとインターフェースし、コアの状態を変更
• CLIはRPCアプローチを使用するため、リモート設定にも使用可能
• P4wnP1にSSHでアクセスすると、CLIクライアントがコマンド（またはタブ補完の技）を待機
• CLIは（ほとんどのコードと同様に）Goで書かれているため、主要なプラットフォームとアーキテクチャ向けにコンパイル可能

したがって、リモートWindowsホストで実行されるバッチファイルを使用してP4wnP1を設定したい場合…問題ありません：

1. クライアントをWindows用にコンパイル
2. 何らかの方法（Bluetooth、WiFi、USB）でP4wnP1に接続できることを確認
3. クライアントコマンドにhostパラメータを追加
4. …そして、ローカルアクセスと同じようにCLIを使用します。

Webクライアントによる設定と制御

当初は計画されていませんでしたが、P4wnP1 A.L.O.A.はWebクライアントを使用して設定できます。クライアントは計画されていなかったものの、優れたソフトウェアへと進化しました。実際、P4wnP1 A.L.O.A.の主要な設定ツールとして完成しました。Webクライアントには、CLIからはアクセスできない機能（テンプレートストレージ、「TriggerActions」の作成）があります。

コア機能：

• 主要なモバイルおよびデスクトップブラウザで動作し、一貫したルックアンドフィールを提供（Quasar Framework）
• websocketsを介してgRPCを使用（RESTful APIやXHRはなし、CLIとほぼ同じアプローチ）
• このインターフェースにより、Webクライアントはリクエスト＆リプライ方式のみに依存せず、P4wnP1コアから「プッシュイベント」を受信。これは以下のことを意味する：
  • あなた（またはスクリプト）がP4wnP1 A.L.O.A.の状態を変更すると、その変更が即座にWebクライアントに反映される
  • 複数のWebクライアントが実行されている場合、コアの状態変更が一つのクライアントから他のすべてのクライアントに反映される
• HIDScriptエディタを内蔵：
  • シンタックスハイライト
  • オートコンプリート（CTRL+SPACE）
  • HIDScriptの永続ストレージと読み込み
  • ブラウザから直接HIDScriptのオンデマンド実行
  • HIDScriptジョブマネージャ（実行中のジョブのキャンセル、ジョブの状態と結果の確認）
• TriggerActionsの概要とエディタを内蔵
• これまで説明したすべての機能に対する完全なテンプレートサポート
• WebClientはシングルページアプリケーションで、一度ロードされるとすべてがクライアント側で実行され、gRPCリクエストのみが交換される

自動化

古いP4wnP1バージョンの自動化アプローチ（静的bashスクリプト）はもはや使用できません。

P4wnP1 A.L.O.A.の自動化アプローチは以下の要件を満たす必要がありました：

• 使いやすく理解しやすい
• Webクライアントから使用可能
• 汎用的でありながら柔軟
• 古い「bashスクリプト」アプローチで可能だったことはすべて依然として可能
• すべてのサブシステム（USB、WiFi、Bluetooth、イーサネットインターフェース、HIDScript...）にアクセス可能
• 再利用可能な部品によるモジュール式
• 追加コードを書かずに（単純な）論理タスクをサポート可能
• GPIOポートを利用した物理コンピューティングを可能にする

いわゆる「TriggerActions」を導入し、テンプレートシステム（すべてのサブシステムの永続設定ストレージ）と組み合わせることで、すべての要件を満たすことができました。TriggerActionsの詳細はWorkFlowセクションにあります。

使用チュートリアル

2. ワークフローパート1 - HIDScript

P4wnP1 A.L.O.A.は、静的な設定やペイロードのような概念を使用しません。実際、まったく静的なワークフローはありません。

P4wnP1 A.L.O.A.は、可能な限り柔軟になるように設計されており、あらゆるシナリオ（P4wnP1 A.L.O.A.の作成時に私が考えられなかったものも含む）で使用できるようにしています。

しかし、このセクションではいくつかの基本的な概念を説明したいと思います。適切な（ビデオ）ドキュメントを作成せずにすべてを説明するのは難しいため、説明すべきことを説明するために、いくつかの一般的な使用例と例を取り上げます。

とはいえ、完全なドキュメントを提供する時間はおそらくないでしょう。そのため、このREADMEにリンクできるチュートリアルやアイデアで皆さんの支援をお願いします

それでは、最も基本的なタスクの1つから始めましょう：

2.1 USBでP4wnP1が接続されたホストに対してキーストローク注入を実行する

この目標を達成するための最小構成要件は：

• USBサブシステムが少なくともキーボードをエミュレートするように設定されていること
• キーストローク注入を開始するために、P4wnP1に（リモートで）アクセスする方法があること

P4wnP1のデフォルト設定（未変更イメージ）はすでにこれらの要件を満たしています：

• USB設定は、キーボード、マウス、およびUSB over Ethernet（RNDISとCDC ECMの両方）を提供するように初期化されています
• P4wnP1は以下のいずれかの方法を使用してリモートからすでにアクセス可能です：
  • WiFi
    • アクセスポイント名は明らかです
    • パスワードはMaMe82-P4wnP1
    • P4wnP1のIPは172.24.0.1
  • USB Ethernet
    • P4wnP1のIPは172.16.0.1
  • Bluetooth
    • デバイス名P4wnP1
    • PIN1337
    • IPは172.26.0.1
    • 注意：PINペアリングを強制するためにSecure Simple Pairingはオフになっています。これにより、高速モードもオフになります。そのため、Bluetooth接続は非常に遅く、SSHアクセスにはあまり問題になりませんが、Webクライアントのリクエストには最大10分かかる可能性があります（高速モードが有効な場合は数秒）。
• SSHサーバーは前述のすべてのIPからアクセス可能
• KALI LinuxのSSHユーザーはroot、デフォルトパスワードはtoor
• Webクライアントは、3つの接続すべてを介してポート8000のHTTPでアクセス可能

注意：HTTPS接続の展開は現在プロジェクトの範囲外です。そのため、WebクライアントでWiFi認証情報などの機密データを扱う場合は、この点に留意してください。プロジェクト全体はセキュリティを考慮して構築されていません（そして、これが要件になることはおそらくないでしょう）。したがって、適切な対策を展開してください（例：アクセスポイントがオープン認証で構成されている場合、iptablesでWebクライアントへのアクセスを制限する、PIN保護なしでBluetoothの検出可能性と接続可能性を有効にしたままにしないなど）

ここで、以下のことを前提とします：

1. P4wnP1をUSBを介していくつかのターゲットホストに接続している（RaspberryのマイクロUSBポートの最も内側が使用するポートです）
2. USBホストがキーストロークを受信できるアプリケーションを実行しており、現在キーボード入力フォーカスがある（例：テキストエディタ）
3. SSHを介してP4wnP1にリモート接続している（最良の方法はWiFi）、できればSSH接続はUSBでP4wnP1 A.L.O.A.が接続されているホストとは異なるホストから実行されている

SSHセッションからCLIクライアントを実行するには、次のコマンドを発行します：``` root@kali:~# P4wnP1_cli The CLI client tool could be used to configure P4wnP1 A.L.O.A. from the command line. The tool relies on RPC so it could be used remotely.

Version: v0.1.0-alpha1

Usage: P4wnP1_cli [command]

Available Commands: db Database backup and restore evt Receive P4wnP1 service events help Help about any command hid Use keyboard or mouse functionality led Set or Get LED state of P4wnP1 net Configure Network settings of ethernet interfaces (including USB ethernet if enabled) system system commands template Deploy and list templates trigger Fire a group send action or wait for a group receive trigger usb USB gadget settings wifi Configure WiFi (spawn Access Point or join WiFi networks)

Flags: -h, --help help for P4wnP1_cli --host string The host with the listening P4wnP1 RPC server (default "localhost") --port string The port on which the P4wnP1 RPC server is listening (default "50051")

Use "P4wnP1_cli [command] --help" for more information about a command.

ヘルプ画面には、CLIクライアントがP4wnP1 A.L.O.A.の様々なサブシステムとやり取りするために異なるコマンドを使用することが既に示されています。これらのコマンドのほとんどには、さらに独自のサブコマンドがあります。各コマンドやサブコマンドのヘルプは、CLIコマンドに `-h` を追加することでアクセスできます。```
root@kali:~# P4wnP1_cli hid run -h
Run script provided from standard input, commandline parameter or by path to script file on P4wnP1

Usage:
  P4wnP1_cli hid run [flags]

Flags:
  -c, --commands string      HIDScript commands to run, given as string
  -h, --help                 help for run
  -r, --server-path string   Load HIDScript from given path on P4wnP1 server
  -t, --timeout uint32       Interrupt HIDScript after this timeout (seconds)