Установка и настройка программного обеспечения

Установка и настройка ПО

Устанавливаемое на стороне магазина программное обеспечение (ПО) представляет собой CGI (Common Gate Interface) приложение, написанное на языке Perl. Оно выполняет следующие задачи:

Обеспечение защищенного обмена данными между АС и магазином.
Безопасный способ передачи данных платежного средства клиента: интерфейс для перенаправления броузера клиента на страницу АС, собирающую данные о кредитной карте клиента по защищенному каналу.
Визуализацию процесса обработки кредитной карты.

Для работы ПО магазина требуется наличие установленного интерпретатора языка PERL и дополнительных модулей CPAN (см. Приложение).

Распакуйте инсталляционный архив ПО магазина во временный каталог на сервере. Скопируйте папку shop, входящую в дистрибутив ПО магазина в некий каталог пространства web-сайта магазина, настройте каталог таким образом, чтобы в нем могли выполняться файлы-скрипты ‘cgi’ по запросу вида: http://<URL магазина>/shop/test.cgi

Проверьте, чтобы пользователь, с правами которого работает магазин (под Unix), имел право на чтение из каталога, в которой находятся ключи, право на запуск утилиты checker.exe и права на запись в подкаталог Sessions.

Для правильной работы ПО магазина под Unix необходимо установить права доступа к папке /shop такие же, как у web-сервера, который будет с ней работать (команда: chown –R nobody /shop, где /shop – корневой каталог ПО магазина).

Проверьте правильность указания пути к интерпретатору Perl для Вашей Unix операционной системы в первой строке следующих файлов: cybercrd.cgi, setshop.pl, test.cgi, result.cgi

Для определения пути к интерпретатору пользуйтесь командой which perl.

Обязательно для UNIX-систем:

Перед началом установки ПО магазина необходимо скомпилировать программу checker.exe, которая осуществляет криптозащиту передаваемой и принимаемой информации. Для этого нужно:

Скомпилировать библиотеку ipriv, которая находится в каталоге /Shop/ipriv/ дистрибутива, выполнив команду make.
Собрать checker.exe, выполнив команду make в каталоге /Shop/checker/. Для ОС Linux, BSD, Solaris, HP-UX в службе поддержки есть готовые скомпилированные варианты этой программы.
Переместите checker.exe в каталог /Shop.

Для инициации процесса установки ПО магазина выполните команду: perl setshop.pl (для Windows-платформы – команда setshop.bat под учетной записью "Администратор"). Этот файл содержит Perl-скрипт, результатом выполнения которого будут настроенные скрипты магазина. Перед запуском setshop.pl поместите файлы Random.bin, Secret.key и Pubkeys.key в каталог Keys (подкаталоги Real или Test, в зависимости от цели работы ПО) магазина. Проверьте наличие в каталоге файлов checker.exe и checker.ini. Ответьте на задаваемые программой инсталляции вопросы (первые три пункта требуются для предоставления электронного чека клиенту):

Режим работы магазина (тестовый, реальный)
Торговое наименование предприятия
Латинское наименование магазина в процессинге (необходимо уточнить в коммерческом отделе CyberPlat® ("КиберПлат") после регистрации магазина)
Контактные координаты (например, e-mail)
URL АС – card.cyberplat.ru/cgi-bin/GetForm.cgi для реальной системы и payment.cyberplat.ru/cgi-bin/GetForm.cgi для тестовой
Путь к каталогу ключей (например: /Shop/Keys )
Ключевую фразу-пароль для подписания сообщений от магазина, которую Вы использовали при создании криптографических ключей магазина

Примечание: Если Вы неверно ответили на вопросы, Вы можете сделать это еще раз, запустив файл setshop.pl(.bat). В случае, если меняется только комплект ключей, можно либо запустить этот файл, либо вручную изменить параметры в файле checker.ini (keypath, password, keynumber, bankkey), а также изменить некоторые параметры в Path.pm (пути в переменных $SIGN_TOOL и $SIGN_INI).

В результате будут созданы файлы Paths.pm, Data.pm и checker.ini. Эти файлы являются конфигурационными и допускают дополнительную настройку, описанную в разделе «Настройка дополнительных параметров».

Проверьте, чтобы пользователь, с правами которого работает магазин, имел право на чтение из каталога, в котором находятся ключи, право на запуск утилиты checker.exe и права на запись в подкаталог Sessions.

Теперь можно выполнить тестовый платеж: вызвать с любой клиентской машины скрипт test.cgi из дистрибутива ПО магазина. (например: http://<URL магазина>/shop/test.cgi).

Рекомендуется вынести каталог Keys из пространства web-сайта магазина (например, в корневой каталог) из соображений защиты ключей. В противном случае возможен несанкционированный доcтуп к ключам и конфигурационному файлу с кодовой фразой любого анонимного пользователя. Также рекомендуется выносить из web-пространства каталог Session, если магазин анализирует его для решения о предоставлении товара или услуги на основе неподписанных файлов сессий. Кроме того, следует озаботиться безопасной передачей входных параметров на скрипт cybercrd.cgi, дабы нерадивый клиент не мог исправить важные параметры.

Настройка дополнительных параметров

ПО магазина позволяет выполнять настройку дополнительных параметров, включать или отключать опции установленные по умолчанию.

Настраиваемые параметры файла Data.pm:

$EnterpriseName = 'ООО «Услуги Онлайн»';	Торговое наименование предприятия. Используется для отображения в электронном чеке
$MerchantName = 'Electronic books';	Латинское наименование магазина в процессинге. Используется для отображения в электронном чеке
$OperationType = 'e-commerce';	Тип операции. Не может быть изменено
$HelpDesk = 'books@some.ru';	Контактный email магазина
$LogLevel = 1;	Уровень детализации лог файла (cybercrd.log). Режимы: 1 – отладка (записываются все сообщения), 2 – сохранение ключевых моментов транзакции, 3 – сохранение только критических ошибок приложения
$WillConvert = 1;	Будет ли вестись суммарный файл транзакций checks.inf. Файл имеет формат: SessionID\|OrderID\|Status
$TerminalID = ‘’;	Код терминала. Устанавливается, если магазин имеет несколько терминалов ($ManyTerminals=1)
$ManyTerminals = 0;	Устанавливается в 1 если магазин имеет более одного терминала. По умолчанию отключена
$ManyChecks = 1;	Сохранять ли результаты авторизации в разных каталогах /Sessions_<TerminalID> (используется при наличии нескольких терминалов)
$ManyTemplates = 1;	Использовать ли разные шаблоны для каждого терминала. Опция работает, если создан каталог /Templates_<TerminalID> с файлами шаблонов. По умолчанию отключена
$Language = 'ru';	Язык интерфейса, используемый по умолчанию. Может иметь значения ‘ru’ и ‘en’. По умолчанию ‘ru’
$CheckParams = 1;	Выполнять ли проверку корректности введенных пользователем данных. 1 – да, 0 – нет. Опция может быть отключена только в тестовых целях. По умолчанию включена
$SaveSignedRequest = 0;	Сохранять ли подписанный магазином запрос. Если да, то запрос сохраняется в каталоге /Sessions в файлах с расширением ‘.in’. По умолчанию опция отключена
$SaveChecks = 1;	Сохранять ли чеки (подписанный ответ АС). Если да, то чек сохраняется в каталоге /Sessions в файлах с расширением ‘.res’. По умолчанию опция включена
$SaveSession = 1;	Сохранять ли файлы сессий (ответ АС без подписи). Если да, то сессия сохраняется в каталоге /Sessions в файлах с расширением ‘.sta’. По умолчанию опция включена

Настраиваемые параметры файла Paths.pm:

$SIGN_TOOL = '/home/httpd/cgi-bin/shop/keys/checker_exe';	Путь к утилите checker.exe. Может быть модифицирован при изменении каталога ключей (вместе с $SIGN_INI)
$SIGN_INI = '/home/httpd/cgi-bin/shop/keys/ checker_ini';	Путь к файлу настроек утилиты checker.exe. Может быть модифицирован при каталога ключей (вместе с $SIGN_TOOL)
$FORM_URL = 'card.cyberplat.ru/cgi-bin/GetForm.cgi ';	URL скрипта АС, принимающего запрос на авторизацию. Может быть изменен только при переносе скрипта и по согласованию с группой технической поддержки CyberPlat® ("КиберПлат")
$SHOP_IP = $ENV{'SERVER_ADDR'};	IP адрес сервера магазина. Может быть задан явно в случае, если это необходимо

Настраиваемые параметры файла checker.ini:

keypath= /home/httpd/shop_keys/;	Путь к каталогу ключей
password=1111111111;	Кодовая фраза, использованная при генерации ключей магазина
keynumber=11206;	код клиента (из третьей строки файла карточки ключа K<shop_code>.dat)
bankkey=1;	Код банка, берется из файла CyberCard.iks

Трубуют изменения только при формировании нового комплекта ключей. Параметры, указанные в таблице изменяются либо при переносе каталога ключей (изменяется только keypath), либо после генерации нового комплекта ключей (изменяются остальные параметры). Проще всего внести подобные изменения, запустив скрипт setshop, который выполнит все настройки автоматически. В случае проблем при ручной настройке обращайтесь в службу технической поддержки CyberPlat® ("КиберПлат").

Приложение: Интерпретатор языка Perl и дополнительные модули CPAN для Windows и Unix

Для работы ПО магазина необходимо иметь установленный интерпретатор языка Perl версии 5.005 и выше для Unix (его можно взять на официальном сайте Perl), и ActivePerl версии 522 и выше для Windows (его можно бесплатно взять на сайте ActiveState).

Описание настройки Microsoft Internet Information Server 4.0 и 5.0 для работы с Perl для Windows

Зайдите в меню Properties Вашего сайта и выберите закладку Home Directory.
Нажмите кнопку Configuration...
Нажмите кнопку Add.
В строке Executable выберите файл perl.exe (по умолчанию устанавливается в каталог c:\perl\bin\)
Добавьте к строке ввода %s %s, таким образом, окончательно она будет выглядеть следующим образом: c:\perl\bin\perl.exe %s %s.
Введите в строку Extension расширение .cgi
Выберите в меню Verbs радио-кнопку Limit to: и укажите GET,POST.
Установите чек-бокс Check that file exist во включенное состояние.

Описание настройки Microsoft Internet Information Server 2.0 для работы с Perl для Windows

После установки ActivePerl необходимо настроить Microsoft IIS таким образом, чтобы на файлы с расширением .cgi вызывался Perl. Для IIS версии 2 для этого необходимо в системном реестре в аздел
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC \Parameters\Script Map добавить поле с именем .cgi и присвоить ему значение соответствующее пути к файлу Perl.exe
(например: C:\Perl\bin\Perl.exe %s%s).

Стать Платежным агентом

123610, г.Москва, ЦМТ, Краснопресненская наб., д.12, подъезд 7, 12-й этаж,
отдел автоматического подключения

Для регионов:
8 (495) 981-80-80
Для Москвы:
8 495 967-02-20

Звонить с 9.00 до 18.00
по московскому времени

e-mail info@cyberplat.ru

Проверка проведения платежа