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

Создание технических учетных записей для отправки соглашений через API

 

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

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

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

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

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

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

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

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

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

Технические учетные записи Adobe Acrobat Sign

Технические учетные записи Acrobat Sign позволяют учетным записям корпоративного уровня запускать свои приложения, используя идентификатор userID, созданный именно для этой цели (не используя личный идентификатор администратора userID).

Технические учетные записи доступны корпоративным клиентам (через Adobe Developer Console) в рамках плана покупки ETLA, который позволяет управлять их учетной записью с помощью Adobe Admin Console.

Карточку продукта для технической учетной записи можно найти на вкладке Продукты в Admin Console с названием предложения Adobe Acrobat Sign Solutions для организаций (найдите флажок Доступен API-интерфейс):

Карточки продуктов технических учетных записей

Примечание.

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

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

Для включения технической учетной записи необходимо, чтобы учетная запись Acrobat Sign соответствовала следующим требованиям:

  • Наличие сервиса ETLA с уровнем предприятия
  • Управление пользователями в Adobe Admin Console*
  • Включен параметр расширенного общего доступа к учетной записи

* Примечание о Adobe Admin Console

Adobe Admin Console предоставляет инфраструктуру для управления пользователями и выделения лицензий. У большинства клиентов только одна консоль Admin Console.

Однако у некоторых клиентов со сложными требованиями к пользователям/лицензированию есть несколько консолей Admin Console, что в таком процессе, как создание технической учетной записи, может приводить к затруднениям: одна консоль Admin Console отвечает за управление федеративными пользователями, а другая — лицензированием Acrobat Sign.

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

Обзор

Создание технической учетной записи — это сложный процесс, требующий доступа уровня администратора к Adobe Acrobat Console и прав администратора уровня учетной записи в Acrobat Sign.

Администратор должен:

  1. Предоставить доступ уровня администратора или разработчика пользователю, который создает техническую учетную запись.
    • Пользователь должен быть администратором или разработчиком, чтобы настраивать параметры, которые позволяют создать техническую учетную запись.
  2. Создать проект в Adobe Developer Console (Adobe.io).
    • Проект — это необходимая среда для хранения пары открытый/закрытый ключ и маркера доступа, который обеспечивает функциональность технической учетной записи.
  3. Создать или добавить пару открытый/закрытый ключ и создать маркер доступа.
    • Создание маркера доступа позволяет создать идентификатор userID технической учетной записи в Adobe Admin Console и внести его в систему Acrobat Sign.
  4. (Необязательно) Создать группу в системе Acrobat Sign.
    • Создание отдельной группы для идентификатора userID технической учетной записи позволяет точно настраивать свойства соглашения, которые могут быть слишком строгими или отличаться от других конфигураций группы.
  5. Присвоить идентификатору userID технической учетной записи в Acrobat Sign права администратора уровня группы.
  6. Создать федеративного пользователя в Adobe Admin Console.
    • Это приводит к созданию адреса электронной почты пользователя с вашим доменом на прокси-сервере для идентификатора userID технической учетной записи при отправке. Таким образом, получается адрес электронной почты, который указывает на вашу компанию.
  7. Предоставить учетной записи федеративного пользователя доступ к технической учетной записи.
    • Идентификатор userID технической учетной записи создается в Licensing Admin Console с адресом электронной почты «adobe.com». Когда вы предоставляете общий доступ к учетной записи федеративного пользователя, вы даете доступ к идентификатору userID технической учетной записи для отправки писем с использованием федеративного userID. Таким образом, создается более понятное для получателей имя/адрес электронной почты.

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

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

Пользователь сможет добавить новую техническую учетную запись только после того, как будет добавлен в профиль продукта Adobe Acrobat Sign Solutions для организаций (в вашей консоли Licensing Admin Console) в качестве администратора или разработчика.

  1. Нажмите ссылку Adobe Acrobat Sign Solutions для организаций на панели слева или в разделе продуктов.

  2. Выберите профиль продукта по умолчанию для службы Acrobat Sign.

    Выбор профиля продукта

  3. Откроется страница Добавление пользователей в этот продукт:

    • Выберите вкладку Администратор или Разработчик.
  4. Введите адрес электронной почты пользователя для предоставления доступа.

  5. Нажмите Добавить администратора/разработчика.

    Добавление разработчика

  6. Введите адрес электронной почты пользователя для предоставления доступа.

  7. Введите имя и фамилию.

  8. Когда все будет готово, нажмите Сохранить.

    Ввод сведений о разработчике

Создание нового проекта в консоли Adobe.io Console

  1. Перейдите по адресу https://console.adobe.io

    • Если вы имеете отношение к нескольким экземплярам Admin Console, убедитесь, что подключены к тому, который подходит для Licensing Admin Console, нажав на стрелку вниз в правом верхнем углу окна.
    Экземпляры Admin Console

  2. Выберите Создать проект.

    Создание проекта

  3. Новый проект отображается на вкладке Проекты в консоли.

    Введите название проекта, нажав кнопку Редактировать проект.

    • Укажите название, которое будет понятно вашим коллегам.
    • Добавьте краткое описание
    • Сохраните изменения
    Редактирование проекта

  4. Выберите новый проект (на вкладке Проекты), чтобы открыть его для настройки.

    На странице Начало работы:

    1. Выберите Добавить проект.
    2. Выберите API-интерфейс в раскрывающемся меню.
    Добавление API-интерфейса

  5. На странице Добавить API:

    1. Выберите фильтр Document Cloud
    2. Выберите Acrobat Sign
    3. Нажмите Далее
    Выбор Acrobat Sign

Создание нового веб-маркера JSON

У вас есть возможность создать новую пару открытый/закрытый ключ или добавить свой открытый ключ. Выберите наиболее удобный вариант:

Выбор профиля продукта

Страница Настройка API обновится и отобразятся профили продуктов, доступные для вашей учетной записи. Может отображаться один или несколько. Зависит от профилей, доступных для вашей учетной записи.

  1. Установите флажок Adobe Acrobat Sign Solutions по умолчанию для организаций.
  2. Затем Сохранить настроенный API.
Сохранение настроенного API

Создание маркера доступа

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

В разделе Создание маркера доступа есть поле для ввода закрытого ключа.

  1. Вставьте закрытый ключ, созданный или добавленный ранее, в поле Закрытый ключ.

  2. Выберите Создать маркер.

  3. Поле Закрытый ключ обновится и отобразится Маркер доступа.

  4. Скопируйте и сохраните маркер доступа.

    Создание маркера доступа

  5. Ниже на той же странице есть доступ к следующему:

    • Идентификатор клиента
    • Секретный ключ клиента
    • Идентификатор технической учетной записи
    • Адрес электронной почты технической учетной записи
    • Идентификатор организации

    Скопируйте и сохраните адрес электронной почты технической учетной записи.

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

Возможность создания уникальной группы в Acrobat Sign для приложения

Группы Acrobat Sign позволяют выполнять точную настройку параметров безопасности и интерфейса для получателей (а также рабочих процессов, шаблонов, отчетов и т. д.)

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

  1. Выполните вход в Acrobat Sign как администратор уровня учетной записи.

  2. В меню администратора перейдите на вкладку Группы.

  3. Нажмите значок плюса для создания группы.

  4. Введите понятное название для группы (возможно, то же, что для проекта).

  5. Сохраните группу.

  6. (Необязательно) Откройте новую группу и настройте параметры для приложения.

    Создание групп

Примечание.

Если организация

  • использует инструмент синхронизации пользователей для автоматической синхронизации пользователей между Adobe и Active Directory,
  • не разрешает вручную добавлять и создавать пользователей в Acrobat Sign,

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

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

Присвоение прав администратора группы идентификатору userID в технической учетной записи в Acrobat Sign

Через несколько минут в системе Acrobat Sign будет создан новый пользователь techacct.adobe.com.

  1. Выполните вход в учетную запись Acrobat Sign как администратор уровня учетной записи.

  2. В меню администратора перейдите на вкладку Пользователи.

  3. Найдите новый адрес электронной почты techacct.adobe.com (скопированный с главной страницы проекта).

  4. Нажмите пользователя и выберите Изменить сведения о пользователе.

    Изменение сведений о пользователе

  5. Нажмите значок плюса в разделе Участие в группе и добавьте группу приложения в профиль пользователя.

  6. Выберите группу приложения и нажмите Сделать основной.

  7. Установите флажок, чтобы отметить идентификатор userID как администратора группы.

  8. (Необязательно) Удалите техническую учетную запись из группы По умолчанию.

  9. По завершении нажмите Сохранить.

    Сохранение настроек пользователя

Создание пользователя/адреса электронной почты в разделе Получатель ответа

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

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

  • Необходимо создать новый федеративный идентификатор userID в Licensing Admin Console.
  • Необходимо предоставить общий доступ к идентификатору userID технической учетной записи новому федеративному идентификатору userID (с помощью расширенного общего доступа к учетной записи).

После настройки API-вызовы должны быть настроены для использования маркера технической учетной записи в качестве значения Авторизация, а userID или адрес электронной почты общего userID в качестве значения  x-on-behalf-of-user.

Создание федеративного userID

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

Чтобы создать userID, выполните следующие действия.

  1. Выполните вход в (Federated Sync) Admin Console как администратор.

  2. Перейдите в Настройки → Личные сведения

    Выберите каталог для создания пользователя.

    Активный домен

  3. Выберите вкладку Синхронизация.

  4. Выберите Перейти в настройки и нажмите Включить редактирование.

    Если функция редактирования включена, Adobe Admin Console позволяет вносить изменения в данные пользователя только в Admin Console. Изменения IdP не сохраняются.

    Настройки каталога — вкладка синхронизации

    Примечание.

    Редактирование будет включено только на один час или пока не будет отключено вручную.

    Техническая учетная запись

  5. Выполните вход в Licensing Admin Console (если у вас несколько консолей Admin Console).

  6. Перейдите в Пользователи → Добавить пользователя.

  7. Настройка нового идентификатора userID:

    • Адрес электронной почты или имя пользователя. Используйте адрес электронной почты, на который хотите получать ответные сообщения от получателей.
    • Тип идентификатора. Federated ID
    • Имя или фамилия. Это значение используется в системе Acrobat Sign и указывается в отчете об аудите. Используйте значение, которое будет давать информацию, например отдел кадров.
    • Имя пользователя SSO. Используйте значение из поля адреса электронной почты.
    • Страна или регион. Выберите страну или регион для вашей компании.
    • Выберите продукт или профиль Acrobat Sign, с которым связан идентификатор userID технической учетной записи.
    • Установите для роли пользователей значение Пользователь.

    По завершении нажмите «Сохранить».

    Техническая учетная запись

  8. Снова выполните вход в Federated Sync Admin Console для включения синхронизации данных IdP.

  9. Вернитесь в Настройки → Личные сведения → {Каталог} → Синхронизация → Перейти в настройки.

    Нажмите Отключить редактирование для повторного включения синхронизации данных с IdP.

  10. Новый идентификатор userID будет автоматически создан в системе Acrobat Sign.

Предоставление доступа к технической учетной записи новому федеративному идентификатору userID

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

  1. Выполните вход в Acrobat Sign как администратор учетной записи.

  2. Перейдите на вкладку Пользователи в меню администратора.

  3. Один раз нажмите нового пользователя, затем Изменить сведения о пользователе.

  4. В меню слева выберите Состояние доступа.

    Убедитесь, что выбрана вкладка Общий доступ к учетной записи пользователя.

  5. Выберите вкладку Доступ предоставлен пользователю в верхней части на странице Состояние доступа.

  6. Предоставьте технической учетной записи доступ к новому идентификатору userID учетной записи

    1. Нажмите значок плюса в строке вверху справа ,чтобы открыть интерфейс селектора.
    2. Справа от поля поиска нажмите значок с тремя линиями.
    3. Разверните группу, в которой находится userID технической учетной записи.
    4. Чтобы выбрать userID технической учетной записи, нажмите значок плюса рядом.
    5. Установите флажок Дополнительные разрешения, чтобы разрешить Отправку.
    6. Нажмите Сохранить.
    Техническая учетная запись

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

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

  1. Перейдите к методам API: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Выберите метод GET /users.

  3. В поле авторизации:

    1. Введите слово Bearer и пробел.
    2. Вставьте код доступа.
    3. Нажмите Попробовать!
    Попробовать!

  4. В тексте ответа отобразится список пользователей в учетной записи и код ответа 200:

    Текст ответа

Проверка отправки соглашения с помощью технической учетной записи от имени нового userID через API

  1. Получите transientDocumentId или подумайте о другом методе для прикрепления файла.

  2. В поле авторизации:

    1. Введите слово Bearer и пробел.
    2. Вставьте Маркер доступа
      технической учетной записи
    3. В поле x-on-behalf-of-user введите адрес электронной почты нового userID
    4. Заполните оставшуюся часть поля AgreementInfo, введя transientDocumentId, название соглашения, тип подписи и состояние.
    5. Нажмите Попробовать!
    Попробовать!

  3. Выполните вход в Acrobat Sign с новым userID и перейдите на вкладку Управление.

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

Проверка содержимого, созданного с использованием нового userID и интерфейса Acrobat Sign

Когда соглашение создается в технической учетной записи с использованием федеративного userID, соглашение публикуется на странице Управление федеративного userID.

Именно на странице Управление федеративного userID можно просматривать соглашение и управлять им.

Соглашение отправлено от лица пользователя

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

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