подпись эцп

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

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

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

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

Настраиваем робота для подписания в Битрикс24
Приложение предназначено для подписания файлов с помощью Электронно Цифровой Подписи (ЭЦП) в интерфейсе Битрикс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 загруженных файлов

Возвращаемые значения

ID подписанного файла(ов)

Это ID файла на Битрикс24.Диск

ID файла(ов) в системе
ID файлов для сохранения в свойства универсальных список, полях бизнес процессов, полях CRM сущностей
Информация об ЭЦП
Информация о всех ЭЦП, которыми были подписаны файлы в следующей структуре

  • Информация о подписях файла 1
  1. Информация о подписи 1 файла 1
  2. Информация о подписи 2 файла 1
  3. Информация о подписи n файла 1

  • Информация о подписях файла 2
  1. Информация о подписи 1 файла 2
  2. Информация о подписи 2 файла 2
  3. Информация о подписи n файла 2

  • Информация о подписях файла n….
  1. Информация о подписи 1 файла n
  2. Информация о подписи 2 файла n
  3. Информация о подписи n файла n
В общем случае для того чтобы извлечь информацию о подписях нужно:

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

2. Выполнять последовательно несколько вложенных итераций

2.1 Итерация по Информации о подписях файлов, т.е. итерация по файлам. Если файл один то этого не требуется.

2.2 Итерация по подписям ЭЦП конкретного файла. Для данной информации вводится отдельная переменная (тип строка, множественная). Чтобы заполнить эту переменную нужно Информацию по подписям конкретного файла разбить (функция explode в форме вставки значения БП) по разделителю «#»

2.3 Далее идет итерация по информации уже конкретной подписи. Для этого так же создается переменная (строка, множественная)
Формат строки
<штамп эцп>|<Владелец>|<Издатель>|<Действительна с>|<Действительна по>
К примеру
1AC9B766C4C1FFCA71CBDC6511A9800EBFDD3798|Сидоров DSS|"Тестовый подчиненный УЦ ООО ""КРИПТО-ПРО"" ГОСТ 2012 (УЦ 2.0)"|01.11.2022 03:53:15 UTC|01.02.2023 04:03:15 UTC
Разбиваем эту информацию по разделителю «|»

2.4 Далее создаем переменные для Штампа ЭЦП, Владельца, С, По. Заполняем их итерацией по предыдущей переменной с учетом индекса.

2.5 После этого генерируем файл с Визуализацией ЭЦП и сохраняем его если требуется.
Файл содержит информацию

Вэбхуки

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

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

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

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

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

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

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

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

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

Адрес офиса
НСО, Бердск, Ленина 69, офис 306
Новосибирск, Инженерная 5, офис 318