*IRC/SMTPゲートウェイ [#w3c4b9e7]
RIGHT:2008-02-12
*IRC/SMTPゲートウェイ 
RIGHT:2008-10-20
RIGHT:川俣吉広

IRCとメールとの間でメッセージをやりとりするための機能を
実験的に実してみました。
**アーキテクチャ [#i8b051b4]
アーキテクチャの概略を下図に示します。~
下図の[IRC/SMTP Gateway]および[injector]の部分が今回作成した部分です。
IRCとメールとの間でメッセージをやりとりする機能の試験的な実**アーキテクチャ 
アーキテクチャの概略を下図に示します。
// +----+  SMTP   +-------------+      SMTP                         +--------+
// |Mail|<--------|< - - - - - -|<---------------[migw.pl]<-------->| IRC    |
// |User|         | mail server |                    ^              | Server |
// |    |-------->|- - - - - - >|-->[.forward]       |socket        +--------+
// +----+         +-------------+        |           |
//                                       +------>[minjector.pl]
|&ref(migw-internal.gif,wrap);|
上図の &ref(migw.pl); および &ref(minjector.pl); の部分が今回作成した部分です。

IRC/SMTP Gatewayは、IRCクライアントとして目的のチャンネルにJOINしており、
migw.pl は、IRCクライアントとして目的のチャンネルにJOINしており、
IRC内での発言を受信します。
受信された発言は、メーリングリストに転送するためメールとしてSMTPサーバに渡されます。
受信された発言はメールに変換され、SMTPサーバに渡されます。

一方、メーリングリストにメールが投稿された場合は、メーリングリストの信先の
アカウントの一つから injectorというプログラムに引き渡されます。
injectorの起動とデータの引き渡しは、.forwardや.procmailrcでの設定により行っています。
一方、メールからIRCへの転送は、メールサーバでの
.forward あるいは .procmailrc などの設定により
メールのヘッダおよび本文が minjector.pl というプログラムに引き渡されます。

injectorは、標準力からメールのヘッダと本文を読み込み
一定の形式に変換した後 IRC/SMTP Gatewayに渡し、このメッセージが
IRCネットワークに投稿されます。
              Mailing                               IRC
              List                                 Channel
                |<---[ML driver]                     |<-->[IRC user 1]
                |        ^                           |
 [ML user 1]<-->|        |                           |<-->[IRC user 2]
                |--->[SMTP Server]<----[IRC/SMTP]<-->|
 [ML user 2]<-->|                      [Gateway ]    |----[IRC user n]
                |                          ^
 [ML user n]<-->|                          |
                |                          |
 [ML user X]<-->|                          |
      |                                    |
      |                                    |
      +-->[.forward or]-->[injector]-------+
          [.procmailrc]
**利用方法 [#o32a25eb]
***IRCユーザ側 [#d45ad74b]
IRCネットワーク上では、ゲートウェイは一人のユーザのように見え、
そのチャンネルでの発言はすべてメーリングリストに投稿されるため、
とくに設定等は要ありません。
***メールユーザ側 [#a64c35b8]
メールを用いて交信を行う場合はメーリングリストに加する
要があります。
minjector.plは、標準力からメールのヘッダと本文を読み込み
一定の形式に変換した後、Unixドメインソケットを経由して migw.pl に
引き渡され、最後に IRCネットワークのJOINしているチャンネルで
発言されます。
**設定及び起動手順 
IRC/SMTPゲートウェイの設置と運用は、通常ユーザの権限で可能です。~
以下の例では、設置と運用を行うユーザのホームディレクトリ直下にmigwというディレクトリを
作成し、その中にスクリプトや設定ファイルを置く場合を想定して説明を行っています。
***準備 
-このPerlスクリプトは、
--Net::IRC
--Jcode
--Net::SMTP
--IO::Socket

今回の実験では、メーリングリストシステムにPPML((http://www.kk.iij4u.or.jp/~ando/ppml/ppml.html))
を使用しています。
というモジュールを使用しますので、
これらのモジュールがない場合は、CPANあるいはOS毎に
用意されているパッケージシステムなどからインストールします。
***設定ファイルの編集 
-このページに添付されている&ref(sample.conf);をに、設定の編集を行います。
 # 各種パラメータ設定
 #
 $IRC_NICK       = 'migw';
 $IRC_SERVER     = 'irc.example.net';
 $IRC_PORT       = 6667;
 $IRC_NAME       = 'IRC/SMTP gateway';
 $IRC_CH         = '#foo';
 $IRC_MAXLINES   = 20;
 $IRC_ITIMEOUT   = 120;
 $IRC_CTIMEOUT   = 150;
 $IRC_HANDLEFILE = $ENV{HOME} . "/migw/sample-handlenames.pl";
 
 $SMTP_SERVER    = 'localhost';
 $SMTP_FROM      = 'migw@example.com';
 $SMTP_TO        = 'talk-irc@mx.example.org';
 
 $SOCKPATH       = $ENV{HOME} . "/migw/sample.sock";
 
 $DEBUG          = 1;

PPMLの使用法を簡単に説明します。
設定書式は、Perlの文法に従います。~
設定目の一部を以下に説明します;
:$IRC_MAXLINES|一通のメール本文からIRCへ送信される最大行数。メッセージ本文でこの行数をえた部分はIRCチャンネルへは送信されない。
:$IRC_ITIMEOUT|IRCからメールへ送信する場合のタイムアウト。IRCで発言のない期間がこの秒数をえると、その時点までで送信されていなかったIRCの発言が、まとめて一通のメールとしてSMTPサーバに送信される。
:$IRC_CTIMEOUT|IRCからメールへ送信する場合のタイムアウト。IRCで$IRC_ITIMEOUTによるタイムアウトが発生していない状況で、発言がこの$IRC_CTIMEOUTで設定した秒数をえると、その時点までで送信されていなかったIRCの発言が、まとめて一通のメールとしてSMTPサーバに送信される。
:$IRC_HANDLEFILE|メールをIRCに中継した場合、IRCチャンネル上ではメールの送信が誰かを明示する必要があります。そのため中継されたメッセージの冒頭には、発言者のメールアドレスを縮めたものが付きます。例えば、メールの送信者アドレスが、kaw@on.rim.or.jpの場合、IRCチャンネル上では、
 <migw> kaw@on: こんにちは。
のようになります。このkaw@onをハンドル名と呼ぶことにします。~
ハンドル名は、上に述べたようにメールアドレスから生成されますが、
それ以外のものを定義することもできます。その定義ファイルの位置を指定するのが$IRC_HANDLEFILEです。~
$IRC_HANDLEFILEによるハンドル名の変換機能を使用しない場合は、この行をコメントアウトします。
:$SOCKPATH|minjector.plとmigw.plが通信するためのUnixドメインソケットのパス

:メーリングリストに参加したい|
以下のようなメールを送信します。
 To: ppserv@dameningen.kicks-ass.net
本文
 subscribe ircebug
しばらくすると、以下のような確認を求めるメールが自動返送されてきます。
 Subject: Request to Confirm
 From: PPML-Server <ppserv@dameningen.kicks-ass.net>
 To: kaw@on.rim.or.jp
本文
 Subscribe request for "ircebug" mail-list from your address received.
 If you can approve this request, Send back a line below.
         confirm 1202794262-00000001741 ircebug
その他は、自明な目だと思いますので省略します。
***メール関係の設定 
-minjector.plがメールを受け取るメールアカウント(設定ファイルでの$SMTP_FROM)を作成します。
-実際にminjector.plがメールを受け取るように、メールサーバの設定を行います。
--~/.forwardに記述する場合
 | perl $HOME/migw/minjector.pl $HOME/migw/sample.conf || exit 75
--~/.procmailrcに記述する場合
 :0
 * ^To: talk-irc@example\.org
 |perl $HOME/migw/minjector.pl $HOME/migw/sample.conf
Perlスクリプトや設定ファイルの置場は、実際のものに読み換えて下さい。
***ハンドル名変換ファイルの設定 
設定ファイル中で$IRC_HANDLEFILEを定義した場合は、そのファイルを用意します。~
設定ファイルは、Perlの文法に従います。容は&ref(sample-handlenames.pl);のようになります。
 %stat_handlenames = (
         'mail@example.com'  => 'HandleName',
         'mawk@foobar.ne.jp' => 'mika'
 );
 
 Thanks.
 -- ircebug-request@dameningen.kicks-ass.net
このメールの「confirm 1202794262-00000001741 ircebug」の部分を
ppserv@dameningen.kicks-ass.net宛に返送すると、
このメールの発信メールアドレスがメーリングリストにメンバーとして追加されます。
:メーリングリストから脱退したい|
以下のようなメールを送信します。
 To: ppserv@dameningen.kicks-ass.net
本文
 unsubscribe ircebug
:メーリングリストに記事を投稿したい|
ircebug@dameningen.kicks-ass.net宛に
メッセージを送信します。~
メッセージは、MLリストに送されます。同時に
IRCのチャンネルにも転送されます。
現在、IRCに転送されるメッセージは、本文中最初の4行までです。
:メーリングリストの送を一時的に停止したい|
以下のようなメールを送信します。
 To: ppserv@dameningen.kicks-ass.net
本文
 off ircebug
:メーリングリストの送を再開したい|
以下のようなメールを送信します。
 To: ppserv@dameningen.kicks-ass.net
本文
 on ircebug
:過去に送されたメールを再取得したい|
以下のようなメールを送信します。
 To: ppserv@dameningen.kicks-ass.net
本文
 get ircebug 1-10
最後の数字は、取得したいメールの記事番号です。~
以下の書式が使用できます。
 get ircebug 10        ... 記事番号10のメールを取得
 get ircebug 1-10      ... 1から10まで
 get ircebug 1,2,7     ... 1と2と7
 get ircebug 1,2,5-10  ... 1と2と5から10まで
offコマンドで一時的に送を停止していた間に
送されたメールもgetコマンドで取得できます。
 1;
このように、%stat_handlenames に、メールアドレスとハンドル名の対を
連想列の要素として定義します。
***プログラムの起動 
設置を行ったユーザアカウントでログインし、コマンドラインから以下のように実行します。
 perl $HOME/migw/migw.pl $HOME/migw/sample.conf
設定ファイルで$DEBUGが1の場合、動作にしたがってメッセージが出力されますので、
実際にIRCで発言したり、$SMTP_TOで設定したアドレスにメールを送信したりして動作を確認します。
***運用 
:ハンドル名の変更|ハンドル名は起動前にあらかじめ定義したものを、運用中に変更することができます。メールアドレスからハンドル名の変換を行う変換表は、2種類あります。~
~*静的変換表 ... $IRC_HANDLEFILE中で定義した変換表 ~
~*動的変換表 ... メールユーザがコマンドメールを送信することにより設定できる変換表。~
~
静的変換表の容を変更するには$IRC_HANDLEFILEの内容を変更した後、migw.plプロセスにUSR1シグナルを送信し、変更を反映させます。~
~
動的変換表を更新するには、ハンドル名を変換したいメールアドレスから以下の形式の本文を含むメールを送信します。
 ゲートウェイのIRCニックネーム<-iam ハンドル名
sample.confの設定値を例にとれば、体的には以下のようになります。
 migw<-iam kaw@home
これで、ハンドル名がkaw@homeに設定されます。ハンドル名を付けず、
 migw<-iam
と送信した場合は、設定されていたハンドル名がリセットされます。~
~
なお、静的変換表と動的変換表で同じ容が設定された場合は、動的変換表の内容が優先されます。
:中継動作の中断と再開|
ゲートウェイの中継動作を停止させたい場合は、以下の形式の本文を含むメールを送信します。
 ゲートウェイのIRCニックネーム<-relay off
これによりメール->IRC, IRC->メールのいずれの方向の中継動作も停止します。~
~
停止している中継動作を再開させたい場合は、以下のようにします。
 ゲートウェイのIRCニックネーム<-relay on
**Tips 
***複数のメールアドレスとIRCの間で交信を行いたい。 
複数のメールアドレスと交信したい場合は、MLを作成し、このMLのアドレスを$SMTP_TOに設定します。そして、設定ファイルの$SMTP_FROMのアドレスをこのMLに追加します。~
動作のイメージとしては、以下のようになります。~
|&ref(migw.gif,wrap);|
|CENTER:MLからIRCへの中継|
~
|&ref(migw-reply.gif,wrap);|
|CENTER:IRCからMLへの中継|
MLといっても、一般的なメーリングリストドライバを導せず、/etc/mail/aliases等を用いた簡易なものを使用することも可能です。
***splitしているIRCサーバの間を接続するために使いたい。 
これは、前のTip、''複数のメールアドレスとIRCの間で交信を行いたい''の応用になります。例えば、IRCサーバ fooと barを接続する場合は、以下のようになります。
--foo用の設定
---foo用の設定ファイル、foo.confを作成
---foo用のメールアカウントを作成し、foo.confを指定したminjector.plがメールを読むように.forwardなどを設定。
--bar用の設定
---barに対しても、fooと同様な設定作業を行う。
--foo, barに加入しているMLを作成する。
--foo用の設定でmigw.plを起動する。
--bar用の設定でもmigw.plを起動する。~
~
... 動作設定を増やすことで、さらに多くのIRCチャンネルを多接続することも可能です。
**ToDo 
-IRCの接続が切れた時に再接続を行う機能
--IRC接続断をトラップする方法が現在不明なため、現在は未実です。


Front page   New Page list Search Recent changes   Help   RSS of recent changes