Logo Search packages:      
Sourcecode: calendarserver version File versions  Download package


# Copyright (c) 2005-2008 Apple Inc. All rights reserved.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# http://www.apache.org/licenses/LICENSE-2.0
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# See the License for the specific language governing permissions and
# limitations under the License.
# DRI: Cyrus Daboo, cdaboo@apple.com

CalDAV scheduling resources.

__all__ = [

from twisted.internet import reactor
from twisted.internet.defer import deferredGenerator, maybeDeferred, succeed, waitForDeferred
from twisted.python import log
from twisted.python.failure import Failure
from twisted.web2 import responsecode
from twisted.web2.http import HTTPError, Response
from twisted.web2.http_headers import MimeType
from twisted.web2.dav import davxml
from twisted.web2.dav.http import ErrorResponse, errorForFailure, messageForFailure, statusForFailure
from twisted.web2.dav.resource import AccessDeniedError
from twisted.web2.dav.util import joinURL

from twistedcaldav import caldavxml
from twistedcaldav import itip
from twistedcaldav.resource import CalDAVResource
from twistedcaldav.caldavxml import caldav_namespace, TimeRange
from twistedcaldav.config import config
from twistedcaldav.customxml import calendarserver_namespace
from twistedcaldav.ical import Component
from twistedcaldav.method import report_common
from twistedcaldav.method.put_common import storeCalendarObjectResource
from twistedcaldav.resource import isCalendarCollectionResource

import md5
import time

00054 class CalendarSchedulingCollectionResource (CalDAVResource):
    CalDAV principal resource.

    Extends L{DAVResource} to provide CalDAV scheduling collection
00061     def __init__(self, parent):
        @param parent: the parent resource of this one.
        assert parent is not None

        CalDAVResource.__init__(self, principalCollections=parent.principalCollections())

        self.parent = parent

    def isCollection(self):
        return True

00074     def isCalendarCollection(self):
        return False

00077     def isPseudoCalendarCollection(self):
        return True

    def supportedReports(self):
        result = super(CalDAVResource, self).supportedReports()
        # free-busy report not allowed
        return result

00087 class ScheduleInboxResource (CalendarSchedulingCollectionResource):
    CalDAV schedule Inbox resource.

    Extends L{DAVResource} to provide CalDAV functionality.

00094     liveProperties = CalendarSchedulingCollectionResource.liveProperties + (
        (caldav_namespace, "calendar-free-busy-set"),

    def resourceType(self):
        return davxml.ResourceType.scheduleInbox

    def defaultAccessControlList(self):
        return davxml.ACL(
            # CalDAV:schedule for any authenticated user

    def readProperty(self, property, request):
        if type(property) is tuple:
            qname = property
            qname = property.qname()

        if qname == (caldav_namespace, "calendar-free-busy-set"):
            # Always return at least an empty list
            if not self.hasDeadProperty(property):
                return succeed(caldavxml.CalendarFreeBusySet())
        return super(ScheduleInboxResource, self).readProperty(property, request)

    def writeProperty(self, property, request):
        assert isinstance(property, davxml.WebDAVElement)

        # Strictly speaking CS:calendar-availability is a live property in the sense that the
        # server enforces what can be stored, however it need not actually
        # exist so we cannot list it in liveProperties on this resource, since its
        # its presence there means that hasProperty will always return True for it.
        if property.qname() == (calendarserver_namespace, "calendar-availability"):
            if not property.valid():
                raise HTTPError(ErrorResponse(
                    (caldav_namespace, "valid-calendar-data")

        elif property.qname() == (caldav_namespace, "calendar-free-busy-set"):
            # Verify that the calendars added in the PROPPATCH are valid. We do not check
            # whether existing items in the property are still valid - only new ones.
            new_calendars = set([str(href) for href in property.children])
            if not self.hasDeadProperty(property):
                old_calendars = set()
                old_calendars = set([str(href) for href in self.readDeadProperty(property).children])
            added_calendars = new_calendars.difference(old_calendars)
            for href in added_calendars:
                cal = waitForDeferred(request.locateResource(str(href)))
                yield cal
                cal = cal.getResult()
                if cal is None or not cal.exists() or not isCalendarCollectionResource(cal):
                    # Validate that href's point to a valid calendar.
                    raise HTTPError(ErrorResponse(
                        (caldav_namespace, "valid-calendar-url")

        d = waitForDeferred(super(ScheduleInboxResource, self).writeProperty(property, request))
        yield d
        yield d.getResult()

00164 class ScheduleOutboxResource (CalendarSchedulingCollectionResource):
    CalDAV schedule Outbox resource.

    Extends L{DAVResource} to provide CalDAV functionality.

    def defaultAccessControlList(self):
        if config.EnableProxyPrincipals:
            myPrincipal = self.parent.principalForRecord()
            return davxml.ACL(
                # CalDAV:schedule for associated write proxies
                    davxml.Principal(davxml.HRef(joinURL(myPrincipal.principalURL(), "calendar-proxy-write"))),
            return super(ScheduleOutboxResource, self).defaultAccessControlList()

    def resourceType(self):
        return davxml.ResourceType.scheduleOutbox

00190     def http_POST(self, request):
        The CalDAV POST method.
        This uses a generator function yielding either L{waitForDeferred} objects or L{Response} objects.
        This allows for code that follows a 'linear' execution pattern rather than having to use nested
        L{Deferred} callbacks. The logic is easier to follow this way plus we don't run into deep nesting
        issues which the other approach would have with large numbers of recipients.
        # Check authentication and access controls
        x = waitForDeferred(self.authorize(request, (caldavxml.Schedule(),)))
        yield x

        # Must be content-type text/calendar
        contentType = request.headers.getHeader("content-type")
        if contentType is not None and (contentType.mediaType, contentType.mediaSubtype) != ("text", "calendar"):
            log.err("MIME type %s not allowed in calendar collection" % (contentType,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "supported-calendar-data")))
        # Must have Originator header
        originator = request.headers.getRawHeaders("originator")
        if originator is None or (len(originator) != 1):
            log.err("POST request must have Originator header")
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "originator-specified")))
            originator = originator[0]
        # Verify that Originator is a valid calendar user (has an INBOX)
        originatorPrincipal = self.principalForCalendarUserAddress(originator)
        if originatorPrincipal is None:
            log.err("Could not find principal for originator: %s" % (originator,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "originator-allowed")))

        inboxURL = originatorPrincipal.scheduleInboxURL()
        if inboxURL is None:
            log.err("Could not find inbox for originator: %s" % (originator,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "originator-allowed")))
        # Verify that Originator matches the authenticated user
        if davxml.Principal(davxml.HRef(originatorPrincipal.principalURL())) != self.currentPrincipal(request):
            log.err("Originator: %s does not match authorized user: %s" % (originator, self.currentPrincipal(request).children[0],))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "originator-allowed")))

        # Get list of Recipient headers
        rawRecipients = request.headers.getRawHeaders("recipient")
        if rawRecipients is None or (len(rawRecipients) == 0):
            log.err("POST request must have at least one Recipient header")
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "recipient-specified")))

        # Recipient header may be comma separated list
        recipients = []
        for rawRecipient in rawRecipients:
            for r in rawRecipient.split(","):
                r = r.strip()
                if len(r):

        timeRange = TimeRange(start="20000101", end="20000102")
        recipientsState = {"OK":0, "BAD":0}

        # Parse the calendar object from the HTTP request stream
            d = waitForDeferred(Component.fromIStream(request.stream))
            yield d
            calendar = d.getResult()
            log.err("Error while handling POST: %s" % (Failure(),))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "valid-calendar-data")))
        # Must be a valid calendar
        except ValueError:
            log.err("POST request calendar component is not valid: %s" % (calendar,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "valid-calendar-data")))

        # Must have a METHOD
        if not calendar.isValidMethod():
            log.err("POST request must have valid METHOD property in calendar component: %s" % (calendar,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "valid-calendar-data")))
        # Verify iTIP behaviour
        if not calendar.isValidITIP():
            log.err("POST request must have a calendar component that satisfies iTIP requirements: %s" % (calendar,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "valid-calendar-data")))

        # X-CALENDARSERVER-ACCESS is not allowed in Outbox POSTs
        if calendar.hasProperty(Component.ACCESS_PROPERTY):
            log.err("X-CALENDARSERVER-ACCESS not allowed in a calendar component POST request: %s" % (calendar,), system="CalDAV Outbox POST")
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (calendarserver_namespace, "no-access-restrictions")))
        # Verify that the ORGANIZER's cu address maps to the request.uri
        organizer = calendar.getOrganizer()
        if organizer is None:
            organizerPrincipal = None
            organizerPrincipal = self.principalForCalendarUserAddress(organizer)

        if organizerPrincipal is None:
            log.err("ORGANIZER in calendar data is not valid: %s" % (calendar,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "organizer-allowed")))

        # Prevent spoofing of ORGANIZER with specific METHODs
        if (
            calendar.propertyValue("METHOD") in ("PUBLISH", "REQUEST", "ADD", "CANCEL", "DECLINECOUNTER") and
            organizerPrincipal.record != self.parent.record
            log.err("ORGANIZER in calendar data does not match owner of Outbox: %s" % (calendar,))
            raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "organizer-allowed")))

        # Prevent spoofing when doing reply-like METHODs
        if calendar.propertyValue("METHOD") in ("REPLY", "COUNTER", "REFRESH"):
            # Verify that there is a single ATTENDEE property and that the Originator has permission
            # to send on behalf of that ATTENDEE
            attendees = calendar.getAttendees()
            # Must have only one
            if len(attendees) != 1:
                log.err("ATTENDEE list in calendar data is wrong: %s" % (calendar,))
                raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "attendee-allowed")))
            # Attendee's Outbox MUST be the request URI
            attendeePrincipal = self.principalForCalendarUserAddress(attendees[0])
            if attendeePrincipal is None or attendeePrincipal.record != self.parent.record:
                log.err("ATTENDEE in calendar data does not match owner of Outbox: %s" % (calendar,))
                raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "attendee-allowed")))

        # For free-busy do immediate determination of iTIP result rather than fan-out
        if (calendar.propertyValue("METHOD") == "REQUEST") and (calendar.mainType() == "VFREEBUSY"):
            # Extract time range from VFREEBUSY object
            vfreebusies = [v for v in calendar.subcomponents() if v.name() == "VFREEBUSY"]
            if len(vfreebusies) != 1:
                log.err("iTIP data is not valid for a VFREEBUSY request: %s" % (calendar,))
                raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "valid-calendar-data")))
            dtstart = vfreebusies[0].getStartDateUTC()
            dtend = vfreebusies[0].getEndDateUTC()
            if dtstart is None or dtend is None:
                log.err("VFREEBUSY start/end not valid: %s" % (calendar,))
                raise HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "valid-calendar-data")))
            timeRange.start = dtstart
            timeRange.end = dtend

            # Look for maksed UID
            excludeUID = calendar.getMaskUID()

            # Do free busy operation
            freebusy = True
            # Do regular invite (fan-out)
            freebusy = False

        # Prepare for multiple responses
        responses = ScheduleResponseQueue("POST", responsecode.OK)
        # Loop over each recipient and do appropriate action.
        autoresponses = []
        for recipient in recipients:
            # Get the principal resource for this recipient
            principal = self.principalForCalendarUserAddress(recipient)

            # Map recipient to their inbox
            inbox = None
            if principal is None:
                log.err("No schedulable principal for calendar user address: %s" % (recipient,))
                inboxURL = principal.scheduleInboxURL()
                if inboxURL:
                    inbox = waitForDeferred(request.locateResource(inboxURL))
                    yield inbox
                    inbox = inbox.getResult()
                    log.err("No schedule inbox for principal: %s" % (principal,))

            if inbox is None:
                err = HTTPError(ErrorResponse(responsecode.NOT_FOUND, (caldav_namespace, "recipient-exists")))
                responses.add(recipient, Failure(exc_value=err), reqstatus="3.7;Invalid Calendar User")
                recipientsState["BAD"] += 1
                # Process next recipient
                # Check access controls
                    d = waitForDeferred(inbox.checkPrivileges(request, (caldavxml.Schedule(),), principal=davxml.Principal(davxml.HRef(organizerPrincipal.principalURL()))))
                    yield d
                except AccessDeniedError:
                    log.err("Could not access Inbox for recipient: %s" % (recipient,))
                    err = HTTPError(ErrorResponse(responsecode.NOT_FOUND, (caldav_namespace, "recipient-permisions")))
                    responses.add(recipient, Failure(exc_value=err), reqstatus="3.8;No authority")
                    recipientsState["BAD"] += 1
                    # Process next recipient
                # Different behaviour for free-busy vs regular invite
                if freebusy:
                    # Extract the ATTENDEE property matching current recipient from the calendar data
                    cuas = principal.calendarUserAddresses()
                    attendeeProp = calendar.getAttendeeProperty(cuas)
                    # Find the current recipients calendar-free-busy-set
                    fbset = waitForDeferred(principal.calendarFreeBusyURIs(request))
                    yield fbset
                    fbset = fbset.getResult()

                    # First list is BUSY, second BUSY-TENTATIVE, third BUSY-UNAVAILABLE
                    fbinfo = ([], [], [])
                        # Process the availability property from the Inbox.
                        has_prop = waitForDeferred(inbox.hasProperty((calendarserver_namespace, "calendar-availability"), request))
                        yield has_prop
                        has_prop = has_prop.getResult()
                        if has_prop:
                            availability = waitForDeferred(inbox.readProperty((calendarserver_namespace, "calendar-availability"), request))
                            yield availability
                            availability = availability.getResult()
                            availability = availability.calendar()
                            report_common.processAvailabilityFreeBusy(availability, fbinfo, timeRange)

                        # Check to see if the recipient is the same calendar user as the organizer.
                        # Needed for masked UID stuff.
                        same_calendar_user = organizerPrincipal.principalURL() == principal.principalURL()

                        # Now process free-busy set calendars
                        matchtotal = 0
                        for calendarResourceURL in fbset:
                            calendarResource = waitForDeferred(request.locateResource(calendarResourceURL))
                            yield calendarResource
                            calendarResource = calendarResource.getResult()
                            if calendarResource is None or not calendarResource.exists() or not isCalendarCollectionResource(calendarResource):
                                # We will ignore missing calendars. If the recipient has failed to
                                # properly manage the free busy set that should not prevent us from working.
                            matchtotal = waitForDeferred(report_common.generateFreeBusyInfo(
                                excludeuid = excludeUID,
                                organizer = organizer,
                                same_calendar_user = same_calendar_user
                            yield matchtotal
                            matchtotal = matchtotal.getResult()
                        # Build VFREEBUSY iTIP reply for this recipient
                        fbresult = report_common.buildFreeBusyResult(
                            organizer = calendar.getOrganizerProperty(),
                            attendee = attendeeProp,
                            uid = calendar.resourceUID(),

                        responses.add(recipient, responsecode.OK, reqstatus="2.0;Success", calendar=fbresult)
                        recipientsState["OK"] += 1
                        log.err("Could not determine free busy information: %s" % (recipient,))
                        err = HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "recipient-permissions")))
                        responses.add(recipient, Failure(exc_value=err), reqstatus="3.8;No authority")
                        recipientsState["BAD"] += 1
                    # Hash the iCalendar data for use as the last path element of the URI path
                    name = md5.new(str(calendar) + str(time.time()) + inbox.fp.path).hexdigest() + ".ics"
                    # Get a resource for the new item
                    childURL = joinURL(inboxURL, name)
                    child = waitForDeferred(request.locateResource(childURL))
                    yield child
                    child = child.getResult()
                    # Copy calendar to inbox (doing fan-out)
                    d = waitForDeferred(
                                sourcecal = False,
                                destination = child,
                                destination_uri = childURL,
                                calendardata = str(calendar),
                                destinationparent = inbox,
                                destinationcal = True,
                                isiTIP = True
                    yield d
                        responses.add(recipient, responsecode.OK, reqstatus="2.0;Success")
                        recipientsState["OK"] += 1
                        # Store CALDAV:originator property
                        # Store CALDAV:recipient property
                        # Look for auto-schedule option
                        if principal.autoSchedule():
                            autoresponses.append((principal, inbox, child))
                        log.err("Could not store data in Inbox : %s" % (inbox,))
                        err = HTTPError(ErrorResponse(responsecode.FORBIDDEN, (caldav_namespace, "recipient-permissions")))
                        responses.add(recipient, Failure(exc_value=err), reqstatus="3.8;No authority")
                        recipientsState["BAD"] += 1

        # Now we have to do auto-respond
        if len(autoresponses) != 0:
            # First check that we have a method that we can auto-respond to
            if not itip.canAutoRespond(calendar):
                autoresponses = []
        # Now do the actual auto response
        for principal, inbox, child in autoresponses:
            # Add delayed reactor task to handle iTIP responses
            reactor.callLater(0.0, itip.handleRequest, *(request, principal, inbox, calendar.duplicate(), child)) #@UndefinedVariable
            #reactor.callInThread(itip.handleRequest, *(request, principal, inbox, calendar.duplicate(), child)) #@UndefinedVariable

        # Return with final response if we are done
        yield responses.response()

00521 class ScheduleResponseResponse (Response):
    ScheduleResponse L{Response} object.
    Renders itself as a CalDAV:schedule-response XML document.
00526     def __init__(self, xml_responses, location=None):
        @param xml_responses: an interable of davxml.Response objects.
        @param location:      the value of the location header to return in the response,
                              or None.

        Response.__init__(self, code=responsecode.OK,

        self.headers.setHeader("content-type", MimeType("text", "xml"))
        if location is not None:
            self.headers.setHeader("location", location)

00541 class ScheduleResponseQueue (object):
    Stores a list of (typically error) responses for use in a
00546     def __init__(self, method, success_response):
        @param method: the name of the method generating the queue.
        @param success_response: the response to return in lieu of a
            L{ScheduleResponse} if no responses are added to this queue.
        self.responses         = []
        self.method            = method
        self.success_response  = success_response
        self.location          = None

00557     def setLocation(self, location):
        @param location:      the value of the location header to return in the response,
                              or None.
        self.location = location

00564     def add(self, recipient, what, reqstatus=None, calendar=None):
        Add a response.
        @param recipient: the recipient for this response.
        @param what: a status code or a L{Failure} for the given recipient.
        @param status: the iTIP request-status for the given recipient.
        @param calendar: the calendar data for the given recipient response.
        if type(what) is int:
            code    = what
            error   = None
            message = responsecode.RESPONSES[code]
        elif isinstance(what, Failure):
            code    = statusForFailure(what)
            error   = errorForFailure(what)
            message = messageForFailure(what)
            raise AssertionError("Unknown data type: %r" % (what,))

        if code > 400: # Error codes only
            log.err("Error during %s for %s: %s" % (self.method, recipient, message))

        children = []
        if calendar is not None:
        if error is not None:
        if message is not None:

00597     def response(self):
        Generate a L{ScheduleResponseResponse} with the responses contained in the
        queue or, if no such responses, return the C{success_response} provided
        to L{__init__}.
        @return: the response.
        if self.responses:
            return ScheduleResponseResponse(self.responses, self.location)
            return self.success_response

Generated by  Doxygen 1.6.0   Back to index