Документация BILLmanager 5

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

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

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

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

Настройка интеграции происходит в процессе создания обработчика услуг в BILLmanager, страница Интеграция Обработчики услуг Создать:

  1. Выберите Тип продукта. Для перепродажи SSL-сертификатов следует выбрать "SSL сертификат".
  2. Выберите в качестве Модуля обработки "BILLmanager".
  3. На шаге Настройка интеграции введите информацию, необходимую для интеграции с BILLmanager.
  4. Введите в поле URL — адрес BILLmanager ISPsystem: https://api.ispsystem.com.
  5. Введите в поле Имя пользователя — имя аккаунта в биллинговой системе.

    Обратите внимание!
    Используйте для каждого перепродающего BILLmanager свой аккаунт в продающем BILLmanager. Иначе взаимодействие биллинговых систем может быть нарушено.
  6. Введите в поле Пароль — пароль аккаунта в биллинговой системе. Нажмите Далее.
  7. На шаге Параметры обработчика услуг настройте параметры обработчика услуг. 

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

Импорт тарифных планов выполняется в разделе Продукты Тарифные планы Импорт.

  1. Выберите обработчик услуг, созданный на этапе интеграции. 
  2. Выберите Тип продукта для перепродажи и его Тарифный план. Укажите Провайдера.

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

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

В статье приведены API запросы, позволяющие заказать лицензию в системе https://api.ispsystem.com и выполнить с ней доступные действия.

API адрес биллинговой платформы ISPsystem: https://api.ispsystem.com.

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

user — имя пользователя в биллинговой системе https://api.ispsystem.com;

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

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

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

ip — IP-адрес, на который будет заказан сертификат.

period — период заказа. Доступен период заказа на 1 месяц, соответственно параметр принимает значение period=1.

pricelist — код тарифного плана.

ID тарифного плана
Пример вызова функции
func=certificate.order.param&CN=example.com&L=Moscow&O=Moscow&OU=&ST=Moscow&adm_email=test@test.com&adm_fname=Test&adm_jtitle=Test&adm_lname=Test&adm_phone=+7 (111) 111-11-11&adm_phone_country=182&approver_email_1=admin@example.com&approver_method=auth_email&auth_file_protocol=off&clicked_button=next&country=182&crt_type=generate&csr=
&delete_private_key=off&domain_count=&emailAddress=&field_country=182&hfields=csr&hide_csr_fields=&itemtype=&key=
&like_admin=on&newbasket=&org_address=1&org_city=Moscow&org_country=182&org_department=1&org_name=Test&org_phone=+7 (111) 111-11-11&org_phone_country=182&org_postcode=1111111&org_state=Moscow&period=12&pricelist=115&tech_email=test@test.com&tech_fname=Test&tech_jtitle=Test&tech_lname=Test&tech_phone=+7 (111) 111-11-11&tech_phone_country=182

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

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

Перевыпуск по старым данным:

Пример вызова функции
func=certificate.reissue.step2&elid={ID сертификата}&crt_type=oldrequest&approver_method=auth_email&sok=ok&approver_email_1={email подтверждения основного домена}&approver_email_{i}={email подтверждения дополнительного домена}
Пояснения

Перевыпуск с указанием нового CSR:

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

Перевыпуск с указанием новых доменов:

Пример вызова функции
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 определяет сертификат, который необходимо удалить.

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