RFC 5397 - WebDAV Current Principal Extension 日本語訳

原文URL : https://datatracker.ietf.org/doc/html/rfc5397
タイトル : RFC 5397 - WebDAV電流プリンシパルエクステンション
翻訳編集 : 自動生成

[要約] RFC 5397は、WebDAVのCurrent Principal拡張機能に関する仕様です。このRFCの目的は、WebDAVクライアントが現在のユーザーの情報を取得するための標準的な方法を提供することです。

Network Working Group                                         W. Sanchez
Request for Comments: 5397                                      C. Daboo
Category: Standards Track                                     Apple Inc.
                                                           December 2008

WebDAV Current Principal Extension

WebDAV電流プリンシパルエクステンション

Status of This Memo

本文書の位置付け

This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited.

このドキュメントは、インターネットコミュニティのインターネット標準トラックプロトコルを指定し、改善のための議論と提案を要求します。このプロトコルの標準化状態とステータスについては、「インターネット公式プロトコル標準」（STD 1）の現在のエディションを参照してください。このメモの配布は無制限です。

著作権表示

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document.

このドキュメントは、BCP 78およびIETFドキュメント（http://trustee.ietf.org/license-info）に関連するIETF Trustの法的規定の対象となります。この文書に関するあなたの権利と制限を説明するので、これらの文書を注意深く確認してください。

Abstract

概要

This specification defines a new WebDAV property that allows clients to quickly determine the principal corresponding to the current authenticated user.

この仕様は、クライアントが現在の認証されたユーザーに対応するプリンシパルをすばやく決定できるようにする新しいWebDAVプロパティを定義します。

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 2
   2.  Conventions Used in This Document . . . . . . . . . . . . . . . 2
   3.  DAV:current-user-principal  . . . . . . . . . . . . . . . . . . 3
   4.  Security Considerations . . . . . . . . . . . . . . . . . . . . 4
   5.  Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . 4
   6.  Normative References  . . . . . . . . . . . . . . . . . . . . . 4

1. Introduction

1. はじめに

WebDAV [RFC4918] is an extension to HTTP [RFC2616] to support improved document authoring capabilities. The WebDAV Access Control Protocol ("WebDAV ACL") [RFC3744] extension adds access control capabilities to WebDAV. It introduces the concept of a "principal" resource, which is used to represent information about authenticated entities on the system.

WebDav [RFC4918]は、HTTP [RFC2616]の拡張であり、ドキュメントオーサリング機能の改善をサポートしています。WebDav Access Controlプロトコル（ "WebDav ACL"）[RFC3744]拡張機能は、WebDAVにアクセス制御機能を追加します。システム上の認証されたエンティティに関する情報を表すために使用される「主要な」リソースの概念を紹介します。

Some clients have a need to determine which [RFC3744] principal a server is associating with the currently authenticated HTTP user. While [RFC3744] defines a DAV:current-user-privilege-set property for retrieving the privileges granted to that principal, there is no recommended way to identify the principal in question, which is necessary to perform other useful operations. For example, a client may wish to determine which groups the current user is a member of, or modify a property of the principal resource associated with the current user.

一部のクライアントは、サーバーが現在認証されているHTTPユーザーと関連付けている[RFC3744] [[RFC3744]の[[RFC3744]を決定する必要があります。[RFC3744]は、そのプリンシパルに付与された特権を取得するためにDAV：Current-User-Privilege-Setプロパティを定義しますが、問題のプリンシパルを特定するための推奨される方法はありません。たとえば、クライアントは、現在のユーザーがどのグループがメンバーであるかを判断したり、現在のユーザーに関連付けられている主要なリソースのプロパティを変更したりすることを希望する場合があります。

The DAV:principal-match REPORT provides some useful functionality, but there are common situations where the results from that query can be ambiguous. For example, not only is an individual user principal returned, but also every group principal that the user is a member of, and there is no clear way to distinguish which is which.

DAV：プリンシパルマッチレポートはいくつかの有用な機能を提供しますが、そのクエリの結果が曖昧になる可能性のある一般的な状況があります。たとえば、個々のユーザープリンシパルが返されるだけでなく、ユーザーがメンバーであるすべてのグループプリンシパルも、どちらがどれであるかを区別する明確な方法はありません。

This specification proposes an extension to WebDAV ACL that adds a DAV:current-user-principal property to resources under access control on the server. This property provides a URL to a principal resource corresponding to the currently authenticated user. This allows a client to "bootstrap" itself by performing additional queries on the principal resource to obtain additional information from that resource, which is the purpose of this extension. Note that while it is possible for multiple URLs to refer to the same principal resource, or for multiple principal resources to correspond to a single principal, this specification only allows for a single http(s) URL in the DAV:current-user-principal property. If a client wishes to obtain alternate URLs for the principal, it can query the principal resource for this information; it is not the purpose of this extension to provide a complete list of such URLs, but simply to provide a means to locate a resource which contains that (and other) information.

この仕様では、サーバー上のアクセス制御下のリソースにDAV：Current-User-Principalプロパティを追加するWebDav ACLへの拡張機能を提案します。このプロパティは、現在認証されているユーザーに対応する主要なリソースにURLを提供します。これにより、クライアントは、主要なリソースで追加のクエリを実行して、このリソースから追加情報を取得することにより、「ブートストラップ」自体を「ブートストラップ」することができます。これは、この拡張機能の目的です。複数のURLが同じプリンシパルリソースを参照すること、または複数のプリンシパルリソースが単一のプリンシパルに対応する可能性があるが、この仕様ではDAVの単一のHTTP URLのみが許可されていることに注意財産。クライアントがプリンシパルの代替URLを取得したい場合、この情報のプリンシパルリソースを照会できます。このようなURLの完全なリストを提供することは、この拡張機能の目的ではなく、単にその（およびその他の）情報を含むリソースを見つける手段を提供するだけです。

2. Conventions Used in This Document

2. このドキュメントで使用されている規則

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].

「必須」、「そうしない」、「必須」、「必要」、「「しない」、「そうでない」、「そうではない」、「そうでない」、「推奨」、「5月」、および「オプション」は、[RFC2119]に記載されているように解釈される。

When XML element types in the namespace "DAV:" are referenced in this document outside of the context of an XML fragment, the string "DAV:" will be prefixed to the element type names.

名前空間のXML要素タイプ「DAV：」がXMLフラグメントのコンテキストの外でこのドキュメントで参照される場合、文字列「DAV：」は要素タイプ名に付けられます。

Processing of XML by clients and servers MUST follow the rules defined in Section 17 of WebDAV [RFC4918].

クライアントとサーバーによるXMLの処理は、WebDAV [RFC4918]のセクション17で定義されているルールに従う必要があります。

Some of the declarations refer to XML elements defined by WebDAV [RFC4918].

宣言の一部は、WebDav [RFC4918]によって定義されたXML要素を指します。

3. DAV:current-user-principal

3. DAV：現在のユーザープリンシパル

Name: current-user-principal

名前：Current-User-Principal

Namespace: DAV:

名前空間：DAV：

Purpose: Indicates a URL for the currently authenticated user's principal resource on the server.

目的：サーバー上の現在認証されているユーザーの主要なリソースのURLを示します。

Value: A single DAV:href or DAV:unauthenticated element.

値：単一のDAV：HREFまたはDAV：認証されていない要素。

Protected: This property is computed on a per-request basis, and therefore is protected.

保護：このプロパティは、リケストごとに計算されるため、保護されています。

Description: The DAV:current-user-principal property contains either a DAV:href or DAV:unauthenticated XML element. The DAV:href element contains a URL to a principal resource corresponding to the currently authenticated user. That URL MUST be one of the URLs in the DAV:principal-URL or DAV:alternate-URI-set properties defined on the principal resource and MUST be an http(s) scheme URL. When authentication has not been done or has failed, this property MUST contain the DAV:unauthenticated pseudo-principal.

説明：DAV：Current-USER-Principalプロパティには、DAV：HREFまたはDAV：UnAurtenticated XML要素のいずれかが含まれています。DAV：HREF要素には、現在認証されているユーザーに対応する主要なリソースへのURLが含まれています。そのURLは、DAVのURLの1つでなければなりません：プリンシパルURLまたはDAV：主要なリソースで定義されている代替-URIセットプロパティであり、HTTPスキームURLでなければなりません。認証が行われていない、または失敗した場合、このプロパティにはDAV：非認証擬似プリンシパルが含まれている必要があります。

In some cases, there may be multiple principal resources corresponding to the same authenticated principal. In that case, the server is free to choose any one of the principal resource URIs for the value of the DAV:current-user-principal property. However, servers SHOULD be consistent and use the same principal resource URI for each authenticated principal.

場合によっては、同じ認証されたプリンシパルに対応する複数のプリンシパルリソースがある場合があります。その場合、サーバーは、DAVの値であるCurrent-User-Principalプロパティの主要なリソースURIのいずれかを自由に選択できます。ただし、サーバーは一貫しており、認証されたプリンシパルごとに同じプリンシパルリソースURIを使用する必要があります。

COPY/MOVE behavior: This property is computed on a per-request basis, and is thus never copied or moved.

動作のコピー/移動：このプロパティは、レクエストごとに計算されるため、コピーまたは移動することはありません。

Definition:

意味：

      <!ELEMENT current-user-principal (unauthenticated | href)>
      <!-- href value: a URL to a principal resource -->

Example:

例：

      <D:current-user-principal xmlns:D="DAV:">
        <D:href>/principals/users/cdaboo</D:href>
      </D:current-user-principal>

4. Security Considerations

4. セキュリティに関する考慮事項

This specification does not introduce any additional security issues beyond those defined for HTTP [RFC2616], WebDAV [RFC4918], and WebDAV ACL [RFC3744].

この仕様では、HTTP [RFC2616]、WebDAV [RFC4918]、およびWebDav ACL [RFC3744]で定義されたものを超えた追加のセキュリティ問題は導入されません。

5. Acknowledgments

5. 謝辞

This specification is based on discussions that took place within the Calendaring and Scheduling Consortium's CalDAV Technical Committee. The authors thank the participants of that group for their input.

この仕様は、カレンダーおよびスケジューリングコンソーシアムのCalDAV技術委員会内で行われた議論に基づいています。著者は、そのグループの参加者に意見を述べてくれたことに感謝します。

The authors thank Julian Reschke for his valuable input via the WebDAV working group mailing list.

著者は、WebDavワーキンググループメーリングリストを介して貴重な入力をしてくれたJulian Reschkeに感謝します。

6. Normative References

6. 引用文献

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するためのキーワード」、BCP 14、RFC 2119、1997年3月。

[RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.

[RFC2616] Fielding、R.、Gettys、J.、Mogul、J.、Frystyk、H.、Masinter、L.、Leach、P。、およびT. Berners-Lee、「HyperText Transfer Protocol-HTTP/1.1」、RFC 2616、1999年6月。

[RFC3744] Clemm, G., Reschke, J., Sedlar, E., and J. Whitehead, "Web Distributed Authoring and Versioning (WebDAV) Access Control Protocol", RFC 3744, May 2004.

[RFC3744] Clemm、G.、Reschke、J.、Sedlar、E.、およびJ. Whitehead、「Web分散オーサリングおよびバージョン（WebDAV）アクセス制御プロトコル」、RFC 3744、2004年5月。

[RFC4918] Dusseault, L., "HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)", RFC 4918, June 2007.

[RFC4918] Dusseault、L。、「Web分散オーサリングおよびバージョン（WebDAV）のHTTP拡張機能」、RFC 4918、2007年6月。

Authors' Addresses

著者のアドレス

Wilfredo Sanchez Apple Inc. 1 Infinite Loop Cupertino, CA 95014 USA

Wilfredo Sanchez Apple Inc. 1 Infinite Loop Cupertino、CA 95014 USA

   EMail: wsanchez@wsanchez.net
   URI:   http://www.apple.com/
      Cyrus Daboo
   Apple Inc.
   1 Infinite Loop
   Cupertino, CA  95014
   USA

   EMail: cyrus@daboo.name
   URI:   http://www.apple.com/