B lack jumbodog 運転と改造のすすめ

BLackJumboDog運転と改造のすすめ 2011.11.19 by sapporowroks

• ハンドル SIN／古谷誠進• Twitter @furuya02• 仕事某社でシステムサポートみたいな感じ• 住居札幌• 年齢アラフィフオヤジなので、新しいもの・・・（ＳＮＳ、スマフォ、Ｆ＃などなど）よく分かりません。（悲）自己紹介

運転• BJD紹介と設定の勘所各種機能の紹介３ステップ、Web、DNSサーバの設定例改造• プログラムの構造と改造要領SAMPLEサーバ・主要クラスSocket、オプション、ログの使用方法アジェンダ

BJD紹介と設定の勘所

BlackJumboDogとは、Windowsで動作するフリーの簡易サーバです。Web、メール、プロキシ、FTP、DNS、DHCPサーバなどが利用可能です。また、リモートで制御・メンテナンスが行えます。【利用の制限など】営利外の場合は制限なし。営利目的の場合は、連絡下さい。過去に悪質業者に無断利用され、問題になりました。悪意がないと判断される場合、承諾させて頂いています。BlackJumboDogとは

公開ファイルは３種類 1.bjd-x.x.x.zip バイナリ 2.bjd-src-x.x.x.zip ソース 3. bjd-x.x.x.msi インストーラーデフォルトでC:¥BlackJumboDogに展開されますインストール

BJD.exe 本体BJD.exe.config アプリケーション構成ファイルOption.def 設定のデフォルト値＊.ini オプション保存ファイル（削除で初期化）＊Server.dll 各種サーバ機能 (14種類)＊.Log ログファイルnamed.ca ルートサーバ一覧(DNSサーバ用)examlpe.pfx SSL証明書サンプル（Webサーバ用）ファイルの種類

資源節約脆弱性リスク軽減DLLを削除すると

「BJD.exe 接続先アドレス」で起動するリモート側で、BJDで行うすべての操作が可能になり、遠隔制御ができます。 ※リモートサーバを使用する設定が、あらかじめ必要です。リモート制御

IPv6がインストールされていれば、IPv6でbindできます。 IPv4とIPv6のデュアルスタックも可能IPv6設定

サーバとクライアント間のデータを表示SEND サーバ送信データRECV クライアント送信データトレース表示

メニューからサービスの登録・起動などが可能です。サービス起動

STEP１サーバを使用する（必須）STEP２ ACL設定する（必須）STEP３サーバごと必要なオプションを指定 STEP３の設定で、必須のものが不足している場合は、明確なエラーが表示されますので、安心して使用してみて下さい。設定の勘所（３ステップ）

当該オプションを開く xｘｘサーバを開始するにチェック１STEP サーバを使用する

デフォルトでALL Deny誰も接続できません 1.各サーバごとオプションの最後のページ「ACL」 2.アドレスを追加 3.指定のみを「許可」/「禁止」に設定する２ STEP ACLを設定する

必須は赤字のみ、その他は、取りあえずデフォルトのままでＯＫ・Webサーバドキュメントルート、CGI、SSI、WebDAV、alias、認証・・・・・FTPサーバユーザ作成、バナーメッセージ、SYST、仮想フォルダ・DNSサーバルートキャッシュ、再帰要求、SOAレコード、リソース追加・・・・HTTPプロキシサーバ上位プロキシ、キャッシュ、ＵＲＬ制限、コンテンツ制限・・・・リモート制御パスワード、Listenポート・・・・DHCPサーバ配布するアドレス範囲、DNSサーバ、リース時間、MAC制御、WPAD・・・ STEP３サーバ毎の設定

１つのサーバDLLで複数サーバを設定できる場合は、「サーバの追加と削除」が必要現在は、「Web」と「トンネル」のみ３ステップの例外

「追加と削除」で複数のサーバを作成できるメニューが増減する３ステップの例外（Webの例）

http://www.ssapporoworks.ne.jp/spw/bjd/support.html 設定のための参考

•デモWeb・DNSサーバの設定例

プログラムの構造と改造要領

bjd-src-x.x.x.zip ソース開発環境が構築済の場合は、BJD.slnをダブルクリックそのまま再構築（F5) コードの展開と再構築

テストプロジェクトは、nunit.feameworkを参照しているのでNUnitが無い場合、エラーとなります。エラーとなるTestプロジェクトを全部削除する。 NUnitをインストールするBJDの構築には影響なし NUnitの参照

ソースコードにはSampleServerというプロジェクトが存在します。構築（F5）すると「SAMPLEサーバ（Z)」を見つけることができます。SampleServer.dllを配布していないので、バイナリ配布物では見えませんSampleサーバ（雛形）

partial class Server : OneServer { public Server(Kanel kanel, string nameTag, OneBind oneBind) :base(kanel, nameTag,oneBind) { } //サーバ生成（BJD起動・設定変更） public override void _dispose() { } //サーバ破棄（BJD停止・設定変更） public override bool _before_loop() { return true; } //サーバ起動 public override void _after_loop() { } //サーバ停止 //接続毎 override public void _subThread(SockObj sockObj) { TcpObj tcpObj = (TcpObj)sockObj; //切断 } 1.接続単位のサーバ動作を記述} 2.前処理等は、オーバライドメソッドを利用Server.cs （サーバ本体）

partial class Server { public override string GetMsg(int messageNo) { switch (messageNo) { case 1:return kanel.Jp ? “日本語” : “English”; //この形式でログ用のメッセージ追加 } return “unknown”; }} 1.ログ出力文字列の定義ログとして出力したい文字列を番号で指定する基底クラス(OneServer)でLoggerを初期化する際、delegateとして渡されるLog.cs （ログ文字列）

public class Option : OneOption { //メニューに表示される文字列 public override string JpMenu { get { return "SAMPLEサーバ(&Z)"; } } public override string EnMenu { get { return "&Sample Server"; } } public Option(Kanel kanel, string path, string nameTag) : base(kanel, path, nameTag, true/*ACL*/) { //「useServer」オプションは必須 Add(new OneVal("useServer", false, CRLF.NEXTLINE, new CtrlCheckBox((kanel.Jp) ? "SAMPLEサーバを使用する" : "Use Sample Server"))); 1.メニューの表示文字列 2.オプション設定ダイログ初期化 {//PAGE 基本設定 //////////////////////////////////////////////////////////////////////////////// サーバ共通オプション・・・・・・・・・・・・・・・・・・・・・・・・ページ構成コントロール変化時の処理Option.cs （オプション設定）

*.dllを検索し ListOptionを元に karnel OneOptionを列挙する OneServerを列挙する BJDカーネル-------------------+o : ListOption BJD.exe TreadBase+s : ListServer スレッド起停 ListOption ListServer オプション一覧サーバ一覧 OneOption OneServer オプション基底サーバ基底 Option Server オプション SampleServer.dll サーバ主要クラス

//Server.cspartial class Server : OneServer { //接続毎 override public void _subThread(SockObj sockObj) { TcpObj tcpObj = (TcpObj)sockObj; １接続単位の処理をここで記述する接続先（クライアント）との処理はsockObjを使用する //切断 }}サーバスレッド

TcpObj若しくはUdpObjにキャストして作業する //接続元IP Ip RemoteAddr SockObj //接続元ホスト String RemoteHost … TcpObj UdpObj//１行受信byte [] LineRecv(…) //送信string AsciiRecv(…) void SendTo(byte [] buf)//１行送信 //受信int LineSend(byte[] buf, …) Bool ReceiveFrom(…)Int AsciiSend(string str,…) … SockObj クラス

//Server.cs override public void _subThread(SockObj sockObj) { TcpObj tcpObj = (TcpObj)sockObj; Logger.Set(LOG_KIND.NOMAL, tcpObj, 1, "テストメッセージ"); //Log.cs public override string GetMsg(int messageNo) { switch (messageNo) { case 1:return kanel.Jp ? “日本語” : “English”; ログ出力

基底クラスで定義されているLoggerを使用し、Logger.Set(…)で出力する Logger OneServer -------------------------- サーバ基底 -------------------------- -------------------------- +Set ( ) #Logger : Logger//コンストラクタ public Logger(…GetMsgDelegate getMsg) Server サーバ//ログ出力void Set(LOG_KIND logKid,SockObj sockObj,int messageNo,string detailInfomation)LOG_KIND 種類 ERROR,NOMAL,DETAILsetmessageNo メッセ―番号 GetMsg()で定義detailInfomation 詳細情報（任意） Logger クラス

//Option.cspublic class Option : OneOption { //メニューに表示される文字列 public override string JpMenu { get { return "SAMPLEサーバ(&Z)"; } } public override string EnMenu { get { return "&Sample Server"; } } メニュー文字列

public class Option : OneOption { public Option(Kanel kanel, string path, string nameTag) : base(kanel, path, nameTag, true/*ACL*/) {ACL有効・無効

public class Option : OneOption { public Option(Kanel kanel, string path, string nameTag) : base(kanel, path, nameTag, true/*ACL*/) { Add(new OneVal()…); {//PAGE 基本設定 //////////////////////////////////////////////////////////////////////////////// Add(new OneVal()….. OneValをAdd()してInit()する }//PAGE 基本設定 //////////////////////////////////////////////////////////////////////////////// 値オブジェクトをリストに列挙して初期化する Init();//ValListの初期化 }Optionのコンストラクタ

OneOption List<OneVal> -------------------------- -ar : ListVal -------------------------- -Add (OneVal ) ListVal -------------------------- -------------------------- Option OneValの値として + CreateCtrl()//Ctrl生成オプション ListValを保持できる //リモート対応public OneVal( string name,//名前 OneVal object defaultValue,//デフォルト値 -------------------------- CRLF crlf,//改行指定 +Name:string OneCtrl oneCtrl) //コントロール +Value:obj -------------------------- - ToReg() //保存OneVal（値）クラス - FromReg() //読込

OneCtrl CtrlTextBox CtrlCehckBox Ctrlint CtrlMemo CtrlTabPagepublic CtrlTextBox(string help, int width,bool hidden=false) CtrlGroupBoxpublic CtrlCheckBox(string help)public CtrlInt(string help, int len)…. コントールの種類ごとにコンストラクタが違うインテリセンスの言う通り・・・・ OneCtrl（コントロール）クラス

//「useServer」オプションは必須Add(new OneVal("useServer", false, CRLF.NEXTLINE , new CtrlCheckBox("SAMPLEサーバを使用する"));//「AppendServerOption」は必須PROTOCOL_KIND protocolKind = PROTOCOL_KIND.TCP;int port = 9999;//ポート番号int timeout = 30;//タイムアウトint multiple = 10;//同時起動数AppendServerOption(list, protocolKind,port, timeout, multiple);これらのオプションは、必ず存在するという前提で各種の動作が組み立てられている必須オプション

//Option.csAdd(new OneVal("test01", "サンプル",CRLF.NEXTLINE, new CtrlTextBox("テストテキスト", 300)); 全てのオプション値は、GetValue(“name”)で取得できるデータの種類によってキャストが必要 //オプション値の取得 var aaa = (string)OneOption.GetValue("aaa");オプションの使用

//CtrlIntvar port = (int)OneOption.GetValue("port");//CtrlCheckBoxvar detail = (bool)OneOption.GetValue("detail");//CtrlRadiovar authType = (int)OneOption.GetValue("authType");//CtrlComboBoxvar matching = (int)OneOption.GetValue("matching");オプションのキャスト例

•デモSampleサーバの修正

SampleServerのフォルダをコピーして名前を変更プロジェクトを開いて名前を付けて保存（プロジェクト名を変更）[付録]サーバ名の変更（1）

プロジェクトのプロパティで「アセンブリ名」及び「既定の名前空間」を変更Server.cs Log.cs Option.csの名前空間を修正[付録]サーバ名の変更（2）

Option.csでメニューに表示される文字列を修正プロジェクトを閉じて不要ファイルを削除SampleServer.csprojSample.slnSample.suo[付録]サーバ名の変更（3）

BJD.slnを開き直して作成したプロジェクトを追加する再構築(F5) [付録]サーバ名の変更（4）

ご清聴ありがとうございました。 2011.11.19 by sapporowroks

http://d.hatena.ne.jp	951
http://webcache.googleusercontent.com	5
http://translate.googleusercontent.com	1

B lack jumbodog 運転と改造のすすめ

by furuya02 on Nov 19, 2011

Accessibility

Categories

Tags

Upload Details

Usage Rights

3 Embeds 957

Statistics

B lack jumbodog 運転と改造のすすめ — Presentation Transcript