demo twilio backend nodejs Télécharger - demo twilio backend nodejs Téléchargement du code source

demo twilio backend nodejs

Code Source AI

1.0.0

Télécharger

Exemple de backend Twilio pour Node.js

Ce référentiel contient un exemple de code backend qui montre comment combiner la génération Virgil et Twilio JWT, qui sont utilisés pour l'authentification avec les services Virgil et Twilio.

N'utilisez pas cette authentification en production. Les requêtes vers des points de terminaison /virgil-jwt et /twilio-jwt doivent être autorisées pour les utilisateurs authentifiés. Utilisez votre stratégie d’autorisation d’application.

Conditions préalables

NodeJS de 10 à 13

Configurer et exécuter une démo

Cloner

Clonez le référentiel depuis GitHub.

 $ git clone https://github.com/VirgilSecurity/twilio-sample-backend-nodejs.git

Obtenez les informations d'identification Virgil

Si vous n'avez pas encore de compte, créez-en un en utilisant votre e-mail.

Vous pouvez télécharger un fichier .env prêt à l'emploi

Accédez au tableau de bord Virgil -> Votre application -> Section E3Kit.
Générez .env dans la section du fichier .env .
Téléchargez le fichier généré, collez-le dans le dossier racine du projet et renommez-le en .env .

Ou vous pouvez ajouter les paramètres manuellement :

Pour générer un Virgil JWT, les valeurs suivantes sont requises :

Nom de la variable	Description
ID_APP	ID de votre application Virgil.
APP_KEY	Clé privée de votre application utilisée pour signer les JWT.
APP_KEY_ID	ID de votre clé d'application. Une valeur de chaîne unique qui identifie votre compte dans le Virgil Cloud.

Copiez et renommez .env.example en .env .
Créez une application dans le tableau de bord Virgil, copiez son APP_ID dans le fichier .env ;
Créez une clé d'application et enregistrez sa valeur de clé privée sur la ligne APP_KEY dans le fichier .env ;
Copiez l'ID de la clé créée sur la ligne APP_KEY_ID dans le fichier .env ;

Obtenez les informations d'identification Twilio

Pour générer un Twilio JWT, les valeurs suivantes sont requises :

Nom de la variable	Description
TWILIO_ACCOUNT_SID	Votre identifiant de compte Twilio principal - trouvez-le dans la console ici.
TWILIO_API_KEY_SID	SID de la clé API Twilio. Utilisé pour l'authentification sur les services Twilio. Généré avec TWILIO_API_SECRET
TWILIO_API_SECRET	Clé secrète de l'API Twilio : générez-en une ici
TWILIO_SERVICE_SID	Une instance de service où toutes les données de notre application sont stockées et étendues. Générez-en un dans la console ici.

Ajoutez ces paramètres à votre fichier .env .

Installer les dépendances et exécuter le serveur

 $ npm install
$ npm run start

Maintenant, utilisez votre code client pour faire une demande afin d'obtenir un JWT à partir de l'exemple de backend qui fonctionne sur http://localhost:3000.

En plus du backend, nous proposons une démonstration d'un simple chat client interagissant avec l'API Virgil, que vous pouvez voir si vous accédez à http://localhost:3000 sur votre navigateur. L'exemple de code de discussion se trouve dans le répertoire public .

Capture d'écran de la démo

Spécification

/authentifier le point de terminaison

Ce point de terminaison est un exemple d’authentification des utilisateurs. Il prend identity de l'utilisateur et répond avec un jeton unique.

 POST https://localhost:3000/authenticate HTTP/1.1
Content-type: application/json;

{
    "identity" : " string "
}

Response:

{
    "authToken" : " string "
}

/virgil-jwt point de terminaison

Ce point de terminaison vérifie si une demande est authentifiée par un en-tête d'autorisation. Il prend authToken de l'utilisateur, trouve l'identité de l'utilisateur associée et génère un virgilToken (qui est un jeton Web JSON) avec cette identity dans une charge utile. Utilisez ce jeton pour effectuer des appels API autorisés vers Virgil Cloud.

 GET https://localhost:3000/virgil-jwt HTTP/1.1
Content-type: application/json;
Authorization: Bearer <authToken>

Response:

{
    "virgilToken" : " string "
}

/point de terminaison twilio-jwt

Identique au point de terminaison du jeton Virgil Le point de terminaison Twilio doit être protégé et répond avec twilioToken .

 GET https://localhost:3000/twilio-jwt HTTP/1.1
Content-type: application/json;
Authorization: Bearer <authToken>

Response:

{
    "twilioToken" : " string "
}

Virgil JWT Génération

Pour générer un Virgil JWT, vous devez utiliser la classe JwtGenerator du SDK Virgil.

 const virgilCrypto = new VirgilCrypto ( ) ;

const generator = new JwtGenerator ( {
  appId : process . env . APP_ID ,
  apiKeyId : process . env . API_KEY_ID ,
  apiKey : virgilCrypto . importPrivateKey ( process . env . API_PRIVATE_KEY ) ,
  accessTokenSigner : new VirgilAccessTokenSigner ( virgilCrypto )
} ) ;