1. サーバ構築のデージーネットTOP
2. OSS情報
3. デージーネットのOSS
4. SaMMA

• 5.1 configure オプション
• 5.2 samma.conf
  • 5.2.1 共通の項目
  • 5.2.2 暗号化モードで利用できる項目
  • 5.2.3 削除モードで利用できる項目
  • 5.2.4 無害化モードで利用できる項目
  
  
• 5.3 harmless.conf
  • 5.3.1 変換コマンド
  
  
• 5.4 mime.types

5. 設定詳細

5.1 configure オプション

configure のオプションとして以下のものが設定できます。

5.2 samma.conf

samma.confに設定可能な項目の一覧です。
暗号化モード、削除モード、無害化モードでそれぞれ記述できる値が異なります。
全てで共通して利用できる項目、それぞれ別個で利用できる項目を別表にて記載します。

5.2.1 共通の項目

※1 reload反映はreload allで再読み込みする設定項目です。CommandPort、ListenIP、ListenPortを変更したい場合はSaMMAを再起動する必要があります。
※2 milterアプリケーションが使用するIPアドレスと同一にする必要があります。
※3 milterアプリケーションが使用するポートと同一にする必要があります。
※4 @sysconfdir@はインストール時に指定した設定ファイルの配置場所です。
※5 書式は以下になります。

{hash|btree}:DBファイルのパス

5.2.2 暗号化モードで利用できる項目

abcdefghijklm
nopqrstuvwxyz
ABCDEFGHIJKLM
NOPQRSTUVWXYZ
0123456789`~!
@#$%^&*()_+-
={}[]:";'<>?,./

※1 @sysconfdir@はインストール時に指定した設定ファイルの配置場所です。
※2 書式は以下になります。

{hash|btree}:DBファイルのパス

　
※3 UserPolicyが「yes」の場合、LdapURI、LdapBaseDn、LdapBindDn、LdapBindPassword、LdapFilterは必須項目になります。
※4 AutoBccOptionが「yes」の場合、DefaultAutoBccConditionString、DefaultAutoBccMailAddrは必須項目になります。

5.2.3 削除モードで利用できる項目

5.2.4 無害化モードで利用できる項目

5.3 harmless.conf

無害化変換の処理対象を指定するファイルです。

以下に設定例を示します。

#　元のMIMEタイプ　　　変換後のMIMEタイプ　　　拡張子　　変換コマンド
multipart/alternative　text/plain　　　　　　　.alt　　　alternative
multipart/mixed　　　　multipart/mixed　　　　 -　　　　 multipart
text/html　　　　　　　text/plain　　　　　　　.txt　　　/usr/bin/python-html2text
＊　　　　　　　　　　 -　　　　　　　　　　　 -　　　　 extension
＊　　　　　　　　　　 -　　　　　　　　　　　 -　　　　 @none

1行あたり4つの設定項目をスペースまたはタブ区切りで記述します。#で始まる行はコメント行として無視されます。

• 元のMIMEタイプ → 変換対象とするMIMEタイプを記述します。「*」を指定することにより、全てのMIMEタイプが対象となります。書式チェックは行いません。
• 変換後のMIMEタイプ → ここに記述されたMIMEタイプに変換されます。ハイフンを指定した場合、MIMEタイプは変換されません。
• 拡張子 → 変換対象パートにファイル名が存在した場合、指定した拡張子が付与されます。ハイフンを記述した場合、拡張子は付与されません。
• 変換コマンド → 変換後のファイル名を記述します。また、コマンドの先頭に@を記述すると無害化処理結果添付メッセージを書き込ませないようにできます。

5.3.1 変換コマンド

• alternative
  • alternativeパートを分割し、text/plainパート以外を削除します。
  • text/plainパートが複数存在した場合、最初の1つを残し、それ以外を削除します。
  • text/plainパートがひとつも存在しなかった場合、変換後のMIMEタイプをtext/plainに設定されているパートを探し、変換を試みます。
  • 残せるパートがひとつも存在しなかった場合、変換エラーとなり、メールは送信されません。

• multipart
  • multipartパートを分割し、それぞれのパートを変換します。
  • 環境設定ファイルに指定された最大のネスト数に達した場合、変換エラーとなります。
  • 最大ネスト数は、MaxMultipartDepthの項目で指定します。

• extension
  • 添付ファイル名の拡張子で設定項目MimeTypeFileに指定されたファイルを検索し、定義されているMIMEタイプを取得します。
  • 添付ファイル名や拡張子がない場合と拡張子がMimeTypeFileで指定されたファイルになかった場合、extensionコマンドの次の処理へ進みます。
  • その取得したMIMEタイプでもう一度無害化処理を行います。

• none
  • 変換を行いません。
  • 主に、text/plainパートを指定することで、本文を変換対象外とすることができます。

• 外部コマンド
  • スラッシュ (/) で始まる、変換コマンドを記述できます。
  • 変換コマンドは絶対パスで指定し、実行権が必要です。
  • 標準入力からデータを受け取り、標準出力に変換後のデータを返す必要があります。
  • 正常終了した場合には、終了コードとして0を返す必要があります。
  • SaMMAから外部コマンドが起動される時、環境変数 SAMMA_FILENAME に添付ファイル名が設定されます。外部コマンドでは、環境変数 SAMMA_FILENAME を参照することで、添付ファイル名を参照することができます。
  • 先の設定例では、HTMLパートをpython-html2txtコマンドによってテキストファイルに変換しています。

5.4 mime.types

harmless.confで指定できるextensionコマンドで参照するファイルです。

以下に設定例を示します。

#　MIMEタイプ　　　　　　　　　　　　 　　　拡張子
application/andrew-inset　　　　　　　　　　ez
application/applefile
application/atom+xml　　　　　　　　　　　　atom
application/atomcat+xml　　　　　　　 　　　atomcat
application/atomdeleted+xml atomdeleted
application/atomicmail
application/atomsvc+xml　　　　　 　　　　　atomsvc
application/auth-policy+xml　　　　　　　　 apxml
application/batch-SMTP
application/cellml+xml　　　　　　　　　　　cellml cml
：
（以下省略）

1行あたり2つの設定項目をスペースまたはタブ区切りで記述します。#で始まる行はコメント行として無視されます。 また、「mailcap」パッケージに含まれるものと同様の形式のファイルとします。(mailcapパッケージは、CentOSでは標準でインストールされています。)

• MIMEタイプ → 拡張子ごとに定義されたMIMEタイプです。添付ファイルの拡張子を元にこの項目から新しいMIMEタイプを取得します。書式チェックは行いません。
• 拡張子 → MIMEタイプを定義する拡張子です。添付ファイルと同じ拡張子だった場合、対応するMIMEタイプとして再度無害化処理を行います。また、拡張子を複数指定する場合、スペース区切りで羅列します。拡張子の存在しない行は、書式上許可されますが無視されます。