Перепродажа через BILLmanager


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

  1. Настройте интеграцию с биллинговой платформой.

  2. Импортируйте необходимые тарифные планы.

  3. Отредактируйте тарифные планы, если необходимо.

  4. Включите продажу.

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

Настройка интеграции происходит в процессе создания обработчика услуг в BILLmanager.

  1. В Основном меню в разделе Интеграция выберите Обработчики услуг.

    Пример формы Обработчик услуг

  2. В открывшейся форме нажмите на кнопку Создать.

  3. Найдите на вкладке Тип продукта "SSL сертификат" и нажмите на кнопку Выбрать.

  4. Найдите на вкладке Модуля обработки "BILLmanager 5" и нажмите на кнопку Выбрать..

  5. На шаге Настройка интеграции введите информацию, необходимую для интеграции с BILLmanager:

    • URL – адрес BILLmanager ispmanager: https://api.ispmanager.com;

    • Имя пользователя – имя учетной записи в биллинговой системе my.ispmanager.com.

    • Пароль – пароль учетной записи в биллинговой системе my.ispmanager.com.

  6. После ввода всей информации нажмите на кнопку Далее.

  7. На вкладке Параметры обработчика услуг введите информацию:

    • Дата-центр;

    • Наименование – произвольное наименование обработчика (обязательное к заполнению поле);

    • Ответственный – ответственный отдел, на который будут назначаться задачи в случае необходимости;

    • Сортировка – приоритет обработчика;

    • Минимальный баланс обработчика – минимальный баланс обработчика для успешного продления услуг.

  8. После ввода информации нажмите на кнопку Завершить.

Используйте для каждого перепродающего BILLmanager свой аккаунт в продающем BILLmanager. Иначе взаимодействие биллинговых систем может быть нарушено.

Импорт тарифных планов

После создания обработчика услуг импортируйте тарифные планы.

  1. В Основном меню в разделе Продукты выберите Тарифные планы.

    Пример формы Тарифные планы

  2. В открывшейся форме нажмите на кнопку Импорт.

  3. В открывшейся вкладке выберите Модуль обработки, созданный на этапе интеграции, и нажмите на кнопку Далее

  4. В открывшейся вкладке Выбор тарифного плана необходимо выбрать в соответствующих полях:

    • Тип продукта;

    • Тарифный план;

    • Провайдер – провайдер, которому будет импортирован выбранный тарифный план.

  5. После ввода информации нажмите на кнопку Завершить.

Редактирование тарифного плана

После импорта тарифных планов возможно изменить их название и стоимость, если это необходимо.

Для того что-бы внести изменения:

  1. В Основном меню в разделе Продукты выберите Тарифные планы.

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

    Пример выбранного тарифного плана

  3. В открывшейся вкладке внесите изменения и нажмите на кнопку Ok.

    Пример настроек тарифного плана

Включение продажи

Чтобы включить продажу:

  1. В Основном меню в разделе Продукты выберите Тарифные планы.

  2. В открывшейся форме выберите один или несколько тарифных планов и нажмите на кнопку Вкл.

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

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


В статье приведены API-запросы, позволяющие работать с SSL-сертифкатами в системе https://api.ispmanager.com.

Таблица идентификаторов SSL-сертификатов

Наименование

Для клиентов РФ (pricelist)

Для клиентов других стран (pricelist)

GlobalSign EV SSL

55330

55352

GlobalSign OrganizationSSL WildCard

55329

55351

GlobalSign OrganizationSSL

55328

55350

GlobalSign DomainSSL Wildcard

55327

55349

GlobalSign DomainSSL

55326

55348

AlphaSSL Wildcard

55325

55347

AlphaSSL

55324

55346

Comodo EV SSL certificate

55153

55153

Comodo PositiveSSL Wildcard

27650

27650

Comodo PositiveSSL Multi Domain (включено 3 домена)

27648

27648

Comodo Positive SSL

3033

3033

Comodo Premium WildCard

2028

2028

Comodo Essential SSL WildCard

2027

2027

Comodo Instant SSL

2026

2026

Comodo Essential SSL

2025

2025

DigiСert Secure Site with EV

2023

2023

DigiСert Secure Site

2021

2021

GeoTrust True BusinessID WildCard

2020

2020

GeoTrust True BusinessID

2019

2019

GeoTrust DV SSL

2018

2018

Thawte SSL Web Server with EV

2015

2015

Thawte SSL Wildcard

2014

2014

Thawte SSL Web Server

2012

2012

GeoTrust True BusinessID with EV

1032

1032

Thawte SSL123

1013

1013

RapidSSL Wildcard

1012

1012

RapidSSL

1011

1011

Доступные действия:

  1. Заказ SSL-сертификата.

  2. Заказ SSL-сертификата с уже существующим ключом (CSR).

  3. Выпуск существующего сертификата.

  4. Перевыпуск SSL-сертификата.

  5. Удаление SSL-сертификата.

  6. Получение список стран с цифровыми кодами.

API-адрес биллинговой системы ispmanager: https://api.ispmanager.com.

Авторизация в системе осуществляется с помощью параметра authinfo, который принимает значение: authinfo=EMAIL:PASSWORD, где:

  • EMAIL — электронная почта пользователя в биллинговой системе https://api.ispmanager.com;

  • PASSWORD — пароль пользователя.

Заказ SSL-сертификата

Заказ SSL-сертификата состоит из двух этапов:

  1. Получение секретного ключа.

  2. Заказ SSL-сертификата.

Получение секретного ключа

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

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.order.csr&sok=ok&snext=ok&crt_type=generate&field_country=COUNTRY&period=12&pricelist=PRICELIST&CN=DOMAIN&ST=REGION&L=CITY&O=ORGANIZATION&OU=ORG_UNIT&emailAddress=EMAIL
NONE

Заказ выполняется с помощью функции certificate.order.csr, которая имеет параметры:

  • authinfo – данные доступа к биллингу в формате EMAIL:PASSWORD;

  • field_country – код страны (182 - Россия);

  • period – период в месяцах (12 или 24);

  • pricelist – идентификатор тарифного плана (см. Таблицу SSL-сертификатов );

  • CN – домен;

  • ST – регион;

  • L – город;

  • O – организация;

  • OU – подразделение (необязательно);

  • emailAddress – электронная почта (необязательно).

При успешном ответе в полях model.csr и model.key будут содержаться запрос и ключ, которые необходимо сохранить для дальнейшего использования.

Заказ SSL-сертификата

Для заказа SSL-сертификата нужно отправить запрос вида:

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.order.param&sok=ok&skipbasket=on&crt_type=generate&field_country=COUNTRY&period=12&pricelist=PRICELIST&CN=DOMAIN&ST=REGION&L=CITY&O=ORGANIZATION&OU=ORG_UNIT&emailAddress=EMAIL&adm_fname=NAME&adm_lname=LASTNAME&adm_jtitle=POSITION&adm_email=EMAIL&adm_phone=PHONE&tech_fname=NAME&tech_lname=LASTNAME&tech_jtitle=POSITION&tech_email=EMAIL&tech_phone=PHONE&approver_email_1=EMAIL&csr=CSR&key=KEY
CODE

Заказ выполняется с помощью функции certificate.order.param, которая имеет параметры:

  • authinfo – данные доступа к биллингу в формате EMAIL:PASSWORD;

  • skipbasket – при передаче значения on добавление в корзину будет пропущено, и оплата сразу спишется с лицевого счета;

  • field_country – код страны (182 – Россия);

  • period – период в месяцах (12 или 24);

  • pricelist – идентификатор тарифного плана (см. Таблицу SSL-сертификатов );

  • CN – домен;

  • ST – регион;

  • L – город;

  • O – организация;

  • OU – подразделение (необязательно);

  • emailAddress – адрес электронной почты (необязательно);

  • adm_fname – имя административного контакта;

  • adm_lname – фамилия административного контакта;

  • adm_jtitle – должность административного контакта;

  • adm_email – адрес электронной почты административного контакта;

  • adm_phone – телефон административного контакта;

  • tech_fname – имя технического контакта;

  • tech_lname – фамилия технического контакта;

  • tech_jtitle – должность технического контакта;

  • tech_email – адрес электронной почты технического контакта;

  • tech_phone – телефон технического контакта;

  • approver_email_1 – адрес электронной почты для подтверждения сертификата; данный адрес должен быть одним из адресов, где DOMAIN - это домен, переданный в параметре CN:

    • admin@DOMAIN;

    • administrator@DOMAIN;

    • hostmaster@DOMAIN;

    • postmaster@DOMAIN;

    • webmaster@DOMAIN;

  • csr - ключ csr, полученный при получение секретного ключа;

  • key - ключ key, полученный при получение секретного ключа.

Заказ SSL-сертификата с уже существующим ключом (CSR)

Для заказа SSL-сертификата необходимо отправить запрос вида:

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.order.param&sok=ok&skipbasket=on&crt_type=manual&period=12&pricelist=PRICELIST&adm_fname=NAME&adm_lname=LASTNAME&adm_jtitle=POSITION&adm_email=EMAIL&adm_phone=PHONE&tech_fname=NAME&tech_lname=LASTNAME&tech_jtitle=POSITION&tech_email=EMAIL&tech_phone=PHONE&approver_email_1=EMAIL&csr=CSR
CODE

Заказ выполняется с помощью функции certificate.order.param, которая имеет параметры:

  • authinfo – данные доступа к биллингу в формате EMAIL:PASSWORD;

  • skipbasket – при передаче значения on добавление в корзину будет пропущено, и оплата сразу спишется с лицевого счета;

  • period – период в месяцах (12 или 24);

  • pricelist – идентификатор тарифного плана (см. Таблицу SSL-сертификатов );

  • adm_fname – имя административного контакта;

  • adm_lname – фамилия административного контакта;

  • adm_jtitle – должность административного контакта;

  • adm_email – адрес электронной административного контакта;

  • adm_phone – телефон административного контакта;

  • tech_fname – имя технического контакта;

  • tech_lname – фамилия технического контакта;

  • tech_jtitle – должность технического контакта;

  • tech_email – адрес электронной почты технического контакта;

  • tech_phone – телефон технического контакта;

  • approver_email_1 – адрес электронной почты для подтверждения сертификата; данный адрес должен быть одним из адресов, где DOMAIN - это домен, переданный в параметре CN:

    • admin@DOMAIN;

    • administrator@DOMAIN;

    • hostmaster@DOMAIN;

    • postmaster@DOMAIN;

    • webmaster@DOMAIN;

  • csr - ключ csr.

Выпуск существующего сертификата

Выпуск SSL-сертификата выполняется с помощью функции certificate.file. Параметр ORDER_ID – идентификатор сертификата.

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&func=certificate.file&elid=ORDER_ID&type=crt
CODE

Перевыпуск сертификата

Перевыпуск SSL-сертификата выполняется с помощью функции certificate.reissue. Параметр elid определяет сертификат, который необходимо перевыпустить.

Для перевыпуска SSL-сертификата нужно отправить запрос вида:

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.reissue.step2&elid={ID сертификата}&crt_type=oldrequest&approver_method=auth_email&sok=ok&approver_email_1={email подтверждения основного домена}&approver_email_{i}={email подтверждения дополнительного домена}
CODE
Пояснения

approver_email_{индекс домена} — используется для указания почты при перевыпуске сертификата с дополнительными доменами. Индекс основного домена — 1, для дополнительных доменов индекс начинается с 2.

При перевыпуске crt_type=oldrequest порядок индекса для approver_email определяется на основании порядка дополнительных доменов в узле altname, полученном в ответе на запрос func=certificate.edit&elid={ID сертификата}.

Для перевыпуска SSL-сертификата с указанием нового CSR нужно отправить запрос вида:

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.reissue.step2&elid={ID сертификата}&crt_type=manual&approver_method=auth_email&sok=ok&csr={urlencoded CSR}&approver_email_1={email подтверждения основного домена}&approver_email_{i}={email подтверждения дополнительного домена}
CODE
Пояснения

approver_email_{индекс домена} — используется для указания почты при перевыпуске сертификата с дополнительными доменами. Индекс основного домена — 1, для дополнительных доменов индекс начинается с 2.

При перевыпуске crt_type=manual порядок индекса для approver_email определяется на основании порядка дополнительных доменов в узле altname, полученном в ответе на запрос func=certificate.edit&elid={ID сертификата}.

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

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.reissue.step2&elid={ID сертификата}&crt_type=altname&approver_method=auth_email&sok=ok&altname={urlencoded список дополнительных доменов через пробел}&approver_email_1={email подтверждения основного домена}&approver_email_{i}={email подтверждения дополнительного домена}
CODE
Пояснения

approver_email_{индекс домена} — используется для указания почты при перевыпуске сертификата с дополнительными доменами. Индекс основного домена — 1, для дополнительных доменов индекс начинается с 2.

При перевыпуске с указанием новых доменов crt_type=altname индекс для approver_email определяется позицией дополнительного домена в параметре altname. Например, если altnames=ex1.com ex2.com, то approver_email_2 — почта для подтверждения ex1.com, approver_email_3 — почта для подтверждения ex2.com).

Удаление сертификата

Удаление сертификата выполняется с помощью функции certificate.delete. Параметр elid определяет сертификат, который необходимо удалить.

Для удаления SSL-сертификата необходимо отправить запрос вида:

https://api.ispmanager.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=certificate.delete&elid=<код лицензии>&sok=ok
CODE

Получение списка стран с цифровыми кодами

Узнать актуальный список стран с соответствующими им идентификаторами возможно с помощью функции certificate.order.csr.

https://api.ispmanager.com/billmgr?authinfo=EMAIL:PASSWORD&out=bjson&func=certificate.order.csr&period=12&pricelist=PRICELIST
CODE

Успешный ответ будет содержать:

  • k – идентификатор страны;

  • v – название страны.