OneSpan Sign How To: Créer un auditeur de notification d'événement de rappel dans Ruby

Haris Haidary, janvier 11, 2017

Dans ce billet de blog, je vais vous montrer comment créer un simple auditeur de notification d'événement de rappel dans le cadre Sinatra Ruby. Sinatra est un cadre Ruby pour créer rapidement des applications web avec un minimum d'effort. Allons-y !

Le code

Dans mon exemple, je vais utiliser Ruby 2.3.3. Si vous ne l'avez pas déjà installé, vous pouvez le télécharger à partir de leur site officiel, ici. Vous devrez également télécharger la trousse d'outils de développement afin d'utiliser le module JSON. Inclus dans le lien est un tutoriel sur la façon d'installer la boîte à outils développeur.

Pour recevoir des notifications d'événements de rappel, vous aurez besoin d'une URL accessible au public pour frapper et travailler. Votre serveur localhost à lui seul ne sera pas. Ngrok est un outil très simple et facile à utiliser qui crée un tunnel sécurisé sur votre machine locale avec une URL publique que vous pouvez utiliser pour naviguer sur votre site local. Cela vous évite la peine de déployer votre application web.

Le code d'exemple complet est disponible sur le Developer Community Code Share. La première chose que vous voudrez faire est d'installer le module 'json' et 'sinatra'. Ouvrez votre invite de commande et entrez la ligne suivante :

gem install json
gemme installer sinatra

Maintenant, dans votre éditeur de texte préféré, créez un nouveau nom de fichier "listener.rb" et enregistrez-le dans un endroit de votre choix. Allez-y et copiez le code ci-dessous. J'examinerai la façon de le faire plus en détail plus en détail.

exiger 'sinatra'
besoin de 'json'

après '/event' ne
  request_payload JSON.parse(request.body.read)
  met request_payload
  statut 200
Fin

Passons en plus du code étape par étape. Les deux premières lignes importent les modules nécessaires pour cet exemple.

exiger 'sinatra'
besoin de 'json'

Ensuite, nous devons définir notre URL de point de terminaison (c'est-à-dire http://localhost:4567/event) pour que OneSpan Sign soit touché. Il ya un gestionnaire de demande POST appelé / événement, qui va servir toutes les demandes de OneSpan Sign.

après '/event' ne
  request_payload JSON.parse(request.body.read)
  met request_payload
  statut 200
Fin

Dans cet exemple simple, je vais simplement imprimer la charge utile JSON sur la console.

Exécution de votre code

Ouvrez votre invite de commande et modifiez l'annuaire actuel à l'endroit où vous avez enregistré votre fichier "listener.rb". Ensuite, entrez la ligne suivante:

listener.py rubis

Ensuite, dans une nouvelle fenêtre de commande rapide, modifiez le répertoire actuel à l'emplacement lorsque vous avez enregistré votre fichier exécutable ngrok et entrez la ligne suivante :

ngrok http 4567 -host-header"localhost:4567"

Enfin, connectez-vous à votre compte OneSpan Sign et naviguez vers la page Admin. Entrez dans le champ « URL de rappel » l'URL à votre auditeur de rappel (c'est-à-dire http://f3e93555.ngrok.io/event) et inscrivez-vous à l'événement « transaction complète ». Enfin, créez, envoyez et remplissez un package de test. Vous devriez être en mesure de voir le JSON envoyé par eSignLive imprimé dans la fenêtre de commande rapide.

Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs: https://developer.OneSpanSign.com. C'est moi qui l'ai fait. Merci de lire! Si vous avez trouvé ce message utile, s'il vous plaît le partager sur Facebook, Twitter, ou LinkedIn.

Haris Haidary
Évangéliste technique junior
LinkedIn - France Twitter (en)