Руководство пользователя Отмена

Обзор веб-перехватчика Acrobat Sign

Поиск

Последнее обновление 18 сент. 2024 г.

Adobe Sign

Открыть приложение

Руководство пользователя Adobe Acrobat Sign

Новые возможности

Начало работы

Администрирование

Обзор Admin Console
Управление пользователями
1. Добавление пользователей
2. Создание пользователей, ориентированных на функции
  1. Технические учетные записи — управляемые API
  2. Служебные учетные записи — управляемые вручную
3. Проверка пользователей с ошибками подготовки
4. Изменение имени и адреса электронной почты
5. Изменение участия в группе
6. Изменение участия в группе с помощью интерфейса группы
7. Повышение роли пользователя до роли администратора
8. Типы идентификаторов пользователей и единый вход
9. Смена удостоверения пользователя
10. Аутентификация пользователей с помощью Microsoft Azure
11. Аутентификация пользователей с помощью Google Federation
12. Профили продуктов
13. Интерфейс входа
Параметры учетной записи/группы
1. Обзор параметров
2. Глобальные настройки
  1. Идентификатор и уровень учетной записи
  2. Новый интерфейс для получателей
  3. Рабочие процессы самостоятельного подписания
  4. Пакетная отправка
  5. Веб-формы
  6. Настраиваемые рабочие процессы отправки
  7. Рабочие процессы Power Automate
  8. Документы библиотеки
  9. Сбор данных формы с соглашениями
  10. Ограниченная видимость документа
  11. Прикрепление копии подписанного соглашения в формате PDF
  12. Добавление ссылки в сообщение электронной почты
  13. Добавление изображения в сообщение электронной почты
  14. Файлы, прикрепленные к электронному письму, получат имя
  15. Прикрепление отчета об аудите к документам
  16. Объединение нескольких документов в один
  17. Загрузка отдельных документов
  18. Добавление подписанного документа
  19. Делегирование для пользователей в моей учетной записи
  20. Предоставление права делегирования внешним получателям
  21. Право на подпись
  22. Право на отправку
  23. Полномочия на добавление электронных печатей
  24. Установка часового пояса по умолчанию
  25. Установка формата даты по умолчанию
  26. Пользователи, состоящие в нескольких группах (UMG)
    1. Переход на использование UMG
  27. Разрешения администратора группы
  28. Замена получателя
  29. Отчет об аудите
    1. Обзор
    2. Разрешение доступа без аутентификации на странице проверки транзакции
    3. Включение напоминаний
    4. Включение событий представления
    5. Включение счетчика страниц и вложений в соглашении
  30. Нижний колонтитул транзакции
  31. Сообщения и инструкции в приложении
  32. Файлы PDF с расширенным доступом
  33. Новый интерфейс авторинга
  34. Клиент в области здравоохранения
3. Настройка учетной записи
  1. Добавление логотипа
  2. Настройка названия и URL-адрес компании
  3. Добавление названия компании
  4. URL-адрес перенаправления после завершения работы с соглашением
4. Настройки подписи
  1. Корректно отформатированные подписи
  2. Предоставление получателям разрешения на добавление подписи
  3. Подписывающие стороны могут изменять свои имена
  4. Предоставление получателям разрешения на использование своих сохраненных подписей
  5. Пользовательские условия использования и соглашение о неразглашении
  6. Перемещение между получателями по полям форм
  7. Перезапуск процесса работы с документом
  8. Отклонение подписания
  9. Предоставление разрешения на использование штампов
  10. Добавление требования о том, чтобы подписывающие стороны указывали должность или название компании
  11. Предоставление подписывающим сторонам разрешения на печать и размещение рукописной подписи
  12. Отображение сообщений при электронном подписании
  13. Добавление требования о том, чтобы подписанты использовали мобильное устройство для создания подписи
  14. Запрос IP-адресов подписантов
  15. Исключение названия компании и должности из штампа участника
5. Цифровые подписи
  1. Обзор
  2. Загрузка и подписание в Acrobat
  3. Подписание с помощью цифровых подписей в облаке
  4. Включение метаданных для поставщиков идентификационных данных
  5. Запрещенные поставщики сервисов подписания в облаке
6. Электронные печати
7. Цифровое удостоверение
  1. Шлюз цифрового удостоверения
  2. Политика проверки личности
8. Параметры отчета
  1. Новый интерфейс для работы с отчетами
  2. Настройки классических отчетов
9. Параметры безопасности
  1. Параметры единого входа
  2. Настройки «Запомнить меня»
  3. Политика пароля для входа
  4. Надежность пароля для входа
  5. Продолжительность веб-сеанса
  6. Тип шифрования PDF
  7. Программный интерфейс
  8. Доступ к сведениям о пользователе и группе
  9. Допустимые диапазоны IP-адресов
  10. Общий доступ к учетной записи
  11. Полномочия на совместное использование учетных записей
  12. Средства управления совместным использованием соглашений
  13. Проверка личности подписывающей стороны
  14. Пароль для подписания соглашения
  15. Надежность пароля для документа
  16. Блокировка подписывающих сторон по геолокации
  17. Аутентификация по телефону
  18. Аутентификация на основе данных (KBA)
  19. Разрешение на извлечение страниц
  20. Истечение срока действия ссылки на документ
  21. Отправка сертификата клиента для веб-перехватчиков и обратных вызовов
  22. Метка времени
10. Параметры отправки
  1. Отображение страницы отправки после входа
  2. Добавление требования о вводе имени получателя при отправке
  3. Блокировка значений имени для известных пользователей
  4. Допустимые роли получателей
  5. Разрешение электронного заверения
  6. Группы получателей
  7. Получатели в копии
  8. Доступ получателя к соглашению
  9. Обязательные поля
  10. Прикрепление документов
  11. Сведение полей
  12. Изменение соглашений
  13. Название соглашения
  14. Языки
  15. Личные сообщения
  16. Разрешенные типы подписей
  17. Напоминания
  18. Защита паролем для подписанных документов
  19. Отправлять уведомления о соглашении через
  20. Параметры идентификации подписывающей стороны
    1. Обзор
    2. Пароль для подписания
    3. Одноразовый пароль по электронной почте
    4. Аутентификация Acrobat Sign
    5. Аутентификация по телефону
    6. Цифровые подписи в облаке
    7. Аутентификация на основе знаний
    8. Удостоверение личности
    9. Отчет по проверке личности подписывающей стороны
  21. Защита контента
  22. Включение операций Notarize
  23. Истечение срока действия документа
  24. Просмотр, размещение подписей и добавление полей
  25. Порядок подписания
  26. Режим Liquid Mode
  27. Элементы управления для настраиваемого рабочего процесса
  28. Возможности для отправки на странице эл. подписания
  29. URL перенаправления при подтверждении после подписания
11. Шаблоны сообщений
12. Требования биофармацевтической отрасли
  1. Обзор
  2. Запрос аутентификации
  3. Основания для подписания
13. Интеграция с рабочим процессом
14. Настройки нотариального заверения
15. Интеграция платежной системы
16. Сообщения для подписывающих сторон
17. Параметры SAML
  1. Конфигурация SAML
  2. Установка Microsoft Active Directory Federation Service
  3. Установка Okta
  4. Установка OneLogin
  5. Установка Oracle Identity Federation
18. Управление данными
19. Настройки меток времени
20. Внешний архив
21. Языки учетной записи
22. Параметры эл. почты
  1. Изображения верхнего и нижнего колонтитула для сообщений электронной почты
  2. Разрешение персональных нижних колонтитулов для сообщений электронной почты
  3. Настройка письма «Запрос на подписание»
  4. Настройка полей «Кому» и «Копия»
  5. Включение уведомлений без ссылок
  6. Настройка шаблонов электронных писем
23. Переход с домена с echosign.com на adobesign.com
24. Настройка параметров для получателей
Руководство по нормативным требованиям
1. Специальные возможности
2. Закон об ответственности и переносе данных о страховании здоровья граждан (HIPAA)
3. Общий регламент по защите данных (GDPR)
4. 21 CFR, часть 11 и приложение EudraLex 11
5. Клиенты в области здравоохранения
6. Поддержка IVES
7. Хранящиеся соглашения
8. Рекомендации для ЕС и Великобритании
Массовая загрузка документов
Подтверждение домена
Ссылки на сообщения о нарушениях

Отправка, подписание соглашений и управление ими

Расширенные возможности и рабочие процессы для работы с соглашениями

Веб-формы
Шаблоны для повторного использования (Шаблоны библиотеки)
Передача прав владения веб-формами и шаблонами библиотек
Рабочие процессы Power Automate
1. Обзор интеграции с Power Automate и включенных в нее прав
2. Включение интеграции Power Automate
3. Контекстные действия на странице «Управление»
4. Отслеживание использования Power Automate
5. Создание потока (с примерами)
6. Триггеры, используемые для потоков
7. Импорт потоков извне Acrobat Sign
8. Управление потоками
9. Редактирование потоков
10. Общий доступ к потокам
11. Отключение и включение потоков
12. Удаление потоков
13. Полезные шаблоны
  1. Только администратор
  2. Архивирование соглашений
    1. Сохранение заполненных документов в SharePoint
    2. Сохранение заполненных документов в OneDrive для бизнеса
    3. Сохранение заполненных документов на Google Диске
    4. Сохранение всех заполненных документов в Dropbox
    5. Сохранение заполненных документов в Box
  3. Архивирование соглашений веб-форм
    1. Сохранение заполненных документов веб-форм в библиотеке SharePoint
    2. Сохранение всех заполненных документов в OneDrive для бизнеса
    3. Сохранение заполненных документов на Google Диске
    4. Сохранение заполненных документов веб-форм в Box
  4. Извлечение данных соглашения
    1. Извлечение данных полей формы из подписанного документа и обновление листа Excel
  5. Уведомления о соглашениях
    1. Отправка по электронной почте настраиваемых уведомлений с содержимым соглашения и подписанным соглашением
    2. Получение уведомлений Adobe Acrobat Sign в канале Teams
    3. Получение уведомлений Adobe Acrobat Sign в Slack
    4. Получение уведомлений Adobe Acrobat Sign в Webex
  6. Создание соглашения
    1. Создание документа на основе формы Power Apps и шаблона Word, отправка на подпись
    2. Создание соглашения на основе шаблона Word в OneDrive и получение подписи
    3. Создание соглашения по выбранной строке Excel, отправка на проверку и подпись
Настраиваемые рабочие процессы отправки
Предоставление доступа к пользователям и соглашениям
1. Предоставление доступа к пользователю
2. Предоставление доступа к соглашению

Интеграция с другими продуктами

Разработчик Acrobat Sign

Поддержка и устранение неполадок

Обзор

Веб-перехватчик — это определяемый пользователем запрос HTTPS, который запускается при возникновении события с подпиской на исходном сайте (в данном случае — Adobe Acrobat Sign).

Итак, веб-перехватчик — это служба REST, принимающая пакет или поток данных.

Веб-перехватчики предназначены для взаимодействия между службами в модели PUSH.

При запуске события с подпиской Acrobat Sign создает запрос HTTPS POST с JSON-текстом и доставляет его по указанному URL-адресу.

Перед настройкой веб-перехватчиков убедитесь, что сеть принимает необходимые для работы диапазоны IP-адресов.

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

Администраторы могут включать собственные веб-перехватчики, не привлекая службу поддержки Acrobat Sign для создания списка URL-адресов обратных вызовов.
Веб-перехватчики лучше обеспечивают актуальность данных, эффективность коммуникации и безопасность. Не требуется регулярный опрос данных.
Веб-перехватчики позволяют с легкостью использовать разные уровни области применения (учетная запись/группа/пользователь/ресурс).
Веб-перехватчики — это более современное решение для API, которое упрощает настройку современных приложений.
Для каждой области (учетная запись/группа/пользователь/ресурс) можно настроить несколько веб-перехватчиков, тогда как обратные вызовы должны быть уникальными.
Веб-перехватчики позволяют выбирать данные для возврата, в то время как обратный вызов работает по принципу «все или ничего».
Можно настроить, какие метаданные (только основные или подробные) может передавать веб-перехватчик.
Поскольку пользовательский интерфейс полностью контролируется администратором, веб-перехватчики намного проще создавать, редактировать или отключать по мере необходимости.

Примечание.

Этот документ в основном посвящен пользовательскому интерфейсу веб-перехватчиков в веб-приложении Acrobat Sign (ранее Adobe Sign).

Разработчики, которым нужны подробности относительно API, могут найти информацию во следующей ссылке:

Подробности о REST v6

Необходимые требования

Для работы службы необходимо разрешить диапазоны IP-адресов для веб-перехватчиков с помощью сетевой безопасности.

Устаревшая служба URL-адресов обратного вызова в REST версии 5 использует те же диапазоны IP-адресов, что и служба веб-перехватчика.

Администраторы могут входить в Adobe Admin Console для добавления пользователей. После входа в систему перейдите к меню администратора и прокрутите вниз до пункта Веб-перехватчики.

Выполните вход в Admin Console

Способ применения

Прежде всего администраторам потребуется служба веб-перехватчиков, готовая принимать входящие push-уведомления от Acrobat Sign. Здесь есть множество вариантов, и веб-перехватчик будет успешно работать с любой службой, которая умеет принимать запросы POST и GET.

После запуска службы администратор Acrobat Sign может создать новый веб-перехватчик в интерфейсе веб-перехватчика в меню «Учетная запись» на сайте Acrobat Sign.

Администраторы могут настроить запуск веб-перехватчика для событий документа, веб-формы (виджет) или массовой отправки (MegaSign). Шаблон библиотеки (документ библиотеки) также можно настроить через API.

Область действия веб-перехватчика может включать всю учетную запись или отдельные группы, что настраивается через интерфейс администратора. API обеспечивает большую гибкость за счет возможности выбора между диапазонами USER или RESOURCE.

Можно настраивать тип данных, передаваемых по URL-адресу, и включать такие сведения, как сведения о соглашении, информацию об участнике, сведения о документе и т. д.

После настройки и сохранения веб-перехватчика Acrobat Sign будет отправлять новый JSON-объект по указанному URL-адресу при каждом срабатывании события с подпиской. Если вы не хотите менять критерии переключающего события или полезную нагрузку JSON, никаких манипуляций с веб-перехватчиком выполнять не нужно.

Проверка намерения для URL-адреса веб-перехватчика

Перед завершением регистрации веб-перехватчика Acrobat Sign проверяет, действительно ли указанный в запросе на регистрацию URL-адрес веб-перехватчика предназначен для получения уведомлений. Поэтому когда Acrobat Sign получает запрос на регистрацию нового веб-перехватчика, он сначала отправляет запрос проверки по URL-адресу веб-перехватчика. Он представляет собой запрос HTTPS GET, отправляемый на URL-адрес веб-перехватчика. Этот запрос имеет собственный HTTP-заголовок X-AdobeSign-ClientId. Значение в этом заголовке установлено для идентификатора клиента API-приложения (идентификатора приложения), которое запрашивает создание/регистрацию веб-перехватчика. Для успешной регистрации веб-перехватчика его URL-адрес должен ответить на этот запрос проверки, используя код ответа 2XX, А ТАКЖЕ должен отправить одно и то же значение идентификатора клиента одним из следующих двух способов:

В заголовке ответа X-AdobeSign-ClientId. Это тот же заголовок, который передан в запросе и должен быть возвращен при ответе.
Либо в тексте ответа JSON с ключом xAdobeSignClientId, значением которого является тот же идентификатор клиента, который отправлен в запросе.

Веб-перехватчик будет зарегистрирован только при успешном ответе (код ответа 2XX) и после проверки идентификатора клиента либо в заголовке, либо в тексте ответа. Цель этого запроса проверки — убедиться в том, что URL-адрес веб-перехватчика действительно готов получать уведомления на указанный URL-адрес. Если вы случайно введете неверный URL-адрес, он не будет правильно отвечать на запрос проверки намерения, и Acrobat Sign не станет отправлять уведомления на этот URL-адрес. URL-адрес веб-перехватчика также может подтвердить, что уведомления будут получаться только через веб-перехватчики, зарегистрированные конкретным приложением. Это выполняется путем проверки идентификатора клиента приложения, переданного в заголовке X-AdobeSign-ClientId. Если URL-адрес веб-перехватчика не распознает идентификатор клиента, он НЕ БУДЕТ отсылать ответный код об успешном выполнении операции, а Acrobat Sign позаботится о том, чтобы этот URL-адрес не был зарегистрирован в качестве веб-перехватчика.

Проверка вызова URL-адреса веб-перехватчика будет выполняться при следующих сценариях:

Регистрация веб-перехватчика. Веб-перехватчик не будет создан, если проверка URL-адреса веб-перехватчика не завершена.
Обновление веб-перехватчика с НЕАКТИВНОГО на АКТИВНЫЙ. Если проверка URL-адреса веб-перехватчика не завершится, состояние веб-перехватчика не будет изменено на АКТИВНОЕ.

Как ответить на уведомление веб-перехватчика

Acrobat Sign выполняет неявную проверку намерений в каждом запросе уведомления веб-перехватчика, отправляемом на его URL-адрес. Таким образом, каждый HTTPS-запрос уведомления веб-перехватчика также содержит настраиваемый HTTP-заголовок X-AdobeSign-ClientId. Значением в этом заголовке является идентификатор клиента (идентификатор приложения) того приложения, которое создало веб-перехватчик. Уведомление веб-перехватчика будет считаться доставленным, только если будет возвращен успешный ответ (код ответа 2XX), а идентификатор клиента будет отправлен либо в заголовке HTTP (X-AdobeSign-ClientId), либо в тексте ответа JSON с ключом xAdobeSignClientId и значением идентификатора клиента. В противном случае мы будем повторять попытки доставить уведомление на URL-адрес веб-перехватчика, пока не будет исчерпано заданное максимальное число попыток.

Как было сказано выше, заголовок 'X-AdobeSign-ClientId' , который включается в каждый запрос уведомления от Sign, и значение этого заголовка (идентификатор клиента) должны возвращаться при ответе одним из двух способов:

1. Заголовок HTTP X-AdobeSign-ClientId, значением которого является идентификатор клиента.

Пример кода Javascript для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа
// Запись идентификатора клиента var clientid = request.headers['X-ADOBESIGN-CLIENTID']; // Проверка if (clientid ==="BGBQIIE7H253K6") // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика { // Возврат в заголовке ответа response.headers['X-AdobeSign-ClientId'] = clientid; response.status = 200; // Значение по умолчанию }

Пример кода Javascript для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа

// Запись идентификатора клиента

var clientid = request.headers['X-ADOBESIGN-CLIENTID'];

// Проверка

if (clientid ==="BGBQIIE7H253K6") // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика

{

// Возврат в заголовке ответа

response.headers['X-AdobeSign-ClientId'] = clientid;

response.status = 200; // Значение по умолчанию

}

Пример кода PHP для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа
<?php // Запись идентификатора клиента $clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID']; // Проверка if($clientid == "BGBQIIE7H253K6") // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика { // Возврат в заголовке ответа header("X-AdobeSign-ClientId:$clientid"); header("HTTP/1.1 200 OK"); // Значение по умолчанию } ?>

Пример кода PHP для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа

<?php

// Запись идентификатора клиента

$clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID'];

// Проверка

if($clientid == "BGBQIIE7H253K6") // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика

{

// Возврат в заголовке ответа

header("X-AdobeSign-ClientId:$clientid");

header("HTTP/1.1 200 OK"); // Значение по умолчанию

}

2. Тело ответа в формате JSON с ключом xAdobeSignClientId и значением того же идентификатора клиента

Пример кода Javascript для получения идентификатора клиента, проверки и последующего возвращения в теле ответа
// Запись идентификатора клиента var clientid = request.headers['X-ADOBESIGN-CLIENTID']; // Проверка if (clientid ==="BGBQIIE7H253K6") // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика { var responseBody = { "xAdobeSignClientId" : clientid // Возвращает идентификатор клиента в теле }; response.headers['Content-Type'] = 'application/json'; response.body = responseBody; response.status = 200; }

Пример кода Javascript для получения идентификатора клиента, проверки и последующего возвращения в теле ответа

// Запись идентификатора клиента

var clientid = request.headers['X-ADOBESIGN-CLIENTID'];

// Проверка

{

var responseBody = {

"xAdobeSignClientId" : clientid // Возвращает идентификатор клиента в теле

};

response.headers['Content-Type'] = 'application/json';

response.body = responseBody;

response.status = 200;

}

Пример кода PHP для получения идентификатора клиента, проверки и последующего возвращения в теле ответа
<?php // Запись идентификатора клиента $clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID']; // Проверка if($clientid == "BGBQIIE7H253K6") // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика { // Возврат в теле ответа header("Content-Type: application/json"); $body = array('xAdobeSignClientId' => $clientid); echo json_encode($body); header("HTTP/1.1 200 OK"); // Значение по умолчанию } ?>

Пример кода PHP для получения идентификатора клиента, проверки и последующего возвращения в теле ответа

<?php

// Запись идентификатора клиента

$clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID'];

// Проверка

{

// Возврат в теле ответа

header("Content-Type: application/json");

$body = array('xAdobeSignClientId' => $clientid);

echo json_encode($body);

header("HTTP/1.1 200 OK"); // Значение по умолчанию

}

Пример тела ответа в формате JSON
{ "xAdobeSignClientId": "BGBQIIE7H253K6" }

Предварительные условия

Вам потребуется следующее:

Учетная запись Microsoft с лицензией на создание приложений Функций Azure;
Существующее приложение Функций Azure, которое можно создать с помощью https://docs.microsoft.com/en-us/azure/azure-functions/functions-create-first-azure-function;
Базовые знания Javascript, чтобы вы могли понимать и писать код на предпочитаемом вами языке программирования.

Процедура создания инициирующего события функций Azure, которое служит веб-перехватчиком Acrobat Sign

Для создания функции инициирующего события HTTP на языке Javascript выполните следующее:

1. Войдите со своей учетной записью Microsoft https://portal.azure.com;

2. Откройте приложение Функций Azure, отображаемое на вкладке «Приложения-функции».

При этом откроется ваш список приложений Функций Azure:

3. Выберите приложение, в котором вы хотите создать новую функцию.

4. Нажмите кнопку «Создать» (+), чтобы создать новую функцию Azure

5. Выберите сценарий Webhook + API и язык Javascript .

6. Нажмите Создать функцию

Вы создали новую функцию, способную обрабатывать входящий запрос API.

Добавление логики для регистрации веб-перехватчика Acrobat Sign

Перед тем, как успешно завершить регистрацию веб-перехватчика, Acrobat Sign проверяет, действительно ли указанный в запросе на регистрацию URL-адрес веб-перехватчика предназначен для получения уведомлений. С этой целью при получении нового запроса на регистрацию веб-перехватчика Acrobat Sign сначала отправляет запрос на проверку URL-адреса веб-перехватчика. Этот запрос на проверку представляет собой запрос HTTPS GET, отправленный на URL-адрес веб-перехватчика с настраиваемым заголовком HTTP X-AdobeSign-ClientId. Значением в этом заголовке является идентификатор клиента того приложения API, которое запрашивает создание и (или) регистрацию веб-перехватчика. Для успешной регистрации веб-перехватчика его URL-адрес должен ответить на этот запрос на проверку, используя код ответа 2XX, А ТАКЖЕ должен отправить одно и то же значение идентификатора клиента одним из следующих двух способов:

У вас есть два варианта действий.

Вариант 1. Передать идентификатор клиента в X-AdobeSign-ClientId в качестве заголовка ответа

Передайте X-AdobeSign-ClientId в заголовке ответа. Это тот же заголовок, который был передан в запросе и должен быть возвращен при ответе.

Замените файл Index.js следующим:

module.exports = function (context, req) {

var clientId = req.headers['x-adobesign-clientid'];

// Проверка подлинности входящего идентификатора клиента

if (clientId === '123XXX456') {

context.res = {

// status: 200, /* По умолчанию: 200 */ // любой ответ 2XX является приемлемым

body: "Notification Accepted",

headers : {

'x-adobesign-clientid' : req.headers['x-adobesign-clientid']

}

};

}

else {

context.res = {

status: 400,

body: "Opps!! Illegitimate Call identified"

};

}

context.done();

};

Проверьте поведение, выполнив имитацию запроса:

1. Нажмите кнопку Тест в правом углу;

2. Смоделируйте фиктивный запрос.

Хотя заголовки ответа не показаны выше, вы можете получить них с помощью имитации запроса через postman, DHC или другую аналогичную службу.

Вариант 2. Передать идентификатор клиента в теле ответа с ключом xAdobeSignClientId

В теле ответа JSON с ключом xAdobeSignClientId, значением которого является тот же идентификатор клиента, который был отправлен в заголовке запроса.

Замените файл Index.js следующим:

module.exports = function (context, req) {

var clientId = req.headers['x-adobesign-clientid'];

// Проверка подлинности входящего идентификатора клиента

if (clientId === '123XXX456') {

context.res = {

// status: 200, /* По умолчанию: 200 */ // любой ответ 2XX является приемлемым

body: {

'xAdobeSignClientId' : clientId

headers : {

'Content-Type' : 'application/json'

}

};

}

else {

context.res = {

status: 400,

body: "Opps!! Illegitimate Call identified"

};

}

context.done();

};

Проверьте поведение, выполнив имитацию запроса:

1. Нажмите кнопку Тест в правом углу;

2. Смоделируйте фиктивный запрос.

Обратите внимание, что такое же поведение для clientID ожидается, когда URL-адрес веб-перехватчика получает уведомления POST.

Готовность к использованию

После проверки поведения URL-адрес веб-перехватчика действует по стандартам Acrobat Sign. В дальнейшем вы можете обновить пользовательскую логику в соответствии с вашими требованиями.

Получение URL-адреса функции

Нажмите Получить URL-адрес функции

Скопируйте URL-адрес и используйте его для создания веб-перехватчиков в Acrobat Sign.

Создание функции AWS Lambda

Чтобы создать функцию AWS Lambda, перейдите к Панели управления AWS и выберите в списке служб AWS Lambda.

Выберите «Создать функцию Lambda» с помощью варианта «Автор с нуля».
На странице настроек функции введите имя функции lambdaWebhooks и выберите Node.js 4.3 в качестве среды выполнения
Для параметра Роль выберите существующую роль или создайте новую на основе шаблона.
- Если вы выбрали Создать новую роль из шаблона(-ов), введите имя роли (например, role-lamda) и выберите Разрешения Simple Microservices из списка Шаблоны политик.
Нажмите кнопку Создать функцию.

На странице новой лямбда-функции AWS выберите вариант Изменить встроенный код для параметра Тип ввода кода и сохраните значение обработчика index.handler.
Добавление логики для регистрации веб-перехватчика Acrobat Sign
Перед тем, как успешно завершить регистрацию веб-перехватчика, Acrobat Sign проверяет, действительно ли указанный в запросе на регистрацию URL-адрес веб-перехватчика предназначен для получения уведомлений. С этой целью при получении нового запроса на регистрацию веб-перехватчика Acrobat Sign сначала отправляет запрос на проверку URL-адреса веб-перехватчика. Этот запрос на проверку представляет собой запрос HTTPS GET, отправленный на URL-адрес веб-перехватчика с настраиваемым заголовком HTTP X-AdobeSign-ClientId. Значением в этом заголовке является идентификатор клиента того приложения API, которое запрашивает создание и (или) регистрацию веб-перехватчика. Для успешной регистрации веб-перехватчика его URL-адрес должен ответить на этот запрос на проверку, используя код ответа 2XX, А ТАКЖЕ должен отправить одно и то же значение идентификатора клиента одним из следующих двух способов: Обратите внимание, что такое же поведение для clientID ожидается, когда URL-адрес веб-перехватчика получает уведомления POST.

Действуйте по одному из следующих сценариев:

Сценарий 1. Передача идентификатора клиента в заголовке ответа X-AdobeSign-ClientId
- Передайте X-AdobeSign-ClientId в заголовке ответа. Это тот же заголовок, который был передан в запросе и должен быть возвращен при ответе.
  
  Фрагмент кода
  В файле index.js замените автоматически сгенерированный фрагмент кода следующим:

Пример кода JS для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа
exports.handler = function index(event, context, callback) { // Запись идентификатора клиента var clientid = event.headers['X-AdobeSign-ClientId']; // Проверка if (clientid =="BGBQIIE7H253K6")) // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика { var response = { statusCode: 200, headers: { "X-AdobeSign-ClientId": clientid } }; callback(null,response); } else { callback("Oops!! illegitimate call"); } }

Пример кода JS для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа

exports.handler = function index(event, context, callback) {

// Запись идентификатора клиента

var clientid = event.headers['X-AdobeSign-ClientId'];

// Проверка

if (clientid =="BGBQIIE7H253K6")) // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика

{

var response = {

statusCode: 200,

headers: {

"X-AdobeSign-ClientId": clientid

}

};

callback(null,response);

}

else {

callback("Oops!! illegitimate call");

}

Сценарий 2. Передача идентификатора клиента в теле ответа с ключом xAdobeSignClientId

Фрагмент кода

Замените файл Index.js следующим:

Пример кода JS для получения идентификатора клиента, проверки и последующего возвращения в заголовке ответа
exports.handler = function index(event, context, callback) { // Запись идентификатора клиента var clientid = event.headers['X-AdobeSign-ClientId']; // Проверка if (clientid =="BGBQIIE7H253K6")) // Заменить BGBQIIE7H253K6 идентификатором клиента приложения на момент создания веб-перехватчика { var responseBody = { xAdobeSignClientId : clientid }; var response = { statusCode: 200, body: JSON.stringify(responseBody) }; callback(null,response); } else { callback("Opps!! illegitimate call"); } }

exports.handler = function index(event, context, callback) {

// Запись идентификатора клиента

var clientid = event.headers['X-AdobeSign-ClientId'];

// Проверка

{

var responseBody = {

xAdobeSignClientId : clientid

};

var response = {

statusCode: 200,

body: JSON.stringify(responseBody)

};

callback(null,response);

}

else {

callback("Opps!! illegitimate call");

}

Сохраните функцию: Лямбда-функция создана, и мы почти готовы использовать ее в веб-перехватчике в режиме реального времени.

Настройка шлюза API AWS

Чтобы сделать эту лямбда-функцию общедоступной через метод HTTP, нам нужно настроить шлюз API AWS, используя созданную выше функцию в качестве серверной части API.

В консоли управления AWS выберите в списке сервисов AWS шлюз API и нажмите кнопку Создать API.

На странице Создание нового API выберите Новый API и введите webhooks в параметре Имя API.
Нажмите кнопку Создать API.
Раскройте список Действия и выберите в нем Создать ресурс.
Поставьте отметку напротив варианта Настроить в качестве ресурса прокси, введите validate в поле Имя ресурса и {proxy+} в поле Путь к ресурсу.
Оставьте пустым поле для отметки напротив варианта Включить CORS шлюза API и нажмите кнопку Создать ресурс.
Оставьте прокси-сервер функции Lambda выбранным в качестве типа интеграции и выберите регион, в котором вы создали свою функцию Lambda, из раскрывающегося списка регионов Lambda (это может быть тот же регион, где вы создаете шлюз API).
Укажите validate в качестве Функции Lambda и нажмите кнопку Сохранить.
Во всплывающем окне Добавить разрешение в функцию Lambda нажмите ОК.

Если все перечисленные выше шаги выполнены успешно, вы увидите что-то подобное:

Развертывание API

Следующий этап — развертывание этого API, чтобы подготовить его к использованию.

В раскрывающемся списке Действия выберите Развернуть API.
Выберите [Новый этап] в разделе Этап развертывания и введите prod (или любое другое понятное название) в поле Название этапа.
Нажмите кнопку Развернуть.

Теперь API готов к использованию, и вы можете найти URL-адрес для его вызова в синем окошке, как показано ниже.

Запишите этот URL-адрес, так как вам нужно будет ввести его в качестве URL-адреса веб-перехватчика в реальном времени.

Готовность к использованию

Готово. Используйте указанный выше URL-адрес с постфиксом «/{nodeJSfunctionName}» в качестве URL-адреса веб-перехватчика в запросе API POST /webhooks. После проверки поведения URL-адрес веб-перехватчика действует по стандартам
Acrobat Sign. В дальнейшем вы можете обновить пользовательскую логику в соответствии с вашими требованиями.

Включение и отключение функции

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

Администраторы на уровне группы могут создавать и контролировать веб-перехватчики, которые работают только в пределах их групп.

Доступ к странице Веб-перехватчики можно получить через панель слева в меню администратора.

Ограничение скорости на основе одновременного выполнения

Для создания веб-перехватчика (и обратного вызова) и событий уведомления ограничено количество одновременных уведомлений, отправляемых клиенту системой Acrobat Sign. Ограничение применяется к учетной записи для включения всех групп в ней.
Этот тип ограничения скорости позволяет предотвратить чрезмерное потребление плохо разработанной учетной записью ресурсов сервера, что в итоге оказывает негативное влияние на всех остальных клиентов в этой среде сервера.

Количество одновременных событий для учетной записи рассчитывается так, чтобы обеспечить учетным записям с хорошо настроенными веб-перехватчиками скорейшее получение уведомлений и предотвратить задержки из-за слишком большого количества запросов. Текущие пороговые значения:

Действие (Событие)	Макс. кол-во одновременных событий	Описание
Создание веб-перехватчика	10	Для каждой учетной записи разрешено не более 10 одновременных запросов на создание веб-перехватчиков. В случае превышения этого лимита будет получен ответ с кодом 429 TOO_MANY_REQUESTS.
Уведомление веб-перехватчика/обратного вызова	30	Для каждой учетной записи разрешено не более 30 одновременных уведомлений веб-перехватчика и обратного вызова. В случае превышения этого лимита уведомления будут повторяться в соответствии с экспоненциальной выдержкой до тех пор, пока они не будут доставлены.

Дополнительные сведения...

Ограничения на размер кода JSON

Рабочая нагрузка JSON не может иметь размер более 10 МБ.

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

В этой ситуации в ответ включается параметр ConditionalParametersTrimmed, чтобы уведомить клиента об удалении информации conditionalParameters.

Параметр conditionalParametersTrimmed является объектом с типом массив, который содержит сведения об отброшенных ключах.

Отбрасывание применяется в следующем порядке:

includeSignedDocuments
includeParticipantsInfo
includeDocumentsInfo
includeDetailedInfo

Первыми отбрасываются подписанные документы, затем сведения об участнике, сведения о документе, и наконец подробные сведения.

Такое может происходить, например, при создании события завершения соглашения, если в него включается не только подписанный документ в кодировке base64, но и соглашение с несколькими полями формы.

Уведомления веб-перехватчика

Веб-перехватчики Acrobat Sign доставляют уведомления отправителю соглашения и любому веб-перехватчику, настроенному в группе, из которой отправлено соглашение. Веб-перехватчики на уровне учетной записи получают все события.

Отправитель: Пользователь A | Подписант: Пользователь B | Получатель общего доступа: Пользователь C

Пользователь А и Пользователь В находятся в разных учетных записях

Пользователь А и Пользователь С находятся в разных учетных записях

Пример использования	Уведомление?	Комментарии/заметки
Учетная запись Пользователя А имеет веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ (созданный администратором учетной записи Пользователя А).	Да	Веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ получает уведомления обо всех событиях, которые происходят в этой учетной записи.
Учетная запись Пользователя А имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя А). Предположение: Пользователь А и администратор группы находятся в одной группе.	Да	Веб-перехватчик уровня ГРУППА получает уведомления обо всех событиях, происходящих в этой группе.
У Пользователя А веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ.	Да	В роли отправителя срабатывает веб-перехватчик Пользователя А уровня ПОЛЬЗОВАТЕЛЬ
У Пользователя А веб-перехватчик уровня РЕСУРС (для указанного выше документа).	Да

Учетная запись Пользователя В имеет веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ (созданный администратором учетной записи Пользователя В).	Нет	Веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ Пользователя В считается веб-перехватчиком Подписанта.
Учетная запись Пользователя В имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя В). Предположение: Пользователь В и администратор группы находятся в одной группе.	Нет	Веб-перехватчик уровня ГРУППА Пользователя В считается веб-перехватчиком Подписанта.
У Пользователя В веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ.	Нет	Веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ Пользователя В считается веб-перехватчиком Подписанта.

Учетная запись Пользователя С имеет веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ (созданный администратором учетной записи Пользователя С).	Нет	Веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ Пользователя С считается веб-перехватчиком стороны, не являющейся инициатором.
Учетная запись Пользователя С имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя С). Предположение: Пользователь С и администратор группы находятся в одной группе.	Нет	Веб-перехватчик уровня ГРУППА Пользователя С считается веб-перехватчиком стороны, не являющейся инициатором.
У Пользователя С веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ.	Нет	Веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ Пользователя С считается веб-перехватчиком стороны, не являющейся инициатором.

Отправитель: Пользователь A | Подписант: Пользователь B | Получатель общего доступа: Пользователь C

Пользователь А, Пользователь В и Пользователь С находятся в одной учетной записи

Пример использования	Уведомление?	Примечания
Учетная запись Пользователя А имеет веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ (созданный администратором учетной записи Пользователя А).	Да	Веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ уведомляет о событиях, запущенных этой учетной записью.
Учетная запись Пользователя А имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя А). Предположение: Пользователь А и администратор группы находятся в одной группе.	Да	Веб-перехватчик уровня ГРУППА уведомляет о событиях, запущенных пользователями в этой группе.
У Пользователя А веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ.	Да	В роли отправителя срабатывает веб-перехватчик Пользователя А уровня ПОЛЬЗОВАТЕЛЬ
У Пользователя А веб-перехватчик уровня РЕСУРС (для упомянутого выше документа).	Да

Учетная запись Пользователя В имеет веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ (созданный администратором учетной записи Пользователя В).	Да	Поскольку Пользователь А и Пользователь В находятся в одной учетной записи, веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ получает уведомления обо всех событиях, которые происходят в этой учетной записи.
Учетная запись Пользователя В имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя В). Предположение: Пользователь А, Пользователь В и администратор группы находятся в одной группе.	Да	Поскольку Пользователь А и Пользователь В находятся в одной группе, веб-перехватчик уровня ГРУППА получает уведомления обо всех событиях, которые происходят в этой группе.
Учетная запись Пользователя В имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя В). Предположение: Пользователь А и Пользователь В находятся в разных группах.	Нет	Веб-перехватчик уровня ГРУППА Пользователя В считается веб-перехватчиком Подписанта. Веб-перехватчик Пользователя А (РЕСУРС/ПОЛЬЗОВАТЕЛЬ/ГРУППА/УЧЕТНАЯ ЗАПИСЬ) будет запущен.
У Пользователя В веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ.	Нет	В роли получателя веб-перехватчик Пользователя В уровня ПОЛЬЗОВАТЕЛЬ не срабатывает.

Учетная запись Пользователя С имеет веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ (созданный администратором учетной записи Пользователя С).	Да	Поскольку Пользователь А и Пользователь С находятся в одной учетной записи, веб-перехватчик уровня УЧЕТНАЯ ЗАПИСЬ получает уведомления обо всех событиях, которые происходят в этой учетной записи.
Учетная запись Пользователя С имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя С). Предположение: Пользователь А, Пользователь С и администратор группы находятся в одной группе.	Да	Поскольку Пользователь А и Пользователь С находятся в одной группе, веб-перехватчик уровня ГРУППА получает уведомления обо всех событиях, которые происходят в этой группе.
Учетная запись Пользователя С имеет веб-перехватчик уровня ГРУППА (созданный администратором учетной записи/группы Пользователя С). Предположение: Пользователь А и Пользователь С находятся в разных группах.	Нет	Веб-перехватчик уровня ГРУППА Пользователя С считается веб-перехватчиком стороны, не являющейся инициатором. Веб-перехватчик Пользователя А (РЕСУРС/ПОЛЬЗОВАТЕЛЬ/ГРУППА/УЧЕТНАЯ ЗАПИСЬ) будет запущен.
У Пользователя С веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ.	Нет	Веб-перехватчик уровня ПОЛЬЗОВАТЕЛЬ Пользователя С считается веб-перехватчиком стороны, не являющейся инициатором.

Повторная попытка при отключенной службе

Если целевой URL-адрес веб-перехватчика по какой-либо причине отключен, Acrobat Sign поместит документ JSON в очередь и будет в течение 72 часов повторять попытку отправки с нарастающими интервалами.

Недоставленные события сохраняются в очереди повторных попыток, и в течение следующих 72 часов предпринимаются все возможные усилия для доставки уведомлений в том порядке, в котором они создавались.

Стратегия повторной доставки уведомлений заключается в удвоении времени между попытками, начиная с 1-минутного интервала, увеличивающегося до 12 часов, что обеспечивает 15 попыток за 72 часа.

Если веб-перехватчик не отвечает в течение 72 часов и за последние 7 дней не зарегистрировано ни одной успешной доставки, этот веб-перехватчик отключается. На этот URL-адрес более не будут отправляться уведомления, пока администратор не включит веб-перехватчик снова.

Все уведомления за период, пока веб-перехватчик находится в отключенном состоянии, будут потеряны.

Adobe

Получайте помощь быстрее и проще

Новый пользователь?

Обзор веб-перехватчика Acrobat Sign

Обзор

Необходимые требования

Способ применения

Проверка намерения для URL-адреса веб-перехватчика

Как ответить на уведомление веб-перехватчика

1. Заголовок HTTP X-AdobeSign-ClientId, значением которого является идентификатор клиента.

2. Тело ответа в формате JSON с ключом xAdobeSignClientId и значением того же идентификатора клиента

Предварительные условия

Процедура создания инициирующего события функций Azure, которое служит веб-перехватчиком Acrobat Sign

Добавление логики для регистрации веб-перехватчика Acrobat Sign

Вариант 1. Передать идентификатор клиента в X-AdobeSign-ClientId в качестве заголовка ответа

Вариант 2. Передать идентификатор клиента в теле ответа с ключом xAdobeSignClientId

Готовность к использованию

Создание функции AWS Lambda

Сценарий 1. Передача идентификатора клиента в заголовке ответа X-AdobeSign-ClientId

Сценарий 2. Передача идентификатора клиента в теле ответа с ключом xAdobeSignClientId

Настройка шлюза API AWS

Развертывание API

Готовность к использованию

Включение и отключение функции

Ограничение скорости на основе одновременного выполнения

Рекомендации

Дополнительные сведения...

Ограничения на размер кода JSON

Уведомления веб-перехватчика

Повторная попытка при отключенной службе

Получайте помощь быстрее и проще

Вопросы сообществу

Свяжитесь с нами