Ex:AntiAdコマンド (転送キャプチャ) - ダウンロードマクロのコマンド (拡張コマンド) - PROSERPINE (プロセルピナ)

				プロセルピナ
Top	Internet Mail	Private Proxy	Capture Device		Download	Config and Words	Online Help	Online Home

[BACK]

☞ Top > FileDownload > Macro > Ex: Command > AntiAd > ClientDump

Ex:AntiAdコマンド
転送キャプチャ (ClientDump-Reg, ClientDump-Del)

Macro Top | Variables | Constants | Commands | Ex-Commands

【はじめに】転送キャプチャとは

「転送キャプチャ」は、 Private Proxy(Service部) がネット側からWebブラウザ側にデータを転送する際、そのデータを HTTPリクエスト単位でファイルにキャプチャする機能です。

Ex:AntiAdコマンドの ClientDump-Regモード、 ClientDump-Delモードを使用してPrivate Proxyを制御することによって、「転送キャプチャ」を行うことができます。

転送キャプチャによるダウンロード処理の流れ

書式

Ex:AntiAd: (Parameters)

【Parameters】
mode= : string, コマンドモード
ClientDump-Reg : 転送キャプチャを登録
ClientDump-Del : 転送キャプチャの登録を解除

O:waitId= : string, Ex:InputForm.Waitコマンドの waitId= に指定する文字列変数。
O:result= : string, コマンド実行結果

dir= : string, キャプチャを保存するフォルダ
targetHost= : string, キャプチャ対象のホスト
ContentTypeList= : string, キャプチャ対象のContent-Type
CallbackMacro= : string, callbackマクロ(結果を通知するマクロ)
SubInfo= : string, callbackマクロに通知する情報

機能

転送キャプチャの登録と(ClientDump-Reg)、その登録の解除(ClientDump-Del) を行います。

「転送キャプチャ」を登録するマクロとは別に、キャプチャが完了したときに起動される callbackマクロ が必要です。
「転送キャプチャ」の登録解除は、 callbackマクロ で行うのが一般的です。

１つのHTTPリクエスト(http-get, http-post)は、１つのファイルにキャプチャされます。
そのファイルは dir= で指定したフォルダに作成されます。ファイル名は Private Proxy(Service部) でキャプチャ開始時に決められます。
キャプチャが終了するとキャプチャ情報がView部に通知されます。 View部はcallbackマクロを起動し、キャプチャ情報をそのcallbackマクロに渡します。

キャプチャの登録

転送をキャプチャするには、
・どのホストからの応答をキャプチャするのか (targetHost=)
・どのような内容をキャプチャするのか (ContentTypeList=)
を、 Private Proxy(Service部) に登録します。
例えば、video.example.com のホストから送られてきた、Content-Type が video/flv のデータをキャプチャするには、コマンドパラメータで
targetHost="video.example.com" ContentTypeList="video/flv"
と指定します。

複数のContent-Typeを指定するときは、Yinyangパックされた文字列を指定します。
Content-Type が video/flv と video/x-flv のデータをキャプチャしたいときは、 YinyangPackコマンドで結合したものを、 ContentTypeList= に指定します。
YinyangPack: "video/flv" "video/x-flv"

targetHost= の指定は、 . (半角ドット記号) から開始することで、後方一致で指定することができます。
例えば、
targetHost=".example.co.jp"
と指定した場合、
video.example.co.jp
mp4.example.co.jp
aaa.bbb.example.co.jp
aaa.bbb.ccc.example.co.jp
のようなホストが対象になります (注: example.co.jp は対象外)。

前方一致で targetHost= の指定をするには、 ^ (半角^記号) から開始します。
例えば、
targetHost="^209.197."
と指定した場合、
209.197.10.3
209.197.250.32
のようなホストが対象になります。

targetHost= と ContentTypeList= の他に、次の情報も登録する必要があります。
・callbackマクロ(キャプチャの通知先) (CallbackMacro=)
・callbackマクロに渡すユーザー情報 (SubInfo=)

CallbackMacro= には、キャプチャ情報を通知する callbackマクロ をフルパスで指定します。
callbackマクロについては次の キャプチャの解除 の項目を参照してください。

SubInfo= には、補助情報を設定します。これは文字列で、その内容はどのようなものでもかまいません。 Ex:AntiAdコマンドを呼び出したマクロから、callbackマクロに渡したい情報を設定しておくことができます。

キャプチャの解除

キャプチャの解除
【Parameters】
mode= : string, 文字列 ClientDump-Del を指定
targetHost= : string, 解除するホスト
ContentType= : string, 解除するContent-Type
O:waitId= : sring, waitIdを設定する文字列変数
O:result= : string, コマンド処理結果

キャプチャの解除は、一般的にはcallbackマクロで行います。
Private Proxyは、キャプチャの解除が行われるまで、登録した条件に一致するデータは全てキャプチャします。

callbackマクロには、７つのパラメータ(input[0]～input[6]) が渡されます。いずれも、 Private Proxy(Service部) から通知された内容です。

input[0] : @hostName の文字列(固定)
input[1] : CBM の３文字(固定)
input[2] : CallbackMacro (CallbackMacro= で指定した内容)
input[3] : RemoteHostname (targetHost= に一致したホスト)
input[4] : Content-Type (ContentTypeList= に一致したContent-Type)
input[5] : キャプチャファイルのフルパス
input[6] : SubInfo (SubInfo= で指定した内容)

キャプチャされた内容を格納しているファイルのフルパスは input[5] に設定されています。
httpリクエストに対するサーバからの応答が全て含まれます。よって、その内容はhttpヘッダ部とhttpボディ部から構成されます。ヘッダ部とボディ部の区切りは CrLfCrLf の４バイトの場合と、LfLf の２バイトの場合があります。どちらになるかはサーバ依存です。
input[5] の内容は、そのまま Ex:HttpDataConvertコマンドの file=パラメータに指定することができます。

動画をPrivate Proxyでキャプチャして保存する例

liveleak.comの動画をPrivate Proxyでキャプチャし、デスクトップに保存するマクロの例です。
(動画は 209.197.～のIPから配信されることを想定)

Ex:AntiAd: mode="ClientDump-Reg"の使用例

上記は Ex:AntiAdコマンドのClientDump-Regモードで、 callBackマクロを登録する例です。
callBackマクロの内容は次のようなものになります。

:Start {
 if (input[1] == "CST") {
   //             [1]   =====[2]=====   ======[3]=====   ====[4]====   ==[5]==   ==[6]==
   // @hostName+++CST+++CallbackMacro+++RemoteHostname+++ContentType+++DumpDir+++SubInfo+++
   Ex:Popup.WideWidth: "#20;キャプチャを開始しました。\r\nHost: " input[3] "\r\nContent-Type: " input[4] "\r\nInfo: " input[6]
   Ex:Message: "キャプチャ開始: " input[6]
   end:
   }
 
 
 //             [1]   =====[2]=====   ======[3]=====   ====[4]====   ==[5]===   ==[6]==
 // @hostName+++CBM+++CallbackMacro+++RemoteHostname+++ContentType+++DumpFile+++SubInfo+++
 
 Ex:AntiAd: mode="ClientDump-Del" dir=Dir.DeskTop targetHost="^209.197." ContentType="ALL" O:waitId=strl["waitId"] O:result=strl[10];
 
 if (input[5].isFile == "false") {
   put: "NG: キャプチャがありません。\r\nfile: " input[5] "\r\nContent-Type: " input[4] "\r\nHost: " input[3]
   end:
   }
 
 file pathInfo: file=input[5] strl.index=10
 //
 if (input[6].Length > 0) {
   Ex:Html.convMetaToString: src=input[6] O:text=strl["タイトル"] entity;
   str[0]=Const.FilenameBad;  strl["タイトル"]=strl["タイトル"].ReplaceEach(Const.FilenameAlt);
   }
  else {
   strl["タイトル"]=strl[11]
   }
 
 Ex:HttpDataConvert: file=input[5] dest.Dir=Dir.DeskTop dest.MidName=strl["タイトル"] O:destfile=strl["destf"] O:result=strl["rslt"];
 if (strl["destf"].isFile == "true") {
   put: input[3] "からの応答を" strl["destf"] " に保存しました。"
   }
  else {
   put: strl["rslt"]
   }
 
 end:
 }

Ex:AntiAd: mode="ClientDump-Del"の使用例 (callBackマクロ)

CallBackマクロは、Private Proxyでのキャプチャ開始時(input[1]が CST の３文字)と、キャプチャ完了時(input[1]が CBM の３文字)の２回起動されます。
(いずれも『プロセルピナ』View部からの起動)

上記の２つの例は、liveleak.comの動画をキャプチャするマクロ (http：／／www.liveleak.com.txt と cbm_http：／／www.liveleak.com.txt) の概要です。
具体的な動作は、次のリンクを『プロセルピナ』View部のメッセージエリアにドラッグ＆ドロップして確認してください。

http://www.liveleak.com/view?i=e26_1210502362

http://www.liveleak.com/view?i=7b4_1215905617

http://www.liveleak.com/view?i=2dc_1213501565

[BACK]

プロセルピナ

【はじめに】 転送キャプチャとは

書式

機能

キャプチャの登録

キャプチャの解除

動画をPrivate Proxyでキャプチャして保存する例

【はじめに】転送キャプチャとは