• 説明
• インストール
• macOS ホスト向けプロファイル方式
  • 使い方
• 脱獄していないデバイス向けプロファイル方式
  • 使い方
• 脱獄済みデバイス向けシークレット設定方式
  • 使い方
• HTTP インストルメンテーション有効化方式

説明

Apple のあまりよく文書化されていない API の一つによって記録された、HTTP/HTTPS の復号済みトラフィックをスニッフィングするためのシンプルな純 Python ユーティリティです。

インストール

python3 -m pip install -U harlogger

macOS ホスト向けプロファイルメソッド

このメソッドは Apple の CFNetwork プロファイルに適用されます。このプロファイルは CFNetwork フレームワークを使用するプロセスのデバッグを目的としています。このメソッドにはリクエスト/レスポンスボディは含まれません。

手順

• Apple の macOS 向け CFNetwork プロファイルをダウンロードします:

• ダブルクリックしてインストールします

• 以上です！ :) あとは次のコマンドでスニッフィングを開始するだけです:

  python3 -m harlogger profile
  

脱獄していないデバイス向けプロファイルメソッド

このメソッドは Apple の CFNetwork プロファイルに適用されます。このプロファイルは CFNetwork フレームワークを使用するプロセスのデバッグを目的としています。このメソッドにはリクエスト/レスポンスボディは含まれません。

手順

• Apple の iOS 向け CFNetwork プロファイルをダウンロードします:

• お好みの方法でインストールします。私は pymobiledevice3 を使用しています:

  # if you don't already have it
  python3 -m pip install -U pymobiledevice3
  
  # install the profile
  pymobiledevice3 profile install CFNetworkDiagnostics.mobileconfig
  

• 以上です！ :) あとは次のコマンドでスニッフィングを開始するだけです:

  python3 -m harlogger mobile profile
  

出力は次のようになります:

➜  harlogger git:(master) ✗ python3 -m harlogger profile
➡️️   POST https://www.bing.com/fd/ls/lsp.aspx HTTP/1.1
Accept: */*
Content-Type: text/xml
Origin: https://www.bing.com
Accept-Encoding: gzip, deflate, br
Cookie: SRCHHPGUSR=CW=414&CH=622&SW=414&SH=736&DPR=3&UTC=180&DM=1&SRCHLANG=en&HV=1634801804; _HPVN=CS=eyJQbiI6eyJDbiI6MiwiU3QiOjAsIlFzIjowLCJQcm9kIjoiUCJ9LCJTYyI6eyJDbiI6MiwiU3QiOjAsIlFzIjowLCJQcm9kIjoiSCJ9LCJReiI6eyJDbiI6MiwiU3QiOjAsIlFzIjowLCJQcm9kIjoiVCJ9LCJBcCI6dHJ1ZSwiTXV0ZSI6dHJ1ZSwiTGFkIjoiMjAyMS0xMC0yMVQwMDowMDowMFoiLCJJb3RkIjowLCJEZnQiOm51bGwsIk12cyI6MCwiRmx0IjowLCJJbXAiOjEwfQ==; SUID=M; _EDGE_S=SID=1BF42681120765EF1EA73656137A640E; _SS=SID=1BF42681120765EF1EA73656137A640E; MUID=1B0D347B85756FDD055524B284086E36; SRCHD=AF=NOFORM; SRCHUID=V=2&GUID=5B989717430E450D9314C927C97602C9&dmnchg=1; SRCHUSR=DOB=20211007; _EDGE_V=1; MUIDB=1B0D347B85756FDD055524B284086E36
User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1 Mobile/15E148 Safari/604.1
Referer: https://www.bing.com/
Content-Length: 458
Accept-Language: en-us

⬅️   HTTP/2.0 204 (request POST https://www.bing.com/fd/ls/lsp.aspx HTTP/1.1)
x-msedge-ref: Ref A: E5B5AE34FBA148E6BDFFBF421B940462 Ref B: VIEEDGE1816 Ref C: 2021-10-21T07:36:44Z
Date: Thu, 21 Oct 2021 07:36:44 GMT
x-cache: CONFIG_NOCACHE
Access-Control-Allow-Origin: *

ジェイルブレイク済みデバイス向けのシークレット設定メソッド

iOS 14.x デバイスには、CFNetwork フレームワークを使用するすべてのプロセスから復号化された HTTP/HTTPS トラフィックを HAR 形式でスニッフィングするための隠し機能が含まれています。ジェイルブレイク済みデバイスでこの機能を有効にするには、com.apple.CFNetwork の正しい設定を配置し、com.apple.CFNetwork.har-capture-update 通知をトリガーするだけです。 このメソッドにはリクエスト/レスポンスのボディも含まれます。

iOS 13.x 以下にはこの機能はありません。

使い方

• com.apple.CFNetowrk.plist を /var/mobile/Library/Preferences/ 内に配置します
• デバイスを再起動します
• 以上です！ :) これで次のコマンドを使ってすべてのスニッフィングを開始できます：

  python3 -m harlogger preference
  

出力は次のようになります：

➜  harlogger git:(master) ✗ python3 -m harlogger mobile preference
➡️   CFNetwork(1140) POST https://www.bing.com/fd/ls/lsp.aspx
POST /fd/ls/lsp.aspx HTTP/2.0
Accept: */*
Content-Type: text/plain
Origin: https://www.bing.com
Cache-Control: max-age=0
Content-Length: 472
Accept-Language: en-us
User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1 Mobile/15E148 Safari/604.1
Accept-Encoding: gzip, deflate, br
Referer: https://www.bing.com/

⬅️   CFNetwork(1140) 0
➡️   CFNetwork(1140) POST https://www.bing.com/fd/ls/lsp.aspx
POST /fd/ls/lsp.aspx HTTP/2.0
Accept: */*
Content-Type: text/xml
Origin: https://www.bing.com
Content-Length: 378
Accept-Language: en-us
Host: www.bing.com
User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1 Mobile/15E148 Safari/604.1
Referer: https://www.bing.com/
Accept-Encoding: gzip, deflate, br
Connection: keep-alive

<ClientInstRequest><Events><E><T>Event.ClientInst</T><IG>EB94C422BC394F90A876D39A790BECBC</IG><TS>1634801882467</TS><D><![CDATA[[{"T":"CI.BoxModel","FID":"CI","Name":"v2.8","SV":"4","P":{"C":1,"N":5,"I":"5iv","S":"V","M":"V+L+M+MT+E+N+C+K+BD","T":1669960,"F":0},"V":"zrpx/////////visible/+zryw/////////hidden/@p"}]]]></D></E></Events><STS>1634801882467</STS></ClientInstRequest>

HTTP インストルメンテーション方式を有効化する

iOS 15.0 以降、デバイスは対象プロセスに以下の要件のいずれかを満たすことを要求します：

• com.apple.private.cfnetwork.har-capture-delegation エンタイトルメント
• get-task-allow エンタイトルメント
• com.apple.security.get-task-allow エンタイトルメント
• OS ビルドが debug モードであること

デバイスで HAR ログを有効にするには、以下のように pymobiledevice3 を使用できます：

python3 -m pymobiledevice3 developer dvt har

これで、preference メソッドを使用してスニッフィングを開始できます:

python3 -m harlogger preference