Я новичок в docusign и api в целом. Я вручную создал основную учетную запись на docusign, и теперь я хочу создавать новых пользователей с помощью этой учетной записи и использовать функцию отправки от имени. Я уже просмотрел этот PDF-файл (http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf). Но может ли кто-нибудь объяснить в условиях непрофессионала, какие именно шаги мне нужно выполнить? Спасибо
docusign функция отправки от имени
Ответы (1)
Обновление за апрель 2021 г.
Ни SOBO, ни устаревшая аутентификация не поддерживаются для новых интеграций REST API. Вместо этого используйте разрешение аутентификации OAuth v2.0. Замена шаблона SOBO заключается в использовании предоставления JWT, которое позволяет приложению выдавать себя за любого пользователя DocuSign, который дал согласие на это приложению. Если у вас есть вопросы, откройте новый q здесь, в StackOverflow.
Оригинальный ответ
Просмотрите DocuSign Dev Center, так как на нем есть очень полезная информация, включая точные шаги SOBO (Отправить от имени), которые вы ищете.
Перейти в Центр разработки - ›Изучить -› Возможности - ›SOBO. В общем, вам необходимо предпринять следующие шаги:
- Получите токен доступа для User1 (аутентифицирующего пользователя)
- Получите токен доступа для User2 (действующего пользователя - вы отправляете от имени этого человека)
- Отправить запрос от имени 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
impersonation
, и вы увидите параметры, которые необходимо установить для доступа к чужой учетной записи: developers.docusign.com/esign-rest-api/guides/authentication/
- person Ergin; 11.04.2019