docusign функция отправки от имени

Я новичок в docusign и api в целом. Я вручную создал основную учетную запись на docusign, и теперь я хочу создавать новых пользователей с помощью этой учетной записи и использовать функцию отправки от имени. Я уже просмотрел этот PDF-файл (http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf). Но может ли кто-нибудь объяснить в условиях непрофессионала, какие именно шаги мне нужно выполнить? Спасибо


person user1285659    schedule 04.11.2013    source источник


Ответы (1)


Обновление за апрель 2021 г.

Ни SOBO, ни устаревшая аутентификация не поддерживаются для новых интеграций REST API. Вместо этого используйте разрешение аутентификации OAuth v2.0. Замена шаблона SOBO заключается в использовании предоставления JWT, которое позволяет приложению выдавать себя за любого пользователя DocuSign, который дал согласие на это приложению. Если у вас есть вопросы, откройте новый q здесь, в StackOverflow.

Оригинальный ответ

Просмотрите DocuSign Dev Center, так как на нем есть очень полезная информация, включая точные шаги SOBO (Отправить от имени), которые вы ищете.

Перейти в Центр разработки - ›Изучить -› Возможности - ›SOBO. В общем, вам необходимо предпринять следующие шаги:

  1. Получите токен доступа для User1 (аутентифицирующего пользователя)
  2. Получите токен доступа для User2 (действующего пользователя - вы отправляете от имени этого человека)
  3. Отправить запрос от имени User2

На этой странице Центра разработки вы найдете точные шаги и возможные настройки учетной записи, которые вам необходимо включить:

http://www.docusign.com/developer-center/explore/features/sobo


Чтобы обобщить то, что объясняется на странице, и получить ответ здесь, вот подробности:

ШАГ 1:

POST https://{server}/restapi/{apiVersion}/oauth2/token

Accept: application/json
Content-Type: application/x-www-form-urlencoded
Content-Length: {length of body}

grant_type=password&client_id={IntegratorKey}&username={email}&password={password}&scope=api

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

При успешном ответе возвращается следующий JSON:

{
    "access_token": "<access token for user>",
    "scope": "api",
    "token_type": "bearer"
}

ШАГ 2:

Здесь вы добавляете заголовок Authorization: bearer <access_token>, где <access_token> - это токен, который был возвращен на шаге 1, а электронное письмо теперь является адресом электронной почты пользователя, которого вы хотите отправить от имени:

POST https://{server}/restapi/{apiVersion}/oauth2/token

Authorization: bearer <access token>
Accept: application/json
Content-Type: application/x-www-form-urlencoded
Content-Length: {length of body}
 
grant_type=password&client_id={IntegratorKey}&username={$emailOnBehalf}&password={password}&scope=api

В результате получился еще один токен доступа, допустим, 12345.

Шаг 3:

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

Authorization: bearer 12345
X-DocuSign-Act-As-User: $emailOnBehalf
person Ergin    schedule 05.11.2013
comment
По какой-то причине эта ссылка не работает - docusign.com/developer-center/ исследовать / features / sobo. Это заставляет меня возвращаться на общую домашнюю страницу developers.docusign.com. Кто-нибудь с обновлениями? - person A. Varma; 09.04.2019
comment
Функция SOBO устарела, такие варианты использования теперь обрабатываются более безопасно с помощью OAuth. Посмотрите раздел получения согласия для OAuth, выполните поиск по запросу impersonation, и вы увидите параметры, которые необходимо установить для доступа к чужой учетной записи: developers.docusign.com/esign-rest-api/guides/authentication/ - person Ergin; 11.04.2019