*IRC/SMTPゲートウェイ [#w3c4b9e7]
 RIGHT:2008-02-12
 RIGHT:2008-10-20
 RIGHT:川俣吉広
 
 IRCとメールとの間でメッセージをやりとりするための機能を
 実験的に実装してみました。
 IRCとメールとの間でメッセージをやりとりする機能の実験的な実装。
 **アーキテクチャ [#i8b051b4]
 アーキテクチャの概略を下図に示します。~
 下図の[IRC/SMTP Gateway]および[injector]の部分が今回作成した部分です。
 アーキテクチャの概略を下図に示します。
         SMTP   +-------------+      SMTP                         +--------+
  Mail <--------|< - - - - - -|<---------------[migw.pl]<-------->| IRC    |
  User          | mail server |                    ^              | Server |
       -------->|- - - - - - >|-->[.forward]       |socket        +--------+
                +-------------+        |           |
                                       +------>[minjector.pl]
 上図の migw.pl および 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]
 メールを用いて交信を行う場合はメーリングリストに加入する
 必要があります。
 
 今回の実験では、メーリングリストシステムにPPML((http://www.kk.iij4u.or.jp/~ando/ppml/ppml.html))
 を使用しています。
 
 PPMLの使用法を簡単に説明します。
 
 :メーリングリストに参加したい|
 以下のようなメールを送信します。
  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は、標準入力からメールのヘッダと本文を読み込み
 一定の形式に変換した後、Unixドメインソケットを経由して migw.pl に
 引き渡され、最後に IRCネットワークのJOINしているチャンネルで
 発言されます。
 **設定及び起動手順 [#ie5adb66]
 IRC/SMTPゲートウェイの設置と運用は、通常ユーザの権限で可能です。~
 以下の例では、設置と運用を行うユーザのホームディレクトリ直下にmigwというディレクトリを
 作成し、その中にスクリプトや設定ファイルを置く場合を想定して説明を行っています。
 ***設定ファイルの編集 [#yb77e279]
 -このページに添付されている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;
  
  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コマンドで取得できます。
  $SMTP_SERVER  = 'localhost';
  $SMTP_FROM    = 'migw@example.com';
  $SMTP_TO      = 'talk-irc@example.org';
  
  $SOCKPATH     = $ENV{HOME} . "/migw/sample.sock";
  
  $DEBUG        = 1;
 設定書式は、Perlの文法に従います。~
 設定項目の一部を以下に説明します;
 :$IRC_MAXLINES|一通のメール本文からIRCへ送信される最大行数。メッセージ本文でこの行数を超えた部分はIRCチャンネルへは送信されない。
 :$IRC_ITIMEOUT|IRCからメールへ送信する場合のタイムアウト。IRCで発言のない期間がこの秒数を超えると、その時点までで送信されていなかったIRCの発言が一通のメールとしてSMTPサーバに送信される。
 :$IRC_CTIMEOUT|IRCからメールへ送信する場合のタイムアウト。IRCで$IRC_ITIMEOUTによるタイムアウトが発生していない状況で、発言がこの$IRC_CTIMEOUTで設定した秒数を超えると、その時点までで送信されていなかったIRCの発言が一通のメールとしてSMTPサーバに送信される。
 :$SOCKPATH|minjector.plとmigw.plが通信するためのUnixドメインソケットのパス
 
 その他は、自明な項目だと思いますので省略します。
 ***メール関係の設定 [#tca1f5b9]
 -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スクリプトや設定ファイルの置場は、実際のものに読み換えて下さい。
 ***プログラムの起動 [#db525786]
 設置を行ったユーザアカウントでログインし、コマンドラインから以下のように実行します。
  perl $HOME/migw/migw.pl $HOME/migw/sample.conf
 セッテイファイルで$DEBUGが1の場合、動作にしたがってメッセージが出力されますので、
 実際にIRCで発言したり、$SMTP_TOで設定したアドレスにメールを送信したりして動作を確認します。
 **Tips [#s9ca28e2]
 :複数のメールアドレスとIRCの間で交信を行いたい。|複数のメールアドレスと交信したい場合は、MLを作成し、このMLのアドレスを$SMTP_TOに設定します。そして、設定ファイルの$SMTP_FROMのアドレスをこのMLに追加します。~
 MLといっても、一般的なメーリングリストドライバを導入せず、/etc/mail/aliases等を用いた簡易なものを使用することも可能です。
 :splitしているIRCサーバの間を接続するために使いたい。|
 **ToDo [#v1a9f1ec]
 -IRCの接続が切れた時に再接続を行う機能
 
Top Index Search Recent Backups  Help  RSS