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

Haris Haidary, décembre 28, 2016

Node.js est un runtime open source construit sur le moteur JavaScript V8 de Chrome pour le développement d'applications Web côté serveur. JavaScript est sans doute le langage de programmation le plus populaire. Par conséquent, si vous connaissez déjà JavaScript, vous pouvez ramasser Node.js assez facilement. La bibliothèque Node.js est très rapide sur l'exécution du code (Chrome V8 JavaScript Engine) et permet un codage asynchrone et événementiel (c'est-à-d. non-blocage). Cela devient très pratique quand il s'agit de construire des applications web en temps réel. Dans ce blog, je vais vous montrer comment créer un simple auditeur de notification d'événement de rappel dans Node.js.

Exigences

Avant de plonger dans le code, vous aurez besoin d'installer un couple de choses. Pour ce blog, vous aurez besoin de Node.js, ngrok, et un éditeur de texte.

Node.js Vous pouvez télécharger l'installateur à partir du liensuivant . Node.js est disponible pour Windows, Mac et Linux.

SublimeTexte Vous aurez également besoin d'un éditeur de texte. Pour ce blog, je vais utiliser SublimeText. Vous pouvez télécharger une copie gratuite, ici.

Ngrok Ngrok 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

Vous pouvez télécharger le code d'exemple complet à partir du Developer Community Code Share. Créez un nouveau fichier .js à l'aide de SublimeText nommé "listener.js" dans un endroit de votre choix et copiez le code ci-dessous. J'y reviendrai bien tôt.

const express 'require') ; 
const bodyParser -exige('body-parser');
const app 'express();

app.use(bodyParser.json));
app.use(bodyParser.urlencoded
  étendu: vrai,
}));

app.post('/event', (req, res)

  res.send ('OK');

  const theData - req.body;
  console.log (theData);
});

const portToListenOn 3800;

app.listen(portToListenOn, ()
  console.log('Listening for eSignLive notifications on port $'portToListenOn.. A commencé $'new Date().toString() ' );
});

Dans mon exemple, j'utiliserai le cadre express pour Node.js. Express est un cadre d'application Web Node.js minimal et flexible qui fournit un ensemble robuste de fonctionnalités pour les applications web et mobiles. Optionnellement, vous pouvez ajouter le middleware "body-parser" pour analyser les organismes de demande entrants dans un middleware avant vos gestionnaires, disponibles sous la propriété req.body.

const express 'require') ; 
const bodyParser -exige('body-parser');
const app 'express();

app.use(bodyParser.json));
app.use(bodyParser.urlencoded
  étendu: vrai,
}));

Si vous n'avez pas installé d'express et de body-parser, ouvrez une fenêtre de commande et modifiez le répertoire où vous avez enregistré votre fichier "listener.js". Entrez ensuite les deux lignes suivantes :

npm installer@latest express --enregistrer
npm installer body-parser@latest --enregistrer

Ensuite, je vais "route" le OneSpan Sign POST appelle à "localhost:3800/event". Le routage fait référence à la définition des points de terminaison des applications (URI) et à la façon dont ils répondent aux demandes des clients. Dans mon exemple, je vais simplement imprimer le JSON entrant à la console.

app.post('/event', (req, res)

  res.send ('OK');

  const theData - req.body;
  console.log (theData);
});

Enfin, nous pouvons démarrer un serveur et écouter sur le port 3800 pour les connexions.

const portToListenOn 3800;

app.listen(portToListenOn, ()
  console.log('Listening for eSignLive notifications on port $'portToListenOn.. A commencé $'new Date().toString() ' );
});

Exécution de votre projet

Allez-y et exécutez votre serveur local avec Node.js en ouvrant une invite de commande et en changeant le répertoire actuel où vous avez enregistré votre fichier "listener.js". Ensuite, entrez:

node listener.js

Dans une nouvelle invite de commande, changez le répertoire à l'endroit où vous avez enregistré votre ngrok exécutable. Entrez la commande suivante :

ngrok http [port] -host-header"localhost:[port]"

Voici une capture d'écran de ce à quoi vous pouvez vous attendre après l'exécution de la commande:

121

Ensuite, 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 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)