Справка

Конфигурационные параметры

Безоблачный Pyrus

В этом разделе представлены обязательные и опциональные параметры, которые используются для настройки Pyrus Datacenter.

Чтобы добавить или изменить параметр, выполните команду:

$ docker-compose run --rm pyrus-setup --setup -id [ID_SETUP_PARAM] -v [NEW_VALUE]

Пример:

$ docker-compose run --rm pyrus-setup --setup -id 101301 -v smtp.mycompany.org

Чтобы запустить сервисы, сконфигурируйте следующие параметры.

  • Лицензия приложения. Ее нужно получить у вашего аккаунт-менеджера или партнера.
  • Домен приложения, по которому ваши пользователи будут обращаться к системе, например: pyrus.yourdomain.org.
  • Параметры доступа к вашему SMTP-серверу. Pyrus использует электронную почту для доставки одноразовых кодов доступа и уведомлений. Возможно настроить при первом запуске системы.
  • Настройка хранения файлов. Поддерживается хранение файлов в S3-совместимых хранилищах.

Подсказка: при обновлении параметров может потребоваться перезапуск контейнеров.

Обязательные параметры

100000 LICENSEЛицензия приложения.
100001 HOSTNAMEДомен основного приложения, пример: pyrus.yourdomain.org.
101301 SMTP_SERVERИмя SMTP-сервера, пример: mx‑out.youdomain.org.
101302 SMTP_PORTSMTP-порт. Значение по умолчанию: 25.
101401 SMTP_USE_SSLИспользование SSL для подключения к SMTP-серверу. Значение по умолчанию: false.
101501 SMTP_CREDENTIALSИспользование Credentials (bool) для подключения к SMTP-серверу. Значение по умолчанию: false. В значении true должны быть заданы параметры SMTP_USERNAME и SMTP_PASSWORD.
101554 SMTP_NOTIFIER_ADDRESSПочтовый адрес, от имени которого необходимо отправлять уведомления на почту, пример: notifier@youdomain.org.
101555 SMTP_LOST_PASSWORD_ADDRESSПочтовый адрес, от имени которого необходимо отправлять запрос на создание/восстановление пароля, пример: recover.password@youdomain.org.
9910001 USE_DATABASE_FILE_STORAGEДля версий до 1.12 включительно. Использование локальной БД для хранения файлов (bool). Если вы планируете хранить файлов только в БД, дополнительная настройка не требуется. Значение по умолчанию: true. Если установлен в false, то в опциональных параметрах должен быть указан один из альтернативных сервисов для хранения файлов.

Опциональные параметры

101502 SMTP_USERNAMEЛогин для подключения к к SMTP-серверу. Используется, если параметр SMTP_CREDENTIALS установлен в true.
101503 SMTP_PASSWORDПароль для подключения к к SMTP-серверу. Используется, если параметр SMTP_CREDENTIALS установлен в true.
110007 PREVIEW_GENERATOR_TYPEДля версий от 1.15 включительно. Режим генератора превью документов и печатных форм. Возможные значения: 0 — LibreOffice; 1 — Chrome (Puppeteer). Если не заполнено, используется значение 0.

9911001

FILE_STORAGE_MIN_UPLOADS

9911571 FILE_STORAGE_1

9911572 FILE_STORAGE_2

9911573 FILE_STORAGE_3

9911574 FILE_STORAGE_4

9911575 FILE_STORAGE_5

9911576 FILE_STORAGE_6

9911577 FILE_STORAGE_7

9911578 FILE_STORAGE_8

Для версий от 1.12.1 и выше. Используются для хранения настроек хранилища файлов. Настройка S3-хранилища в установках Pyrus Datacenter версии 1.12.1 и выше производится так, как описано здесь.

9900301 DadataTokenAPI ключ для интеграциии с DaData.
1040000 DiadocClientIdКлюч разработчика для интеграциии с Диадок.

Для просмотра текущей конфигурации системы выполните команду:

$ docker-compose run --rm pyrus-setup --setup -ls

Для просмотра значения конкретного параметра выполните команду:

$ docker-compose run --rm pyrus-setup --setup -ls -id [ID_SETUP_PARAM]

Пример настройки параметров SMTP-сервера

Допустим, у вас есть почтовый ящик yourfavoritemail@yandex.ru и пароль yoursupersecurepwd, и вы хотите использовать его для отправки уведомлений. Тогда настройка SMTP-сервера будет выглядеть следующим образом.

$ docker-compose run --rm pyrus-setup --setup -id 101302 -v 465
$ docker-compose run --rm pyrus-setup --setup -id 101401 -v true
$ docker-compose run --rm pyrus-setup --setup -id 101301 -v smtp.yandex.ru
$ docker-compose run --rm pyrus-setup --setup -id 101501 -v true
$ docker-compose run --rm pyrus-setup --setup -id 101502 -v yourfavoritemail@yandex.ru
$ docker-compose run --rm pyrus-setup --setup -id 101503 -v yoursupersecurepwd
$ docker-compose run --rm pyrus-setup --setup -id 101554 -v yourfavoritemail@yandex.ru
$ docker-compose run --rm pyrus-setup --setup -id 101555 -v yourfavoritemail@yandex.ru

Автоматическая загрузка в форму данных компаний

Чтобы в форму автоматически добавлялись реквизиты, адреса и другие данные организаций и банков из базы ЕГРЮЛ, необходимо:

  1. Зарегистрироваться на сайте DaData.
  2. Получить API ключ на странице профиля.
  3. Настроить интеграцию с DaData в Pyrus. Для этого необходимо выполнить команду:
$ docker-compose run --rm pyrus-setup --setup -id 9900301 -v 'Token xxxxxxxxx'

Обратите внимание: xxxxxxxxx в примере – это API-ключ сервиса DaData.

Интеграция с Диадок

Для подключения интеграциии с ЭДО Диадок в Pyrus Datacenter 1.14 и более поздних версиях необходимо:

  1. Оставить заявку на получение Ключа разработчика на странице API в сервисе Диадок.
  2. Настроить интеграцию с Диадок в Pyrus. Для этого необходимо выполнить команду:
$ docker-compose run --rm pyrus-setup --setup -id 1040000 -v 'xxxxxxxxx'

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

  • xxxxxxxxx в примере – это Ключ разработчика сервиса Диадок;
  • чтобы интеграция работала, необходимо обязательно подключить [автоматическую загрузку](/ru/help/datacenter/
  • parameters#avtomaticheskaya-zagruzka-v-formu-dannyh-kompanij) в форму данных компании.

Интеграция с HeadHunter

Для подключения интеграции с сервисом HeadHunter в Pyrus Datacenter 1.16 и более поздних версиях вам необходима действующая учетная запись в HeadHunter с подтвержденным ИНН.

Далее следует выполнить следующие действия.

  1. Создать приложение в HeadHunter пройдя по ссылке.

  2. Войти в свой аккаунт HeadHunter и заполнить заявку, указав:

    • Название приложения: [Название вашей компании] HeadHunter integration.
    • Redirect URI: https://yourdomain.com/integrations/oauthorization.
    • Контактное лицо — контактная информация ответственного сотрудника. вашей компании.
    • Приложением будут пользоваться: сотрудники компании.
    • Информация о создателе приложения: название вашей компании.
    • Кто будет его использовать: сотрудники компании.
    • Какие задачи должно решать приложение: приложение будет реагировать на вебхуки HeadHunter и создавать задачи в приложении Pyrus для более легкого управления процессом рекрутинга.
    • Функциональные возможности:
      • авторизация;
      • подпись на вебхуки — post/webhook/subscriptions;
      • получение резюме заинтересовавших кандидатов — resumes/{resume_id};
      • скачивание резюме в формате pdf.

    Обратите внимание: HeadHunter может рассматривать заявку несколько дней.

  3. Настроить интеграцию. Для этого выполните команды:

$ docker-compose run --rm pyrus-setup --setup -id 9902003 -v 'ClientID'
$ docker-compose run --rm pyrus-setup --setup -id 9902004 -v 'Client secret'

Подсказка: Client ID и Client Secret необходимо взять на этой странице после согласования вашей заявки со стороны HH.

Обратите внимание: при обновлении данных HeadHunter произведет вызов серверной версии Pyrus Пайруса по URL https://<yourdomain.com>/headhunterwebhook/**. Для корректной работы интеграции установленный у вас Pyrus DataCenter не должен блокировать такие запросы.

Интеграция с Яндекс Телемост

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

Для подключения интеграции с Яндекс Телемост в Pyrus Datacenter 1.17 и более поздних версиях выполните следующие действия.

Создайте приложение в Яндекс

  1. Войдите в аккаунт в Яндексе и пройдите по ссылке.

  2. Укажите название своего сервиса (вы можете выбрать любое произвольное имя).

  3. В разделе Платформы приложения выберите веб-сервисы:

    • Redirect URL https://<yourpyrusdomain.com>/meeting/oauth;
    • Suggest Hostname https://<yourpyrusdomain.com>.

  4. В разделе Доступ к данным добавьте необходимый набор прав доступа: login:email; login:info; telemost-api:conferences.read; telemost-api:conferences.create; telemost-api:conferences.update; telemost-api:conferences.delete.

Настройте интеграцию в Pyrus

  1. В SetupParam укажите данные приложения в Яндексе — ClientID и Client secret:

     $ docker-compose run --rm pyrus-setup --setup -id 99000181 -v 'ClientID'
     $ docker-compose run --rm pyrus-setup --setup -id 99000182 -v 'Client secret'
    

  2. Перейдите в пользовательский раздел Pyrus и откройте вкладку Авторизация.

  3. Нажмите Подключить Яндекс Телемост.

  4. Введите авторизационные данные вашего аккаунта в Яндекс 360 для бизнеса.

Интеграция с Zoom

Обратите внимание: интеграция подразумевает подключение одной учетной записи Zoom для всех пользователей вашей организации.

Для подключения интеграции с сервисом Zoom в Pyrus Datacenter 1.17 и более поздних версиях выполните следующие действия.

Создайте приложение в Zoom

  1. Авторизуйтесь в вашей учетной записи Zoom и войдите в Zoom App Marketplace.

  2. В верхней правой части экрана нажмите вкладку Develop, выберите Build App, а затем — Server to Server.

  3. В разделе Information укажите информацию о вашей компании и контакты ответственного сотрудника.

  4. В разделе Scopes добавьте следующее:

    • meeting:write:meeting;
    • user:read:user.

  5. В разделе Activation активируйте ваше приложение.

Настройте интеграцию в Pyrus

  1. Для настройки интеграции выполните команды:

    docker-compose run --rm pyrus-setup --setup -id 9900900 -v 'Client ID'
    docker-compose run --rm pyrus-setup --setup -id 9900901 -v 'Client Secret'
    docker-compose run --rm pyrus-setup --setup -id 9900902 -v 'Verification Token'
    

    Подсказка: ClientId и ClientSecret можно скопировать в разделе App Credentials в Zoom.

    Verification Token находится в разделе Feature.

  2. Настройте S2S-авторизацию.

    docker-compose run --rm pyrus-setup set-config -n ZoomS2S:AccountId -v (Account id)
    

    Подсказка: Account id доступен в разделе App Credentials в Zoom.

Проверьте работу интеграции

  1. Нажмите значок камеры в нижней панели под блоком для ввода комментария.

  2. Поставьте галочку на зум и нажмите Создать.

    Детали видеовстречи и ссылка на подключение отобразятся в комментарии к задаче.

Была ли эта статья полезной?