подпись эцп

Автоматизируйте Ваши бизнес-процессы вместе с нами. Полезно для Вашего бизнеса

ПОДПИСЫВАТЬ ДОКУМЕНТЫ ПРЯМО ИЗ БИТРИКС?

Приложение "Подпись ЭЦП" (B24eds) позволит Вам подписывать документы с помощью ЭЦП. Подписание файлов присоединенной и отсоединенной подписью

Как это работает?

Приложение предназначено для подписания файлов с помощью Электронно Цифровой Подписи (ЭЦП) в интерфейсе Битрикс24.

ЭЦП может быть как Неквалифицированной (НЭП) так и Квалифицированной (КЭП).
Возможно подписание файлов присоединенной (создается новый файл, который содержит подписываемый документ и подпись к нему) и отсоединенной подписью (подпись содержится в отдельном файле).

Ключевые особенности:

  • подписание документов ЭЦП происходит в интерфейсе вашего Битрикс24
  • подпись документов из карточки CRM (для подписания можно выбрать сгенерированные Битрикс24 документы либо выбрать файлы на локальном диске)
  • интеграция с Роботами - робот для подписания файлов с помощью ЭЦП для Роботизации бизнеса (RPA), Смарт-процессов, Лидов, Сделок
  • интеграция с Бизнес процессами - действие подписания файлов с помощью ЭЦП на Битрикс24.Диске, в Ленте новостей и Универсальных списках
  • механизм вэбхуков - после подписания документов из карточки CRM, они могут быть отправлены на указанный в настройках приложения адрес
Для работы потребуется
один из браузеров с поддержкой плагинов NPAPI
  • Mozilla Firefox
  • Google Chrome
  • Internet Explorer
  • Opera
  • Safari
Установить один из СКЗИ:
  • КриптоПро CSP версии 4.0 и выше
  • ViPNet CSP 4

ДОКУМЕНТАЦИЯ

Работа с приложением в Битрикс24

Подписание документов из карточки CRM

Подписание документов с помощью ЭЦП из карточки CRM доступно для:
  • Контактов
  • Компаний
  • Сделок
  • Лидов
Для запуска интерфейса подписание откройте карточку CRM и выберите один из пунктов меню (верхнего меню либо в таймлайне сущности).
Откроется интерфейс подписания.

интерфейс подписания

1 - Наименование сущности CRM либо элемента смарт процесса, либо элемента RPA, либо имя файла на Битрикс24.Диске
2 - Информация о КриптоПро ЭЦП Browser плагине и установленном криптопровайдере (CSP)
3 - Выбор сертификата ЭЦП
4 - Информация о ЭЦП
5 - Расширение для файла подписи. Возможные варианты: sig, p7s, sgn, p7b
6 - Тип подписи: присоединенная или отсоединенная.

доступна ПОДПИСЬ СГЕНЕРИРОВАННЫХ В Б24 ДОКУМЕНТОВ И ЗАГРУЖЕННЫХ С ПК

  • Если требуется подписание сгенерированных документов
    ---> перейдите на вкладку "Выбор из доступных файлов"
    ---> отметьте галочкой необходимые файлы

  • Если требуется подписать ЭЦП файлы с локального диска компьютера
    ---> перейдите на вкладку "Выбрать файлы с компьютера"
    ---> выберите или перетащите файлы в область
Предварительно убедитесь что:

  • КриптоПро ЭЦП Browser плагин загружен и активен
  • Выберите требуемый сертификат (если их несколько).
    * В списке отображаются только действительные на момент подписания сертификаты ЭЦП.
  • Укажите расширение файла подписи.
    * Выбранное расширения запоминается браузером.
  • Выберите тип подписи - присоединенная или отсоединенная

подписанные файлы крепятся В Карточке CRM

После подписания:
  • Файлы крепятся в карточке CRM
  • Отображается сведения о ЭЦП
В дальнейшем файлы могут быть выбраны для отправки по email либо сохранены на локальном компьютере.

Если требуется чтобы после подписания файл крепился в какое либо поле сущности, то можно воспользоваться механизмом вэбхуков либо подписывать файлы в рамках Бизнес процессов

Интеграция с Бизнес процессами

Робот для подписания документов

Робот для подписания
документов

Доступно в:

  • лидах
  • сделках
  • смарт-процессах
  • роботизации бизнеса (RPA)
  • в других CRM сущностях из редактора бизнес процессов
Действие подписи документа на Битрикс24.Диске

Доступно в:

  • файлам на Битрикс24.Диске
  • ленте новостей (БП организации)
  • элементам универсальных списков
  • в CRM сущностях
  • роботизации бизнеса (RPA)
Робота робота аналогична для всех сущностей - подписание файлов расположенных в поле типа файл. Поэтому его конфигурацию покажем на примере сделок.

1. В настройках полей для сделки создаем поле(я) типа Файл, если данного поля(ей) еще нет

Возможны следующие варианты:
  • Поле одно и множественное, тогда подписанные файлы могут сохраняться в него. Подписываемые файлы останутся так же в этом поле
  • Два множественных поля. Тогда из одного поля файлы берутся на подпись, а в другое поле сохраняются
  • Поле не множественное, в этом случае требуется два поля типа Файл. Для подписываемого файла и подписанного В примере ниже показан второй вариант
2. При необходимости создаем дополнительную стадию, на которой будет срабатывать робот
3. Переходим в добавление роботов для этой стадии
4. Настраиваем робота:
  • указываем поля
  • указываем текст сообщения ответственному
  • выбираем ответственного за подписание
5. Для отображения диалога подписания файлов требуется кликнуть на сообщение. Укажите файлы, требующие подписания
6. После подписания будет отображено сообщение "Задача выполнена. Документ(ы) подписаны
7. Файлы сохраняются в указанном в настройках робота поле
Настройка робота через дизайнер бизнес процессов аналогична

1. Добавляем робота в шаблон
2. Производим его настройку

Действие подписи документа на Битрикс24.Диске

Робота действия аналогична для всех процессов - подписание файлов расположенных на Битрикс24.Диске. Поэтому его конфигурацию покажем на примере настроек бизнес процесса по файлам на битрикс24.Диске

1. Активируем бизнес процессы на диске компании (если они не активированы)
2. Создаем бизнес процесс подписания документов с помощью ЭЦП
3. В блоке Действия приложений выбираем [Подпись ЭЦП] Подпись документа на Битрикс24.Диске
4. Вводим следующие настройки параметров
5. Запускаем бизнес процесс в контекстном меню файла
6. Подписывающему придет системное уведомление
7. Для отображения диалога подписания файлов требуется кликнуть на сообщении и нажать кнопку подписать
8. После подписания высвечивается сообщение об успешности процесса
9. Подписанный файл находится в той же папки что и оригинальный документ
10. Выходными параметрами действия подписания является id файла(ов) на Битрикс диске

В других типах бизнес процессов следует придерживаться следующих правил:
--> Если файлы для подписания берутся из входных параметров бизнес процесса, то их следует сохранить сначала на диск пользователя либо на диск компании
--> Далее в действии подписания документов передать id загруженных файлов

Вэбхуки

Приложение реализует механизм вэбхуков.

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

Для активации вэбхука вы должны иметь административные права в вашем Битрикс24.

Чтобы указать адрес вэбхука откройте главный интерефейс приложения (из левого главного меню либо Карта сайт -> Маркет -> Подпись ЭЦП) В поле "Адрес вэбхука" указываем требуемый адрес, к примеру
Формат отправляемых данных
 [
      'memberId' => '' '
       entityTypeId'=> '',
       'entityId' => '',
       'sinatureType' => '',
       'originalFile' => [
               'name' => '',
               'content' => ''
           ],
       'signedFile' => [
       'name' => '',
       'content' => ''
             ]
       ]
Описание параметров:
- member_id - ID вашего портала, значение для вашего Битрикс24 выводится автоматически.
- entityTypeId - Тип сущности. Возможные значения: 1 - лид, 2 - сделка, 3 - контакт, 4 - компания
- entityId - ID сущности
- sinatureType - Тип подписи. Возможные значения: attached - прикрепленная, detached - открепленная
- signedFile - Файл подписи (для открепленной подписи) или результирующий подписанный файл (для прикрепеленной подписи).
name - имя файла, content - содержимое файла
- originalFile - Оригинальный файл в случае открепленной подписи. Значение будет отсутствовать в случае прикрепленной подписи. name - имя файла, content - содержимое файла
Обратите внимание, даже если логика обработки файлов не реализована, но вы хотите указать урл для тестирования, ваш скрипт в любом случае должен возвращать текст "OK", чтобы сохранить настройки.

Тестирование

Для тестирования решения, если у вас нету ЭЦП, можно воспользоваться тестовым сертификатом ЭЦП.

  • если вы планируете использовать КриптоПро CSP, то сгенерировать тестовый сертификат можно на странице
  • если вы планируете использовать ViPNet CSP, то сгенерируйте запрос на тестовый сертификат из Все программы > ViPNet > ViPNet CSP > Создание запроса на сертификат. Далее загрузите этот файл на странице
 В обоих случаях требуется, чтобы был установлен Корневой сертификат тестового удостоверяющего центра в список доверенных сертификатов.
Настраиваем робота для подписания в Битрикс24

наши контакты

Пожалуйста, свяжитесь с нами если у Вас возникли любые вопросы по продукту или возможности расширения функционала.
Наша поддержка будет рада Вам ответить!

Адрес офиса
НСО, Бердск, Вокзальная 26, офис 211Б
Новосибирск ул. Карла Маркса 30/1, офис 215