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

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

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

Перепродажа через 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.

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

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

Заказ выполняется с помощью функции 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

Заказ выполняется с помощью функции 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

Заказ выполняется с помощью функции 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

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

Перевыпуск 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 подтверждения дополнительного домена}

Для перевыпуска 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 подтверждения дополнительного домена}

Для перевыпуска 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 подтверждения дополнительного домена}

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

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

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

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

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

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

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

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

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

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