From: yamaoka Date: Mon, 29 Aug 2005 08:46:30 +0000 (+0000) Subject: Translated. X-Git-Tag: ngnus-0_4-doc-ja~172 X-Git-Url: http://git.chise.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=347f6cfaddf605823b081baea522081864df50f9;p=elisp%2Fgnus-doc-ja.git Translated. --- diff --git a/sasl-ja.texi b/sasl-ja.texi index 15fd321..4242f94 100644 --- a/sasl-ja.texi +++ b/sasl-ja.texi @@ -12,7 +12,7 @@ @settitle Emacs SASL Library @value{VERSION} @ifinfo -This file describes the Emacs SASL library. +このファイルは Emacs SASL ライブラリーを説明します。 Copyright (C) 2000 Daiki Ueno. @@ -47,6 +47,12 @@ any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". + +この文書を、フリーソフトウェア財団発行の GNU フリー文書利用許諾契約書 +第 1.1 版またはそれ以降の版が定める条件の下で複製、配布、あるいは変更す +ることを許可します。変更不可部分、表表紙テキストおよび裏表紙テキストは指 +定しません。この利用許諾契約書の複写は「GNU フリー文書利用許諾契約書」と +いう章に含まれています。 @end titlepage @page @@ -54,203 +60,201 @@ Free Documentation License". @node Top @top Emacs SASL -This manual describes the Emacs SASL library. -A common interface to share several authentication mechanisms between -applications using different protocols. +このマニュアルは Emacs SASL ライブラリーを説明します。 + +異なるプロトコルを使うアプリケーション間で、複数の認証メカニズムを共有す +るための共通インターフェースです。 @menu -* Overview:: What Emacs SASL library is. -* How to use:: Adding authentication support to your applications. -* Data types:: -* Back end drivers:: Writing your own drivers. -* Index:: -* Function Index:: -* Variable Index:: +* Overview:: Emacs SASL ライブラリーとは +* How to use:: アプリケーションに認証サポートを追加する +* Data types:: +* Back end drivers:: 独自のドライバーを書く +* Index:: +* Function Index:: +* Variable Index:: @end menu @node Overview -@chapter Overview +@chapter 大要 -@sc{sasl} is short for @dfn{Simple Authentication and Security Layer}. -This standard is documented in RFC2222. It provides a simple method for -adding authentication support to various application protocols. +@sc{sasl} は @dfn{Simple Authentication and Security Layer} の略です。標 +準は RFC2222 に文書化されています。これは、さまざまなアプリケーション・ +プロトコルに、認証サポートを追加するための簡単な手段を提供します。 -The toplevel interface of this library is inspired by Java @sc{sasl} -Application Program Interface. It defines an abstraction over a series -of authentication mechanism drivers (@ref{Back end drivers}). +このライブラリーの最上位のインターフェースは、Java @sc{sasl} Application +Program Interface によって触発されました。それは、抽象化した一連の認証メ +カニズムのドライバーを定義します。 -Back end drivers are designed to be close as possible to the -authentication mechanism. You can access the additional configuration -information anywhere from the implementation. +バックエンドのドライバーは、なるべく認証メカニズムに密接していることを目 +指しています。どこにある追加の設定情報にも、この実装からアクセスすること +ができます。 @node How to use -@chapter How to use +@chapter 使い方 -(Not yet written). +(まだ書かれていません)。 -To use Emacs SASL library, please evaluate following expression at the -beginning of your application program. +Emacs SASL ライブラリーを使うには、アプリケーション・プログラムの最初で、 +以下の式を評価して下さい。 @lisp (require 'sasl) @end lisp -If you want to check existence of sasl.el at runtime, instead you -can list autoload settings for functions you want. +実行時にのみ sasl.el が存在していることを検査したいならば、代わりに必要 +な関数の autoload の設定を並べておいても構いません。 @node Data types -@chapter Data types +@chapter データの型 -There are three data types to be used for carrying a negotiated -security layer---a mechanism, a client parameter and an authentication -step. +ネゴシエートされたセキュリティー層の伝送に使われる三つのデータの型として、 +メカニズム、クライアント・パラメータ、および認証ステップがあります。 @menu -* Mechanisms:: -* Clients:: -* Steps:: +* Mechanisms:: +* Clients:: +* Steps:: @end menu @node Mechanisms -@section Mechanisms +@section メカニズム -A mechanism (@code{sasl-mechanism} object) is a schema of the @sc{sasl} -authentication mechanism driver. +メカニズム (@code{sasl-mechanism} オブジェクト) が、@sc{sasl} 認証メカニ +ズムのドライバーの schema です。 @defvar sasl-mechanisms -A list of mechanism names. +メカニズム名のリスト。 @end defvar @defun sasl-find-mechanism mechanisms +適切なメカニズムを取得します。@* +この関数は @var{mechanisms} と @code{sasl-mechanisms} を比較して、適切 +な @code{sasl-mechanism} オブジェクトを返します。 -Retrieve an apropriate mechanism. -This function compares @var{mechanisms} and @code{sasl-mechanisms} then -returns apropriate @code{sasl-mechanism} object. - -@example +@lisp (let ((sasl-mechanisms '("CRAM-MD5" "DIGEST-MD5"))) (setq mechanism (sasl-find-mechanism server-supported-mechanisms))) -@end example - +@end lisp @end defun @defun sasl-mechanism-name mechanism -Return name of mechanism, a string. +メカニズムの名前を文字列で返します。 @end defun -If you want to write an authentication mechanism driver (@ref{Back end -drivers}), use @code{sasl-make-mechanism} and modify -@code{sasl-mechanisms} and @code{sasl-mechanism-alist} correctly. +認証メカニズムのドライバー (@ref{Back end drivers}) を書きたければ、 +@code{sasl-make-mechanism} を使い、@code{sasl-mechanisms} およ +び @code{sasl-mechanism-alist} を正しく変更して下さい。 @defun sasl-make-mechanism name steps -Allocate a @code{sasl-mechanism} object. -This function takes two parameters---name of the mechanism, and a list -of authentication functions. +@code{sasl-mechanism} オブジェクトを割り当てます。@* +この関数は二つのパラメータ、すなわちメカニズムの名前、および認証するため +の関数のリストを受け取ります。 -@example +@lisp (defconst sasl-anonymous-steps - '(identity ;no initial response + '(identity ; 最初は応答無し sasl-anonymous-response)) (put 'sasl-anonymous 'sasl-mechanism (sasl-make-mechanism "ANONYMOUS" sasl-anonymous-steps)) -@end example - +@end lisp @end defun @node Clients -@section Clients +@section クライアント -A client (@code{sasl-client} object) initialized with four -parameters---a mechanism, a user name, name of the service and name of -the server. +クライアント (@code{sasl-client} オブジェクト) は四つのパラメータ、すな +わちメカニズム、ユーザー名、サービス名、およびサーバー名によって初期化さ +れます。 @defun sasl-make-client mechanism name service server -Prepare a @code{sasl-client} object. +@code{sasl-client} オブジェクトを用意します。 @end defun @defun sasl-client-mechanism client -Return the mechanism (@code{sasl-mechanism} object) of client. +クライアントのメカニズム (@code{sasl-mechanism} オブジェクト) を返します。 @end defun @defun sasl-client-name client -Return the authorization name of client, a string. +クライアントの認証名を文字列で返します。 @end defun @defun sasl-client-service client -Return the service name of client, a string. +クライアントのサービス名を文字列で返します。 @end defun @defun sasl-client-server client -Return the server name of client, a string. +クライアントのサーバー名を文字列で返します。 @end defun -If you want to specify additional configuration properties, please use -@code{sasl-client-set-property}. +属性の設定を追加したい場合は、@code{sasl-client-set-property} を使って下 +さい。 @defun sasl-client-set-property client property value -Add the given property/value to client. +与えられた属性およびその値をクライアントに追加します。 @end defun @defun sasl-client-property client property -Return the value of the property of client. +クライントの属性の値を返します。 @end defun @defun sasl-client-set-properties client plist -Destructively set the properties of client. -The second argument is the new property list. +クライアントの属性を破壊的に設定します。@* +第二引数は新しいプロパティー・リスト (plist) です。 @end defun @defun sasl-client-properties client -Return the whole property list of client configuration. +クライアントの設定のプロパティー・リストを、まるごと返します。 @end defun @node Steps -@section Steps +@section ステップ -A step (@code{sasl-step} object) is an abstraction of authentication -``step'' which holds the response value and the next entry point for the -authentication process (the latter is not accessible). +ステップ (@code{sasl-step} オブジェクト) は認証ステップの抽象化です。そ +れは、応答の値と次回の認証処理の入り口を保持します (後者はアクセスできま +せん)。 @defun sasl-step-data step -Return the data which @var{step} holds, a string. +@var{step} が保持するデータを文字列で返します。 @end defun @defun sasl-step-set-data step data -Store @var{data} string to @var{step}. +@var{step} に @var{data} の文字列を格納します。 @end defun -To get the initial response, you should call the function -@code{sasl-next-step} with the second argument @code{nil}. +最初の応答を得るには、第二引数を @code{nil} にして関 +数 @code{sasl-next-step} を呼ばなければなりません。 -@example +@lisp (setq name (sasl-mechanism-name mechanism)) -@end example +@end lisp -At this point we could send the command which starts a SASL -authentication protocol exchange. For example, +この段階で、SASL の認証プロトコルの交換を開始するコマンドを送ることがで +きます。例です。 -@example +@lisp (process-send-string process - (if (sasl-step-data step) ;initial response - (format "AUTH %s %s\r\n" name (base64-encode-string (sasl-step-data step) t)) + (if (sasl-step-data step) ; 最初の応答 + (format "AUTH %s %s\r\n" + name (base64-encode-string (sasl-step-data step) t)) (format "AUTH %s\r\n" name))) -@end example +@end lisp -To go on with the authentication process, all you have to do is call -@code{sasl-next-step} consecutively. +認証処理を続けるために行なわなければならないことは、連続し +て @code{sasl-next-step} を呼ぶことです。 @defun sasl-next-step client step -Perform the authentication step. -At the first time @var{step} should be set to @code{nil}. +認証ステップを実行します。@* +最初は @var{step} を @code{nil} に設定しなければなりません。 @end defun @node Back end drivers -@chapter Back end drivers +@chapter バックエンド・ドライバー -(Not yet written). +(まだ書かれていません)。 @node Index @chapter Index