Groupe de travail Réseau	W. Sanchez, Apple Inc.
Request for Comments : 5397	C. Daboo, Apple Inc.
Catégorie : Sur la voie de la normalisation	
Traduction Claude Brière de L'Isle	décembre 2008

Extension Principal actuel à WebDAV

Statut du présent mémoire
Le présent document spécifie un protocole de l’Internet sur la voie de la normalisation pour la communauté de l’Internet, et appelle à des discussions et suggestions pour son amélioration. Prière de se référer à l’édition en cours des "Protocoles officiels de l’Internet" (STD 1) pour voir l’état de normalisation et le statut de ce protocole. La distribution du présent mémoire n’est soumise à aucune restriction.

Notice de droits de reproduction
Copyright (c) 2009 IETF Trust et les personnes identifiées comme auteurs du document. Tous droits réservés.

Le présent document est soumis au BCP 78 et aux dispositions légales de l’IETF Trust qui se rapportent aux documents de l’IETF (http://trustee.ietf.org/license-info) en vigueur à la date de publication de ce document. Prière de revoir ces documents avec attention, car ils décrivent vos droits et obligations par rapport à ce document. Les composants de code extraits du présent document doivent inclure le texte de licence simplifié de BSD comme décrit au paragraphe 4.e des dispositions légales du Trust et sont fournis sans garantie comme décrit dans la licence de BSD simplifiée.

Résumé
La présente spécification définit une nouvelle propriété de WebDAV qui permet aux clients de déterminer rapidement le principal correspondant à l’utilisateur authentifié actuel.
Table des matières
1. Introduction	1
2. Conventions utilisées dans le document	2
3. DAV:current-user-principal	2
4. Considérations sur la sécurité	3
5. Remerciements	3
6. Références normatives	3
Adresse des auteurs	3

 	1.	Introduction

WebDAV [RFC4918] est une extension à HTTP [RFC2616] pour prendre en charge des capacités améliorées d’identification d’auteurs de documents. L’extension au protocole de contrôle d’accès à WebDAV (WebDAV ACL, WebDAV Access Control Protocol) [RFC3744] ajoute des capacités de contrôle d’accès à WebDAV. Elle introduit le concept d’une ressource "principale", qui est utilisée pour représenter des informations sur les entités authentifiées sur le système.

Certains clients ont besoin de déterminer quel principal [RFC3744] un serveur associe à l’utilisateur HTTP actuellement authentifié. Bien que la [RFC3744] définisse une propriété DAV:current-user-privilege-set pour restituer les privilèges accordés à ce principal, elle ne recommande pas de moyen d’identifier le principal en question, ce qui est nécessaire pour effectuer d’autres opérations utiles. Par exemple, un client peut souhaiter déterminer de quels groupes l’utilisateur actuel est membre, ou modifier une propriété de la ressource principale associée à l’utilisateur actuel.

Le RAPPORT DAV:principal-match fournit une fonction utile, mais il y a des situations courantes où le résultat de cette interrogation peut être ambigu. Par exemple, non seulement un utilisateur individuel principal est retourné, mais aussi tout groupe principal dont l’utilisateur est membre, et il n’y a pas de façon claire de distinguer qui est qui.

La présente spécification propose une extension à WebDAV ACL qui ajoute une propriété DAV:current-user-principal aux ressources sous le contrôle d’accès du serveur. Cette propriété fournit un URL pointant sur une ressource principale correspondant à l’utilisateur actuellement authentifié. Cela permet à un client de "s’amorcer" lui-même en effectuant des interrogations supplémentaires sur la ressource principale pour obtenir des informations supplémentaires de cette ressource, ce qui est l’objet de cette extension. Noter qu’alors qu’il est possible que plusieurs URL se réfèrent à la même ressource principale, ou que plusieurs ressources principales correspondent à un seul principal, la présente spécification permet seulement un URL http(s) dans la propriété DAV:current-user-principal. Si un client souhaite obtenir des URL de remplacement pour le principal, il peut interroger la ressource principale sur ces informations; ce n’est pas l’objet de la présente extension de fournir une liste complète de ces URL, mais simplement de donner un moyen pour localiser une ressource qui contient cette information (et d’autres).

 	2.	Conventions utilisées dans le document
Les mots clés "DOIT", "NE DOIT PAS", "EXIGE", "DEVRA", "NE DEVRA PAS", "DEVRAIT", "NE DEVRAIT PAS", "RECOMMANDE", "PEUT", et "FACULTATIF" en majuscules dans ce document sont à interpréter comme décrit dans le BCP 14, [RFC2119].

Quand des types d’élément XML dans l’espace de noms "DAV:" sont référencés dans le présent document en dehors du contexte d’un fragment XML, la chaîne "DAV:" va être mise en préfixe devant les noms de type d’élément.

Le traitement XML par les clients et serveurs DOIT suivre les règles définies à la Section 17 de WebDAV [RFC4918].

Certaines déclarations se réfèrent à des éléments XML définis par WebDAV [RFC4918].

 	3.	DAV:current-user-principal

Nom : current-user-principal

Espace de noms : DAV:

Objet : indique un URL pour la ressource principale de l’utilisateur actuellement authentifié sur le serveur.

Valeur : un seul élément DAV:href ou DAV:unauthenticated.

Protégé : cette propriéte est calculée demande par demande, et est donc protégée.

Description : la propriété DAV:current-user-principal contient un élément XML DAV:href ou DAV:unauthenticated. L’élément DAV:href contient un URL pointant sur une ressource principale correspondant à l’utilisateur actuellement authentifié. Cet URL DOIT être un des URL dans les propriétés DAV:principal-URL ou DAV:alternate-URI-set définies sur la ressource principale et DOIT être un URL de schéma http(s). Quand l’authentification n’a pas éte faite ou a échoué, cette propriété DOIT contenir le pseudo-principal DAV:unauthenticated.

Dans certains cas, il peut y avoir plusieurs ressources principales correspondant au même principal authentifié. Dans ce cas, le serveur est libre de choisir l’un des URI de la ressource principale pour la valeur de la propriété DAV:current-user-principal. Cependant, les serveurs DEVRAIENT être cohérents et utiliser le même URI de ressource principale pour chaque principal authentifié.

Comportement de COPY/MOVE : cette propriéte est calculée demande par demande, et n’est donc jamais copiée ni déplacée.

Définition :

<!ELEMENT current-user-principal (unauthenticated | href)> 
<!-- valeur de href : un URL pointant sur une ressource principale -->

Exemple :

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

 	4.	Considérations sur la sécurité

La présente spécification n’introduit aucun problème de sécurité supplémentaire au delà de ceux définis pour HTTP [RFC2616], WebDAV [RFC4918], et WebDAV ACL [RFC3744].

 	5.	Remerciements

La présente spécification se fonde sur les discussions qui ont eu lieu dans dans le comité technique CalDAV du Consortium Calendaring and Scheduling. Les auteurs remercient les participants à ce groupe de leurs apports.

Les auteurs remercient Julian Reschke de sa précieuse contribution via la liste de diffusion du groupe de travail WebDAV.

 	6.	Références normatives

[RFC2119]	S. Bradner, "Mots clés à utiliser dans les RFC pour indiquer les niveaux d'exigence", BCP 14, mars 1997. (MàJ par RFC8174)

[RFC2616]	R. Fielding et autres, "Protocole de transfert hypertexte -- HTTP/1.1", juin 1999. (D.S., MàJ par 2817, 6585)

[RFC3744]	G. Clemm et autres, "Protocole de contrôle d'accès à la collecte des noms d'auteurs et de version répartie sur la Toile (WebDAV)", mai 2004. (P.S.)

[RFC4918]	L. Dusseault, éd. "Extensions HTTP pour les informations d'auteur et de version distribuées sur la Toile (WebDAV)", juin 2007. (Remplace RFC2518) (P.S.)

 	Adresse des auteurs

Wilfredo Sanchez	Cyrus Daboo	
Apple Inc.	Apple Inc.	
1 Infinite Loop	1 Infinite Loop	
Cupertino, CA  95014	Cupertino, CA  95014	
USA	USA	
mél : wsanchez@wsanchez.net 	mél : cyrus@daboo.name 	
URI : http://www.apple.com/ 	URI : http://www.apple.com/