Для партнеров

/
/
/
Перепродажа SSL-сертификатов через WHMCS

Перепродажа SSL-сертификатов через WHMCS

Модуль ispmanager NOC для WHMCS автоматизирует перепродажу SSL-сертификатов через WHMCS.

Возможности модуля

  • Покупка SSL-сертификатов.
  • Продление SSL-сертификатов.
  • Просмотр информации об SSL-сертификатах.

Требования модуля

Рекомендуемая версия WHMCS — 8.9 или выше.

Модуль ispmanager NOC доступен бесплатно, но требует установки.

Установка модуля

  1. Подключитесь к серверу с WHMCS по SSH.

  2. Перейдите в директорию modules. Директория modules находится в директории, в которую был установлен WHMCS.

    cd /КОРЕНЬ_WHMCS/modules/

  3. Скачайте модуль ispmanager NOC:

     wget https://www.ispmanager.com/static/files/whmcs/whmcs_ispmanager_noc.zip
    Если терминал не распознает утилиту wget

    Установите утилиту:

    Для Debian-подобных ОС
    apt install wget
    Для RHEL-подобных ОС
    yum install wget

  4. Распакуйте модуль в директории modules:

    unzip whmcs_ispmanager_noc.zip
    Если терминал не распознает утилиту unzip

    Установите утилиту:

    Для Debian-подобных ОС
    apt install unzip
    Для RHEL-подобных ОС
    yum install unzip

После распаковки модуль активируется автоматически и станет доступен для использования. Для проверки:

  1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Configurations → Apps & Integrations.

  3. Введите в строке поиска «ispmanager». В списке должен появиться модуль ispmanager NOC с отметкой Active.

Настройка интеграции между WHMCS и ispmanager

Для перепродажи SSL-сертификатов настройте интеграцию между WHMCS и ispmanager. Для этого создайте сервер в WHMCS и укажите в нем данные от личного кабинета в ispmanager. Если для перепродажи используется несколько личных кабинетов ispmanager, создайте по серверу для каждого.

Чтобы заказ SSL-сертификатов выполнялся автоматически, после создания сервера привяжите его к SSL-сертификатам в настройках услуг. Привязка доступна только для:

Если для перепродажи SSL-сертификатов, лицензий и модулей ispmanager будет использован один личный кабинет ispmanager, достаточно назначить сервер ispmanager сервером по умолчанию. 

Если будет использовано несколько личных кабинетов, создайте для каждого сервера ispmanager свою группу.

Создание сервера

  1. Если у вас ещё нет личного кабинета в ispmanager, зарегистрируйтесь.
  2. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  3. Перейдите в раздел Configurations → System Settings.
  4. Выберите блок Servers.
  5. Нажмите Add New Server.
  6. Заполните поля. Обязательные поля отмечены звездочками.
    • Module* — выберите «ispmanager NOC»
    • Hostname or IP Address* — укажите доменное имя продающего биллинга ispmanager — my.ispmanager.ru или eu.ispmanager.com
    • Username* — имя пользователя в личном кабинете ispmanager
    • Password* — пароль пользователя в личном кабинете ispmanager
    • Access Hash — оставьте пустым
  7. Нажмите Continue.
  8. Заполните остальные поля. Обязательные поля отмечены звездочками.
    • Общие сведения:
      • Name* — произвольное название, под которым сервер ispmanager сохранится в WHMCS. Название сервера будет доступно для просмотра только администратору WHMCS
      • Assigned IP Addresses — оставьте поле пустым
      • Monthly Cost — оставьте поле пустым
      • Datacenter/NOC — оставьте поле пустым

      • Maximum No. of Accounts — ограничение на количество SSL-сертификатов, доступных для перепродажи с использованием сервера. Значение используется для расчета заполненности серверов в группе при распределении заказываемых SSL-сертификатов между серверами. Если сервер не добавлен в группу или является единственным сервером в группе, значение не применяется

        Реальное количество доступных для перепродажи SSL-сертификатов не ограничено.

      • Server Status Address — оставьте поле пустым
      • Enable/Disable — статус сервера: включен/выключен. Выключенный сервер нельзя будет подключить к новой услуге при ее создании. Действующие услуги, привязанные к выключенному серверу, будут доступны для заказа, но для них не будет автоматически заказан SSL-сертификат
    • Nameservers — оставьте поля пустыми
    • SSO Access Control — доступ к единому входу:
      • Unrestricted — неограниченный: разрешить всем администраторам WHMCS автоматически авторизовываться в продающем биллинге ispmanager
        • Restricted — ограниченный: разрешить автоматическую авторизацию продающем биллинге ispmanager только администраторам и пользователям WHMCS с указанной ролью:
          • Full Administrator — полный администратор
          • Sales Operator — оператор отдела продаж
          • Support Operator — оператор технической поддержки
  9. Нажмите Save Changes.

Создание группы серверов

Создайте группу серверов, если для перепродажи используется несколько личных кабинетов ispmanager. Это позволит привязать группу к SSL-сертификатам в настройках услуг и автоматизировать их заказ.

  1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Configurations → System Settings.
  3. Выберите блок Servers.
  4. Нажмите Create New Group.
  5. Заполните поля:
    • Name — название, под которым группа сохранится в WHMCS. Название группы будет доступно для просмотра только администратору WHMCS.

    • Fill Type — правило, по которому из группы будет выбираться сервер для заказа SSL-сертификатов, если в группе несколько серверов.

      • Add to the least full server — SSL-сертификаты будут заказываться через самый свободный сервер.
      • Fill active server until full then switch to next least used — SSL-сертификаты будут заказываться через сервер по умолчанию или первый сервер по алфавиту, если сервер по умолчанию не входит в группу, пока он не заполнится, а затем — через самый свободный сервер.

      Заполненность сервера вычисляется по соотношению уже созданных заказов к максимально допустимому количеству.

    • Selected Servers — серверы в группе. Для добавления сервера в группу выделите его в левой колонке и нажмите Add:

  6. Нажмите Save Changes.

Сервер по умолчанию

Для каждого модуля в WHMCS назначается сервер по умолчанию. Сервер по умолчанию используется для обработки услуг:

  • если в настройках модуля при создании услуги не указана группа серверов (выбрана опция «None»)
  • в качестве приоритетного в составе группы серверов 

Единственный сервер автоматически назначается сервером по умолчанию.

Если серверов несколько, чтобы назначить один из них сервером по умолчанию, нажмите на его название в списке. Рядом с сервером по умолчанию появится звездочка:

Создание услуг в WHMCS

Создание услуг доступно после создания хотя бы одной группы услуг.

Группы услуг

При добавлении услуг в группы на странице заказа клиента услуги будут сгруппированы по группам в разделе Categories.

  1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Configurations → System Settings.
  3. Выберите блок Products/Services.

  4. Нажмите Create a New Group.

  5. Заполните поля. Обязательные поля отмечены звездочками.
    • Product Group Name* — название группы услуг, под которым она будет отображаться в клиентской зоне WHMCS, например «SSL-сертификаты»
    • URL — ссылка на группу в клиентской зоне WHMCS. При скрытии группа будет доступна по указанной ссылке.
    • Product Group Headline — заголовок, c которым группа будет отображаться в клиентской зоне WHMCS, например «SSL-сертификаты для сайтов и почты».
    • Product Group Tagline — подзаголовок, c которым группа будет отображаться в клиентской зоне WHMCS, например «DV-/OV/-EV-сертификаты».

    • Group Features — возможности, которые будут доступны клиенту при заказе любой услуги из группы.

    • Order Form Template — шаблон страницы заказа. Шаблон становится доступен для выбора при редактировании группы после ее создания.
      • Use System Default (Standard Cart) — использовать стандартную страницу заказа
      • Use Specific Template — выбрать другую страницу заказа для услуги
    • Available Payment Gateways — доступные платежные системы.
    • Hidden — установите галочку, чтобы скрыть группу услуг из клиентской зоны WHMCS. Группа будет доступна только по прямой ссылке.
  6. Нажмите Save Changes.

Услуги

Подробнее о настройке услуг — в официальной документации WHMCS.

  1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Configurations → System Settings.
  3. Выберите блок Products/Services.
  4. Нажмите Create a New Product.
  5. Заполните поля. Обязательные поля отмечены звездочками.
    • Product Type* — выберите Other
    • Product Group* — группа услуг
    • Product Name* — название услуги, под которым она будет отображаться в клиентской зоне WHMCS
    • URL — ссылка на услугу в клиентской зоне WHMCS. При скрытии услуги она будет доступна по указанной ссылке.
    • Module — выберите «ispmanager NOC»
    • Create as Hidden:
      • ON — услуга будет скрыта из клиентской зоне WHMCS и доступна только по прямой ссылке
      • OFF — услуга отобразится в клиентской зоне WHMCS сразу после создания
  6. Нажмите Continue.

  7. Настройте остальные параметры услуги. Обязательные поля отмечены звездочками.

    Details — общие сведения
    • Product Tagline — слоган, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS при заказе другой услуги, например «Защитите свой домен».
    • Product Short Description — краткое описание, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS при заказе другой услуги, например «Подходит для физических и юридических лиц».
    • Product Description — описание, с которым услуга будет отображаться на странице заказа, например список возможностей.

    • Product Color — цвет темы, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS.
      Чтобы услуга отображалась как рекомендованная при заказе другой услуги, она должна быть добавлена в качестве рекомендованной в настройках другой услуги на вкладке Cross-sells.

    • Welcome Email — шаблон приветственного письма, которое будет автоматически отправлено клиенту на электронную почту при активации услуги.

      • None — письмо не будет отправлено автоматически
      • Other Product/Service Welcome Email — будет использован шаблон по умолчанию «Other Product/Service Welcome Email»

      Редактирование шаблона по умолчанию и создание собственных шаблонов доступно в разделе Configuration → System Settings → Email Templates.

    • Require Domain — оставьте поле пустым.
    • Stock Control — установите галочку, чтобы ограничить количество доступных для заказа услуг, и укажите доступное количество в поле. При достижении этого количества услуга станет недоступной для заказа.
    • Apply Tax — добавить к стоимости услуги налог. Налоги настраиваются в разделе Configuration → System Settings → Tax Configuration.
    • Featured — установите галочку, чтобы услуга отображалась на странице заказа как самая популярная. Доступно не для всех шаблонов страниц заказа.
    • Hidden — установите галочку, чтобы скрыть услугу из клиентской зоны WHMCS. Услуга будет доступна для заказа по прямой ссылке.
    • Retired — установите галочку, чтобы услугу невозможно было заказать ни из клиентской, ни из административной зоны WHMCS, в т. ч. по прямой ссылке.
    Pricing — стоимость и оплата

    • Payment Type* — тип оплаты:

      Услуга будет доступна бесплатно.

      Для услуги будет доступна единовременная оплата.

      Установите галочку Enable рядом с валютой EUR/RUB, чтобы активировать цену в этой валюте и укажите:

      • Setup Fee — стоимость услуги
      • Price — единовременный платеж за открытие услуги

      Услуга будет доступна по подписке.

      Используйте расчетные периоды «раз в год», «раз в 2 года» и «раз в 3 года». При выборе других периодов заказ лицензии завершится ошибкой.

      Чтобы активировать расчетный период, установите галочку Enable рядом с нужным периодом:

      • Annually — раз в год
      • Biennially — раз в 2 года
      • Triennially — раз в 3 года

      Для каждого активированного периода укажите:

      • Setup Fee — единовременный платеж за открытие услуги
      • Price — стоимость услуги
    • Allow Multiple Quantities* — разрешить заказ нескольких услуг этого вида:
      • No — не разрешать
      • Yes - Multiple Services — при заказе нескольких услуг каждая услуга будет оформлена как отдельный заказ.
      • Yes - Scaling Service — при заказе нескольких услуг все услуги будут оформлены как один заказ. Стоимость заказа будет равна стоимости услуги, умноженной на количество услуг.
    • Recurring Cycles Limit — сколько раз будет продлеваться услуга, для которой выбран тип оплаты «Подписка» (Recurring). При достижении этого количества услуга клиента будет автоматически отменена. Если указать 0, услуга будет продлеваться бесконечно, пока не будет отменена вручную.
    • Auto Terminate/Fixed Term — количество дней, через которое услуга будет автоматически отменена.
    • Termination Email — шаблон письма, которое будет автоматически отправлено клиенту на электронную почту при автоматической отмене услуги, если настроен параметр Auto Terminate/Fixed Term. Создание и редактирование шаблонов доступно в разделе Configuration → System Settings → Email Templates.
    • Prorata Billing — не устанавливайте галочку.
    • On-Demand Renewals* — раннее продление услуги:
      • Use System Default — использовать глобальные настройки, заданные на вкладке Ordering в разделе Configuration → System Settings → General Settings
      • Use Product-Specific Configuration — переопределить глобальные настройки для услуги
      • Check to allow clients to place renewal orders early — установите галочку, чтобы разрешить клиентам создавать заказы на продление услуги и укажите максимальное количество дней до срока оплаты, за которое клиенты могут заказывать продление, для каждого расчетного периода. Чтобы отключить раннее продление для конкретного периода, укажите 0.
    Module Settings — настройки модуля
    • Server Group* — сервер или группа серверов ispmanager. Выберите из списка группу или None, если для услуги будет использоваться сервер по умолчанию.

    • Product ID* — укажите ID нужного тарифа ispmanager.

      Как узнать ID тарифа ispmanager

      Чтобы список ID отобразился корректно, назначьте сервер, который будет использоваться для предоставления услуги, сервером по умолчанию.

      1. Перейдите в раздел Configurations → Apps & Integrations.
      2. Введите в строке поиска «ispmanager».
      3. В списке выберите модуль ispmanager NOC partner module.

      4. В открывшейся форме нажмите Use app. Откроется список SSL-сертификатов с ID. ID SSL-сертификатов будут указаны в разделе «SSL Certificate» в колонке «ID».

    • Admin phone — укажите ваш номер телефона, чтобы при выпуске SSL-сертификата вместо телефона клиента использовался ваш номер.

    Настройте автоматизацию:

    • Automatically setup the product as soon as an order is placed — автоматически заказывать SSL-сертификат для клиента при размещении заказа
    • Automatically setup the product as soon as the first payment is received — автоматически заказывать SSL-сертификат для клиента при получении первого платежа по заказу
    • Automatically setup the product when you manually accept a pending order — автоматически заказывать SSL-сертификат для клиента после подтверждения заказа администратором WHMCS
    • Do not automatically setup this product — не заказывать SSL-сертификат для клиента автоматически 
    Custom Fields — дополнительные поля

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

    Для SSL-сертификатов автоматически создаются поля ниже. По умолчанию все поля, кроме Order ID и Organization DUNS, обязательны для заполнения клиентом при заказе.

    • CN|Domain — домен, для которого будет заказан сертификат.
    • field_country|Country — страна клиента.
    • ST|Region — регион клиента.
    • L|City — город клиента.
    • O|Organization — ФИО клиента.
    • approver_method|Approver method — способ проверки владения доменом. Доступные способы зависят от конкретного сертификата и могут включать:
      • auth_email|By email — проверку по почте. На почтовый ящик на домене клиента, выбранный из списка Approver email, будет отправлено письмо от удостоверяющего центра со ссылкой для проверки.
      • auth_dnstxt|By DNS TXT record — проверку по TXT-записи домена. На почтовый ящик клиента, указанный в его личном кабинете WHMCS, будет отправлено письмо от удостоверяющего центра с токеном, который клиент должен будет добавить в TXT-записи домена.
    • order_id|Order ID — ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.
    • approver_email|Approver email — почтовый ящик, на который будет выслана ссылка для проверки при проверке по почте.
    • CN|Domain — домен, для которого будет заказан сертификат.
    • field_country|Country — страна клиента.
    • ST|Region — регион клиента.
    • L|City — город клиента.
    • O|Organization — полное название организации, для которой будет заказан сертификат. Название должно быть указано так же, как в свидетельстве о регистрации юридического лица. Допускается использование только символов латиницы.
    • approver_method|Approver method — способ проверки владения доменом. Доступные способы зависят от конкретного сертификата и могут включать:
      • auth_email|By email — проверку по почте. На почтовый ящик на домене клиента, выбранный из списка Approver email, будет отправлено письмо от удостоверяющего центра со ссылкой для проверки.
      • auth_dnstxt|By DNS TXT record — проверку по TXT-записи домена. На почтовый ящик клиента, указанный в его личном кабинете WHMCS, будет отправлено письмо от удостоверяющего центра с токеном, который клиент должен будет добавить в TXT-записи домена.
    • order_id|Order ID — ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.
    • approver_email|Approver email — почтовый ящик, на который будет выслана ссылка для проверки при проверке по почте.
    • org_name|Organization name — полное название организации, для которой будет заказан сертификат. Название должно быть указано так же, как в свидетельстве о регистрации юридического лица.
    • org_country|Organization country — страна организации.
    • org_state|Organization region — регион организации.
    • org_city|Organization city — город организации.
    • org_postcode|Organization ZIP code — почтовый индекс организации.
    • org_address|Organization address — адрес организации.
    • org_phone|Organization phone — номер телефона организации.
    • org_duns|Organization DUNS — номер DUNS организации.
    • CN|Domain — домен, для которого будет заказан сертификат.
    • field_country|Country — страна клиента.
    • ST|Region — регион клиента.
    • L|City — город клиента.
    • O|Organization — полное название организации, для которой будет заказан сертификат. Название должно быть указано так же, как в свидетельстве о регистрации юридического лица, вместе с юридической формой. Допускается использование только символов латиницы.
    • approver_method|Approver method — способ проверки владения доменом. Доступные способы зависят от конкретного сертификата и могут включать:
      • auth_email|By email — проверку по почте. На почтовый ящик на домене клиента, выбранный из списка Approver email, будет отправлено письмо от удостоверяющего центра со ссылкой для проверки.
      • auth_dnstxt|By DNS TXT record — проверку по TXT-записи домена. На почтовый ящик клиента, указанный в его личном кабинете WHMCS, будет отправлено письмо от удостоверяющего центра с токеном, который клиент должен будет добавить в TXT-записи домена.
    • order_id|Order ID — ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.
    • approver_email|Approver email — почтовый ящик, на который будет выслана ссылка для проверки при проверке по почте.
    • org_name|Organization name — полное название организации, для которой будет заказан сертификат. Название должно быть указано так же, как в свидетельстве о регистрации юридического лица.
    • org_country|Organization country — страна организации.
    • org_state|Organization region — регион организации.
    • org_city|Organization city — город организации.
    • org_postcode|Organization ZIP code — почтовый индекс организации.
    • org_address|Organization address — адрес организации.
    • org_phone|Organization phone — номер телефона организации.
    • org_duns|Organization DUNS — номер DUNS организации.

    Для добавления собственного поля укажите его параметры в блоке Add New Custom Field:

    • Field Name — название поля.
    • Display Order — порядок отображения поля. По умолчанию поля отображаются в том порядке, в котором они добавлены.
    • Field Type — тип поля:
      • Text Area — текстовое поле в несколько строк
      • Text Box — текстовая строка
      • Link/URL — ссылка/URL
      • Password — пароль
      • Drop Down — выпадающий список
      • Checkbox — чекбоксы
    • Description — описание поля для клиента.
    • Validation — регулярное выражение для проверки введенного значения.
    • Select Options — укажите опции для поля типа «выпадающий список» через запятую.
    • Admin Only — установите галочку, чтобы скрыть поле из клиентской зоны WHMCS. Поле будет доступно только для администратора WHMCS.
    • Required Field — установите галочку, чтобы сделать поле обязательным для заполнения.
    • Show on Order Form — установите галочку, чтобы поле отображалось на странице заказа услуги.
    • Show on Invoice — установите галочку, чтобы поле отображалось в счетах на оплату.

    Чтобы сохранить поле и добавить новое, нажмите Save Changes.

    Configurable options — настраиваемые опции

    Оставьте поля без изменений.

    Upgrades — повышения и понижения тарифа

    Повышения и понижения не поддерживаются для SSL. Оставьте поля без изменений.

    Free Domain — бесплатный домен

    Оставьте поля без изменений.

    Cross-sells — рекомендованные товары и услуги

    Рекомендованные товары и услуги будут предложены клиенту при заказе текущей услуги.

    Чтобы добавить товар или услугу в рекомендованные, выберите их из списка Product Cross-sells и нажмите Save Changes.

    Активация и настройка рекомендаций выполняется в разделе Configuration → System Settings → General Settings на вкладке Ordering.

    Other — прочие настройки
    • Custom Affiliate Payout — партнерские выплаты:
      • Use Default — использовать выплаты по умолчанию
      • Percentage — выплачивать процент от стоимости услуг, заказанных привлеченным клиентом
      • Fixed Amount — выплачивать фиксированную сумму
      • No Commission — не выплачивать партнерские выплаты
    • Affiliate Pay Amount — процент или сумма партнерской выплаты. По умолчанию сумма будет выплачиваться регулярно. Чтобы выплата была разовой, установите галочку One Time Payout.
    • Subdomain Options — оставьте поле пустым.
    • Associated Downloads — оставьте поле пустым.
    • Overages Billing — оставьте поле пустым.
    Links — ссылки
    • Direct Shopping Cart Link — прямая ссылка на корзину с добавленной услугой
    • Direct Shopping Cart Link Specifying Template — прямая ссылка на корзину с добавленной услугой и кастомным шаблоном страницы заказа
    • Direct Shopping Cart Link Including Domain — прямая ссылка на корзину с добавленной услугой, на форму выбора домена
    • Product Group Cart Link — прямая ссылка на группу услуг
    • Product URLs — прямая ссылка на услугу
  8. Нажмите Save Changes.
  9. Для каждого тарифа ispmanager создайте отдельную услугу.

Проверка создания услуги

Если услуга была создана корректно, она станет доступна для заказа в клиентской зоне WHMCS. Для проверки: 

  1. Авторизуйтесь в WHMCS под тестовой учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php или создайте новую учетную запись.

    Как создать тестовую учетную запись клиента в WHMCS

    1. Нажмите Account → Register. 

    2. Заполните поля. Обязательные поля отмечены звездочками. Данные могут быть выдуманными.
      • Personal Information:
        • First Name* — имя тестового клиента
        • Last Name* — фамилия тестового клиента
        • Email Address* — email тестового клиента
        • Phone Number — номер телефона тестового клиента
      • Billing Address:
        • Company Name — место работы
        • Street Address — адрес 1
        • Street Address 2 — адрес 2
        • City — город
        • State — область/край/округ/регион
        • Postcode — почтовый индекс
        • Выберите страну из списка
      • Additional Information:
        • Выберите валюту из списки, например RU или EUR
      • Account Security:
        • Password* — пароль
        • Confirm Password* — подтверждение пароля
        • Generate Password — сгенерировать пароль:
          • Password Length — длина пароля
          • Generated Password — сгенерированный пароль
          • Generate New Password — сгенерировать новый пароль
          • Copy — скопировать сгенерированный пароль
          • Copy to Clipboard and Insert — скопировать и использовать сгенерированный пароль
    3. Нажмите Register.
  2. Перейдите в раздел Services → Order New Services.
  3. Выберите группу услуг в меню Categories. На странице отобразится созданная вами услуга.
В этой статье