Node.js

Configurer l'environnement backend

Créer le projet

Ouvrez un terminal et créez un nouveau dossier :

mkdir -p vonage-verify-tutorial/backend cd vonage-verify-tutorial/backend npm init -y

npm init -y crée un fichier par défaut package.jsonqui est l'endroit où npm suit les dépendances et les scripts.

Installer les dépendances

npm install express cors dotenv @vonage/auth @vonage/verify2

A quoi sert chaque paquet :

  • express: pour construire nos points d'accès à l'API HTTP.
  • cors: autorise les requêtes provenant de l'application Android (origine différente).
  • dotenv: charge les variables d'environnement à partir d'un fichier .env local.
  • @vonage/auth: permet de générer/authentifier des requêtes Vonage à l'aide de JWT.
  • @vonage/verify2le SDK Verify API Server (lancer une vérification, puis vérifier un code à l'aide de l'identifiant de la demande).

Enfin, il faut s'assurer que nous ne validons pas le fichier node_modules à notre dépôt git :

echo "node_modules" >> .gitignore

Créer app.js

app.js sera le point d'entrée de notre application backend. Il s'agit du fichier qui démarre un serveur HTTP et expose les points de terminaison que l'application mobile appellera.

Créer le fichier :

touch app.js

Pour l'instant, nous ajouterons un serveur Express minimal juste pour vérifier que tout est correctement câblé.

Ce qu'il fait :

  • Charge les variables d'environnement à l'aide de dotenv
  • Crée un Express application
  • Active :
    • cors afin qu'une application mobile puisse appeler cette API
    • express.json() pour lire les corps de requête JSON
  • Expose un /health pour vérifier rapidement que le serveur est en cours d'exécution

Vous pouvez démarrer le serveur avec :

node app.js

Ouvrez ensuite un navigateur ou exécutez :

curl http://localhost:3000/health

A voir :

{ "status": "ok" }

Se souvenir: Ce point de terminaison n'a rien à voir avec Verify. Il s'agit simplement d'une vérification de la logique avant d'en ajouter d'autres.

Créer le fichier de configuration

Nous utiliserons un .env pour stocker la configuration et les secrets, tels que les informations d'identification de l'API.

Pour l'instant, créez un fichier vide :

touch .env

Nous la remplirons dans la section suivante, une fois que nous aurons présenté les informations d'identification de Vonage et expliqué à quoi sert chaque variable.

Enfin, assurez-vous que .env est non engagé afin de ne pas commettre accidentellement des informations d'identification. Chaque développeur aura sa propre version :

echo ".env" >> .gitignore

Mise à jour de la structure des dossiers

Après cette étape, votre dossier backend se présentera comme suit :