AlterOffice-cloud — различия между версиями

Материал из Wiki AlterOS
Перейти к: навигация, поиск
(Новая страница: « == Главная страница посвященная проекту AlterOffice == #Сайт продукта [https://alteroffice.ru[https://alteroffice.r…»)
 
 
(не показано 45 промежуточных версий 6 участников)
Строка 13: Строка 13:
 
<!-- thumb| -->
 
<!-- thumb| -->
 
[[Файл:AlterOffice_Cloud.png|200px| Схема развёртывание облачного офиса и файлового хранилища.]]
 
[[Файл:AlterOffice_Cloud.png|200px| Схема развёртывание облачного офиса и файлового хранилища.]]
 +
 +
== Условные обозначения: ==
 +
 +
*'''web.alteroffice.ru'''  - домен на котором будет работать облачный офис,к которому будут обращаться пользователи
 +
*'''editors.alteroffice.ru''' - домен на котором будет работать часть отвечающая за онлайн-редакторы AlterOffice
 
* Прокси - Nginx  
 
* Прокси - Nginx  
* Server 1 - editor
+
* Server 1 - web (AlterOS Server)
* Server 2 - cloud
+
* Server 2 - editors (AlterOS Server)
 +
 
 +
== Развертывание облачного офиса: ==
 +
 
 +
=== Nginx ===
 +
 
 +
Для работы по протоколу https используется reverse-proxy [https://nginx.org/ nginx]
 +
 
 +
Пример настроек:
 +
[[Настройка_nginx_conf_в_качестве_reverse_proxy_для_облачного_офиса]]
 +
 
 +
''При этом в данном примере использованы сертификаты letsencrypt полученные с помощью certbot.''
 +
 
  
=== Развертывание облачного офиса: ===
+
=== Server1: ===
 +
Установить на виртуальную или физическую машину ОС AlterOS в конфигурации Server с GUI. Добавить пользователей с правами SUDO и дальнейшие действия производятся от этого пользователя.
  
==== Server1: ====
+
Выполнить команду подключения репозиториев для облачного офиса, для чего открыть терминал и последовательно выполнить команды:
  docker load < alteroffice.docker.tar
+
  repo_name="AlterOffice-cloud"; repo_url="http://repo.alter-os.ru/alteroffice-web/x86_64/"; echo -e "[$repo_name]\nname=$repo_name\nbaseurl=${repo_url}\nenabled=1\ngpgcheck=0\n" | sudo tee -a /etc/yum.repos.d/$repo_name.repo;
+
 
# Запуск
+
sudo yum install web-alteroffice-ru-install
+
 
sudo docker run --name office1 -t -d -p 9980:9980 -e 'DONT_GEN_SSL_CERT=true' -e 'extra_params=-o:ssl.enable=false' -e 'domain=web7\\.alteroffice\\.ru' --restart always --cap-add MKNOD cff01d
+
  sudo web-alteroffice-ru-install.sh
  sudo docker exec -it office1 /bin/bash
 
  
==== Server2: ====
+
  sudo yum install web-alteroffice-ru
repo_name="AlterOffice-cloud"; repo_url="http://repo.alter-os.ru/alteroffice-web/x86_64/"; echo -e "[$repo_name]\nname=$repo_name\nbaseurl=${repo_url}\nenabled=1\n" | sudo tee -a /etc/yum.repos.d/$repo_name.repo;
 
  sudo yum install alteroffice-web-install
 
sudo alteroffice-web-install
 
  
=== Настройка облачного офиса: ===
 
  
==== Nginx ====
+
Если у Вас активирован SELinux, или дополнительные настройки системы не производились - необходимо выполнить еще следующие команды:
  
Для работы по протоколу https используется reverse-proxy [https://nginx.org/ nginx]
+
sudo ausearch -c 'httpd' --raw | sudo audit2allow -M my-httpd
  
Пример настроек:
+
  sudo semodule -i my-httpd.pp
  /nas/Parkhomenko/web_alteroffice/RPMS/conf.zip
 
  
==== Server1: ====
+
sudo systemctl restart httpd
  
Настройки '''loolwsd.xml'''
 
  
<host desc="Regex pattern of hostname to allow or deny." allow="true">web\.alteroffice\.ru</host>
+
перейти по адресу в браузере http://localhost/alteroffice и закончить работу установщика.  
...
+
[[Файл:Cloud-init-setup.png|600px|thumb|none|Инициализация настроек]]
<ssl desc="SSL settings">
 
            <enable type="bool" desc="Controls whether SSL encryption between storage and loolwsd is enabled. Defaults when empty to following the ssl.enable setting">false</enable>
 
  
==== Server2: ====
+
''Пароль пользователя базы данных необходимо указать "password". Если требуется в дальнейшем его изменить, то необходимо изменить его в MySQL и затем в конфигурационном файле.''
  
Строки для добавления в файл настроек '''config/config.php'''
 
  
  'overwriteprotocol' => 'https',
 
  'overwrite.cli.url' => 'https://web7.alteroffice.ru/alteroffice',
 
 
 
  # для тестирования может быть полезным отключение функции защиты от перебора паролей
 
  'auth.bruteforce.protection.enabled' => false,
 
  
 
==== Apache ====
 
==== Apache ====
  
 +
После установки AlterOffice облако автоматически устанавливается на адрес http://<server_addr>/alteroffice
 
Облачный AlterOffice гибко настраивается, может работать на виртуальном хосте.
 
Облачный AlterOffice гибко настраивается, может работать на виртуальном хосте.
Если Вы хотите сделать редирект из корневой папки сервера на виртуальный хост, то в корневой папке необходимо добавить строки в '''.htaccess'''
+
Если Вы хотите сделать редирект из корневой папки сервера на виртуальный хост, то в корневой папке можно добавить строки в '''.htaccess'''
  
 
  RewriteEngine On
 
  RewriteEngine On
Строка 70: Строка 74:
  
  
=== Интеграция LDAP ===
+
==== Интеграция LDAP ====
  
 
Есть возможность администраторам подключать AlterOffice к каталогу пользователей на основе LDAP для аутентификации и подготовки пользователей, групп и пользовательских атрибутов. Администраторы могут настроить это приложение для подключения к одному или нескольким каталогам LDAP или Active Directory через интерфейс LDAP. Такие атрибуты, как пользовательская квота, электронная почта, изображения аватаров, членство в группах и т. д., Можно загружать в AlterOffice из каталога с соответствующими запросами и фильтрами.
 
Есть возможность администраторам подключать AlterOffice к каталогу пользователей на основе LDAP для аутентификации и подготовки пользователей, групп и пользовательских атрибутов. Администраторы могут настроить это приложение для подключения к одному или нескольким каталогам LDAP или Active Directory через интерфейс LDAP. Такие атрибуты, как пользовательская квота, электронная почта, изображения аватаров, членство в группах и т. д., Можно загружать в AlterOffice из каталога с соответствующими запросами и фильтрами.
Строка 76: Строка 80:
 
Пользователь входит в AlterOffice со своими учетными данными LDAP или AD, и ему предоставляется доступ на основе запроса аутентификации, обрабатываемого сервером LDAP или AD. AlterOffice не хранит пароли LDAP или AD, скорее эти учетные данные используются для аутентификации пользователя, а затем AlterOffice использует сеанс для идентификатора пользователя.
 
Пользователь входит в AlterOffice со своими учетными данными LDAP или AD, и ему предоставляется доступ на основе запроса аутентификации, обрабатываемого сервером LDAP или AD. AlterOffice не хранит пароли LDAP или AD, скорее эти учетные данные используются для аутентификации пользователя, а затем AlterOffice использует сеанс для идентификатора пользователя.
  
==== Интеграция LDAP ====
 
  
 
1. Установить php-ldap
 
1. Установить php-ldap
Строка 85: Строка 88:
  
  
[[Файл:Integration_LDAP.png|400px|thumb|left|Интеграция LDAP]]
+
[[Файл:Integration_LDAP.png|400px|thumb|none|Интеграция LDAP]]
 +
 
 +
 +
 
 +
=== Server2: ===
 +
 
 +
[[Подготовка_виртуальной_машины_AlterOffice_editors]]
 +
 
 +
 
 +
== Дополнительная настройка облачного офиса: ==
 +
 
 +
 
 +
=== Server1: ===
 +
 
 +
Для принудительного включения перехода на протокол https необходимо внести строки в файл настроек '''config/config.php'''  (/var/www/alteroffice)
 +
 
 +
  'overwriteprotocol' => 'https',
 +
  'overwrite.cli.url' => 'https://web.alteroffice.ru/alteroffice',
 +
 
 +
  # для тестирования может быть полезным отключение функции защиты от перебора паролей
 +
  'auth.bruteforce.protection.enabled' => false,
 +
 
 +
 
 +
=== Server2: ===
 +
 
 +
Выполнить Шаг 9 из руководства [[Подготовка_виртуальной_машины_AlterOffice_editors]]
 +
 
 +
Запустить редактор nano в открывшемся приглашении bash:
 +
nano /etc/loolwsd/loolwsd.xml
 +
 
 +
В файле  '''loolwsd.xml''' убедится в корректности настройки сервера с которого разрешены обращения к редакторам:
 +
 
 +
<host desc="Regex pattern of hostname to allow or deny." allow="true">web\.alteroffice\.ru</host>
 +
 
 +
Отключение опции шифрования между редактором и облачной частью
 +
<ssl desc="SSL settings">
 +
            <enable type="bool" desc="Controls whether SSL encryption between storage and loolwsd is enabled. Defaults when empty to following the ssl.enable setting">false</enable>
 +
 
 +
А так же, т.к. в нашем случае работа осуществляется через reverse-proxy поэтому опция "Connection via proxy where loolwsd acts as working via https" устанавливаем в "true"
 +
 
 +
<termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">true</termination>
 +
 
 +
В случае отличий в настройках, необходимо изменить файл и записать изменения в него. После внесения изменений процесс облачных редакторов завершится, для его перезапуска выполните перезапуск контейнера или перезагрузку виртуальной машины с докером.
 +
 
 +
== Подключение редакторов AlterOffice и дополнений ==
 +
 
 +
[[Файл:AlterOffice-cloud-Right.png|600px|thumb|none|1. Выбираем Приложения]]
 +
[[Файл:AlterOffice-cloud-App.png|600px|thumb|none|2. Включаем AlterOffice облако]]
 +
[[Файл:AlterOffice-cloud-Right.png|600px|thumb|none|3. Выбираем Настройки]]
 +
[[Файл:AlterOffice-cloud-UserSettings.png|600px|thumb|none|4. В меню слева Администрирование > AlterOfficeOnline]]
 +
[[Файл:AlterOffice-cloud-Server.png|600px|thumb|none|5. Настраиваем адрес сервера документов. Если указан адрес вида http://example.com:9980, отключаем проверку сертификатов.]]
 +
 
 +
== Советы и хитрости ==
 +
#[[Загрузка больших файлов в AlterOffice-cloud]]
 +
 
 +
[[Категория:AlterOffice]]

Текущая версия на 15:08, 1 апреля 2024

Главная страница посвященная проекту AlterOffice

  1. Сайт продукта [https://alteroffice.ru]
  2. Инструкции по продукту: [[1]]
  3. Курс по офисному пакету [[2]]

Облачный офис

Облачный AlterOffice - многокомпонентный масштабируемый продукт. Ниже представлен пример развёртывание облачного офиса и файлового хранилища.

Схема развёртывание облачного офиса и файлового хранилища.

Условные обозначения:

  • web.alteroffice.ru - домен на котором будет работать облачный офис,к которому будут обращаться пользователи
  • editors.alteroffice.ru - домен на котором будет работать часть отвечающая за онлайн-редакторы AlterOffice
  • Прокси - Nginx
  • Server 1 - web (AlterOS Server)
  • Server 2 - editors (AlterOS Server)

Развертывание облачного офиса:

Nginx

Для работы по протоколу https используется reverse-proxy nginx

Пример настроек:

Настройка_nginx_conf_в_качестве_reverse_proxy_для_облачного_офиса

При этом в данном примере использованы сертификаты letsencrypt полученные с помощью certbot.


Server1:

Установить на виртуальную или физическую машину ОС AlterOS в конфигурации Server с GUI. Добавить пользователей с правами SUDO и дальнейшие действия производятся от этого пользователя.

Выполнить команду подключения репозиториев для облачного офиса, для чего открыть терминал и последовательно выполнить команды:

repo_name="AlterOffice-cloud"; repo_url="http://repo.alter-os.ru/alteroffice-web/x86_64/"; echo -e "[$repo_name]\nname=$repo_name\nbaseurl=${repo_url}\nenabled=1\ngpgcheck=0\n" | sudo tee -a /etc/yum.repos.d/$repo_name.repo;
sudo yum install web-alteroffice-ru-install
sudo web-alteroffice-ru-install.sh
sudo yum install web-alteroffice-ru


Если у Вас активирован SELinux, или дополнительные настройки системы не производились - необходимо выполнить еще следующие команды:

sudo ausearch -c 'httpd' --raw | sudo audit2allow -M my-httpd
sudo semodule -i my-httpd.pp
sudo systemctl restart httpd


перейти по адресу в браузере http://localhost/alteroffice и закончить работу установщика.

Инициализация настроек

Пароль пользователя базы данных необходимо указать "password". Если требуется в дальнейшем его изменить, то необходимо изменить его в MySQL и затем в конфигурационном файле.


Apache

После установки AlterOffice облако автоматически устанавливается на адрес http://<server_addr>/alteroffice Облачный AlterOffice гибко настраивается, может работать на виртуальном хосте. Если Вы хотите сделать редирект из корневой папки сервера на виртуальный хост, то в корневой папке можно добавить строки в .htaccess

RewriteEngine On
RewriteCond %{SERVER_PORT} !^443$
RewriteRule .* https://%{SERVER_NAME}/alteroffice%{REQUEST_URI} [R=301,L]


Интеграция LDAP

Есть возможность администраторам подключать AlterOffice к каталогу пользователей на основе LDAP для аутентификации и подготовки пользователей, групп и пользовательских атрибутов. Администраторы могут настроить это приложение для подключения к одному или нескольким каталогам LDAP или Active Directory через интерфейс LDAP. Такие атрибуты, как пользовательская квота, электронная почта, изображения аватаров, членство в группах и т. д., Можно загружать в AlterOffice из каталога с соответствующими запросами и фильтрами.

Пользователь входит в AlterOffice со своими учетными данными LDAP или AD, и ему предоставляется доступ на основе запроса аутентификации, обрабатываемого сервером LDAP или AD. AlterOffice не хранит пароли LDAP или AD, скорее эти учетные данные используются для аутентификации пользователя, а затем AlterOffice использует сеанс для идентификатора пользователя.


1. Установить php-ldap

2. Включить приложение "Интерфейс пользователей и групп LDAP"

3. Настроить интеграцию


Интеграция LDAP


Server2:

Подготовка_виртуальной_машины_AlterOffice_editors


Дополнительная настройка облачного офиса:

Server1:

Для принудительного включения перехода на протокол https необходимо внести строки в файл настроек config/config.php (/var/www/alteroffice)

 'overwriteprotocol' => 'https',
 'overwrite.cli.url' => 'https://web.alteroffice.ru/alteroffice',
 
 # для тестирования может быть полезным отключение функции защиты от перебора паролей
 'auth.bruteforce.protection.enabled' => false,


Server2:

Выполнить Шаг 9 из руководства Подготовка_виртуальной_машины_AlterOffice_editors

Запустить редактор nano в открывшемся приглашении bash:

nano /etc/loolwsd/loolwsd.xml

В файле loolwsd.xml убедится в корректности настройки сервера с которого разрешены обращения к редакторам:

<host desc="Regex pattern of hostname to allow or deny." allow="true">web\.alteroffice\.ru</host>

Отключение опции шифрования между редактором и облачной частью

<ssl desc="SSL settings">
           <enable type="bool" desc="Controls whether SSL encryption between storage and loolwsd is enabled. Defaults when empty to following the ssl.enable setting">false</enable>

А так же, т.к. в нашем случае работа осуществляется через reverse-proxy поэтому опция "Connection via proxy where loolwsd acts as working via https" устанавливаем в "true"

<termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">true</termination>

В случае отличий в настройках, необходимо изменить файл и записать изменения в него. После внесения изменений процесс облачных редакторов завершится, для его перезапуска выполните перезапуск контейнера или перезагрузку виртуальной машины с докером.

Подключение редакторов AlterOffice и дополнений

1. Выбираем Приложения
2. Включаем AlterOffice облако
3. Выбираем Настройки
4. В меню слева Администрирование > AlterOfficeOnline
5. Настраиваем адрес сервера документов. Если указан адрес вида http://example.com:9980, отключаем проверку сертификатов.

Советы и хитрости

  1. Загрузка больших файлов в AlterOffice-cloud