CommuniGate Pro
Версия 6.4
 

Модуль WebDAV

Протокол WebDAV является расширением протокола HTTP. Многие клиенты используют его для управления различными наборами данных.
Модуль WebDAV CommuniGate Pro реализует аутентифицированный доступ к Хранилищу файлов Пользователя, Календарям, Заданиям и Папкам с Контактами.

В CommuniGate Pro поддержка WebDAV реализована в Модуле HTTP User, и настройки этого Модуль применяются и к функциям WebDAV.




Корневой элемент

Компонента WebDAV поддерживает "Корневой элемент" с доступом только на чтение через следующие URL:
http://serverName[:port]/
или
https://serverName[:port]/
где port является портом Модуля HTTP User (по умолчанию - 8100, 9100).

Клиенты WebDAV (CalDAV, CardDAV и т.д.) могут быть настроены для использования этого Корневого элемента. Они смогут извлечь свойства Корневого элемента, которые направят их на другие URL (разделы), реализующие соответствующие протоколы.

Настройка Корневого элемента Модуля DAV

Протокол WebDAV использует в качестве транспорта протокол HTTP, реализуемый модулем HTTPU. Откройте установки Модуля HTTPU и найдите раздел Доп. протоколов:

Доп. протоколы
 ДоступУровень Журнала
RootDAV:

Используйте настройку Уровень Журнала для указания, какую информацию Модуль WebDAV должен сохранять в Журнале работы Сервера.
Записи, помещённые Корневым элементом модуля WebDAV в журнал работы Сервера, имеют пометку RootDAV.

Установка Доступ определяет, клиенты из каких сетей имеют доступ к услуге RootDAV.


Основные Элементы

Протокол WebDAV и основанные на нём протоколы позволяют Пользователям обращаться к ресурсам других Пользователей, если им были даны соответствующие права.
Для поддержки ACL (Списков Прав Доступа) в WebDAV, у каждого Пользователя CommuniGate Pro есть уникальный URL, с помощью которого этого Пользователя можно представить в Списках Прав Доступа. Такими URL являются:
http://servername[:port]/UserDAV/accountName@domainName
или
https://servername[:port]/UserDAV/accountName@domainName/
где port - порт Модуля HTTP User (по умолчанию - 8100, 9100).

Настройка Основных элементов Модуля DAV

Протокол WebDAV использует в качестве транспорта протокол HTTP, реализуемый модулем HTTPU. Откройте установки Модуля HTTPU и найдите раздел Доп. протоколов:

Доп. протоколы
 ДоступУровень Журнала
UserDAV:

Используйте настройку Уровень Журнала для указания, какую информацию Модуль WebDAV должен сохранять в Журнале работы Сервера.
Записи, помещённые Основными элементами модуля WebDAV в журнал работы Сервера, имеют пометку UserDAV.

Установка Доступ определяет, клиенты из каких сетей имеют доступ к услуге Основных элементов WebDAV.


Доступ к файлам

Сервер CommuniGate Pro реализует доступ к Хранилищу файлов Пользователя по протоколу WebDAB (FileDAV).

Все запросы FileDAV должны быть аутентифицированным: пользователь должен ввести своё имя и пароль. У указанного Пользователя и в его Домене Услуга WebSite должна быть включена.

"Корневой элемент" Хранилища файлов Пользователя доступен через следующие URL:
http://servername[:port]/WebDAV/
или
https://servername[:port]/WebDAV/
где port является портом Модуля HTTP User (по умолчанию - 8100, 9100).

Для доступа к Хранилищу файлов другого Пользователя должен быть использован следующий URL:


http://servername[:port]/WebDAV/~accountName/
or
https://servername[:port]/WebDAV/~accountName/
где port является портом Модуля HTTP User (по умолчанию - 8100, 9100), а accountName - имя Пользователя, к чьим файлам осуществляется доступ. Если этот Пользователь находится в другом домене, используйте полное имя в виде accountName@domainName.

Настройка Модуля FileDAV

Протокол WebDAV использует в качестве транспорта протокол HTTP, реализуемый модулем HTTPU. Откройте установки Модуля HTTPU и найдите раздел Доп. протоколов:

Доп. протоколы
 ДоступУровень Журнала
FileDAV:

Используйте настройку Уровень Журнала для указания, какую информацию Модуль проверки орфографии должен сохранять в Журнале работы Сервера.
Записи, помещённые модулем Доступа к Файлам по WebDAV в Журнал работы Сервера, имеют пометку FileDAV.

Установка Доступ определяет, клиенты из каких сетей имеют доступ к услуге FileDAV.


CalDAV

Сервер CommuniGate Pro поддерживает протокол CalDAV, расширение протокола WebDAV.

Этот протокол позволяет клиентам CalDAV читать и изменять данные Календаря Пользователя и его Задания, хранящиеся на Сервере.

Полноценный клиент CalDAV способен самостоятельно определить URL для операций по протоколу CalDAV, если его настроить на обращение к Корневому элементу:
http://serverName[:port]/
или
https://serverName[:port]/
где port является портом Модуля HTTP User (по умолчанию - 8100, 9100).

Если клиент CalDAV не может определить URL для работы по протоколу CalDAV, его надо задать явно:

http://servername:port/CalDAV/
https://servername:port/CalDAV/

Некоторые клиенты можно настроить для доступа только к определённому Календарю или набору заданий. Для доступа к любой из Папок, содержащих данные Календаря или Задания, может использоваться следующие URL:

http://servername:port/CalDAV/mailboxName/
https://servername:port/CalDAV/mailboxName/

Если mailboxName заканчивается расширением имени файла ics, то Сервер удаляет это расширение.

Все запросы данных CalDAV должны быть аутентифицированными: пользователь должен ввести своё имя и пароль. У указанного Пользователя и в его Домене Услуга WebCal должна быть включена.

Если Имя Домена пользователя или Псевдоним имени домена - mail.company.com, номер порта HTTP User - 80, а имя Папки - Calendar, то, в таком случае, для доступа будет использоваться URL

http://mail.company.com/CalDAV/Calendar
или
https://mail.company.com/CalDAV/Calendar.ics

Таким образом может осуществляться доступ к любой Папке, имеющей тип Календарь или Задания. Для доступа к Папке другого Пользователя должно быть указано полное имя Папки:

http://mail.company.com/CalDAV/~username/Calendar/
Аутентифицированный пользователь должен иметь соответствующие права доступа на чтение и/или изменение данных в Папках, принадлежащих другим пользователям.

Модуль CalDAV проверяет Подписку на Папки Пользователя для создания списка доступных папок-Календарей других Пользователей.

Модуль CalDAV сохраняет приложения к объектам в Календарях и Заданиях в Хранилище файлов Пользователя, в директории private/caldav/.

Настройка Модуля CalDAV

Протокол CalDAV использует в качестве транспорта протокол HTTP, реализуемый модулем HTTPU. Откройте установки Модуля HTTPU и найдите раздел Доп. протоколов:

Доп. протоколы
 ДоступУровень Журнала
CalDAV:

Используйте настройку Уровень Журнала для указания, какую информацию Модуль проверки орфографии должен сохранять в Журнале работы Сервера.
Записи, помещённые модулем CalDAV в журнал работы Сервера, имеют пометку CalDAV.

Установка Доступ определяет, клиенты из каких сетей имеют доступ к услуге CalDAV.

Использование метода Публикация/Подписка (ICS)

В Модуле HTTP User CommuniGate Pro реализован также старый, применявшийся до CalDAV, метод работы с данными в Папках Календарь и Задания.
Модуль позволяет клиентским приложениям получать данные используя формат iCalendar. Эта операция часто называется подписыванием на данные Календаря.
Модуль также позволяет клиентским приложениям перезаписывать содержимое Папки в формате iCalendar (публиковать данные Календаря).

Для получения доступа к данным Календаря используется следующий URL:

http://servername:port/CalendarData/mailboxName
https://servername:port/CalendarData/mailboxName
где port является одним из номеров портов модуля HTTP User (по умолчанию 8100 и 9100).
Если mailboxName заканчивается расширением имени файла ics, то Сервер удаляет это расширение.
Если mailboxName отсутствует, то Сервер использует имя Календаря По Умолчанию.

Все запросы данных Календаря должны быть аутентифицированным: пользователь должен ввести своё имя и пароль. У Пользователя и в Домене должна быть включена услуга WebCal.

Если Имя Домена пользователя или Псевдоним имени домена - mail.company.com, номер порта HTTP User - 80, а имя Папки - Calendar, то, в таком случае, для доступа будет использоваться URL
http://mail.company.com/CalendarData/Calendar
или
http://mail.company.com/CalendarData/Calendar.ics

Таким образом может осуществляться доступ к любой Папке, имеющей тип Календарь или Задания. Для доступа к Папке другого Пользователя должно быть указано полное имя Папки:

http://mail.company.com/CalendarData/~username/Calendar.ics
Аутентифицированный пользователь должен иметь соответствующие права доступа на чтение и/или изменение данных в Папках, принадлежащих другим пользователям.

Модуль HTTP поддерживает следующие HTTP операции для раздела /CalendarData/:

  • GET/HEAD: Папка разбирается и все элементы данных, в которых содержится информация в формате iCalendar, возвращаются в виде объекта VCALENDAR, имеющего элементы VEVENT и VTODO. Если Папка является чужой, то аутентифицированный пользователь должен иметь право доступа Входить для этой папки.
  • DELETE: Папка разбирается и все элементы данных, в которых содержится информация в формате iCalendar, удаляются. Если Папка является чужой, то аутентифицированный пользователь должен иметь право доступа Удалить для этой Папки.
  • PUT: тело HTTP запроса разбирается как объект VCALENDAR. Все обнаруженные элементы VEVENT и VTODO добавляются в Папку как отдельные элементы. Если разбор какого-либо элемента закончился неудачно, то никаких элементов не добавляется. Если Папка является чужой, то аутентифицированный пользователь должен иметь права доступа Добавить для этой папки.

Некоторыми приложениями не поддерживается метод DELETE. Такие приложения предполагают, что операция PUT удаляет всю существовавшую ранее информацию в Папке Календарь.
Для того, чтобы обеспечить совместимость с такими приложениями, используйте раздел CalendarDataDel вместо раздела CalendarData или включите в URL параметр DeleteAll="1".
В этом случае, каждой операции PUT будет предшествовать виртуальная операция DELETE, удаляющая все существующие элементы iCalendar из папки.


CardDAV

Сервер CommuniGate Pro поддерживает протокол CardDAV, расширение протокола WebDAV.

Этот протокол позволяет клиентам CardDAV читать и изменять данные Контактов Пользователя, хранящиеся на Сервере.

Полноценный клиент CardDAV способен самостоятельно определить URL для операций по протоколу CardDAV, если его настроить на обращение к Корневому элементу:
http://serverName[:port]/
или
https://serverName[:port]/
где port является портом Модуля HTTP User (по умолчанию - 8100, 9100).

Если клиент CardDAV не может определить URL для работы по протоколу CardDAV, его надо задать явно:

http://servername:port/CardDAV/
https://servername:port/CardDAV/

Некоторые клиенты можно настроить для доступа только к определённой папке с Контактами. Для доступа к любой из Папок с Контактами может использоваться следующий URL:

http://servername:port/CardDAV/mailboxName/
https://servername:port/CardDAV/mailboxName/

Если mailboxName заканчивается расширением имени файла vcf, то Сервер удаляет это расширение.

Все запросы данных Контактов должны быть аутентифицированным: пользователь должен ввести своё имя и пароль. У указанного Пользователя и в его Домене Услуга WebSite должна быть включена.

Если Имя Домена пользователя или Псевдоним имени домена - mail.company.com, номер порта HTTP User - 80, а имя Папки - Contacts, то, в таком случае, для доступа будет использоваться URL

http://mail.company.com/CardDAV/Contacts
или
https://mail.company.com/CardDAV/Contacts.vcf

Таким образом может осуществляться доступ к любой Папке с Контактами. Для доступа к Папке другого Пользователя должно быть указано полное имя Папки:

http://mail.company.com/CardDAV/~username/Contacts/
Аутентифицированный пользователь должен иметь соответствующие права доступа на чтение и/или изменение данных в Папках, принадлежащих другим пользователям.

Модуль CardDAV проверяет Подписку на Папки Пользователя для создания списка доступных папок с Контактами других Пользователей.

Настройка модуля CardDAV

Протокол CardDAV использует в качестве транспорта протокол HTTP, реализуемый модулем HTTPU. Откройте установки Модуля HTTPU и найдите раздел Доп. протоколов:

Доп. протоколы
 ДоступУровень Журнала
CardDAV:

Используйте настройку Уровень Журнала для указания, какую информацию Модуль проверки орфографии должен сохранять в Журнале работы Сервера.
Записи, помещённые модулем CardDAV в журнал работы Сервера, имеют пометку CardDAV.

Установка Доступ определяет, клиенты из каких сетей имеют доступ к услуге CardDAV.


Руководство CommuniGate Pro. Copyright © 2020-2023, АО СталкерСофт