Настоящая инструкция описывает процесс развертывания экземпляра ПО «Личный кабинет агента банка 2.0».
- 1 vCPU
- 2 Gb RAM
- 10 Gb HDD
- любая современная ОС семейства Linux
- Docker v.19 или выше
- Docker Compose v.1.26 или выше
- PostgreSQL v.12 или выше
Для работы с ПО требуется предварительно заключить агентские договора с одним или несколькими банками из списка, приведённого ниже. После заключения договора банки предоставят реквизиты доступа (API-ключи и т.д.), которые необходимо будет подставить вместо тестовых значений.
Тестовые значения приводятся для примера, их можно использовать для тестирования ПО, реальные заявки в банки с их помощью отправляться не будут.
- URL для отправки заявок
- URL для получения списка заявок
- токен
- URL для отправки заявок
- URL для получения списка заявок
- API-ключ
- API-секрет
- ID агента
- URL для отправки заявок
- URL для получения списка заявок
- токен
Эти реквизиты доступа нужны для администрирования ПО (см. документацию API). Значения этих реквизитов могут быть произвольными (агент самостоятельно их придумывает), но в целях безопасности рекомендуется следовать следующим требованиям:
- не менее 8 символов
- не должно быть легко подбираемым словарным словом (admin, manager и т.д.)
- не менее 16 символов
- содержит строчные и заглавные буквы
- содержит цифры
- содержит символы пунктуации
- Создать новую базу данных в PostgreSQL, например:
CREATE DATABASE partnerka;
CREATE USER partnerka WITH ENCRYPTED PASSWORD 'wqkMYYfUNk9PP2yfc';
GRANT ALL PRIVILEGES ON DATABASE partnerka TO partnerka;
-
Перейти в каталог с приложением.
-
Указать необходимые реквизиты в файле .env (см. описание ниже):
$ cp .env.example .env
$ vim .env- Запустить приложение в Docker:
$ docker-compose build
$ docker-compose up -d- Для отправки тестовых JSON-запросов можно использовать Postman, Insomnia, cURL или их аналоги.
| Параметр | Описание |
|---|---|
| JAR_FILE | Путь к JAR-файлу (относительный) |
| DATASOURCE_URL | URL БД |
| DATASOURCE_USERNAME | Имя пользователя БД |
| DATASOURCE_PASSWORD | Пароль БД |
| LOGGING_LEVEL_ORG | Уровень журналирования для библиотек |
| LOGGING_LEVEL_COM | Уровень журналирования для приложения |
| APP_ADMIN_USERNAME | Имя пользователя менеджера |
| APP_ADMIN_PASSWORD | Пароль менеджера |
| APP_BANK_OPEN_URL_CREATE | Открытие: URL для отправки заявок |
| APP_BANK_OPEN_URL_FETCH | Открытие: URL для получения списка заявок |
| APP_BANK_OPEN_API_TOKEN | Открытие: токен |
| APP_BANK_TINKOFF_URL_CREATE | Тинькофф: URL для отправки заявок |
| APP_BANK_TINKOFF_URL_FETCH | Тинькофф: URL для получения списка заявок |
| APP_BANK_TINKOFF_API_KEY | Тинькофф: API-ключ |
| APP_BANK_TINKOFF_API_SECRET | Тинькофф: API-секрет |
| APP_BANK_TINKOFF_API_ID | Тинькофф: ID агента |
| APP_BANK_TOCHKA_URL_CREATE | Точка: URL для отправки заявок |
| APP_BANK_TOCHKA_URL_FETCH | Точка: URL для получения списка заявок |
| APP_BANK_TOCHKA_API_TOKEN | Точка: токен |
JAR_FILE=target/partnerka-1.1.4-RELEASE.jar
DATASOURCE_URL=jdbc:postgresql://localhost:5432/partnerka
DATASOURCE_USERNAME=partnerka
DATASOURCE_PASSWORD=wqkMYYfUNk9PP2yfc
LOGGING_LEVEL_ORG=ERROR
LOGGING_LEVEL_COM=DEBUG
APP_ADMIN_USERNAME=admin
APP_ADMIN_PASSWORD=NeJigaMYL4WulPaIc
APP_BANK_OPEN_URL_CREATE=https://www.regberry.ru/import/2022-08-14/open-create.php
APP_BANK_OPEN_URL_FETCH=https://www.regberry.ru/import/2022-08-14/open-fetch.php
APP_BANK_OPEN_API_TOKEN=test
APP_BANK_TINKOFF_URL_CREATE=https://www.regberry.ru/import/2022-08-14/tinkoff-create.php
APP_BANK_TINKOFF_URL_FETCH=https://www.regberry.ru/import/2022-08-14/tinkoff-fetch.php
APP_BANK_TINKOFF_API_KEY=test
APP_BANK_TINKOFF_API_SECRET=test
APP_BANK_TINKOFF_API_ID=test
APP_BANK_TOCHKA_URL_CREATE=https://www.regberry.ru/import/2022-08-14/tochka-create.php
APP_BANK_TOCHKA_URL_FETCH=https://www.regberry.ru/import/2022-08-14/tochka-fetch.php
APP_BANK_TOCHKA_API_TOKEN=testВ случае возникновения вопросов по развёртыванию ПО «Личный кабинет агента банка 2.0» свяжитесь с нами по следующим контактным данным:
- +7 (499) 755-85-96
- contact@1c-start.biz