| ・ |
ドキュメントセンターを初めてご利用する方や運営方針についての基本的な姿勢をご覧になりたい方へ。
|
| ご利用の皆様から多く寄せられる質問にお答えしています。 |
|
| ・ |
ディーエーオフィスなどが利用する用語に関する解説を行います。
|
|
|
|
 | |
Maia Mailguard |
| amavisd-newとSpamAssassinに対するWebベースの管理システム。FreeBSD 4.11へ導入。
! 事前作業
php、cpanほか、事前に導入しておかないといけないものは多岐にわたる。面倒ならば後から、警告される都度導入しても良い。
・cpan
・php
・pear
・Smarty Template Engine
・libmcrypt
まずは、portsでsmartyとlibmcrypt、fileを導入する。
cd /usr/ports/www/smarty
make install
cd /usr/ports/security/libmcrypt
make install
/usr/ports/sysutils/file
make install
fileについては導入後もconfigtest.plを実行しても認識してもらえないので、file自体を置き換えることにした。mvコマンドで古いファイルを名称変更し、lnコマンドでシンボリックリンクを貼っている。なお、cpコマンドでコピーしたものを使っても良い。lnコマンドかcpコマンドかのいずれかを実行する。
mv /usr/bin/file /usr/bin/file.old
ln /usr/local/bin/file /usr/bin/file
(cp /usr/local/bin/file /usr/bin/file)
imapについては下記のようになる。手順も煩雑なため分かりづらいから留意する。c-clientやimapといったパッケージが見つかるが、どれも中身は同じようだ。
make時はFreeBSDの場合、bsfを指定する。configureは必要ない。作業が完了したら必要なものを自身で移動する。特に特別なオプションは他に必要ない。なお、導入は何度か失敗したが、失敗したときには、make cleanの他、いったんディレクトリを削除し、パッケージからの展開をやり直さないといけない。うまく動かなかった(のでネットで調べると同様の主旨の説明があった)。
なお、imap-2006なる最新パッケージも試したが、うまくいかなかったのでimap-2004gを利用。
fetch ftp://ftp.cac.washington.edu/imap/c-client.tar.Z
tar xvzf c-client.tar.Z
cd imap-2004g
make bsf
コピー前にコピー先へファイルがないことを確認。FreeBSD4.11の環境には少なくともなかった。いったん、ライブラリの利用をとりやめたいときのために、削除についても列挙した。
cd /usr/local/src/imap-2004g/c-client
= 導入時 =
cp c-client.a /usr/local/lib/libc-client.a
ldconfig -m
cp c-client.h /usr/local/include
cp imap4r1.h /usr/local/include
cp rfc822.h /usr/local/include
cp mail.h /usr/local/include
cp linkage.h /usr/local/include
cp env.h /usr/local/include
cp env_unix.h /usr/local/include
cp fs.h /usr/local/include
cp ftl.h /usr/local/include
cp misc.h /usr/local/include
cp nntp.h /usr/local/include
cp nl.h /usr/local/include
cp osdep.h /usr/local/include
cp smtp.h /usr/local/include
cp tcp.h /usr/local/include
cp utf8.h /usr/local/include
= 削除時 =
rm /usr/local/lib/libc-client.a
rm /usr/local/include/utf8.h
rm /usr/local/include/c-client.h
rm /usr/local/include/imap4r1.h
rm /usr/local/include/rfc822.h
rm /usr/local/include/mail.h
rm /usr/local/include/linkage.h
rm /usr/local/include/env.h
rm /usr/local/include/env_unix.h
rm /usr/local/include/fs.h
rm /usr/local/include/ftl.h
rm /usr/local/include/misc.h
rm /usr/local/include/nntp.h
rm /usr/local/include/nl.h
rm /usr/local/include/osdep.h
rm /usr/local/include/smtp.h
rm /usr/local/include/tcp.h
rm /usr/local/include/utf8.h
cpanについては下記が必要。configtest.plで確認可能。普段、CPANを使っているならば、確認せずに進んで、configtest.plを走らせたときに警告されたものだけを導入すると良い。初めてのときは確認するようにしたい。
cpanは「perl -MCPAN -e shell」を実行してシェルを呼び出す。「[[docs link 3427]]」を参照。導入済みのモジュールを更新したいときは「[[docs link 6978]]」を参照。なお、下記の一覧は、cpanのシェル上で「install Archive::Tar」と実行すれば、導入される。
perl -MCPAN -e shell
Archive::Tar
Archive::Zip
BerkeleyDB
Compress::Zlib
Convert::TNEF
Convert::UUlib
Crypt::Blowfish
Crypt::CBC
Crypt::OpenSSL::RSA
Data::UUID
DB_File
DBD::mysql
DBD::Pg
DBI
Digest::MD5
Digest::SHA1
File::Spec
HTML::Parser
HTTP::Date
IO::Stringy
IO::Zlib
IP::Country
LWP::UserAgent
Mail::Address
Mail::DomainKeys
Mail::Internet
Mail::SpamAssassin
Mail::SPF::Query
MIME::Base64
MIME::Parser
MIME::QuotedPrint
Net::CIDR::Lite
Net::DNS
Net::Server
Net::SMTP
Pod::Usage
Template
Time::HiRes
Unix::Syslog
URI
phpについては下記のようになる。configtest.phpで確認可能。phpのインストール時にconfigureオプションを指定する。試験時のconfigure設定については下記へ別記した。
・postgresql --with-pgsql
・mysql --with-mysql
・ldap --with-ldap
・imap --with-imap
・mcrypt --with-mcrypt
・gd --with-gd=/usr/local
pearについては下記が必要。シェル上で直接、以下を実行すれば良い。configtest.phpで確認可能。
pear install DB_Pager
pear install Net_Socket
pear install Net_SMTP
pear install Auth_SASL
pear install Net_IMAP
pear install Net_POP3
pear install Log
pearのNet_IMAPについては、php5へ導入するときは注意が必要。
A bug exists in Net_IMAP 1.0.3 when run under PHP 5, see https://secure.renaissoft.com/maia/ticket/266 for more details.
ee /usr/local/lib/php/Net/IMAPProtocol.php
https://secure.renaissoft.com/maia/ticket/266
https://secure.renaissoft.com/maia/attachment/ticket/266/IMAPProtocol.php.patch
! インストール
fetch http://www.renaissoft.com/maia/files/maia-1.0.1.tar.gz
tar zxf maia-1.0.1.tar.gz
fetch http://www.aconus.com/~oyaji/suse9.3/maia-1.0.1-japanese.patch
patch -p0 < maia-1.0.1-japanese.patch
! SQLを実行
Maia Mailguardのインストール方法だとrootで実行すると説明されてあったので、思わず下記のように修正して実行した。別段、Maia Mailguardの説明通りでも、本文書の方法でも最終的な着地点に変わりはない。
mysql -uroot -p
create database maia;
grant all on maia.* to maia@localhost identified by "パスワード";
ee maia-mysql.sql
冒頭にuse maia;を追記。
mysql -u maia -p < maia-mysql.sql
/usr/local/etc/rc.d/mysql-server.sh restart
! 必要なものを移動
基本的にはpostfixadminと同じで、phpスクリプトが主体となるので、UNIX的なインストール作業はない。好みで作業して構わない。本文書では/usr/local/src以下にソースを残したまま、必要なものだけ/home/maia以下に展開することとした。
mkdir /home/maia/
cp -R /usr/local/src/maia-1.0.1/scripts /home/maia/scripts/
cp -R /usr/local/src/maia-1.0.1/templates /home/maia/templates/
cp -R /usr/local/src/maia-1.0.1/php /home/maia
chmod 750 /home/maia/scripts/*.pl
chmod 640 /home/maia/templates/*.tpl
(chown -r vscan:vscan /home/maia)
chown -r nobody:nobody /home/maia/php
! 設定
cp /usr/local/src/maia-1.0.1/maia.conf.dist /etc/maia.conf
chmod 640 /etc/maia.conf
chown vscan:vscan /etc/maia.conf
ee /etc/maia.conf
下記を修正。データベースへの接続に利用される。$script_dirは、scriptsの位置を変更した際に必要。今回は移動したので修正した。
$username = "vscan";
$password = "passwd";
$script_dir = "/home/maia/scripts";
! 必要なものが動作するかを試験
cd /home/maia/scripts
./configtest.pl
上記を実行した例は次の通り。一覧で「OK」となっているものは、導入できており、なおかつバージョンも問題ない。下記の例ならば、file(1)などは導入されているが、3.41という古いバージョンなので4.12以降のバージョンへ更新するように表示された状態。また、データベースへの接続試験も行われる。maia.confの設定を確認する。
MAIA MAILGUARD CONFIGURATION TEST
This script checks for the presence of applications and Perl modules
required by amavisd-maia, SpamAssassin, and Maia Mailguard's maintenance
scripts. Version numbers are also checked, and if a newer version of
a component is recommended, you should consider upgrading to at least
the minimum recommended version.
If you have already configured your Maia Mailguard database, the script
will also test the connection to that database.
Remember also to run the configtest.php script on your web server to
perform similar tests of your web, PHP, and PEAR environment.
Application/Module Version Status
========================================================================
Perl : 5.8.8 : OK
file(1) : 3.41 : UPGRADE RECOMMENDED (minimum version 4.12)
Archive::Tar : 1.29 : OK
Archive::Zip : 1.16 : OK
BerkeleyDB : 0.27 : OK
Compress::Zlib : 1.41 : OK
Convert::TNEF : 0.17 : OK
Convert::UUlib : 1.06 : OK
Crypt::Blowfish : N/A : NOT INSTALLED (Maia Mailguard's optional encryption feature requires this)
Crypt::CBC : N/A : NOT INSTALLED (Maia Mailguard's optional encryption feature requires this)
Crypt::OpenSSL::RSA : 0.23 : OK
Data::UUID : N/A : NOT INSTALLED (required by Maia Mailguard)
DB_File : 1.814 : OK
DBD::mysql : 3.0004 : OK
DBD::Pg : 1.49 : OK
DBI : 1.51 : OK
Digest::MD5 : 2.36 : OK
Digest::SHA1 : 2.11 : OK
File::Spec : 0.9 : OK
HTML::Parser : 3.54 : OK
HTTP::Date : 1.47 : OK
IO::Stringy : 2.110 : OK
IO::Zlib : 1.04 : OK
IP::Country : 2.21 : OK
LWP::UserAgent : 2.033 : OK
Mail::Address : 1.74 : OK
Mail::DomainKeys : 0.80 : OK
Mail::Internet : 1.74 : OK
Mail::SpamAssassin : 3.1.3 : OK
Mail::SPF::Query : 1.999.1 : OK
MIME::Base64 : 3.07 : OK
MIME::Parser : 5.420 : OK
MIME::QuotedPrint : 3.07 : OK
Net::CIDR::Lite : 0.20 : OK
Net::DNS : 0.57 : OK
Net::Server : 0.93 : OK
Net::SMTP : 2.29 : OK
Pod::Usage : 1.33 : OK
Template : N/A : NOT INSTALLED (required by Maia Mailguard)
Time::HiRes : 1.87 : OK
Unix::Syslog : 0.100 : OK
URI : 1.35 : OK
DBI connect('maia:localhost:3306','vscan',...) failed: Access denied for user 'vscan'@'localhost' (using password: YES) at ./configtest.pl line 306
Database DSN test : FAILED (verify $dsn, $username, and $password in /etc/maia.conf)
! php5のインストール
導入試験時のconfigure指定例を示す。
./configure \
--with-apxs2=/usr/local/apache2/bin/apxs \
--with-openssl=/usr \
--with-ssl \
--enable-soap \
--enable-ftp \
--enable-i18n \
--enable-multibyte \
--enable-mbregex \
--enable-mbstr-enc-trans \
--enable-mbstring \
--enable-jstring \
--with-zlib-dir=/usr \
--with-freetype-dir=/usr/local \
--with-ttf \
--with-gd=/usr/local \
--enable-gd-native-ttf=/usr \
--with-jpeg-dir=/usr \
--with-tiff-dir=/usr \
--with-png-dir=/usr \
--enable-exif \
--with-imagick \
--with-magickwand \
--with-mcrypt \
--enable-bcmath \
--with-imap \
--with-pgsql \
--with-mysql
--with-ldap \
! 不具合の例「utf8.hがない」
In file included from /usr/local/src/php-5.1.4/ext/imap/php_imap.h:39,
from /usr/local/src/php-5.1.4/ext/imap/php_imap.c:47:
/usr/local/include/c-client.h:38: utf8.h: No such file or directory
*** Error code 1
Stop in /usr/local/src/php-5.1.4.
utf8.hが不足しているようだったので、includeディレクトリへコピーした。
cp utf8.h /usr/local/include
! 不具合の例「utf8.hに問題」
/usr/local/src/php-5.1.4/ext/imap/php_imap.c:78: conflicting types for `utf8_mime2text'
/usr/local/include/utf8.h:538: previous declaration of `utf8_mime2text'
*** Error code 1
Stop in /usr/local/src/php-5.1.4.
ee /usr/local/src/imap-2006.DEV.SNAP-0606151542/Makefile
Makefileを見たりもしたが、諦めて、imap-2004gを利用した。
! Smarty導入後のメッセージ
/usr/ports/www/smarty
You need to adjust php's include_path to contain `/usr/local/share/smarty'!
For example, insert
include_path = ".:/usr/local/lib/php:/usr/local/share/smarty"
into `/usr/local/etc/php.ini'.
===> Registering installation for smarty-2.6.13
! IMAP Makefile
tarで展開した直下のディレクトリには、Makefileがある。中に説明があり、以下のような詳しい指定方法が記載されている。若干抜粋して紹介する。
# Normal command to build IMAP toolkit:
# make [EXTRAAUTHENTICATORS=xxx] [EXTRADRIVERS=xxx] [EXTRACFLAGS=xxx]
# [PASSWDTYPE=xxx] [SSLTYPE=xxx] [IP=n]
# Port name. These refer to the *standard* compiler on the given system.
# This means, for example, that the hpx port is for HP's compiler and not for
# a non-standard compiler such as gcc.
#
# If you are using gcc and it is not the standard compiler on your system, try
# using an ANSI port that is close to what you have. For example, if your
# system is SVR4ish, try a32 or lnx; if it's more BSDish, try nxt, mct, or bsi.
# The following ports are bundled:
# bs3 BSD/i386 3.0 and higher
# bsd generic BSD 4.3 (as in ancient 1980s version)
# bsf FreeBSD
# bsi BSD/i386
# bso OpenBSD (yes, yet another one...)
# Extra authenticators (e.g. OTP, Kerberos, etc.). Adds linkage for
# auth_xxx.c and executes Makefile.xxx, where xxx is the name of the
# authenticator. Some authenticators are only available from third parties.
#
# The following extra authenticators are bundled:
# gss Kerberos V
EXTRAAUTHENTICATORS=
# Additional mailbox drivers. Add linkage for xxxdriver. Some drivers are
# only available from third parties.
#
# The following extra drivers are bundled:
# mbox if file "mbox" exists on the home directory, automatically moves mail
# from the spool directory to "mbox" and uses "mbox" as INBOX.
EXTRADRIVERS=mbox
# Plaintext password type. Defines how plaintext password authentication is
# done on this system.
#
# The following plaintext login types are bundled:
# afs AFS authentication database
# dce DCE authentication database
# gss Kerberos V
# nul plaintext authentication never permitted
# pam PAM authentication (note: for Linux, you should use the "lnp" port
# instead of setting this...also, you may have to modify PAMLDFLAGS
# in the imap-[]/src/osdep/unix/Makefile
# pmb PAM authentication for broken implementations such as Solaris.
# you may have to modify PAMLDFLAGS
# std system standard (typically passwd file), determined by port
# two try alternative (defined by CHECKPWALT), then std
PASSWDTYPE=std
# SSL type. Defines whether or not SSL support is on this system
#
# The following SSL types are bundled:
# none no SSL support
# unix SSL support using OpenSSL
# nopwd SSL support using OpenSSL, and plaintext authentication permitted only
# in SSL/TLS sessions
# sco link SSL before other libraries (for SCO systems)
# unix.nopwd same as nopwd
# sco.nopwd same as nopwd, plaintext authentication in SSL/TLS only
#
# SSLTYPE=nopwd is now the default as required by RFC 3501
SSLTYPE=nopwd
# IP protocol version
#
# The following IP protocol versions are defined:
# o IPv4 support, no DNS (truly ancient systems)
# 4 (default) IPv4 support only
# 6 IPv6 and IPv4 support
IP=4
# The following extra compilation flags are defined. None of these flags are
# recommended. If you use these, include them in the EXTRACFLAGS.
#
# -DDISABLE_POP_PROXY
# By default, the ipop[23]d servers offer POP->IMAP proxy access,
# which allow a POP client to access mail on an IMAP server by using the
# POP server as a go-between. Setting this option disables this
# facility.
#
# -DOLDFILESUFFIX=\"xxx\"
# Change the default suffix appended to the backup .newsrc file from
# "old".
#
# -DSTRICT_RFC822_TIMEZONES
# Disable recognition of the non-standard UTC (0000), MET (+0100),
# EET (+0200), JST (+0900), ADT (-0300), AST (-0400), YDT (-0800),
# YST (-0900), and HST (-1000) symbolic timezones.
#
# -DBRITISH_SUMMER_TIME
# Enables recognition of non-standard symbolic timezone BST as +0100.
#
# -DBERING_STANDARD_TIME
# Enables recognition of non-standard symbolic timezone BST as -1100.
#
# -DNEWFOUNDLAND_STANDARD_TIME
# Enables recognition of non-standard symbolic timezone NST as -0330.
#
# -DNOME_STANDARD_TIME
# Enables recognition of non-standard symbolic timezone NST as -1100.
#
# -DSAMOA_STANDARD_TIME
# Enables recognition of non-standard symbolic timezone SST as -1100.
#
# -DY4KBUGFIX
# Turn on the Y4K bugfix (yes, that's year 4000). It isn't well-known,
# but century years evenly divisible by 4000 are *not* leap years in the
# Gregorian calendar. A lot of "Y2K compilant" software does not know
# about this rule. Remember to turn this on sometime in the next 2000
# years.
#
# -DUSEORTHODOXCALENDAR
# Use the more accurate Eastern Orthodox calendar instead of the
# Gregorian calendar. The century years which are leap years happen
# at alternating 400 and 500 year intervals without shifts every 4000
# years. The Orthodox and Gregorian calendars diverge by 1 day for
# gradually-increasing intervals, starting at 2800-2900, and becoming
# permanent at 48,300.
#
# -DUSEJULIANCALENDAR
# Use the less accurate Julian calendar instead of the Gregorian
# calendar. Leap years are every 4 years, including century years.
# My apologies to those in the English-speaking world who object to
# the reform of September 2, 1752 -> September 14, 1752, since this
# code still uses January 1 (which Julius Ceasar decreed as the start
# of the year, which since 153 BCE was the day that Roman consuls
# took office), rather than the traditional March 25 used by the
# British. As of 2005, the Julian calendar and the Gregorian calendar
# diverge by 15 days.
EXTRACFLAGS=
# Extra linker flags (additional/alternative libraries, etc.)
EXTRALDFLAGS=
# Special make flags (e.g. to override make environment variables)
EXTRASPECIALS=
SPECIALS=
! imap-uwの導入後の画面
The ipop2d, ipop3d, and imapd daemons should be invoked by your
/etc/inetd.conf file with lines such as:
pop2 stream tcp nowait root /usr/local/libexec/ipop2d ipop2d
pop3 stream tcp nowait root /usr/local/libexec/ipop3d ipop3d
imap4 stream tcp nowait root /usr/local/libexec/imapd imapd
If PAM authentication support has been compiled in you will need to add
something like the following lines to /etc/pam.conf (PAM authentication is
default):
imap auth required pam_unix.so
imap account required pam_unix.so
imap session required pam_unix.so
pop3 auth required pam_unix.so
pop3 account required pam_unix.so
pop3 session required pam_unix.so
The pam_unix module does not have session support, so we do not use it for
session management. Be sure to read up on pam.conf(5).
===> NB: IMAP-UW now rejects non-encrypted logins by default. To change this
===> behaviour, recompile and reinstall cclient and imap-uw ports with one of
===> the following make variables defined:
WITHOUT_SSL - build without SSL/encryption support.
WITH_SSL_AND_PLAINTEXT - build with SSL/encryption support, but allow
non-encrypted logins.
To create and install a new SSL certificate for imapd and ipop3d, type "make
cert". Or install manually in /usr/local/certs.
Example inetd config for SSL only services:
pop3s stream tcp nowait root /usr/local/libexec/ipop3d ipop3d
imaps stream tcp nowait root /usr/local/libexec/imapd imapd
================================================================================
/bin/mkdir -p -m 0755 -p /usr/local/share/doc/imap-uw
===> Compressing manual pages for imap-uw-2004g_1,1
===> Registering installation for imap-uw-2004g_1,1
===> SECURITY REPORT:
This port has installed the following binaries which execute with
increased privileges.
/usr/local/libexec/mlock
If there are vulnerabilities in these programs there may be a security
risk to the system. FreeBSD makes no guarantee about the security of
ports included in the Ports Collection. Please type 'make deinstall'
to deinstall the port if this is a concern.
For more information, and contact details about the security
status of this software, see the following webpage:
http://www.washington.edu/imap/
! Maia Mailguardへの初ログイン時に表示される文書
あなたはこれがはじめてのログインですね。スパムとウィルスを遮断するために、このメッセージをよく読んでください。
まず最初に、保護レベルを設定してください。高レベルがお勧めです。保護レベルを選んだら「レベルを変更する」をクリックして、Maia Mailguardによるフィルタリングをスタートしましょう
スパムのチェックは非常に複雑で、Maia Mailguardが間違った判定を行うことがあります。しかし心配はいりません。Maia Mailguardはスパムと判断したメールを隔離エリアに保存します。この画面から隔離エリアのメールにアクセスできます。間違ってスパムと判定されてしまったメールは隔離エリアから救出できます。また、スパムなのに誤って配送されてしまうこともありえます。このような場合には、[すり抜けたスパムを報告]をクリックして、誤配送されたスパムをMaia Mailguardに学習させることができます。
Maia Mailguardを上手に活用して、スパムとウィルスを排除しましょう。
「隔離エリアと履歴」の各カテゴリをチェックしてください。時間が取れるなら、隔離エリアのメールを個々にチェックして、スパムかどうかの最終判断を行ってください。Maia Mailguardはあなたの判断結果にもとづいて学習を積み重ねます。詳細にチェックする余裕がないときは、誤判定されたメールの救出などの必要な作業だけを行い、残りのメールは全部破棄してください。
システム設定によっては、あなたが判定したスパムの情報は、インターネット上の互助組織にも送られ、スパム情報の整備に使われます。この結果は次のスパム判定に生かされることになります。 |
| 文書番号 |
06980 |
| 日付 |
2006.06.17 |
| 参照数 |
2033 |
|
