CalDAV Managed Attachments
draft-ietf-calext-caldav-attachments-03

Document Type Active Internet-Draft (calext WG)
Last updated 2017-08-16 (latest revision 2017-07-24)
Stream IETF
Intended RFC status Informational
Formats plain text xml pdf html bibtex
Reviews OPSDIR will not review this version
Stream WG state Submitted to IESG for Publication (wg milestone: May 2017 - Send attachment drat... )
Document shepherd Philipp Kewisch
Shepherd write-up Show (last changed 2017-08-14)
IESG IESG state IESG Evaluation::AD Followup
Consensus Boilerplate Yes
Telechat date On agenda of 2017-08-17 IESG telechat
Has enough positions to pass.
Responsible AD Alexey Melnikov
Send notices to (None)
IANA IANA review state IANA - Not OK
IANA action state None
Calendering Extensions                                          C. Daboo
Internet-Draft                                                     Apple
Intended status: Informational                               A. Quillaud
Expires: January 24, 2018                                         Oracle
                                                       K. Murchison, Ed.
                                                                FastMail
                                                           July 23, 2017

                       CalDAV Managed Attachments
                draft-ietf-calext-caldav-attachments-03

Abstract

   This specification defines an extension to the calendar access
   protocol (CalDAV) to allow attachments associated with iCalendar data
   to be stored and managed on the server.

   This specification documents existing code deployed by multiple
   vendors.  It is published as an Informational specification rather
   than Standards-Track due to its non-standard method of updating an
   existing resource via HTTP.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on January 24, 2018.

Copyright Notice

   Copyright (c) 2017 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   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

Daboo, et al.           Expires January 24, 2018                [Page 1]
Internet-Draft         CalDAV Managed Attachments              July 2017

   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  Conventions Used in This Document . . . . . . . . . . . . . .   3
   3.  Overview  . . . . . . . . . . . . . . . . . . . . . . . . . .   3
     3.1.  Requirements  . . . . . . . . . . . . . . . . . . . . . .   4
     3.2.  Discovering Support for Managed Attachments . . . . . . .   4
     3.3.  POST Request for Managing Attachments . . . . . . . . . .   5
     3.4.  Adding attachments  . . . . . . . . . . . . . . . . . . .   6
     3.5.  Updating Attachments  . . . . . . . . . . . . . . . . . .   9
     3.6.  Removing Attachments via POST . . . . . . . . . . . . . .  12
     3.7.  Adding Existing Managed Attachments via PUT . . . . . . .  14
     3.8.  Updating Attachments via PUT  . . . . . . . . . . . . . .  14
     3.9.  Removing Attachments via PUT  . . . . . . . . . . . . . .  14
     3.10. Retrieving Attachments  . . . . . . . . . . . . . . . . .  14
     3.11. Error Handling  . . . . . . . . . . . . . . . . . . . . .  15
     3.12. Additional Considerations . . . . . . . . . . . . . . . .  16
   4.  Modifications to iCalendar Syntax . . . . . . . . . . . . . .  17
     4.1.  SIZE Property Parameter . . . . . . . . . . . . . . . . .  17
     4.2.  FILENAME Property Parameter . . . . . . . . . . . . . . .  18
     4.3.  MANAGED-ID Property Parameter . . . . . . . . . . . . . .  18
   5.  Additional Message Header Fields  . . . . . . . . . . . . . .  19
     5.1.  Cal-Managed-ID Response Header Field  . . . . . . . . . .  19
   6.  Additional WebDAV Properties  . . . . . . . . . . . . . . . .  19
     6.1.  CALDAV:managed-attachments-server-URL property  . . . . .  19
     6.2.  CALDAV:max-attachment-size property . . . . . . . . . . .  20
     6.3.  CALDAV:max-attachments-per-resource property  . . . . . .  21
   7.  Implementation Status . . . . . . . . . . . . . . . . . . . .  22
   8.  Security Considerations . . . . . . . . . . . . . . . . . . .  24
   9.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  24
     9.1.  Parameter Registrations . . . . . . . . . . . . . . . . .  24
     9.2.  Message Header Field Registrations  . . . . . . . . . . .  24
   10. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . .  25
Show full document text