Commit: c724044c023d359f3d5df84d7f38281295d30b36 - msmtp_doc_ja (git)

Commit MetaInfo

• Revision: c724044c023d359f3d5df84d7f38281295d30b36 (tree)
• Time: 2010-08-12 15:55:55
• Author: nobody <nobody@exam...>
• Commiter: nobody

Log Message

msmtp 1.4.21

Change Summary

• modified: msmtp.texi

Incremental Difference

--- a/msmtp.texi
+++ b/msmtp.texi
@@ -1,8 +1,8 @@
 \input texinfo   @c -*-texinfo-*-
 @setfilename msmtp.info
 @documentencoding utf-8
-@set UPDATED October 3, 2009
-@set VERSION 1.4.19
+@set UPDATED July 3, 2010
+@set VERSION 1.4.21
 @settitle msmtp @value{VERSION} 日本語訳
 
 @c Define new indices: for options (op) and commands (cm)
@@ -14,11 +14,11 @@
 このマニュアルは msmtp バージョン @value{VERSION} 用に、
 @value{UPDATED} に更新されました。
 
-日本語訳は、2010年2月22日に更新しました。
+日本語訳は、2010年8月12日に更新しました。
 
 @itemize @bullet
 @item
-Copyright (C) 2005, 2006, 2007, 2008, 2009 Martin Lambers
+Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010 Martin Lambers
 @item
 Copyright (C) 2008, 2010 KINUGAWA Akihito (Japanese Translation)
 @end itemize
@@ -81,7 +81,7 @@ msmtp のデフォルトモードの動作では、標準入力からメール
 
 サポートする SMTP の機能は次のようなものです:
 @itemize
-@item PLAIN、LOGIN、CRAM-MD5、EXTERNALの各認証方法 (GNU SASL サポートを付けてコンパイルすると GSSAPI、DIGEST-MD5、NTLMも使えます)
+@item PLAIN、LOGIN、CRAM-MD5、EXTERNALの各認証方法 (GNU SASL サポートを付けてコンパイルすると GSSAPI、SCRAM-SHA-1、DIGEST-MD5、NTLMも使えます)
 @item OpenSSL あるいは GnuTLS ライブラリでの TLS 暗号化接続 (サーバ証明書の検証とクライアント証明書の送信機能も含みます)
 @item 国際化ドメイン名 (IDN: Internationalized Domain Names) のサポート
 @item 配送状況の通知 (DSN: Delivery Status Notification) のサポート
@@ -201,7 +201,7 @@ SMTP がデフォルト値です。
 また、使用する認証方法を選択することもできます。
 認証方法の選択は必須なわけではありません。
 引数 @samp{on} が指定されると、msmtp は利用可能な中からベストな一つを選択します。
-受け付ける認証方法は、@samp{plain}、@samp{cram-md5}、@samp{digest-md5}、@samp{gssapi}、@samp{external}、@samp{login}、@samp{ntlm} です。
+受け付ける認証方法は、@samp{plain}、@samp{cram-md5}、@samp{digest-md5}、@samp{scram-sha-1}、@samp{gssapi}、@samp{external}、@samp{login}、@samp{ntlm} です。
 @xref{認証}.@*
 @anchor{user}
 @item user [@var{username}]
@@ -217,7 +217,7 @@ SMTP 認証に使うあなたのパスワードを設定します。
 認証は、@samp{auth} コマンドで有効にしなければなりません。
 パスワードが設定されていなくて認証中にパスワードが必要になった場合は、msmtp は @code{~/.netrc} の中からパスワードを探します。
 それに失敗すると、@code{SYSCONFDIR/netrc}の中から探します（あなたのプラットフォームにおいて @code{SYSCONFDIR} が何であるかを知るには、@code{--version} を使ってください）。
-それに失敗すると、(利用できるのであれば) システム固有のキーチェインからパスワード取得を試みます。
+それに失敗すると、(利用できるのであれば) システム固有のキーリングからパスワード取得を試みます。
 それに失敗すると、制御中のターミナルがあれば、あなたがパスワードを入力するようにプロンプトを表示します。
 @xref{認証}.
 @anchor{ntlmdomain}
@@ -254,6 +254,15 @@ Debian ベースのシステムでは、@samp{ca-certificates} パッケージ
 このファイルは、@ref{tls_trust_file} コマンドで厳密なサーバ証明書の検証を有効にしたりしたような場合に、その検証の間に使われます。
 このコマンドにより、失効した証明書を検出する検証手続きが可能になります。
 @xref{トランスポートレイヤセキュリティ}.
+@anchor{tls_fingerprint}
+@item tls_fingerprint [@var{fingerprint}]
+@cmindex tls_fingerprint
+このコマンドは、特定の TLS 証明書のフィンガープリントを設定したり設定しないようにしたりします。
+この証明書は、その後、その内容に関わらず信頼されます。
+これは、 (たとえば、ホスト名がマッチしないなど) 壊れている証明書を信頼したり、何らかの理由で@samp{tls_trust_file}を使用することができない状況で利用することができます。
+SHA1 (推奨) のフィンガープリントあるいは MD5 のフィンガープリントのどちらかを @code{01:23:45:67:@dots{}} という形式で指定することができます。
+@samp{--serverinfo --tls --tls-certcheck=off}を使えば、ピア証明書のフィンガープリントを取得することができます。
+@xref{トランスポートレイヤセキュリティ}.
 @anchor{tls_key_file}
 @item tls_key_file [@var{file}]
 @cmindex tls_key_file
@@ -507,6 +516,13 @@ TLS の暗号化に際し、トラストファイルを設定したり未設定
 @opindex --tls-crl-file
 TLS に際し、失効証明書リスト (CRL) ファイルを設定したり未設定にしたりします。
 @xref{tls_crl_file}.
+
+@anchor{--tls-fingerprint}
+@itemx --tls-fingerprint=[@var{fingerprint}]
+@opindex --tls-fingerprint
+信頼する TLS 証明書のフィンガープリントを設定したり未設定にしたりします。
+@xref{tls_fingerprint}.
+
 @anchor{--tls-key-file}
 @itemx --tls-key-file=[@var{file}]
 @opindex --tls-key-file
@@ -690,7 +706,7 @@ TLS が開始すると、サーバは、サーバ自体を識別するための
 この情報はサーバ情報モードで表示することができます。
 @xref{サーバ情報モード}.
 
-TLS を使うには、@samp{tls_trust_file} コマンドか @samp{--tls-trust-file} オプションを使って完全なサーバ証明書の検証を行うようにするか、あるいは、@samp{tls_certcheck off} か @samp{--tls-certcheck=off} を使って全ての証明書検証を無効にするかどちらかをする必要があります。
+TLS を使うには、@samp{tls_trust_file} コマンドか @samp{--tls-trust-file} オプションを使って完全なサーバ証明書の検証を行うようにするか、あるいは、ある特定のピア証明書を @samp{tls_fingerprint} コマンドか @samp{--tls-fingerprint} オプションを用いて信頼するか、またあるいは、@samp{tls_certcheck off} か @samp{--tls-certcheck=off} を使って全ての証明書検証を無効にするかのいずれかを行なう必要があります。
 警告: 証明書の検証を無効にした場合、TLS/SSL のセッションは中間者攻撃に対して脆弱になります！
 @ref{tls_trust_file}、@ref{--tls-trust-file}、@ref{tls_certcheck}、@ref{--tls-certcheck} を参照。
 
@@ -698,26 +714,18 @@ TLS を使うには、@samp{tls_trust_file} コマンドか @samp{--tls-trust-fi
 Debian ベースのシステムの場合、例えば、@samp{tls_trust_file /etc/ssl/certs/ca-certificates.crt} というコマンドを記述すれば間に合うでしょう。
 
 また、どの認証局証明書を信頼する必要があるかを手動で調べることもできます。
-次の例は 2007 年 4 月 18 日の時点で動作します。
-
-Gmail の SMTP サーバに対して、先ず次のコマンドを実行します:
+まず次のコマンドを実行してください。
 @example
-$ msmtp --serverinfo --host=smtp.gmail.com --tls=on --port=587 \
-  --tls-certcheck=off
+$ msmtp --serverinfo --host=smtp.example.com --tls=on --tls-certcheck=off
 @end example
-@samp{--port=587} というオプションは Gmail 特有のものですので、他のサーバに対して使うものではありません。
-@samp{--tls-certcheck=off} というオプションで、msmtp にどんな証明書でも受け入れさせることができますので、その証明書の何らかの情報を表示させることができます。
-
-このコマンドの出力によれば、このサーバ証明書の発行者の共通名は「Thawte Premium Server CA」です。
-これは、TLS セキュリティを完全に利用するためには、あなたが「Thawte CA」を信頼しなければならないということを示しています。
-Thawte CA の証明書のセットは @url{http://thawte.com/roots} からダウンロードできます。
-あなたは種々の証明書が入った ZIP ファイルを入手します。
-@samp{tls_trust_file} コマンドに必要なファイルは、@file{Thawte Server Roots/ThawtePremiumServerCA_b64.txt} です。
-
-これで次のコマンドが動作するはずです:
+@samp{--tls-certcheck=off}オプションを使うと msmtp にあらゆる証明書を受け入れさせることができますので、その証明書に関する何らかの情報を表示させることができます。
+このコマンドの出力は、サーバ証明書の発行者についての一般名を教えてくれます。
+完全なTLSセキュリティを行なうにはこの発行者を信頼しなければなりません。
+通常その発行者のホームページでCA証明書を見つけられます。
+このCA証明書を用いれば以下が成功するはずです。
 @example
-$ msmtp --serverinfo --host=smtp.gmail.com --tls=on --port=587 \
-  --tls-trust-file="Thawte Server Roots/ThawtePremiumServerCA_b64.txt"
+$ msmtp --serverinfo --host=smtp.example.com --tls=on \
+  --tls-trust-file=ca_cert.txt
 @end example
 
 サーバが要求した場合は、クライアントが証明書を送ることもできます。
@@ -758,6 +766,10 @@ msmtp は以下の認証方法をサポートします:
 この認証方法はユーザ名とパスワードが必要です。
 認証に使われるデータはプレインテキストで送信されません。
 つまりこの方法は TLS 無しで安全に使うことができます。
+@item @samp{SCRAM-SHA-1}@*
+この認証方法はユーザ名とパスワードが必要です。
+認証に使われるデータはプレインテキストで送信されません。
+つまりこの方法は TLS 無しで安全に使うことができます。
 @item @samp{GSSAPI}@*
 この認証方法はユーザ名が必要です。
 Kerberos フレームワークが安全な認証を引き受けますので、この方法は TLS 無しで安全に使うことができます。
@@ -788,39 +800,24 @@ sendmail 8.12.11 は、TLS クライアント証明書が送信された後 EXTE
 @ref{user}、@ref{password}、@ref{--user} を見てください。
 もしパスワードが設定されていなくて、認証中にパスワードが必要となった場合には、msmtp は @code{~/.netrc} の中からパスワード取得を試みます。
 それに失敗すると、@code{SYSCONFDIR/netrc}の中からパスワードを探します（あなたのプラットフォームにおいて @code{SYSCONFDIR} が何であるかを知るには、@code{--version} を使ってください）。
-それに失敗すると、(利用できれば) システム固有のキーチェインからパスワード取得を試みます。
+それに失敗すると、(利用できれば) システム固有のキーリングからパスワード取得を試みます。
 それにも失敗して、しかも制御ターミナルが利用できるのであれば、パスワードを入力するようにユーザに要求します。
 
-現在のところサポートしているキーチェインは GNOME keychain と Mac OS X Keychain です。
-@xref{Mac OS X Keychain の利用}.
+現在のところサポートしているキーチェインは Gnome キーリングと Mac OS X キーチェインです。
+@code{msmtp-gnome-tool.py} スクリプトは、msmtpに対する Gnome キーリングのパスワードを管理するのに利用することができます。
+Mac OS X キーチェインのパスワードを管理するには、Keychain Access GUIアプリケーションを使用してください。
+@samp{account name}は msmtp の @samp{user} 引数と同じです。
+@samp{keychain item name} は @code{smtp://<hostname>} で、ここで、@code{<hostname>} は msmtp の @samp{host} 引数と対応します。
 
 認証方法は @samp{auth} コマンドか @samp{--auth} オプションで選択できますが、@samp{on} 引数を使って msmtp に認証方法を選択させるだけで通常は十分です。@ref{auth}、@ref{--auth} を見てください。
 
 msmtp が認証方法を選択する場合、決して安全でない方法は選択しません。
 TLS が有効な場合 サーバへの接続は TLS によって保護されているので、このコンテキストでの認証方法は全て安全だとみなされます。
-もし TLS が機能していない場合、CRAM-MD5、DIGEST-MD5、GSSAPI という認証方法だけがこのコンテキストで安全であるとみなされます。
+もし TLS が機能していない場合、CRAM-MD5、DIGEST-MD5、SCRAM-SHA-1、GSSAPI という認証方法だけがこのコンテキストで安全であるとみなされます。
 それ以外の認証方法は全て認証に使うデータを危険な状態にするからです。
 
 認証に使うデータを危ない状態にしておいてもよいと本当に考えるなら、TLS を off にして認証方法を手動で設定することで、msmtp がそのように実行されるようにしなければなりません。
 
-@section Mac OS X Keychain の利用
-@anchor{Mac OS X Keychain の利用}
-
-@footnote{訳注: 訳者は Mac OS X のことを知りませんのでグダグダな翻訳になっています}
-
-Mac OS X のユーザは、Keychain Access GUI Application を使って、パスワードをキーチェインアイテムの中に入れることができます。
-@samp{account name} はそのまま @samp{user} 引数の値になります。
-しかし、その @samp{keychain item name} は @code{smtp://<hostname>} where となり、その @code{<hostname>} は @samp{host} の引数に一致します。
-アイテムが @samp{internet password} kind として作成されるので、@code{smtp://} は必要です。
-例えば、@samp{host smtp.freemail.example} と @samp{user joe.smith} とに該当するキーチェインアイテム上で @samp{File->Get Info} を選択すると、次のようになります:
-
-@example
-   Name: smtp.freemail.example
-   Kind: Internet password
-Account: joe.smith
-  Where: smtp://smtp.freemail.example
-@end example
-
 
 @node 配送状況の通知
 @chapter 配送状況の通知