Ключ интегратора Docusign и имя пользователя
Я использую устаревшую сервисную интеграцию с DocuSign (через пользовательский атрибут заголовка X-DocuSign-Authentication), и меня немного смущает связь между именем пользователя и Integrator-Key.
Например, для целей тестирования я использовал следующий сценарий:
- Я отправил запрос на подписание документа и получил envelopeId с помощью Integrator-Key-1
- После того, как я отправляю запрос на получение URL-адреса представления получателя (для встроенной подписи), используя те же учетные данные и предоставленный envelopeId, но другой ключ-интегратор-2
Я ожидал, что запрос не удастся, но он работает нормально, и документ отображается для подписи. Я получаю тот же результат, даже если предоставленный ключ интегратора принадлежит другому пользователю.
Итак, я действительно запутался, для чего используется ключ интегратора. Спасибо.
2 ответа
Ключ интегратора идентифицирует интеграцию. После одобрения для использования в конкретной среде DocuSign (например, demo, prod) ключ интегратора можно использовать для выдачи запросов API на данные, связанные с любой Учетной записью и / или Пользователем в этой среде (при условии, конечно, что каждый запрос API) включает в себя правильную информацию для аутентификации пользователя, который делает запрос API).
Так, например, если вы являетесь независимым разработчиком ПО, который создает интеграцию, которая будет использоваться несколькими клиентами для нескольких учетных записей DocuSign, вы можете использовать один и тот же ключ интегратора для всех вызовов API, которые вызывает ваша интеграция, независимо от учетной записи и / или Пользователь связан с любым конкретным запросом.
Ключ интегратора (также известный как идентификатор клиента) - это уникальный идентификатор, который аутентифицирует вашу учетную запись с помощью API DocuSign. Если у вас есть два ключа интегратора для одной и той же среды, вы сможете вызывать API-интерфейсы DS с любым ключом интегратора. Но Integrator Key имеет большее значение для DocuSign, например, если вы создали приложение с API-интерфейсами DS с IK 1 и рассмотрели этот IK для использования в среде PROD. После того как вы пройдете процесс рецензирования, IK перейдет в среду PROD, что позволит вам вызывать API-интерфейсы DS в среде Live / Prod в рамках правил и ограничений API. Теперь в будущем вы сделали какие-либо изменения кода на своей стороне, и ваш вновь развернутый код не был разработан в соответствии с правилами и ограничениями API DS, после чего DS может внести ваш IK в черный список, чтобы он не использовался в PROD, что повлияет на остановку вашего приложения в ПРОД прямо.