RFC2696 日本語訳
2696 LDAP Control Extension for Simple Paged Results Manipulation. C.Weider, A. Herron, A. Anantha, T. Howes. September 1999. (Format: TXT=12809 bytes) (Status: INFORMATIONAL)
プログラムでの自動翻訳です。
英語原文
Network Working Group C. Weider Request for Comments: 2696 A. Herron Category: Informational A. Anantha Microsoft T. Howes Netscape September 1999
コメントを求めるワーキンググループC.ワイダーの要求をネットワークでつないでください: 2696年のA.ハーロンカテゴリ: 情報のA.のAnanthaマイクロソフトT.ハウズNetscape1999年9月
LDAP Control Extension for Simple Paged Results Manipulation
簡単な呼び出された結果操作のためのLDAPコントロール拡張子
Status of this Memo
このMemoの状態
This memo provides information for the Internet community. It does not specify an Internet standard of any kind. Distribution of this memo is unlimited.
このメモはインターネットコミュニティのための情報を提供します。 それはどんな種類のインターネット標準も指定しません。 このメモの分配は無制限です。
Copyright Notice
版権情報
Copyright (C) The Internet Society (1999). All Rights Reserved.
Copyright(C)インターネット協会(1999)。 All rights reserved。
1. Abstract
1. 要約
This document describes an LDAPv3 control extension for simple paging of search results. This control extension allows a client to control the rate at which an LDAP server returns the results of an LDAP search operation. This control may be useful when the LDAP client has limited resources and may not be able to process the entire result set from a given LDAP query, or when the LDAP client is connected over a low-bandwidth connection. Other operations on the result set are not defined in this extension. This extension is not designed to provide more sophisticated result set management.
このドキュメントは検索結果の簡単なページングのためのLDAPv3コントロール拡張子について説明します。 このコントロール拡大で、クライアントはLDAPサーバがLDAP索敵行動の結果を返すレートを制御できます。 LDAPクライアントがリソースを制限して、与えられたLDAP質問から全体の結果セットを処理できないかもしれませんし、LDAPクライアントが低バンド幅接続の上に接続もされるとき、このコントロールは役に立つかもしれません。 結果セットにおける他の操作はこの拡大で定義されません。 この拡大は、より高度な結果セット管理を提供するように設計されていません。
The key words "MUST", "SHOULD", and "MAY" used in this document are to be interpreted as described in [bradner97].
“MUST"、“SHOULD"、および「5月」が本書では使用したキーワードは[bradner97]で説明されるように解釈されることです。
2. The Control
2. コントロール
This control is included in the searchRequest and searchResultDone messages as part of the controls field of the LDAPMessage, as defined in Section 4.1.12 of [LDAPv3]. The structure of this control is as follows:
このコントロールはLDAPMessageのコントロール分野の一部としてsearchRequestとsearchResultDoneメッセージに含まれています、.12セクション4.1[LDAPv3]で定義されるように。 このコントロールの構造は以下の通りです:
Weider, et al. Informational [Page 1] RFC 2696 LDAP Control Ext. for Simple Paged Results September 1999
ワイダー、他 情報[1ページ]のRFC2696LDAPコントロールExt簡単な呼び出された結果1999年9月のために
pagedResultsControl ::= SEQUENCE { controlType 1.2.840.113556.1.4.319, criticality BOOLEAN DEFAULT FALSE, controlValue searchControlValue }
pagedResultsControl:、:= 系列controlType、1.2 .840 .113556 .1 .4 .319 臨界BOOLEAN DEFAULT FALSE、controlValue searchControlValue
The searchControlValue is an OCTET STRING wrapping the BER-encoded version of the following SEQUENCE:
searchControlValueは以下のSEQUENCEのBERによってコード化されたバージョンを包装するOCTET STRINGです:
realSearchControlValue ::= SEQUENCE { size INTEGER (0..maxInt), -- requested page size from client -- result set size estimate from server cookie OCTET STRING }
realSearchControlValue:、:= 系列サイズINTEGER(0..maxInt)--クライアントからの要求されたページ・サイズ--結果はサーバクッキーOCTET STRINGからサイズ見積りを設定しました。
3. Client-Server Interaction
3. クライアント/サーバ相互作用
An LDAP client application that needs to control the rate at which results are returned MAY specify on the searchRequest a pagedResultsControl with size set to the desired page size and cookie set to the zero-length string. The page size specified MAY be greater than zero and less than the sizeLimit value specified in the searchRequest.
結果が返されるレートを制御する必要があるLDAPクライアントアプリケーションはsearchRequestで必要なページ・サイズとクッキーセットに設定されたサイズでゼロ長ストリングにpagedResultsControlを指定するかもしれません。 サイズが指定したページはsizeLimit値ゼロと以下がsearchRequestで指定したより大きいかもしれません。
If the page size is greater than or equal to the sizeLimit value, the server should ignore the control as the request can be satisfied in a single page. If the server does not support this control, the server MUST return an error of unsupportedCriticalExtension if the client requested it as critical, otherwise the server SHOULD ignore the control. The remainder of this section assumes the server does not ignore the client's pagedResultsControl.
ページ・サイズがそう以上なら、sizeLimit値であり、要望が1ページで応じることができるようにサーバはコントロールを無視するべきです。 クライアントが重要であるとしてそれを要求して、サーバがこのコントロールをサポートしないなら、サーバはunsupportedCriticalExtensionの誤りを返さなければなりません。さもなければ、サーバSHOULDはコントロールを無視します。 このセクションの残りは、サーバがクライアントのpagedResultsControlを無視しないと仮定します。
Each time the server returns a set of results to the client when processing a search request containing the pagedResultsControl, the server includes the pagedResultsControl control in the searchResultDone message. In the control returned to the client, the size MAY be set to the server's estimate of the total number of entries in the entire result set. Servers that cannot provide such an estimate MAY set this size to zero (0). The cookie MUST be set to an empty value if there are no more entries to return (i.e., the page of search results returned was the last), or, if there are more entries to return, to an octet string of the server's choosing,used to resume the search.
pagedResultsControlを含む検索要求を処理するサーバが1セットの結果をクライアントに返す各回、サーバはsearchResultDoneメッセージにpagedResultsControlコントロールを含んでいます。 クライアントに返されたコントロールでは、サイズはサーバの全体の結果セットにおける、エントリーの総数の見積りに設定されるかもしれません。 そのような見積りを提供できないサーバは、(0)のゼロを合わせるためにこのサイズにセットするかもしれません。 返すより多くのエントリーがあればまたは、戻る(すなわち、結果が返した検索のページは最終であった)ためにそれ以上のエントリーが全くなければ、空の値にクッキーを設定しなければなりません、サーバの選ぶことの八重奏ストリングに、検索を再開するのにおいて、使用されています。
The client MUST consider the cookie to be an opaque structure and make no assumptions about its internal organization or value. When the client wants to retrieve more entries for the result set, it MUST
クライアントは、クッキーが不明瞭な構造であり、その内部の組織か値に関する仮定を全くしないと考えなければなりません。 クライアントが結果セットのために、より多くのエントリーを検索したがっているとき、それは検索しなければなりません。
Weider, et al. Informational [Page 2] RFC 2696 LDAP Control Ext. for Simple Paged Results September 1999
ワイダー、他 情報[2ページ]のRFC2696LDAPコントロールExt簡単な呼び出された結果1999年9月のために
send to the server a searchRequest with all values identical to the initial request with the exception of the messageID, the cookie, and optionally a modified pageSize. The cookie MUST be the octet string on the last searchResultDone response returned by the server. Returning cookies from previous searchResultDone responses besides the last one is undefined, as the server implementation may restrict cookies from being reused.
messageIDを除いて、初期の要求と同じすべての値があるsearchRequestをサーバに送ってください、クッキー、そして、任意に、aはpageSizeを変更しました。 クッキーはサーバによって返された最後のsearchResultDone応答での八重奏ストリングであるに違いありません。最後のもの以外に前のsearchResultDone応答からクッキーを返すのは未定義です、サーバ実装が再利用されるのでクッキーを制限するとき。
The server will then return the next set of results from the whole result set. This interaction will continue until the client has retrieved all the results, in which case the cookie in the searchResultDone field will be empty, or until the client abandons the search sequence as described below. Once the paged search sequence has been completed, the cookie is no longer valid and MUST NOT be used.
そして、サーバは全体の結果セットから結果の次のセットを返すでしょう。 クライアントがsearchResultDone分野のクッキーがその場合でなくなるすべての結果を検索したか、またはクライアントが以下で説明されるように検索系列をやめるまで、この相互作用は続くでしょう。 呼び出された検索系列がいったん完了すると、クッキーは、もう有効でなく、使用されてはいけません。
A sequence of paged search requests is abandoned by the client sending a search request containing a pagedResultsControl with the size set to zero (0) and the cookie set to the last cookie returned by the server. A client MAY use the LDAP Abandon operation to abandon one paged search request in progress, but this is discouraged as it MAY invalidate the client's cookie.
呼び出された検索要求の系列はサイズセットでpagedResultsControlを含む検索要求を送るクライアントによってやめられて、(0)のゼロを合わせる、クッキーはサーバによって返された最後のクッキーにセットしました。クライアントは進行中の1つの呼び出された検索要求を捨てるのにLDAP Abandon操作を使用するかもしれませんが、クライアントのクッキーを無効にするとき、これはがっかりしています。
If, for any reason, the server cannot resume a paged search operation for a client, then it SHOULD return the appropriate error in a searchResultDone entry. If this occurs, both client and server should assume the paged result set is closed and no longer resumable.
どんな理由によるサーバも再開できないなら、aはクライアントのために索敵行動を呼び出して、次に、それはSHOULDリターンです。searchResultDoneエントリーにおける適切な誤り。 これが起こるなら、クライアントとサーバの両方が、呼び出された結果セットが閉じられると仮定して、もう再開可能されるべきではありません。
A client may have any number of outstanding search requests pending, any of which may have used the pagedResultsControl. A server implementation which requires a limit on the number of outstanding paged search requests from a given client MAY either return unwillingToPerform when the client attempts to create a new paged search request, or age out an older result set. If the server implementation ages out an older paged search request, it SHOULD return "unwilling to perform" if the client attempts to resume the paged search that was aged out.
クライアントには、未定のいろいろな傑出している検索要求があるかもしれません。そのいずれもpagedResultsControlを使用したかもしれません。 新しい状態でaを作成するクライアント試みが、より古い結果セットから検索要求、または時代を呼び出したとき、当然のことのクライアントからの傑出している呼び出された検索要求の数における限界を必要とするサーバ実装はunwillingToPerformを返すかもしれません。 実装はサーバであるなら、より古い呼び出された検索要求から年をとります、それ。クライアントが、外で熟成した呼び出された検索を再開するのを試みるなら、SHOULDは「実行するために、不本意な」状態で戻ります。
A client may safely assume that all entries that satisfy a given search query are returned once and only once during the set of paged search requests/responses necessary to enumerate the entire result set, unless the result set for that query has changed since the searchRequest starting the request/response sequence was processed. In that case, the client may receive a given entry multiple times and/or may not receive all entries matching the given search criteria.
クライアントは、与えられた検索クエリーを満たすすべてのエントリーが一度と全体の結果セットを数え上げるのに必要な呼び出された検索要求/応答のセットの間の一度だけ返されると安全に仮定するかもしれません、要求/応答系列を始めるsearchRequestが処理されて以来その質問に設定された結果が変化していない場合。 その場合、クライアントは、エントリーの与えられた倍数回数を受けるかもしれない、そして/または、与えられた検索評価基準に合っているすべてのエントリーを受けるかもしれないというわけではありません。
Weider, et al. Informational [Page 3] RFC 2696 LDAP Control Ext. for Simple Paged Results September 1999
ワイダー、他 情報[3ページ]のRFC2696LDAPコントロールExt簡単な呼び出された結果1999年9月のために
4. Example
4. 例
The following example illustrates the client-server interaction between a client doing a search requesting a page size limit of 3. The entire result set returned by the server contains 5 entries.
以下の例は、3のページ・サイズ限界を要求する検索をしながら、クライアントの間でクライアント/サーバ相互作用を例証します。 サーバによって返された全体の結果セットは5つのエントリーを含んでいます。
Lines beginning with "C:" indicate requests sent from client to server. Lines beginning with "S:" indicate responses sent from server to client. Lines beginning with "--" are comments to help explain the example.
始めを裏打ちする、「C:」 . 線が要求でクライアントからサーバに始まったのを示してください、「S:」 応答がサーバからクライアントまで発信したのを示してください。 「--」で始まる線は例について説明するのを助けるコメントです。
-- Client sends a search request asking for paged results -- with a page size of 3. C: SearchRequest + pagedResultsControl(3,"") -- Server responds with three entries plus an indication -- of 5 total entries in the search result and an opaque -- cooking to be used by the client when retrieving subsequent -- pages. S: SearchResultEntry S: SearchResultEntry S: SearchResultEntry S: SearchResultDone + pagedResultsControl(5, "opaque") -- Client sends an identical search request (except for -- message id), returning the opaque cooking, asking for -- the next page. C: SearchRequest + PagedResultsControl(3, "opaque") -- Server responds with two entries plus an indication -- that there are no more entries (null cookie). S: SearchResultEntry S: SearchResultEntry S: SearchResultDone + pagedResultsControl(5,"")
-- クライアントは検索要求に3のページ・サイズで呼び出された結果を求めさせます。 C: 「SearchRequest+pagedResultsControl、(3、インチ」、)、--検索その後である、クライアントによって使用されるように料理して、サーバは検索結果と不透明なものの5つの総エントリーの3つのエントリーとしるしで反応します--ページ S: SearchResultEntry S: SearchResultEntry S: SearchResultEntry S: SearchResultDone+pagedResultsControl(5、「不透明なもの」)--、クライアントが同じ検索要求を送る、(--、メッセージイド) 尋ねる、不透明な料理を返して、--次のページ。 C: SearchRequest+PagedResultsControl(3、「不透明なもの」)--サーバはそれ以上のエントリー(ヌルクッキー)が全くないという2つのエントリーと指示で反応します。 S: SearchResultEntry S: SearchResultEntry S: SearchResultDone+pagedResultsControl(5,"")
5. Relationship to X.500
5. X.500との関係
For LDAP servers providing a front end to X.500 (93) directories, the paged results control defined in this document may be mapped directly onto the X.500 (93) PagedResultsRequest defined in X.511 [x500]. The size parameter may be mapped onto pageSize. The cookie parameter may be mapped onto queryReference. The sortKeys and reverse fields in the X.500 PagedResultsRequest are excluded.
X.500(93)ディレクトリにフロントエンドを供給するLDAPサーバにおいて、コントロールが定義した呼び出された結果は直接X.511[x500]で定義されたX.500(93)PagedResultsRequestに本書では写像されるかもしれません。 サイズ・パラメータはpageSizeに写像されるかもしれません。 クッキーパラメタはqueryReferenceに写像されるかもしれません。 X.500 PagedResultsRequestのsortKeysと逆の分野は除かれます。
Weider, et al. Informational [Page 4] RFC 2696 LDAP Control Ext. for Simple Paged Results September 1999
ワイダー、他 情報[4ページ]のRFC2696LDAPコントロールExt簡単な呼び出された結果1999年9月のために
6. Security Considerations
6. セキュリティ問題
Server implementors should consider the resources used when clients send searches with the simple paged control, to ensure that a client's misuse of this control does not lock out other legitimate operations.
サーバ作成者は、クライアントが発信するとき、運用資金がクライアントのこのコントロールの誤用が他の正統の操作を締め出さないのを保証するために簡単な呼び出されたコントロールで探されると考えるべきです。
Servers implementations may enforce an overriding sizelimit, to prevent the retrieval of large portions of a publically-accessible directory.
サーバ実装は、publicallyにアクセス可能なディレクトリの大半の検索を防ぐために最優先のsizelimitを実施するかもしれません。
Clients can, using this control, determine how many entries match a particular filter, before the entries are returned to the client. This may require special processing in servers which perform access control checks on entries to determine whether the existence of the entry can be disclosed to the client.
このコントロールを使用して、クライアントは、いくつのエントリーが特定のフィルタに合っているかを決心できます、エントリーをクライアントに返す前に。 これはエントリーの存在をクライアントに明らかにすることができるかどうか決定するためにエントリーにアクセス制御チェックを実行するサーバにおける特別な処理を必要とするかもしれません。
7. References
7. 参照
[LDAPv3] Wahl, M., Howes, T. and S. Kille, "Lightweight Directory Access Protocol (v3)", RFC 2251, December 1997.
[LDAPv3]ウォールとM.とハウズとT.とS.Kille、「ライトウェイト・ディレクトリ・アクセス・プロトコル(v3)」、RFC2251 1997年12月。
[Bradner97] Bradner, S., "Key Words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.
[Bradner97] ブラドナー、S.、「Indicate Requirement LevelsへのRFCsにおける使用のための主要なワーズ」、BCP14、RFC2119、1997年3月。
Weider, et al. Informational [Page 5] RFC 2696 LDAP Control Ext. for Simple Paged Results September 1999
ワイダー、他 情報[5ページ]のRFC2696LDAPコントロールExt簡単な呼び出された結果1999年9月のために
8. Authors' Addresses
8. 作者のアドレス
Chris Weider Microsoft Corp. 1 Microsoft Way Redmond, WA 98052 USA
クリスワイダーMicrosoft Corp.1マイクロソフト、道のワシントン98052レッドモンド(米国)
Phone: +1 425 882-8080 EMail: cweider@microsoft.com
以下に電話をしてください。 +1 425 882-8080 メールしてください: cweider@microsoft.com
Andy Herron Microsoft Corp. 1 Microsoft Way Redmond, WA 98052 USA
アンディハーロンMicrosoft Corp.1マイクロソフト、道のワシントン98052レッドモンド(米国)
Phone: +1 425 882-8080 EMail: andyhe@microsoft.com
以下に電話をしてください。 +1 425 882-8080 メールしてください: andyhe@microsoft.com
Anoop Anantha Microsoft Corp. 1 Microsoft Way Redmond, WA 98052 USA
Anoop Anantha Microsoft Corp.1マイクロソフト、道のワシントン98052レッドモンド(米国)
Phone: +1 425 882-8080 EMail: anoopa@microsoft.com
以下に電話をしてください。 +1 425 882-8080 メールしてください: anoopa@microsoft.com
Tim Howes Netscape Communications Corp. 501 E. Middlefield Road Mountain View, CA 94043 USA
ティムハウズネットスケープ・コミュニケーションズ501E.Middlefield Roadカリフォルニア94043マウンテンビュー(米国)
Phone: +1 415 937-2600 EMail: howes@netscape.com
以下に電話をしてください。 +1 415 937-2600 メールしてください: howes@netscape.com
Weider, et al. Informational [Page 6] RFC 2696 LDAP Control Ext. for Simple Paged Results September 1999
ワイダー、他 情報[6ページ]のRFC2696LDAPコントロールExt簡単な呼び出された結果1999年9月のために
9. Full Copyright Statement
9. 完全な著作権宣言文
Copyright (C) The Internet Society (1999). All Rights Reserved.
Copyright(C)インターネット協会(1999)。 All rights reserved。
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English.
それに関するこのドキュメントと翻訳は、コピーして、それが批評するか、またはそうでなければわかる他のもの、および派生している作品に提供するか、または準備されているかもしれなくて、コピーされて、発行されて、全体か一部分配された実装を助けるかもしれません、どんな種類の制限なしでも、上の版権情報とこのパラグラフがそのようなすべてのコピーと派生している作品の上に含まれていれば。 しかしながら、このドキュメント自体は何らかの方法で変更されないかもしれません、インターネット協会か他のインターネット組織の版権情報か参照を取り除くのなどように、それを英語以外の言語に翻訳するのが著作権のための手順がインターネットStandardsプロセスで定義したどのケースに従わなければならないか、必要に応じてさもなければ、インターネット標準を開発する目的に必要であるのを除いて。
The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns.
上に承諾された限られた許容は、永久であり、インターネット協会、後継者または案配によって取り消されないでしょう。
This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
このドキュメントとそして、「そのままで」という基礎とインターネットの振興発展を目的とする組織に、インターネット・エンジニアリング・タスク・フォースが速達の、または、暗示しているすべての保証を放棄するかどうかというここにことであり、他を含んでいて、含まれて、情報の使用がここに侵害しないどんな保証も少しもまっすぐになるという情報か市場性か特定目的への適合性のどんな黙示的な保証。
Acknowledgement
承認
Funding for the RFC Editor function is currently provided by the Internet Society.
RFC Editor機能のための基金は現在、インターネット協会によって提供されます。
Weider, et al. Informational [Page 7]
ワイダー、他 情報[7ページ]
一覧
スポンサーリンク