DocuSign отправляет уведомление на запрашиваемый URL-адрес, но я не могу его получить

Question

Я установил конверт для получения уведомления о событиях конверта. Я использую Rails и жемчуг Docusign_REST вместе с ним.

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

event_notification: { 
     url: "<MY_REQUEST_URL>", 
     logging: true, 
     envelope_events: [ 
      { 
      include_documents: false, 
      envelope_event_status_code: "Sent" 
      }, 
      { 
      include_documents: false, 
      envelope_event_status_code: "Completed" 
      }, 
      { 
      include_documents: false, 
      envelope_event_status_code: "Delivered" 
      } 
     ] 
     }, 

Answer 1

Основы

Вы используете "webhook." Вы зарегистрировали URL-адрес с помощью DocuSign. Платформа DocuSign будет называть ваш URL-адрес webhook, когда ваш конверт (ы) изменится.

Диагностировать проблему

Вы знаете, что DocuSign пытается отправить вас (в вашей «webhook_url») сообщения уведомления, глядя на «Connect» журнал сообщений в инструменте DocuSign Admin. - И вы можете использовать кнопку «Resend» для инструмента «Администратор», чтобы легко отправить уведомление в виде теста.

Поскольку вы знаете, что DocuSign пытается отправить вам, проблема находится где-то в вашей системе. Я хотел бы сделать следующее, чтобы диагностировать проблему:

1. Пусть ваш webhook_address что-то вроде «http://my-server.com/my_app/webhook» Вы зарегистрировать весь URL с DocuSign? Не оставляйте http или https! (https требуется в производстве, но не в песочнице разработчика)
2. Посмотрите на журналы входящих серверов. Вы должны увидеть запросы POST, поступающие из DocuSign. Если вы этого не сделаете, проверьте брандмауэры, наличие вашего интернет-адреса в Интернете и т. Д.
3. Является ли ваш webhook_url доступным из общедоступного Интернета? Вы можете протестировать, используя услугу www.hurl.it. Поскольку hurl.it будет отправлять пустой тело запроса, ваш слушатель, вероятно, задохнется. Конечно, если вы пожаробезопасны, ваш слушатель проверяет наличие пустых тел запроса, хорошо для вас.
4. Если вы используете webbrick или другой веб-сервер Ruby на своей собственной машине разработки, вам нужен адрес в общедоступном Интернете, так как DocuSign не может отправить прямо на вашу машину разработки. ngrok (и аналогичные приложения) являются хорошим решением для этого. Запустите ngrok на локальном компьютере и укажите его номер порта localhost вашего сервера Ruby. Затем ngrok предоставит вам URL-адрес в общедоступном Интернете, который вы можете использовать с DocuSign.
5. Для разработки ваш URL-адрес для прослушивания webhook может использовать http или https. Ваш сертификат SSL должен иметь доверительный путь к одному из обычных доверенных корневых сертификатов. (Список Mozilla). Вполне нормально использовать сертификат за 4 доллара. Не нужно использовать сертификат Extended Validation или аналогичный. Не используйте самозаверяющий сертификат. Платформа DocuSign не будет доверена, и вы не будете получать уведомления через свой веб-сайт.