Интеграция — Аврора Почта

Оглавление

Интеграция с Р7-офис

Аврора Почта поддерживает интеграцию с «Р7-Офис. Сервер документов», которая позволяет редактировать офисные документы, электронные таблицы и презентации в браузере. Также интеграция позвояет просматривать вложенные файлы офисных форматов, не прибегая к внешним сервисам от Microsoft и Google.

Интеграция тестировалась с пакетом, установленным по официальной инструкции. По умолчанию, доступ к серверу защищен токеном безопасности — чтобы получить его значение, выполните следующую команду:

cat /etc/r7-office/documentserver/local.json | grep string

В выводе будет получено несколько одинаковых строк вида:

      "string": "CYcxMnj7aUe51NlbJ61Alc9i3JF4EpYg"
      "string": "CYcxMnj7aUe51NlbJ61Alc9i3JF4EpYg"
      "string": "CYcxMnj7aUe51NlbJ61Alc9i3JF4EpYg"

После того, как пакет был установлен, отредактируйте конфигурационный файл Авроры data/settings/modules/OfficeDocumentEditor.config.json и установите значение «Disabled» в true, в поле «DocumentServerUrl» укажите URL сервера документов, а в поле «Secret» — значение токена безопасности, полученное выше.

Для того, чтобы использовать интеграцию с сервером документов для просмотра вложенных файлов, выставьте «Disabled» в true в файле data/settings/modules/OfficeDocumentViewer.config.json.

Интеграция с Rocket.Chat

Для добавления чата в Аврора Почту, доступна интеграция с бесплатным opensource решением Rocket.Chat.

Установка Rocket.Chat

Устанавливается продукт по стандартной инструккции; предварительно убедитесь, что ваш сервер соответствуеет минимальным требованиям.

Rocket.Chat не обеспечивает поддержку https непосредственно, мы рекомендуем использовать nginx в качестве reverse proxy. Вы можете использовать существующий SSL-сертификат или создать новый при помощи Let’s Encrypt — в этом случае, настройки nginx будут выглядеть примерно следующим образом:

    ssl_certificate /etc/letsencrypt/live/chat.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/chat.yourdomain.com/privkey.pem;

Чтобы обеспечить перенаправление с http на https, в конфигурацию nginx добавляется следующий блок:

server {
    listen 80;
    server_name _;
    return 301 https://$host$request_uri;
}

Как работает интеграция

После того, как интегррация настроена (см.ниже), пользователи в Rocket.Chat будут создаваться автоматически. Для авторизации используются те же email и пароль, что и для входа в почту. Имя пользователя в чате — это, по умолчанию, часть адреса email до символа «@» и первое слово из доменного имени после «@» — разделенные точкой. Например, адресу myname@thedomain.ru будет соответствовать имя пользователя myname.thedomain .

Это поведение настраивается изменением параметра «ChatUsernameFormat» в файле data/settings/modules/RocketChatWebclient.config.json:

0 — имя пользователя совпадает с частью адреса до символа «@», например адресу myname@thedomain.ru соответствует имя пользователя myname;
1 (штатное поведение) — часть адреса email до символа «@» и первое слово из доменного имени после «@» — разделенные точкой. Например, пользователь myname.thedomain для адреса myname@thedomain.ru;l
2 — имя пользователя совпадает с адресом email, но «@» заменяется точкой, например имя myname.thedomain.ru для адреса myname@thedomain.ru.

Настройка интеграции

Прежде всего, выставьте «Disabled» в false в файле data/settings/modules/RocketChatWebclient.config.json. После этого вы сможете указать адрес инсталляции, логин и пароль администратора в админпанели Авроры (пароль сохраняется в зашифрованном виде, так что указать его в файле вручную не удастся).

После того, как основные настройки сохранены, необходимо обновить системные настройки Rocket.Chat и, по желанию, применить ряд визуальных настроек для более комфортной интеграции — для этого в админпанели также есть соответствующие кнопки.