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

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

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

В HostBill реализован модуль ispmanager reselling, который автоматизирует перепродажу SSL-сертификатов через ispmanager.

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

ВозможностьПартнерКлиент
Заказ сертификата✅✅
Скачивание CSR, закрытого ключа, файлов сертификата✅✅
Запрос на проверку сертификата✅✅
Просмотр информации об услуге✅✅
Просмотр информации для проверки сертификата❌✅
Продление сертификата❌❌
Перевыпуск сертификата✅✅
Просмотр инструкции по выпуску и установке сертификата✅❌
Просмотр истории изменений для услуги✅❌
Удаление услуги✅✅

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

Модуль ispmanager reselling доступен бесплатно.

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

  1. Скачайте модуль по ссылке.
  2. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin или по SSH.
  3. Загрузите архив в корневую директорию HostBill.
  4. Распакуйте архив.
  1. Авторизуйтесь на сервере с HostBill под учетной записью администратора по SSH.

  2. Скачайте модуль в корневую директорию HostBill:

    wget-P /КОРЕНЬ/HOSTBILL/ https://static.ispmanager.com/static/files/hostbill/ispmanager_reselling.zip

  3. Перейдите в корневую директорию HostBill:

    cd /КОРЕНЬ/HOSTBILL/

  4. Распакуйте архив:

    unzip ispmanager_reselling.zip

Активация модуля

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

  3. На вкладке Inactive найдите модуль ispmanager_reselling и нажмите Activate.

Настройка подключения к ispmanager

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.

  2. Перейдите в раздел Settings → Apps Connections → Add new Connection.

  3. В поле Application выберите ispmanager_reselling.

  4. Заполните параметры подключения. Обязательные поля отмечены звездочками.

    • Name* — произвольное название, под которым подключение сохранится в HostBill. Название будет доступно для просмотра только администратору HostBill.
    • Hostname* — доменное имя личного кабинета ispmanager — my.ispmanager.ru или eu.ispmanager.com.
    • Username* — имя пользователя в личном кабинете ispmanager.
    • Password* — пароль пользователя в личном кабинете ispmanager.

    Оставьте без изменений.

  5. Нажмите Test Configuration для проверки подключения. Если подключение успешно установлено, появится уведомление со статусом Success.
  6. Нажмите Add New Connection.

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

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

Страницы заказа

Страницы заказа позволяют сгруппировать услуги в клиентской зоне HostBill.

Для создания страницы заказа:

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Нажмите Add new order page.
  4. Заполните поля. Обязательные поля отмечены звездочками.
    • Name* — название страницы заказа, которое будет отображаться в клиентской зоне HostBill, например «SSL-сертификаты ispmanager».
    • Order page URL — нажмите Edit, чтобы отредактировать автоматически сгенерированный URL страницы заказа.
    • This category will contain* — выберите Products.
    • Order type* — выберите SSL Certificates.

    • Cart Template — выберите шаблон корзины из стандартных или нажмите Here для покупки платного шаблона. Для предварительного просмотра нажмите Preview.

    • Description — описание услуг, которые будут размещены на странице заказа, для клиентской зоны.
    • Advanced : Order scenario — выберите сценарий заказа — последовательность шагов, которые должен выполнить клиент при заказе услуг на странице заказа. Подробнее о сценариях заказа — в официальной документации HostBill.
  5. Нажмите Add new order page.

Услуги

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Выберите созданную ранее страницу заказа.
  4. Нажмите:
    • Add new product — чтобы создать услугу вручную
    • Import products — чтобы импортировать существующую услугу, используя файл в формате JSON

  5. Заполните или отредактируйте поля на вкладках. Обязательные поля отмечены звездочками.

    General — основные настройки
    • Product Name* — название услуги.
    • Product Code — внутренний код услуги, который виден только администратору HostBill.
    • Product Description — нажмите Add description, чтобы добавить описание услуги, которое будет отображаться в карточке услуги в клиентской зоне HostBill.

    • Price* — тип оплаты:

      Для SSL-сертификатов ispmanager доступен только тип оплаты «Regular». При использовании других типов заказ невозможно будет обработать.

      • Выберите платежный период*.

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

        • 1 Year — раз в год. Доступен для всех сертификатов.
        • 2 Year — 2 раза в год. Доступен для всех сертификатов, кроме GlobalSign, Digicert Secure Site Pro и Digicert Secure Site Pro with EV.
        • 3, 4, 5 Year — 3, 4, 5 раз в год. Доступен только для Sectigo (ex Comodo) Instant SSL, Sectigo (ex Comodo) EV SSL certificate, GeoTrust QuickSSL Premium, GeoTrust True BusinessID Wildсard и GeoTrust True BusinessID with EV
      • Setup Fee — единовременный платеж за открытие услуги
      • Upgrade Fee — единовременный платеж за апргрейд услуги
      • Billing Type* — выберите форму оплаты:
        • Pre-paid — предоплата.
        • Post-paid — постоплата.
        • Hybrid — не поддерживается для SSL-сертификатов.
      • Для каждого платежного периода и стоимости создайте отдельную цену, нажав Add pricing option.
    • Tax — налог, который будет добавлен к стоимости услуги. Для включения налога активируйте опцию Yes и выберите налоговую группу из списка Tax Group.
    • Tags — теги для обозначения услуги, которые видны только администратору HostBill.
    Connect with App — настройки подключения к ispmanager
    1. App* — выберите из списка ispmanager_reselling.

    2. App Connection* — чтобы при заказе услуги SSL-сертификат для клиента был заказан в ispmanager автоматически, выберите созданное ранее подключение.

      • Нажмите Get values from server, чтобы услуги были автоматически импортированы из личного кабинета ispmanager.
      • Нажмите Add new connection, чтобы добавить еще одно подключение.

      Product ID* — укажите ID услуги вручную или выберите из списка, если импортировали ID на предыдущем шаге

      Admin phone — укажите номер телефона, который будет использован в качестве административного и технического контакта вместо номера клиента

    Automation — автоматические действия с услугами клиента

    Чтобы создать собственное действие с услугами, нажмите Add custom automation task. 

    Чтобы скопировать настройки из другой услуги, нажмите Copy automation settings.

    Подробнее о настройке автоматизации и добавлении собственных автоматических действий — в документации HostBill.

    • Auto-create — заказ SSL-сертификата в ispmanager:
      • When the order is placed — при создании заказа в HostBill
      • When the first payment is received — после получения оплаты
      • After payment received, process by cron — с помощью периодического задания после получения оплаты
    • Automatic Upgrades — не поддерживается для SSL-сертификатов.
    • Automatic Renew — автоматическое продление услуги в HostBill. Для продления самого сертификата будет необходимо заново пройти проверку.
      • Renew account automatically after receiving payment — после получения оплаты
      • When renewal invoice is issued — после выставления счета на оплату
    • Automatic Suspension — приостановка услуги в HostBill:
      • Autosuspend account after X days past due date — приостанавливать услугу через X дней после истечения срока оплаты
    • Automatic Unsuspension — возобновление услуги в HostBill:
      • Unsuspend account automatically after receiving due payment — услуга будет возобновлена после получения оплаты
    • Automatic Termination — отключение услуги:
      • Automatically terminate account after X days past due date — отключать услугу через X дней после истечения срока оплаты
      • Automatically cancel related unpaid invoices — отменять неоплаченные счета по услуге
    • Auto-cancel unpaid orders — отменять неоплаченные заказы:
      • Cancel unpaid orders X days since creation — отменять неоплаченные заказы через X дней после создания
    • Generate invoices — выставление счетов на оплату:
      • X days before the due date for product/service — за X дней до истечения срока оплаты услуги
    • Advanced due date settings — расширенные настройки срока оплаты:
      • Invoice is expected to be paid X days before the due date for service/product — счет должен быть оплачен за X дней до истечения срока оплаты услуги
      • First invoice due date set to X days after order — первый срок оплаты наступает через X дней после создания заказа
      • Move due date X days into future for recurring invoices — перенести срок оплаты на X дней вперед для периодических счетов
    • Adjust Initial Period — сдвинуть начало срока действия услуги на момент оплаты. Если заказ будет оплачен с задержкой, услуга начнет действовать с даты оплаты, а не с даты заказа.
    Messages — уведомления для клиента и администратора HostBill

    Для настройки уведомления нажмите Change и выберите шаблон уведомления из списка.

    Создание шаблонов уведомлений доступно в разделе Settings → Message Templates. 

    • Client email notifications — email-уведомления для клиентов:
      • Initial Order — о создании заказа.
      • Account created email — о создании услуги.
      • Account suspended email — о приостановке услуги.
      • Account unsuspended email — о возобновлении услуги.
      • Account terminated email — об отключении услуги.
      • Reminder of the service expiration — напоминание об истечении срока действия услуги.
      • Client: Success upgrade — не поддерживается для SSL-сертификатов.
    • Admin email notifications — email-уведомления для администратора:
      • Staff: Success upgrade — не поддерживается для SSL-сертификатов.
      • Staff: Failed upgrade — не поддерживается для SSL-сертификатов.
    • Client mobile notifications — мобильные уведомления для клиентов:
      • Account created email — о создании услуги
    Components — дополнительные услуги, доступные при заказе SSL-сертификатов

    Для SSL-сертификатов поддерживаются только формы («Forms»).

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

    Все поля должны быть заполнены латиницей.

    Список полей

    Для всех сертификатов:

    • Country — страна клиента.
    • State — регион клиента.
    • City — город клиента.
    • Organization — название организации или ФИО, если сертификат выпускается на физическое лицо.
    • Approver method — метод проверки сертификата:
      • By email — по электронной почте. Доступно для всех сертификатов.
      • By DNS TXT record — по TXT-записи. Доступно для сертификатов GlobalSign AlphaSSL, GlobalSign AlphaSSL Wildcard, GlobalSign DomainSSL, GlobalSign DomainSSL Wildcard.
    • Approver email — электронная почта для проверки по почте. Домен hostname автоматически заменяется на домен клиента.

    Только для EV-/OV-сертификатов:

    • Organization name — название организации
    • Organization country — страна организации
    • Organization state — регион организации
    • Organization city — город организации
    • Organization ZIP code — почтовый индекс организации
    • Organization address — адрес организации
    • Organization phone — телефонный номер организации
    • Organization DUNS — идентификатор DUNS организации

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

    Для добавления собственной формы или поля нажмите одну из трех кнопок и выполните настройку:

    • Add new form field — добавить новое поле
    • Import — импортировать форму в виде файла в формате JSON или YML
    • Copy from product — скопировать форму из другого продукта или услуги

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

    Client Functions — действия с заказанной услугой, доступные клиенту в личном кабинете HostBill

    Чтобы разрешить действие, нажмите Enable рядом с ним. Чтобы разрешить все действия, нажмите Enable all.

    Разрешенные действия будут доступны для активных заказов клиента в его личном кабинете HostBill в разделе Services:

    Возможные действия:

    • License details — просматривать информацию об SSL-сертификате.
    • Change Label — менять ярлык, который отображается рядом с заказанной услугой.
    • Change Ownership — передавать владение заказанной услугой другому пользователю HostBill.
    • Contracts — просматривать соглашения, принятые при заказе услуги. Просмотр доступен, если для услуги настроено принятие соглашения.
    • Account Logs — просматривать журнал действий с услугой, таких как активация, продление, остановка.
    • Manual Service Renew — продлевать услугу.
    • Related Emails — просматривать письма, связанные с услугой.
    • Related Invoices — просматривать счета по услуге.
    • Service Auto Renewal — просматривать дату автоматического продления услуги, настраивать автопродление и метод оплаты.
    • Service notes — просматривать заметки к услуге, оставленные для клиента администратором HostBill.

    Остальные действия не поддерживаются для SSL-сертификатов.

    Other Settings — настройки отмен, ограничений и др.
    • Limit Per Customer — максимальное количество заказов услуги, доступное одному клиенту. Для применения ограничения нажмите Yes и укажите количество услуг в поле One customer is allowed to order X products of this type.
    • Allow Cancellations — разрешить клиенту отменять заказ с услугой:
      • Yes, client can cancel service using this product — клиент сможет отменить заказ
      • Yes, client can cancel service after/for X days since account creation — клиент сможет отменить заказ в течение/через X дней после создания аккаунта
      • No, client cannot cancel service with this product — клиент не сможет отменить заказ
    • Allowed Cancellation Types — допустимые типы отмен:
      • Immediate — немедленная отмена
      • End of billing period — отмена в конце платежного периода
    • Pro-rate cancellations — отмена с перерасчетом стоимости услуги
      • No — запретить
      • Yes, for pre-paid services (for immediate cancelations) — разрешить для услуги с предоплатой (немедленная отмена)
      • Yes, for post-paid services — разрешить для услуги с постоплатой
    • Full Month Billing — не поддерживается для SSL-сертификатов.
    • Contract template — шаблон пользовательского соглашения. Выберите соглашение из списка или нажмите See all contract templates, чтобы настроить соглашения.
    • Clientarea Layout — расположение меню действий в клиентской зоне HostBill:
      • Left menu — слева
      • Right menu — справа
      • Top menu — сверху
    • Custom username — не поддерживается для SSL-сертификатов.
    • Starting price calculation method — не поддерживается для SSL-сертификатов.
    • Upgrades — не поддерживаются для SSL-сертификатов.
  6. Нажмите Save Changes.
  7. Для каждого SSL-сертификата создайте отдельную услугу.

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

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

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

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

    1. В правом верхнем углу экрана нажмите в раздел Login / Register → Create Account.

    2. Заполните поля. Обязательные поля отмечены звездочками. Данные могут быть выдуманными. Список полей может отличаться, если он был изменен в разделе Clients → Registration Fields.
      • Email Address* — контактный email.
      • Password* — пароль.
      • Repeat Password* — подтверждение пароля.
      • First Name* — имя клиента.
      • Last Name* — фамилия клиента.
      • Organization* — название компании, если выбран тип аккаунта Organization.
      • Address 1* — адрес 1.
      • Address 2 — адрес 2.
      • City* — город.
      • State* — область/край/округ/регион.
      • Postal Code* — почтовый индекс.
      • Country* — страна.
      • Phone* — номер телефона.
      • Account type — тип аккаунта:
        • Personal — для физического лица
        • Organization — для юридического лица
    3. Сохраните изменения.
  2. На главной странице личного кабинета клиента нажмите Order и выберите нужную страницу заказа.

Если услуги активны, они появятся на странице.

Действия с SSL-сертификатами

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Orders and Accounts → Orders → Active Orders для активных заказов и Pending Orders — для ожидающих одобрения.
  3. Нажмите на нужный заказ в списке.
  4. В открывшейся форме в блоке Order items нажмите на услугу.
  1. Выполните нужное действие:
    • Renewal — продлить сертификат. Услуга будет продлена, если до окончания срока действия сертификата осталось 30 или менее дней. Проверку владения сертификатом нужно будет пройти заново.
    • Reissue — перевыпустить сертификат. Доступно только для выпущенных сертификатов. Проверку владения сертификатом нужно будет пройти заново.
    • Validation — запросить проверку сертификата по почте или DNS. Доступно только для сертификатов GlobalSign.
    • Download certificate — скачать сертификат.
    • Download CSR — скачать CSR.
    • Instruction — просмотреть инструкцию по выпуску и установке сертификата от ispmanager.

    • History — просмотреть историю услуги.

      Подробнее о действиях с услугами — в документации HostBill.

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

Подробнее о всех возможностях, которые могут быть разрешены клиенту — в разделе Создание услуг → Услуги на вкладке Client Functions.

  1. Авторизуйтесь в HostBill под учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php.
  2. В меню слева в разделе Services выберите страницу заказа услуг.

  3. В открывшемся списке выберите нужную услугу.

  4. Выполните нужное действие:
    • License Details — просмотреть информацию о сертификате и скачать файлы сертификата:
      • Download certificate — скачать SSL-сертификат.
      • Download CSR — скачать CSR.
      • Download private key — скачать закрытый ключ.
      • Reissue — перевыпустить сертификат. Проверку владения сертификатом нужно будет пройти заново.
      • Validation — запросить проверку сертификата по почте или DNS. Доступно только для сертификатов GlobalSign.
    • Account Logs — просмотреть историю изменений для услуги
    • Manual Service Renew — продлить услугу
    • Service Auto Renewal — просмотреть информацию об автоматическом продлении и изменить его настройки
    • Request Cancellation — запросить отключение услуги
В этой статье