linux/tips/dovecot

${smdncms:tags,Dovecot}
*Dovecot
IMAP/POPサーバ[[Dovecot:http://www.dovecot.org/]]に関するTips。

-参考
--[[FrontPage - Dovecot Wiki:http://wiki.dovecot.org/]]
--[[メールサーバー構築(Postfix+Dovecot) - Fedoraで自宅サーバー構築:http://fedorasrv.com/postfix.shtml]]

**設定ファイル
***使用するプロトコルを設定する
protocolsで設定する。　設定出来るのはimap(IMAP), imaps(IMAP+SSL) pop3(POP), pop3s(POP+SSL)。　SSLを使用する場合は、ssl_disableをnoにする。
protocols = imap imaps
ssl_disable = no

また必要に応じてssl_cert_fileとssl_key_fileも設定する
ssl_cert_file = /usr/share/ssl/certs/dovecot.pem
ssl_key_file = /usr/share/ssl/certs/dovecot.pem

***メールボックスの形式・パスを設定する
mail_locationで設定する。　Maildir形式を使用する場合はmaildir、:に続けてパスを指定する。　%hはユーザ名に展開される。
mail_location = maildir:%h/Maildir

***CRAM-MD5, APOP等の認証方法を有効にする
まずmechanismsで使用したい認証方法、passdb passwd-fileセクションで認証に使用するパスワードファイルをを設定する。
auth default {
mechanisms = login plain cram-md5 apop anonymous
passdb passwd-file {
args = /etc/dovecot/passwd
}
}
次に、dovecotpwコマンドでパスワードファイルに記入するパスワードを作成する。
$ dovecotpw -s CRAM-MD5
Enter new password: # ここでパスワードを入力
Retype new password: # 確認のためもう一度入力
{CRAM-MD5}a9f061d1dbbda6f500f99b019d8c3ba7236507d4bcaecf6cfc9e21c36d5402e3

作成するパスワードに使用できるスキームは-lオプションで一覧できる。
$ dovecotpw -l
CRYPT MD5 MD5-CRYPT SHA SHA1 SMD5 SSHA PLAIN CLEARTEXT CRAM-MD5 HMAC-MD5 DIGEST-MD5 PLAIN-MD4 PLAIN-MD5 LDAP-MD5 LANMAN NTLM RPA

作成したパスワードを先ほど設定したパスワードファイルに書き込む。　書式は「ユーザ名:パスワード」
dovecotuser:{CRAM-MD5}a9f061d1dbbda6f500f99b019d8c3ba7236507d4bcaecf6cfc9e21c36d5402e3
dovecotuser:{PLAIN}password

書き込み終わったらパーミッションを読み取り専用に変えておく。
$ sudo chmod 400 /etc/dovecot/passwd

***PAMによる認証を無効にする
passdb pamのセクションをコメントアウトする。
# passdb pam {
:
:
# }

***SSL/TLSを使用しない接続での平文によるログインを拒否する
disable_plaintext_authをyes, ssl_disableをnoにする。
disable_plaintext_auth = yes
ssl_disable = no
このように設定すると、IMAP LOGINDISABLED, IMAP STARTTLS, POP STLSの各capabilityを返すようになる。

***greeting messageでcapabilityを返すようにする
login_greeting_capabilityをyesにする。
protocol imap {
login_greeting_capability = yes

このように設定すると、クライアントが接続した時(CAPABILITYコマンドを発行する前)にcapabilityを返すようになる。　接続時にDovecotが返すレスポンスは次のようになる。
* OK [CAPABILITY IMAP4rev1 SASL-IR SORT THREAD=REFERENCES MULTIAPPEND UNSELECT LITERAL+ IDLE CHILDREN NAMESPACE LOGIN-REFERRALS STARTTLS AUTH=LOGIN AUTH=PLAIN AUTH=CRAM-MD5] Dovecot ready.
noの場合(デフォルト)は次のようになる。
* OK Dovecot ready.

ただしyesに設定してもクライアントがこの機能をサポートしていない場合capabilityは無視され、noに設定した場合と同様に通常どおりCAPABILITYコマンドが発行される。

***anonymousでのログインを許可する
auth_anonymous_usernameにanonymousでログインした場合に参照するメールボックスのユーザを指定し、mechanismsにanonymousを追加する。
auth_anonymous_username = dovecotuser
auth default {
mechanisms = login plain cram-md5 apop anonymous

この設定例だと、anonymousでログインした場合はユーザdovecotuserのメールボックスが参照される。　anonymousでログインしたときに使用されるトークンは/var/log/mail.log(anonymousの後ろの括弧内)に記録される。
Apr 25 19:58:39 hayami dovecot: auth(default): anonymous(test,127.0.0.1): login
Apr 25 19:58:39 hayami dovecot: imap-login: Login: user=<dovecotuser>, method=ANONYMOUS, rip=127.0.0.1, lip=127.0.0.1, secured
Apr 25 20:04:22 hayami dovecot: auth(default): anonymous(idolm@ster.example.com,127.0.0.1): login
Apr 25 20:04:22 hayami dovecot: imap-login: Login: user=<dovecotuser>, method=ANONYMOUS, rip=127.0.0.1, lip=127.0.0.1, secured



linux/tips/wine

${smdncms:tags,Wine}
*Wine
[[Wine:http://www.winehq.org/]]に関するTips

**論理ドライブ
~~/.wine/dosdevices配下にシンボリックリンクを作成することでファイルシステム上の任意のパスを論理ドライブとして参照させることが出来る。　Wineのインストール後はこのようになっていた。
$ ls -l ~/.wine/dosdevices/
合計 0
lrwxrwxrwx 1 santamarta santamarta 10 2008-04-06 12:20 c: -> ../drive_c
lrwxrwxrwx 1 santamarta santamarta 13 2008-04-09 19:52 d: -> /media/cdrom0
lrwxrwxrwx 1 santamarta santamarta 8 2008-04-09 19:52 d:: -> /dev/hdc
lrwxrwxrwx 1 santamarta santamarta 1 2008-04-06 12:20 z: -> /

ディレクトリ/srv/smb/をドライブレターe:の論理ドライブとして参照させるには、次のようにする。
ln -s /srv/smb/ e:

**WMAへのエンコード
Linuxで使えるWindows Media Audioエンコーダはおそらく存在しないので、Linux上でWMAへエンコードするにはWineを使ってWindows用のWMAエンコーダを使う。　まず[[Windows Media 9 シリーズ - Windows Media Encoding Utility:http://www.microsoft.com/japan/windows/windowsmedia/WM8/encoding.aspx]]からwm8eutil_setup.exeをダウンロードし、インストールする。
wine wm8eutil_setup.exe
インストールウィザードが表示されるが、Windowsと同様ウィザードに従って適当に設定して[次へ]で進む。　エンコーダは~/.wine/drive_c/Program Files/Windows Media Components/Tools下にインストールされる。　エンコード例は以下のとおり。
wine WM8EUTIL.exe -input ~/music.wav -output ~/music.wma -a_setting 96_44_2
コマンドラインオプションはwine WM8EUTIL.exe /?で確認できる。
$ wine WM8EUTIL.exe /?

HELP usage for wm8eutil. Use one of the following for how to use wm8eutil.exe.

[-help?] Display the user help doc for wm8eutil.
[-all?] Usage for all settings.
[-io?] Usage for Input/Output and config file.
[-profile?] Profile numbers and basic descriptions.
[-profileall?] Details for all profiles.
[-profile_aN?] Details for audio-only profile N.
[-profile_vN?] Details for video-only profile N.
[-profile_avN?] Details for audio/video profile N.
NOTE: It uses the actual bitrate for N.
Example: -profile_a32?.
[-audio?] Usage for Audio Codec settings.
[-video?] Usage for Video Codec settings.
[-default?] All default values for custom settings.
[-a_default?] Audio default values for custom settings.
[-v_default?] Video default values for custom settings.
[-cont_desc?] Usage for how to put content descriptions in the WMV/WMA files.
[-example?] Examples for how to use wm8eutil.
[-a_example?] Examples for how to use wm8eutil for audio-only encoding.
[-v_example?] Examples for how to use wm8eutil for video-only encoding.
[-av_example?] Examples for how to use wm8eutil for audio/video encoding.
[-d_example?] Examples for how to use wm8eutil for directory mode encoding.



programming/tips/modified_utf7

${smdncms:tags,C#,Modified,修正,UTF-7,UTF7,IMAP-UTF7}
*Modified UTF-7のエンコード・デコード
Modified UTF-7は修正 UTF-7, IMAP-UTF7とも呼ばれるもので、IMAPで非ASCII文字を含むメールボックス名をASCII文字のみで表記するためのエンコード方式。　UTF-7へのエンコードはUTF-16文字列中の非ASCII文字のみBase64に変換することで得られるが、Modified UTF-7へのエンコードはUTF-16文字列(ビッグエンディアン)に対して次の変換ルールを適用することで得ることが出来る。
+'&'は'&-'に変換する
+'&'を除く印字可能な文字(0x20〜0x25と0x27〜0x7e)はそのまま
+上記以外の印字不可能な文字は後述するModified Base64に変換し、'&'(shift)と'-'(shift back)で括る
例えば文字列「INBOX.日本語」を変換するときは、「INBOX.&日本語-」とシフトしたあと「日本語」のところだけModified Base64を適用する。　Modified Base64の変換ルールは次のとおり。
+基本の変換ルールは通常のBase64と同じ
+ただし変換テーブルは'/'の代わりに','を使う
+上記ルールで変換した後の文字数が4の倍数にならなくてもパディング('=')は入れない
+印字可能な文字(0x20〜0x25と0x27〜0x7e)にModified Base64を適用してはいけない
このルールに則り文字列「日本語」を変換すると「ZeVnLIqe」となるので、「INBOX.日本語」をModified UTF-7へエンコードした結果は「INBOX.&ZeVnLIqe-」となる。

**C#での実装
Modified UTF-7へのエンコード(コメントはRFC 3501のsection 5.1.3より抜粋)
public static string ToModifiedUTF7String(string str)
{
var encoded = new StringBuilder();
var shiftFrom = -1;

for {
var c = str[index];

if {
if {
// string -> modified UTF7
encoded.Append('&');
encoded.Append(ToModifiedUTF7(str.Substring(shiftFrom, index - shiftFrom)));
encoded.Append('-');

shiftFrom = -1;
}

// printable US-ASCII characters
if
// except for "&"
encoded.Append("&-");
else
encoded.Append(c);
}
else {
if
shiftFrom = index;
}
}

if {
// string -> modified UTF7
encoded.Append('&');
encoded.Append(ToModifiedUTF7(str.Substring(shiftFrom)));
encoded.Append('-');
}

return encoded.ToString();
}

private static string ToModifiedUTF7(string str)
{
return ToModifiedBase64(Encoding.BigEndianUnicode.GetBytes(str));
}

private static string ToModifiedBase64(byte[] bytes)
{
var base64 = Convert.ToBase64String(bytes).Replace('/', ',');
var padding = base64.IndexOf('=');

if
return base64.Substring(0, padding);
else
return base64;
}

Modified UTF-7からのデコード
public static string FromModifiedUTF7String(string str)
{
if
return str;

var bytes = Encoding.ASCII.GetBytes(str);
var decoded = new StringBuilder();

for {
// In modified UTF-7, printable US-ASCII characters, except for "&",
// represent themselves
// "&" is used to shift to modified BASE64
if { // '&'
decoded.Append((char)bytes[index]);
continue;
}

if
// incorrect form
throw new FormatException("incorrect form");

if { // '-'
// The character "&" is represented by the two-octet sequence "&-".
decoded.Append('&');
continue;
}

var nonprintable = new StringBuilder();

for {
if // '-'
// "-" is used to shift back to US-ASCII
break;

nonprintable.Append((char)bytes[index]);
}

// modified UTF7 -> string
decoded.Append(FromModifiedUTF7(nonprintable.ToString()));
}

return decoded.ToString();
}

private static string FromModifiedUTF7(string str)
{
return Encoding.BigEndianUnicode.GetString(FromModifiedBase64(str));
}

private static byte[] FromModifiedBase64(string str)
{
// "," is used instead of "/"
str = str.Replace(',', '/');

var padding = 4 - str.Length & 3;

if
return Convert.FromBase64String(str);
else if
throw new FormatException("incorrect form");
else
return Convert.FromBase64String(str +;
}

**参考資料
-[[RFC 3501 INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1 5.1.3. Mailbox International Naming Convention:http://tools.ietf.org/html/rfc3501#section-5.1.3]]
-[[Unicode - Wikipedia:http://ja.wikipedia.org/wiki/Unicode]]


programming/tips/cram_md5

${smdncms:tags,C#,CRAM-MD5}
*CRAM-MD5による認証
CRAM-MD5はPOP, IMAPで使用されるチャレンジ・レスポンス方式の認証方法で、HMAC-MD5ハッシュアルゴリズムを用いてパスワードを暗号化する。　IMAPでのAUTHENTICATE CRAM-MD5による認証のシーケンスは次の例のようになる。
C: 0001 AUTHENTICATE CRAM-MD5
S: + PDIxMDQ1OTA2MjYzMjA1MjguMTIwMzkzMDcwMkBoYXlhbWk+
C: c2FudGFtYXJ0YSAzNTY0MzhmMGU0MzhhZDdlZTdhYTZkYzJjYzE5MmIwMg==
S: 0001 OK Logged in.
上記の送受信内容をBase64デコードするとこのようになっている。
S: + <2104590626320528.1203930702@hayami>
C: santamarta 356438f0e438ad7ee7aa6dc2cc192b02

AUTHENTICATEコマンドに対して、サーバからはBase64エンコードされたタイムスタンプとホスト名を含むチャレンジコードが返され、クライアントはユーザ名と、パスワードをキーにしてHMAC-MD5ハッシュアルゴリズムを適用したチャレンジコードをBase64エンコードしてレスポンスとしてを返す。　簡略化して表記するなら
S: + Base64(チャレンジコード)
C: Base64(ユーザ名 HMAC-MD5(パスワード, チャレンジコード))

チャレンジコード = <タイムスタンプ@ホスト名>
のようになる。

**C#でのCRAM-MD5認証の実装
Mono/.NET FrameworkではHMAC-MD5ハッシュ値の計算にSystem.Security.Cryptography.HMACMD5クラスのComputeHashメソッドを用いることが出来る。　次の例は受信したチャレンジコードと、ユーザ名、パスワードを引数としてCRAM-MD5認証のレスポンスを返すメソッド。

public string AuthenticateCramMD5(string challenge, string username, string password)
{
// Base64デコードしたチャレンジコードに対してパスワードをキーとしたHMAC-MD5ハッシュ値を計算する
var keyed =;

// 計算したHMAC-MD5ハッシュ値のbyte[]を16進表記の文字列に変換する
var digest = string.Empty;

foreach {
digest += octet.ToString("x02");
}

// ユーザ名と計算したHMAC-MD5ハッシュ値をBase64エンコードしてレスポンスとして返す
return Convert.ToBase64String(Encoding.ASCII.GetBytes(string.Format("{0} {1}", username, digest)));
}

**C#でのHMAC-MD5の実装
次の例はRFC 2104で記述されている内容に基づいて作成したHMAC-MD5ハッシュ値の計算を行うメソッド。　System.Security.Cryptography.HMACMD5.ComputeHashメソッドに相当するものを実装したもの。　(コメントはRFCより抜粋)
public byte[] HmacMd5(byte[] key, byte[] text)
{
const int B = 64;

// 2. Definition of HMAC

// The definition of HMAC requires a cryptographic hash function,
// which we denote by H,
var H = new MD5CryptoServiceProvider();

// and a secret key K
var K = new byte[B];

// We assume H to be a cryptographic hash function where data is
// hashed by iterating a basic compression function on blocks of data.
// We denote by B the byte-length of such blocks
//

// The authentication key K can be of any length up to B, the
// block length of the hash function.
if
throw new InvalidOperationException("key length is too long");

// We define two fixed and different strings ipad and opad as follows
//:
var ipad = new byte[B]; // ipad = the byte 0x36 repeated B times <