Настройка доступа от имени пользователя для Analyzer в Acrobat

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

Что обеспечивает доступ от имени пользователя

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

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

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

Требования

Перед запросом доступа от имени пользователя:

• Настройте техническую учетную запись для доступа API Analyzer.
• Выполните как минимум один успешный вызов API Analyzer с использованием этой технической учетной записи.
• Убедитесь, что каждый пользователь принадлежит к той же организации, что и техническая учетная запись.
• Соберите точный адрес электронной почты для каждого пользователя, которому требуется доступ от имени другого пользователя.

Adobe отклоняет запросы от имени пользователей из другой организации или если указанный адрес электронной почты не совпадает точно с учетной записью пользователя.

Определение технической учетной записи

Определите техническую учетную запись, которая создает токен доступа OAuth и выполняет API-запросы.

Поиск идентификатора этой технической учетной записи

1. Откройте проект в Adobe Developer Console.
2. Откройте учетные данные OAuth Server-to-Server, используемые для Analyzer.
3. Откройте страницу, используемую для генерации токена доступа.
4. Найдите идентификатор технической учетной записи.

Идентификатор технической учетной записи заканчивается на @techacct.adobe.com.

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

Определение пользователей

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

Для каждого пользователя:

1. Соберите точный адрес электронной почты учетной записи Adobe пользователя.
2. Убедитесь, что пользователь принадлежит к той же организации, что и техническая учетная запись.

Доступ через запросы от имени другого лица возможен только к пользователям, включенным в утвержденный список разрешений.

Запрос доступа от имени другого лица

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

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

• Идентификатор технической учетной записи заканчивается на @techacct.adobe.com.
• Полный список адресов электронной почты пользователей, которые необходимо включить в список разрешенных.
• Подтверждение одобрения со стороны системного администратора организации.

Специалисты Adobe рассматривают запрос и настраивают утвержденных пользователей для технической учетной записи.

Чтобы компания Adobe могла внести изменения в конфигурацию технической учетной записи, требуется как минимум один успешный вызов API Analyzer.

Отправка запроса API от имени пользователя

После того как Adobe утвердит список разрешенных, включите заголовок x-on-behalf-user в запросы, которые должны выполняться от имени утвержденного пользователя.

Установите значение заголовка равным утвержденному адресу электронной почты пользователя:

x-on-behalf-user: user@example.com

Продолжайте выполнять аутентификацию запроса с помощью токена носителя, полученного через OAuth Server-to-Server для технической учетной записи.

Запрос выполняется в контексте пользователя, указанного в заголовке x-on-behalf-user. Этот пользователь должен присутствовать в списке разрешенных для данной технической учетной записи.