doc: add instructions for SASL "ecdsa-nist256p-challenge"

1 files changed, 110 insertions, 24 deletions

diff --git a/doc/ja/weechat_user.ja.asciidoc b/doc/ja/weechat_user.ja.asciidoc
index c9045018d..0b0e23fd5 100644
--- a/doc/ja/weechat_user.ja.asciidoc
+++ b/doc/ja/weechat_user.ja.asciidoc
@@ -93,38 +93,81 @@ OS X では、http://brew.sh/[Homebrew] を使ってください:
 
 [width="100%",cols="5,^3,^3,.^13",options="header"]
 |===
-| パッケージ ^(1)^                    | バージョン  | 要件  | 機能
-| cmake                               |             | *必須* | ビルド (autotools でも可能ですが、cmake を推奨します)
-| pkg-config                          |             | *必須* | インストール済みライブラリを検出
-| libncursesw5-dev ^(2)^              |             | *必須* | ncurses インターフェイス
-| libcurl4-gnutls-dev                 |             | *必須* | URL 転送
-| zlib1g-dev                          |             | *必須* | relay プラグインでパケットを圧縮 (weechat プロトコル)、スクリプトプラグイン
-| libgcrypt20-dev                     |             | *必須* | 保護データ、IRC SASL 認証 (DH-BLOWFISH/DH-AES)、スクリプトプラグイン
+| パッケージ ^(1)^ | バージョン | 要件 | 機能
+
+| cmake | | *必須* |
+  ビルド (autotools でも可能ですが、cmake を推奨します)
+
+| pkg-config | | *必須* |
+  インストール済みライブラリを検出
+
+| libncursesw5-dev ^(2)^ | | *必須* |
+  ncurses インターフェイス
+
+| libcurl4-gnutls-dev | | *必須* |
+  URL 転送
+
+| zlib1g-dev | | *必須* |
+  relay プラグインでパケットを圧縮 (weechat プロトコル)、スクリプトプラグイン
+
+| libgcrypt20-dev | | *必須* |
+  保護データ、IRC SASL 認証 (DH-BLOWFISH/DH-AES)、スクリプトプラグイン
+
 // TRANSLATION MISSING
-| libgnutls28-dev                     | ≥ 2.2.0     |       | IRC サーバへの SSL 接続, IRC SASL authentication (ECDSA-NIST256P-CHALLENGE)
-| gettext                             |             |       | 国際化 (メッセージの翻訳; ベース言語は英語です)
-| ca-certificates                     |             |       | SSL 接続に必要な証明書、relay プラグインで SSL サポート
-| libaspell-dev または libenchant-dev |             |       | aspell プラグイン
-| python-dev                          | ≥ 2.5 ^(3)^ |       | python プラグイン
-| libperl-dev                         |             |       | perl プラグイン
-| ruby2.1-dev                         | ≥ 1.8       |       | ruby プラグイン
-| liblua5.2-dev                       |             |       | lua プラグイン
-| tcl-dev                             | ≥ 8.5       |       | tcl プラグイン
-| guile-2.0-dev                       | ≥ 2.0       |       | guile (scheme) プラグイン
-| asciidoc                            | ≥ 8.5.0     |       | man ページと文書のビルド
-| source-highlight                    |             |       | 文書中のソースに対するシンタックスハイライト
-| xsltproc,
-  docbook-xml, docbook-xsl            |             |       | man ページのビルド
-| libcpputest-dev                     | ≥ 3.4       |    .2+| テストの実行
-| C++ コンパイラ                      |             |
+| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | |
+  IRC サーバへの SSL 接続, IRC SASL authentication (ECDSA-NIST256P-CHALLENGE)
+
+| gettext | | |
+  国際化 (メッセージの翻訳; ベース言語は英語です)
+
+| ca-certificates | | |
+  SSL 接続に必要な証明書、relay プラグインで SSL サポート
+
+| libaspell-dev または libenchant-dev | | |
+  aspell プラグイン
+
+| python-dev | ≥ 2.5 ^(4)^ | |
+  python プラグイン
+
+| libperl-dev | | |
+  perl プラグイン
+
+| ruby2.1-dev | ≥ 1.8 | |
+  ruby プラグイン
+
+| liblua5.2-dev | | |
+  lua プラグイン
+
+| tcl-dev | ≥ 8.5 | |
+  tcl プラグイン
+
+| guile-2.0-dev | ≥ 2.0 | |
+  guile (scheme) プラグイン
+
+| asciidoc | ≥ 8.5.0 | |
+  man ページと文書のビルド
+
+| source-highlight | | |
+  文書中のソースに対するシンタックスハイライト
+
+| xsltproc, docbook-xml, docbook-xsl | | |
+  man ページのビルド
+
+| libcpputest-dev | ≥ 3.4 | .2+|
+  テストの実行
+
+| C++ コンパイラ | |
 |===
 
+// TRANSLATION MISSING (note 3)
 [NOTE]
 ^(1)^ Debian GNU/Linux ディストリビューションにおけるパッケージ名です。
 他のディストリビューションではバージョンとパッケージ名が異なるかもしれません。 +
 ^(2)^ WeeChat は libncurses5-dev でもコンパイル可能ですが、これは推奨*されません*
 (ワイドキャラクタの表示にバグを生じるでしょう)。 +
-^(3)^ Python はバージョン 2.7 をお勧めします (全てのスクリプトはバージョン 2.7
+^(3)^ Gnutls ≥ 3.0.21 is required for IRC SASL authentication with mechanism
+ECDSA-NIST256P-CHALLENGE. +
+^(4)^ Python はバージョン 2.7 をお勧めします (全てのスクリプトはバージョン 2.7
 で正しく動きますが、バージョン 2.6 以下または 3.0 以上では正しく動きません)。
 
 [[compile_with_cmake]]
@@ -2194,6 +2237,49 @@ WeeChat のコンパイル時に必要です (<<dependencies,依存関係>>を�
 // TRANSLATION MISSING
 * 'sasl_key': path to private key (for mechanism 'ecdsa-nist256p-challenge')
 
+// TRANSLATION MISSING
+[[irc_sasl_ecdsa_nist256p_challenge]]
+===== SASL ECDSA-NIST256P-CHALLENGE
+
+You must generate a private key in order to authentify with the
+ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection).
+
+You can generate the key with this command:
+
+----
+$ openssl ecparam -genkey -name prime256v1 >~/.weechat/ecdsa.pem
+----
+
+Get the public key (encoded as base64) with this command:
+
+----
+$ openssl ec -noout -text -conv_form compressed -in ~/.weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
+----
+
+Connect to the server, identify (for example with "nickserv identify") and set
+your public key in your account, using nickserv (replace the base64 value with
+your public key):
+
+----
+/connect freenode
+/msg nickserv identify your_password
+/msg nickserv set pubkey Av8k1FOGetUDq7sPMBfufSIZ5c2I/QYWgiwHtNXkVe/q
+----
+
+Configure the SASL options in the server:
+
+----
+/set irc.server.freenode.sasl_mechanism ecdsa-nist256p-challenge
+/set irc.server.freenode.sasl_username "your_nickname"
+/set irc.server.freenode.sasl_key "%h/ecdsa.pem"
+----
+
+Reconnect to the server:
+
+----
+/reconnect freenode
+----
+
 [[irc_tor_freenode]]
 ==== TOR/SASL を使って Freenode に接続する場合