Статьи с тэгом :
Закрыть
История изменений
Закрыть

Как интегрировать Hosting Edition с платежным модулем ISP BillManager

Введение

Несомненным преимуществом продукта Hosting Edition является возможность интегрироваться в схему работы хостинг-провайдера с минимальным количеством затрат.

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

Системные требования

Для полноценного развертывания системы Вам необходимо выполнить следующие требования:

  1. Серверная нагрузка
    • Сервер не ниже 6-core CPU и 8 GB RAM с установленной Windows Server 2012 для установки на нем продукта Hosting Edition
    • Сервер с 4-core CPU и 6 GB RAM с установленной Ubuntu LTS 14.04 или CentOS 7 для установки отдельно работающего сервиса Document Server
    • Сервер с 2-core CPU и 4 GB RAM с установленной CentOS 7 (рекомендуется) или Ubuntu LTS 14.04 для установки биллинговой системы ISP BillManager

    Все сервера должны иметь доступ к сети, выделенный внешний IP адрес и следующие открытые порты:

    • 80
    • 443
    • Windows - 3389 (для доступа по протоколу RDP)
    • Unix - 22 (для доступа по SSH)

    Ширина интернет-канала - 500-750 Mb/s

  2. Конфигурационные требования
    • Wildcard A-Запись следующего вида: Windows Server 2012 IP <> *.domainname.com

      domainname.com - домен второго уровня, планируемый для всех порталов.

      • portal1.domainname.com - имя первого портала
      • portal2.domainname.com - имя второго портала

      Имя портала (вместо portal1 и portal2) выбирается конечным пользователем в процессе создания портала в интерфейсе ISP BillManager.

  3. Требования к безопасности
    • Wildcard SSL-сертификат для доменного имени, которое будет использоваться.
      Наличие сертификата не является обязательным при установке на тестовый стенд, но является обязательным при запуске продукта в продажу.
  4. Доступ
    • Доступ на сервера осуществляется по заранее обговоренным условиям по протоколу RDP для Windows Server 2012 и по SSH для Ubuntu/CentOS серверов.
    • Все сервера с компонентами продукта, находящиеся в локальной сети, должны иметь доступ друг к другу.
  5. Установка и конфигурация Hosting Edition

    Установка и конфигурация всех компонентов продукта Hosting Edition производится силами сотрудников технической поддержки компании ONLYOFFICE при условии соблюдения всех требований (пункты 1-4, изложенные выше).

  6. Интеграция с системой продаж ISP BillManager

    Процесс интеграции описывается в следующем разделе.

Инструкции по интеграции

Для интеграции платежной системы ISP BillManager и продукта Hosting Edition потребуются:

  1. Уже установленная версия ISP BillManager. Для установки можно воспользоваться следующей инструкцией.

    Для доступа под аккаунтом администратора в web-интерфейс ISP BillManager используются логин-пароль учетной записи root сервера с установленной CentOS.

  2. Доступ на сервер с установленным ISP BillManager.
    Если curl и libxml2 (утилита xmllint) не установлены на этом сервере, потребуется также установить эти пакеты. Для Debian jessie требуются пакеты curl и libxml2-utils.
  3. Файл обработчика ONLYOFFICE Hosting Edition for ISP (Высылается по запросу).

Действия, необходимые для интеграции продукта:

  1. Разархивируйте следующие файлы и поместите их в указанные папки:
    • поместите файл billmgr_mod_pmonlyoffice.xml в папку /usr/local/mgr5/etc/xml
    • поместите файл pmonlyoffice.sh в папку /usr/local/mgr5/processing
    • поместите файл addononlyoffice.sh в папку /usr/local/mgr5/addon
    • поместите картинку onlyoffice_48x48.png в папку /usr/local/mgr5/skins/common/img/
      Файлы должны быть распакованы на сервере с ISP BillManager, иначе (если архив был распакован в среде Windows) после копирования .sh файлов необходимо выполнить скрипт:
      sed -i 's/\r$//' /usr/local/mgr5/processing/pmonlyoffice.sh
      sed -i 's/\r$//' /usr/local/mgr5/addon/addononlyoffice.sh

      На файлы pmonlyoffice.sh и addononlyoffice.sh необходимо выставить права '777'.

  2. Перезапустите сервис:
    /usr/local/mgr5/sbin/mgrctl -m billmgr exit
  3. Создайте новый продукт в ISP BillManager. Подробная инструкция по созданию продукта приводится в следующем разделе.

Создание продукта

Для создания продукта:

  1. Перейдите в раздел Продукты >> Типы продуктов. Нажмите кнопку Кнопка Создать Создать. Откроется форма создания нового типа продуктов.
    • Введите ONLYOFFICE в поле Наименование.
    • Введите oo в поле Внутреннее имя.
      Внутреннее имя обязательно должно быть точно таким же, как здесь указано.
    • Добавьте как минимум один период, доступный для покупки, установив галочки напротив нужных опций в разделе Доступные периоды оплаты. Например, выберите опции Месяц и Год.
    • Нажмите кнопку Ok. Созданный продукт будет добавлен в список Типы продуктов.
      Создание продукта Создание продукта
  2. Задайте параметры продукта. Необходимо добавить пять следующих обязательных параметров:
    • Имя с внутренним именем firstname
    • Фамилия с внутренним именем lastname
    • Имя портала с внутренним именем alias
    • Email с внутренним именем email
    • Пароль с внутренним именем password
      Внутренние имена обязательно должно быть точно такими же, как здесь указано.

    Для создания параметра:

    • Выделите продукт ONLYOFFICE в списке Типы продуктов, нажмите кнопку Кнопка Параметры Параметры, расположенную выше, затем нажмите кнопку Кнопка Создать Создать.
    • Укажите наименование параметра и его внутреннее имя, как указано выше.
    • Для каждого из параметров установите галочки рядом с опциями Показывать при заказе и Обязательный параметр, а также выберите в списке Доступ для изменения опцию Сотрудник.
    • При создании параметра Имя портала также необходимо выбрать опцию check.alias в списке Функция проверки.
    • При создании параметра Password также необходимо выбрать опцию check.password_length в списке Функция проверки.
    • Нажмите кнопку Ok, чтобы сохранить параметр.
      Добавление параметров Добавление параметров

      Эти параметры будут использоваться для создания порталов.

  3. Задайте содержание продукта. Необходимо добавить три следующих обязательных дополнения к типу продукта:
    • Активные пользователи с внутренним именем activeusers
    • Дисковое пространство с внутренним именем maxtotalsize
    • Максимальный размер файла с внутренним именем maxfilesize
      Внутренние имена обязательно должно быть точно такими же, как здесь указано.

    Для создания дополнения:

    • Выделите продукт ONLYOFFICE в списке Типы продуктов, нажмите кнопку Кнопка Содержание Содержание, расположенную выше, затем нажмите кнопку Кнопка Создать Создать.
    • Укажите наименование дополнения и его внутреннее имя, как указано выше.
    • Нажмите кнопку Ok, чтобы сохранить параметр.
      Добавление дополнений Добавление дополнений

      Эти параметры будут использоваться для выставления параметров тарифа.

  4. Создайте обработчик.
    • Перейдите в раздел Интеграция >> Обработчики услуг и нажмите кнопку Кнопка Создать Создать.
    • Нажмите кнопку Выбрать напротив типа продукта ONLYOFFICE.
    • Нажмите кнопку Добавить напротив пункта Интеграция с ONLYOFFICE.
    • Укажите Apisystem Url следующего вида: http://apisystem.domainname.com.
    • Укажите значение параметра Machine Key (он находится в файле web.appsettings.config) и нажмите кнопку Далее.
      Параметры Apisystem Url и Machine Key необходимы для доступа к API сервера с установленным на нем продуктом Hosting Edition.
    • Задайте наименование обработчика и нажмите кнопку Завершить.
      Создание обработчика Создание обработчика
  5. Создайте тарифный план.
    • Перейдите в раздел Продукты >> Тарифные планы и нажмите кнопку Кнопка Создать Создать.
    • Нажмите кнопку Выбрать напротив типа продукта ONLYOFFICE. Откроется форма создания нового тарифа.
    • Укажите любое наименование (например, ONLYOFFICE 1-5 пользователей) и любое внутреннее имя и выберите Обработчик услуг, созданный на предыдущем шаге.
    • В разделе Цены за период укажите цены за месяц и за год. Они должны совпадать с ценами, опубликованными на странице Цены на SaaS-версию нашего официального сайта.
    • Нажмите кнопку Завершить, чтобы сохранить созданный тариф.
      Создание тарифного плана Создание тарифного плана
  6. Задайте параметры тарифного плана. Для этого необходимо добавить три дополнения к тарифному плану на основе дополнений к типу продукта, созданных на шаге 3: Активные пользователи, Дисковое пространство, Максимальный размер файла.

    Для создания дополнения:

    • В списке Тарифные планы выделите тарифный план, созданный на предыдущем шаге, нажмите кнопку Кнопка Дополнения Конфиг., расположенную выше, затем нажмите кнопку Кнопка Создать Создать.
    • В списке Тип учета оставьте выбранную по умолчанию опцию Не учитывать.
    • В списке Тип выберите нужный тип дополнения:
      • Активные пользователи - чтобы задать максимальное количество пользователей, разрешенное для данного тарифного плана
      • Дисковое пространство - чтобы задать доступное дисковое пространство для данного тарифного плана
      • Максимальный размер файла - чтобы задать максимальный размер файла, который можно загрузить на портал
    • В списке Тип значения выберите опцию Целое число.
    • Выберите соответствующие Единицы измерения (Шт., ГиБ или МиБ) для выбранного типа дополнения и укажите нужное значение в поле Включено в тариф.
    • Нажмите кнопку Ok, чтобы сохранить параметр.
      Добавление дополнений Добавление дополнений
  7. После того как все нужные тарифные планы будут созданы, задайте для каждого из них правила смены тарифа.
    • В списке Тарифные планы выделите нужный тарифный план и нажмите кнопку Кнопка Смена тарифа Смена тарифа, расположенную выше.
    • Чтобы разрешить пользователям переход с выбранного тарифа на какой-либо другой тариф, выделите один из имеющихся тарифов и нажмите кнопку Кнопка Включить тариф Вкл. наверху, чтобы разрешить переход на этот тариф.
    • Чтобы запретить возможность перехода с выбранного тарифа на какой-либо другой, выделите один из имеющихся тарифов и нажмите кнопку Кнопка Отключить тариф Выкл. наверху, чтобы запретить переход на этот тариф.
      Правила смены тарифа Правила смены тарифа

      Для тарифа ONLYOFFICE 6-10 пользователей можно разрешить переход на тариф с более широкими возможностями (ONLYOFFICE 11-20 пользователей) и запретить переход на тариф с меньшими возможностями (ONLYOFFICE 1-5 пользователей).

  8. Чтобы пользователи могли оплатить продукт, добавьте хотя бы один метод оплаты, если это не было сделано ранее.
    • Перейдите в раздел Провайдер >> Методы оплаты.
    • Нажмите кнопку Кнопка Создать Создать, расположенную наверху.
    • Нажмите кнопку Добавить рядом с нужным модулем оплаты (например, Банковский перевод).
    • Заполните форму Настройки интеграции и нажмите кнопку Далее.
    • Укажите необходимые Настройки метода оплаты и нажмите кнопку Завершить.
  9. Ссылки на заказ тарифа с выбранным периодом один год или один месяц можно найти в параметрах тарифного плана. Для этого выделите тарифный план в списке Тарифные планы, нажмите кнопку Кнопка Изменить Изменить и перейдите в раздел Ссылки. Скопируйте ссылку и вставьте ее в адресную строку браузера, чтобы убедиться, что добавленный тариф корректно отображается в корзине.
    Заказ тарифа Заказ тарифа

    Для добавления подсказок к полям alias и password необходимо выполнить следующие действия:

    • Откройте файл billmgr_mod_pmonlyoffice.xml.
    • Найдите раздел <lang name="ru"> или <lang name="en"> в зависимости от нужной локализации.
    • Добавьте в него следующее содержимое:
      
      <messages name="oo.order.param">
      <msg name="hint_alias">Имя Вашего портала будет portalname.mycloudoffice.ru</msg>
      </messages>
                                    

    При оформлении заказа пользователю необходимо заполнить все поля для создания портала. После того, как пользователь оплатит выбранный тариф, он сможет изменить тариф с помощью кнопки Кнопка Смена тарифа Смена тарифа в соответствии с заданными правилами смены тарифа.

Learn more Enhance your hosting Host ONLYOFFICE now and
boost your sales getting even more clients
Вас также может заинтересовать:
Закрыть