ung220z-tool — 光回線ルーターUNG220Zから認証情報を抽出するPythonツール
Hut-hzf/ung220z-tool
★ 1,282 ・ Python ・ MIT
概要
ung220z-tool は、中国移動(China Mobile)向けに提供されている九聯(Unionman)製の光回線終端装置(ONU/ルーター)「UNG220Z」を対象に、各種認証情報を一括で抽出するためのPythonスクリプトです。
この種の端末では、Web管理画面のログインパスワードがリモート管理プロトコル(TR-069)によって定期的に自動更新される仕様になっている場合があります。そのため、機器本体のラベルに記載された初期パスワードや、以前確認したパスワードが短期間で無効化され、管理画面に入れなくなるケースが存在します。本ツールは、そうした自己所有の機器において、紛失した管理者パスワードの復旧、光回線の移行に伴うPPPoE設定の確認、あるいはセキュリティの自己診断を行いたいネットワーク管理者やエンジニアに向けて開発されています。
主な特徴
- Telnet機能の自動有効化
管理画面のCGIエンドポイント(
telnet.gch)に対してリクエストを送信し、無効化されているTelnetサービスを自動的に立ち上げます。 - 暗号化設定ファイルの自動復号
Telnet接続でrootシェルを取得した後、内部コマンドを利用して暗号化されている設定ファイル(
db_user_cfg.xml)を復号し、平文のXMLデータを抽出します。 - 多様な認証情報の一括収集 Web管理画面のアカウント、Telnetパスワード、PPPoEの接続情報、Wi-Fiの暗号化キー、さらには端末のrootパスワードまでを一度の実行で同時に取得します。
- 外部ライブラリへの依存なし
Python 3.8以上の標準ライブラリのみで実装されており、
pipを使ったサードパーティ製パッケージのインストールを行うことなく、スクリプト単体で動作します。 - 柔軟な実行形態 対話型プロンプトによるガイド形式の実行に加え、コマンドライン引数経由でIPアドレスやパスワードを指定した自動実行にも対応しています。
- ログファイルへの自動保存 コンソールへの結果表示にとどまらず、抽出された認証情報のサマリーをタイムスタンプ付きのログファイルとしてローカルディスクへ自動出力します。
使い方
動作要件
- Python 3.8 以上
- 追加の外部パッケージは不要(標準ライブラリのみで動作)
基本的な実行方法(対話モード)
端末と同じローカルネットワークに接続した状態で、以下のコマンドを実行します。
python3 ung220z.py
実行すると、対話型の入力プロンプトが順に表示されます。入力するユーザー名とパスワードは、ONU本体の背面や底面ラベル(S/Nラベルなど)に記載されている一般ユーザー用のアカウント情報です。
① 光猫地址 [192.168.1.1]:
② 用户名 [user]:
③ 密码(输入时不显示)
密码:
コマンドライン引数による実行
引数を指定することで、対話入力を省略して直接実行することも可能です。ブラウザを自動起動させず、HTTPリクエストのみで処理を完結させる場合は --no-browser オプションを付与します。
python3 ung220z.py -i 192.168.1.1 -u user -p 'あなたのパスワード'
python3 ung220z.py -i 192.168.1.1 -u user -p 'あなたのパスワード' --no-browser
主なコマンドライン引数は以下の通りです。
| オプション | 説明 |
|---|---|
-i, --ip |
対象ONUのIPアドレス(デフォルト: 192.168.1.1) |
-u, --user |
ログインユーザー名(デフォルト: user) |
-p, --password |
ログインパスワード(未指定時は対話形式で入力) |
--telnet-user |
Telnetログインユーザー名(デフォルト: CMCCAdmin) |
--telnet-password |
Telnetパスワード(Webパスワードと異なる場合に使用) |
--no-browser |
ブラウザ呼び出しを行わず、純粋なHTTPリクエストのみで実行 |
--unlock |
Webセッションがロックされている場合にhttpdを再起動してロック解除 |
--no-release |
残留したWebセッションの解放処理をスキップ |
実行時の出力例
スクリプトが進行すると、各ステップの進捗が標準出力に表示されます。
[22:15:00] INFO 会话开始 目标=192.168.1.1 账户=user
[22:15:00] HTTP 已发送给浏览器: http://192.168.1.1/usr=user&psw=***&cmd=1&telnet.gch
[22:15:00] HTTP telnet.gch → TelnetSet Success!
[22:15:00] PROBE nc -zv 192.168.1.1 23 → succeeded
[22:15:01] AUTH Telnet CMCCAdmin / ****** → 登录成功(root)
[22:15:02] SHELL sidbg 1 DB decry /userconfig/cfg/db_user_cfg.xml → /tmp/debug-decry-cfg
[22:15:03] DATA DevAuthInfo CMCCAdmin / ****** Level=1
[22:15:04] CRACK MATCH: ****** (/etc/shadow)
処理が完了すると、抽出されたアカウント一覧のテーブルが表示され、同一ディレクトリに ung220z_<タイムスタンプ>.log という形式でログが出力されます。
技術的なポイント
ung220z-tool の動作フローは、組み込みLinux系ONUの特性や既知のインターフェース仕様を組み合わせて構成されています。
-
WebインターフェースとCGIの挙動
対象機器のWebインターフェースは.gch拡張子を持つCGIフレームワークで実装されています。スクリプトはhttp:///usr=&psw=&cmd=1&telnet.gchという特定のリクエストを送信することで、内部のTelnetデーモンを起動させます。また、Web管理画面へのログイン処理ではパスワードがBase64で扱われ、レスポンスごとにインクリメントされるトークン(Frm_Logintoken)を適切にハンドリングして通信を成立させています。 -
rootシェルの取得と設定復号
Telnetが起動した後は、デフォルトアカウント(CMCCAdmin)を用いてログインを試行し、root権限のシェルを確立します。続いて、組み込みバイナリであるsidbgコマンド(sidbg 1 DB decry /userconfig/cfg/db_user_cfg.xml)を呼び出し、暗号化されて格納されている本体設定ファイルを一時領域(/tmp/配下)に平文XMLとして出力させます。この復号処理には追加のパスワードを必要としない仕組みが利用されています。 -
パスワード情報の解析
復号されたXMLからWeb管理アカウント、Telnetパスワード、PPPoE接続設定、Wi-Fiの暗号化キーを順次パースします。さらに/etc/shadowに記載されたSHA-256 crypt形式のハッシュ値に対し、一般的な工場出荷時パスワードとのパターン照合を行うことで、rootパスワードの特定を試みるロジックが組み込まれています。
注意点
- 対象機器の限定性
本ツールは九聯(Unionman)製の特定の中国移動向けONU「UNG220Z」を想定して設計されています。異なる型番や他社製ONU、ファームウェアのバージョン差異によってはCGIの仕様や設定ファイルの配置が異なり、正常に動作しない可能性があります。 - 法的留意事項と利用範囲
リポジトリのREADMEおよび免責事項において明記されている通り、本ツールの利用はユーザー自身が所有・管理権限を持つ端末に限定されます。自身が正当な権限を持たない他人の設備やネットワーク機器に対して無許可で実行することは、不正アクセス行為などの法令違反に該当する可能性があります。 - ライセンス
本ソフトウェアは MIT ライセンスの下で公開されています。
まとめ
ung220z-tool は、特定機種のONUから設定復旧や自己診断に必要な認証情報を素早く取り出すためのPythonスクリプトです。外部依存がなく標準ライブラリのみでTelnetの起動からXML設定ファイルの復号までを自動化できるため、対象端末の運用管理やメンテナンスにおいて有用なツールとなっています。





