33 #include <libical/ical.h>
34 #include <ne_session.h>
36 #include <ne_request.h>
38 #include <ne_redirect.h>
49 static void *exchangecal_load_calendar(
void *data);
50 static void *unref_exchangecal(
void *obj);
55 .description =
"MS Exchange calendars",
57 .load_calendar = exchangecal_load_calendar,
58 .unref_calendar = unref_exchangecal,
59 .write_event = exchangecal_write_event,
83 static int parse_tag(
void *data,
char *name,
char **atts,
int type)
88 if ((tmp = strchr(name,
':'))) {
98 if (!strcasecmp(state->tag,
"response")) {
101 state->in_response = 1;
106 }
else if (!strcasecmp(state->tag,
"propstat")) {
107 state->in_propstat = 1;
108 }
else if (!strcasecmp(state->tag,
"prop")) {
114 if (!strcasecmp(state->tag,
"response")) {
118 state->in_response = 0;
119 if (ast_strlen_zero(event->uid)) {
120 ast_log(LOG_ERROR,
"This event has no UID, something has gone wrong\n");
126 }
else if (!strcasecmp(state->tag,
"propstat")) {
127 state->in_propstat = 0;
128 }
else if (!strcasecmp(state->tag,
"prop")) {
140 static time_t mstime_to_time_t(
char *mstime)
144 for (read = write = mstime; *read; read++) {
150 if (*read ==
'-' || *read ==
':')
156 tt = icaltime_from_string(mstime);
157 return icaltime_as_timet(tt);
160 static enum ast_calendar_busy_state msbusy_to_bs(
const char *msbusy)
162 if (!strcasecmp(msbusy,
"FREE")) {
163 return AST_CALENDAR_BS_FREE;
164 }
else if (!strcasecmp(msbusy,
"TENTATIVE")) {
165 return AST_CALENDAR_BS_BUSY_TENTATIVE;
167 return AST_CALENDAR_BS_BUSY;
171 static int parse_cdata(
void *data,
char *value,
size_t len)
180 if (str == value + len)
186 memcpy(str, value, len);
187 if (!(state->in_response && state->in_propstat && state->in_prop)) {
193 if (!strcasecmp(state->tag,
"subject")) {
195 }
else if (!strcasecmp(state->tag,
"location")) {
197 }
else if (!strcasecmp(state->tag,
"uid")) {
199 }
else if (!strcasecmp(state->tag,
"organizer")) {
201 }
else if (!strcasecmp(state->tag,
"textdescription")) {
203 }
else if (!strcasecmp(state->tag,
"dtstart")) {
204 event->start = mstime_to_time_t(str);
205 }
else if (!strcasecmp(state->tag,
"dtend")) {
206 event->end = mstime_to_time_t(str);
207 }
else if (!strcasecmp(state->tag,
"busystatus")) {
208 event->busy_state = msbusy_to_bs(str);
209 }
else if (!strcasecmp(state->tag,
"reminderoffset")) {
212 event->alarm =
event->start - atoi(str);
219 static void exchangecal_destructor(
void *obj)
223 ast_debug(1,
"Destroying pvt for Exchange calendar %s\n", pvt->owner->
name);
225 ne_session_destroy(pvt->session);
227 ne_uri_free(&pvt->uri);
235 static void *unref_exchangecal(
void *obj)
244 static struct ast_str *generate_exchange_uuid(
struct ast_str *uid)
246 char buffer[AST_UUID_STR_LEN];
253 static int is_valid_uuid(
struct ast_str *uid)
265 static struct ast_str *xml_encode_str(
struct ast_str *dst,
const char *src)
270 for (tmp = src; *tmp; tmp++) {
273 strcpy(buf,
""");
277 strcpy(buf,
"'");
281 strcpy(buf,
"&");
293 sprintf(buf,
"%c", *tmp);
302 static struct ast_str *epoch_to_exchange_time(
struct ast_str *dst, time_t epoch)
304 icaltimezone *utc = icaltimezone_get_utc_timezone();
305 icaltimetype tt = icaltime_from_timet_with_zone(epoch, 0, utc);
310 for (i = 0; tmp[i]; i++) {
312 if (i == 3 || i == 5)
314 if (i == 10 || i == 12)
323 static struct ast_str *bs_to_exchange_bs(
struct ast_str *dst,
enum ast_calendar_busy_state bs)
326 case AST_CALENDAR_BS_BUSY:
330 case AST_CALENDAR_BS_BUSY_TENTATIVE:
341 static int fetch_response_reader(
void *data,
const char *block,
size_t len)
343 struct ast_str **response = data;
349 memcpy(tmp, block, len);
357 static int auth_credentials(
void *userdata,
const char *realm,
int attempts,
char *username,
char *secret)
362 ast_log(LOG_WARNING,
"Invalid username or password for Exchange calendar '%s'\n", pvt->owner->
name);
366 ne_strnzcpy(username, pvt->user, NE_ABUFSIZ);
367 ne_strnzcpy(secret, pvt->secret, NE_ABUFSIZ);
380 ast_log(LOG_ERROR,
"There is no private!\n");
385 ast_log(LOG_ERROR,
"Could not allocate memory for response.\n");
389 snprintf(buf,
sizeof(buf),
"%s%s", pvt->uri.path, subdir ?
ast_str_buffer(subdir) :
"");
391 req = ne_request_create(pvt->session, method, buf);
392 ne_add_response_body_reader(req, ne_accept_2xx, fetch_response_reader, &response);
394 ne_add_request_header(req,
"Content-type",
"text/xml");
396 ret = ne_request_dispatch(req);
397 ne_request_destroy(req);
400 ast_log(LOG_WARNING,
"Unknown response to CalDAV calendar %s, request %s to %s: %s\n", pvt->owner->
name, method, pvt->url, ne_get_error(pvt->session));
411 struct ast_str *response = NULL;
414 struct ast_str *summary = NULL;
415 struct ast_str *description = NULL;
416 struct ast_str *organizer = NULL;
417 struct ast_str *location = NULL;
420 struct ast_str *busystate = NULL;
424 ast_log(LOG_WARNING,
"No event passed!\n");
428 if (!(event->
start && event->
end)) {
429 ast_log(LOG_WARNING,
"The event must contain a start and an end\n");
434 ast_log(LOG_ERROR,
"Could not allocate memory for request!\n");
446 ast_log(LOG_ERROR,
"Unable to allocate memory for request values\n");
450 if (ast_strlen_zero(event->uid)) {
451 uid = generate_exchange_uuid(uid);
453 ast_str_set(&uid, AST_UUID_STR_LEN,
"%s", event->uid);
456 if (!is_valid_uuid(uid)) {
457 ast_log(LOG_WARNING,
"An invalid uid was provided, you may leave this field blank to have one generated for you\n");
461 summary = xml_encode_str(summary, event->summary);
462 description = xml_encode_str(description, event->description);
463 organizer = xml_encode_str(organizer, event->organizer);
464 location = xml_encode_str(location, event->location);
465 start = epoch_to_exchange_time(start, event->
start);
466 end = epoch_to_exchange_time(end, event->
end);
467 busystate = bs_to_exchange_bs(busystate, event->
busy_state);
470 "<?xml version=\"1.0\"?>\n"
471 "<a:propertyupdate\n"
472 " xmlns:a=\"DAV:\"\n"
473 " xmlns:e=\"http://schemas.microsoft.com/exchange/\"\n"
474 " xmlns:mapi=\"http://schemas.microsoft.com/mapi/\"\n"
475 " xmlns:mapit=\"http://schemas.microsoft.com/mapi/proptag/\"\n"
476 " xmlns:x=\"xml:\" xmlns:cal=\"urn:schemas:calendar:\"\n"
477 " xmlns:dt=\"uuid:%s/\"\n"
478 " xmlns:header=\"urn:schemas:mailheader:\"\n"
479 " xmlns:mail=\"urn:schemas:httpmail:\"\n"
483 " <a:contentclass>urn:content-classes:appointment</a:contentclass>\n"
484 " <e:outlookmessageclass>IPM.Appointment</e:outlookmessageclass>\n"
485 " <mail:subject>%s</mail:subject>\n"
486 " <mail:description>%s</mail:description>\n"
487 " <header:to>%s</header:to>\n"
488 " <cal:location>%s</cal:location>\n"
489 " <cal:dtstart dt:dt=\"dateTime.tz\">%s</cal:dtstart>\n"
490 " <cal:dtend dt:dt=\"dateTime.tz\">%s</cal:dtend>\n"
491 " <cal:instancetype dt:dt=\"int\">0</cal:instancetype>\n"
492 " <cal:busystatus>%s</cal:busystatus>\n"
493 " <cal:meetingstatus>CONFIRMED</cal:meetingstatus>\n"
494 " <cal:alldayevent dt:dt=\"boolean\">0</cal:alldayevent>\n"
495 " <cal:responserequested dt:dt=\"boolean\">0</cal:responserequested>\n"
496 " <mapi:finvited dt:dt=\"boolean\">1</mapi:finvited>\n"
499 "</a:propertyupdate>\n",
511 if ((response = exchangecal_request(event->
owner->tech_pvt,
"PROPPATCH", body, subdir))) {
518 ast_free(description);
532 static struct ast_str *exchangecal_get_events_between(
struct exchangecal_pvt *pvt, time_t start_time, time_t end_time)
534 struct ast_str *body, *response;
535 char start[80], end[80];
536 struct timeval tv = {0,};
539 tv.tv_sec = start_time;
543 tv.tv_sec = end_time;
548 ast_log(LOG_ERROR,
"Could not allocate memory for body of request!\n");
553 "<?xml version=\"1.0\"?>\n"
554 "<g:searchrequest xmlns:g=\"DAV:\">\n"
555 " <g:sql> SELECT \"urn:schemas:calendar:location\", \"urn:schemas:httpmail:subject\",\n"
556 " \"urn:schemas:calendar:dtstart\", \"urn:schemas:calendar:dtend\",\n"
557 " \"urn:schemas:calendar:busystatus\", \"urn:schemas:calendar:instancetype\",\n"
558 " \"urn:schemas:calendar:uid\", \"urn:schemas:httpmail:textdescription\",\n"
559 " \"urn:schemas:calendar:organizer\", \"urn:schemas:calendar:reminderoffset\"\n"
560 " FROM Scope('SHALLOW TRAVERSAL OF \"%s/Calendar\"')\n"
561 " WHERE NOT \"urn:schemas:calendar:instancetype\" = 1\n"
562 " AND \"DAV:contentclass\" = 'urn:content-classes:appointment'\n"
563 " AND NOT (\"urn:schemas:calendar:dtend\" < '%s'\n"
564 " OR \"urn:schemas:calendar:dtstart\" > '%s')\n"
565 " ORDER BY \"urn:schemas:calendar:dtstart\" ASC\n"
567 "</g:searchrequest>\n", pvt->url, start, end);
570 response = exchangecal_request(pvt,
"SEARCH", body, NULL);
587 end = now.tv_sec + 60 * pvt->owner->
timeframe;
588 if (!(response = exchangecal_get_events_between(pvt, start, end))) {
592 p = iks_sax_new(&state, parse_tag, parse_cdata);
600 static void *exchangecal_load_calendar(
void *void_data)
609 ast_log(LOG_ERROR,
"You must enable calendar support for res_exchangecal to load\n");
613 if (ao2_trylock(cal)) {
614 if (cal->unloading) {
615 ast_log(LOG_WARNING,
"Unloading module, load_calendar cancelled.\n");
617 ast_log(LOG_WARNING,
"Could not lock calendar, aborting!\n");
623 if (!(pvt = ao2_alloc(
sizeof(*pvt), exchangecal_destructor))) {
624 ast_log(LOG_ERROR,
"Could not allocate exchangecal_pvt structure for calendar: %s\n", cal->
name);
632 ast_log(LOG_ERROR,
"Could not allocate space for fetching events for calendar: %s\n", cal->
name);
633 pvt = unref_exchangecal(pvt);
640 ast_log(LOG_ERROR,
"Couldn't allocate string field space for calendar: %s\n", cal->
name);
641 pvt = unref_exchangecal(pvt);
647 for (v = ast_variable_browse(cfg, cal->
name); v; v = v->
next) {
648 if (!strcasecmp(v->
name,
"url")) {
650 }
else if (!strcasecmp(v->
name,
"user")) {
652 }
else if (!strcasecmp(v->
name,
"secret")) {
659 if (ast_strlen_zero(pvt->url)) {
660 ast_log(LOG_WARNING,
"No URL was specified for Exchange calendar '%s' - skipping.\n", cal->
name);
661 pvt = unref_exchangecal(pvt);
666 if (ne_uri_parse(pvt->url, &pvt->uri) || pvt->uri.host == NULL || pvt->uri.path == NULL) {
667 ast_log(LOG_WARNING,
"Could not parse url '%s' for Exchange calendar '%s' - skipping.\n", pvt->url, cal->
name);
668 pvt = unref_exchangecal(pvt);
673 if (pvt->uri.scheme == NULL) {
674 pvt->uri.scheme =
"http";
677 if (pvt->uri.port == 0) {
678 pvt->uri.port = ne_uri_defaultport(pvt->uri.scheme);
681 pvt->session = ne_session_create(pvt->uri.scheme, pvt->uri.host, pvt->uri.port);
682 ne_redirect_register(pvt->session);
683 ne_set_server_auth(pvt->session, auth_credentials, pvt);
684 if (!strcasecmp(pvt->uri.scheme,
"https")) {
685 ne_ssl_trust_default_ca(pvt->session);
690 ast_mutex_init(&refreshlock);
693 update_exchangecal(pvt);
700 struct timespec ts = {0,};
702 ts.tv_sec = tv.tv_sec + (60 * pvt->owner->
refresh);
704 ast_mutex_lock(&refreshlock);
705 while (!pvt->owner->unloading) {
706 if (ast_cond_timedwait(&pvt->owner->unload, &refreshlock, &ts) == ETIMEDOUT) {
710 ast_mutex_unlock(&refreshlock);
712 if (pvt->owner->unloading) {
713 ast_debug(10,
"Skipping refresh since we got a shutdown signal\n");
719 update_exchangecal(pvt);
725 static int load_module(
void)
736 static int unload_module(
void)
743 AST_MODULE_INFO(
ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER,
"Asterisk MS Exchange Calendar Integration",
744 .support_level = AST_MODULE_SUPPORT_EXTENDED,
746 .unload = unload_module,
748 .requires =
"res_calendar",
struct ast_variable * next
Asterisk locking-related definitions:
int ast_calendar_register(struct ast_calendar_tech *tech)
Register a new calendar technology.
Asterisk main include file. File version handling, generic pbx functions.
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
#define ao2_callback(c, flags, cb_fn, arg)
ao2_callback() is a generic function that applies cb_fn() to all objects in a container, as described below.
struct ast_tm * ast_localtime(const struct timeval *timep, struct ast_tm *p_tm, const char *zone)
Timezone-independent version of localtime_r(3).
Structure for variables, used for configurations and for channel variables.
Universally unique identifier support.
int ast_str_append(struct ast_str **buf, ssize_t max_len, const char *fmt,...)
Append to a thread local dynamic string.
enum ast_calendar_busy_state busy_state
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
#define AST_DECLARE_STRING_FIELDS(field_list)
Declare the fields needed in a structure.
int ast_str_set(struct ast_str **buf, ssize_t max_len, const char *fmt,...)
Set a dynamic string using variable arguments.
void ast_calendar_merge_events(struct ast_calendar *cal, struct ao2_container *new_events)
Add an event to the list of events for a calendar.
Configuration File Parser.
General Asterisk PBX channel definitions.
#define ast_string_field_init(x, size)
Initialize a field pool and fields.
#define ao2_ref(o, delta)
Reference/unreference an object and return the old refcount.
struct ao2_container * ast_calendar_event_container_alloc(void)
Allocate an astobj2 container for ast_calendar_event objects.
#define AST_STRING_FIELD(name)
Declare a string field.
A general API for managing calendar events with Asterisk.
static struct stasis_rest_handlers events
REST handler for /api-docs/events.json.
#define ast_malloc(len)
A wrapper for malloc()
#define ast_debug(level,...)
Log a DEBUG message.
const ast_string_field name
struct ast_uuid * ast_str_to_uuid(char *str)
Convert a string to a UUID.
struct ast_calendar_event * ast_calendar_event_alloc(struct ast_calendar *cal)
Allocate an astobj2 ast_calendar_event object.
Support for dynamic strings.
char * ast_skip_blanks(const char *str)
Gets a pointer to the first non-whitespace character in a string.
#define ast_calloc(num, len)
A wrapper for calloc()
struct ast_calendar * owner
const struct ast_config * ast_calendar_config_acquire(void)
Grab and lock pointer to the calendar config (read only)
char * ast_uuid_generate_str(char *buf, size_t size)
Generate a UUID string.
Module has failed to load, may be in an inconsistent state.
int ast_strftime(char *buf, size_t len, const char *format, const struct ast_tm *tm)
Special version of strftime(3) that handles fractions of a second. Takes the same arguments as strfti...
struct ast_calendar_event * ast_calendar_unref_event(struct ast_calendar_event *event)
Unreference an ast_calendar_event.
structure to hold users read from users.conf
#define ast_string_field_build(x, field, fmt, args...)
Set a field to a complex (built) value.
void ast_calendar_unregister(struct ast_calendar_tech *tech)
Unregister a new calendar technology.
size_t ast_str_strlen(const struct ast_str *buf)
Returns the current length of the string stored within buf.
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Individual calendaring technology data.
Asterisk calendar structure.
void ast_calendar_config_release(void)
Release the calendar config.
#define ASTERISK_GPL_KEY
The text the key() function should return.
Asterisk module definitions.
#define ast_string_field_free_memory(x)
free all memory - to be called before destroying the object
Structure for mutex and tracking information.
#define ast_str_create(init_len)
Create a malloc'ed dynamic length string.
#define ast_string_field_set(x, field, data)
Set a field to a simple string value.
#define ao2_link(container, obj)
Add an object to a container.