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

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

ISPSystem

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


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

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

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

  1. Выберите Тип продукта. Для перепродажи SSL-сертификатов следует выбрать "SSL сертификат".
  2. Выберите в качестве Модуля обработки "BILLmanager".
  3. На шаге Настройка интеграции введите информацию, необходимую для интеграции с BILLmanager.

  4. Введите в поле URL — адрес BILLmanager ISPsystem: https://api.ispmanager.com.
  5. Введите в поле Имя пользователя — имя аккаунта в биллинговой системе.

    Обратите внимание!

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

  6. Введите в поле Пароль — пароль аккаунта в биллинговой системе. Нажмите Далее.
  7. На шаге Параметры обработчика услуг настройте параметры обработчика услуг. 

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

НаименованиеId
EV SSLpricelist=55330
OrganizationSSL WildCardpricelist=55329
OrganizationSSLpricelist=55328
Domain ServerSign Wildcardpricelist=55327
Domain ServerSignpricelist=55326
AlphaSSL Wildcardpricelist=55325
AlphaSSLpricelist=55324
Comodo EV SSL certificatepricelist=55153
GeoTrust True BusinessID Multi Domain (включено 5 доменов)pricelist=27652
GeoTrust True BusinessID with EV Multi Domain (включено 5 доменов)pricelist=27651
Comodo PositiveSSL Wildcardpricelist=27650
Comodo PositiveSSL Multi Domain Wildcard (включено 3 домена)pricelist=27649
Comodo PositiveSSL Multi Domain (включено 3 домена)pricelist=27648
Comodo Positive SSLpricelist=3033
Comodo Premium WildCardpricelist=2028
Comodo Essential SSL WildCardpricelist=2027
Comodo Instant SSLpricelist=2026
Comodo Essential SSLpricelist=2025
Symantec Secure Site Pro with EVpricelist=2024
Symantec Secure Site with EVpricelist=2023
Symantec Secure Site Propricelist=2022
Symantec Secure Sitepricelist=2021
Geotrust True BusinessID WildCardpricelist=2020
Geotrust True BusinessIDpricelist=2019
Geotrust Quick SSL Premiumpricelist=2018
Thawte SSL Web Server with EVpricelist=2015
Thawte SSL Wildcardpricelist=2014
Thawte SSL Web Serverpricelist=2012
GeoTrust True BusinessID with EVpricelist=1032
Thawte SSL123pricelist=1013
RapidSSL Wildcardpricelist=1012
RapidSSLpricelist=1011
Пример вызова функции
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 подтверждения дополнительного домена}

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

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

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

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

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

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

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

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

Пример вызова функции
https://api.ispmanager.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=certificate.delete&elid=<код лицензии>&sok=ok
Спасибо за ваш отзыв!
Была ли полезна статья?
Уточните, почему:

статья не соответствует названию

статью сложно понять

в статье нет ответа на мой вопрос

рекомендации из статьи не помогли

другая причина

Расскажите, что вам не понравилось в статье: