Chapitre 4 - La force des variables 💪

 

Objectifs de la Mission 🎯

• Découvrir les variables d'environnement
• Découvrir la gestion des secrets

Les variables d'environnement

Aujourd'hui pour intéragir avec le système centralisé de gestion des types de personnages et des guerres de la galaxie nous utilisons une version de l'API accessible en locale.

Imaginons que demain, la résistance décide que l'accès à ces ressources soit impossible en local et se fasse sur différents serveurs en fonction de l'étoile la plus proche de votre position. Il faudrait alors changer toutes les requêtes en mettant à jour vos URLs, et ce, à chaque fois que vous changerez de position dans la galaxie.

Pour palier à ce problème, et à n'importe quel problème de répétition d'informations identiques en fonction d'un contexte donné, il est possible de déclarer des variables d'environnement.

Créer un nouvel environnement

Évitez les espaces et caractères spéciaux dans le nommage de votre environnement

Cliquez sur une des requêtes de votre collection > cliquez en haut à droite de l'interface de Bruno sur le bouton No environment > Configure > Create Environment. Renseignez un nom pour votre environnement, par exemple Andor pour une configuration correspondant à la planète Andor.

Une nouvelle fenêtre s'ouvre, vous pouvez alors ajouter, supprimer et/ou modifier des variables d'environnement.

Évitez les espaces et caractères spéciaux dans le nommage de vos variables

Ces variables sont, par défaut, visibles pour toutes les personnes ayant accès à la collection, mais vous pouvez définir comme "secrète" une variable "sensible" en cochant la checkbox correspondante.

Ajouter des variables pour:

• l'url de base de vos appels (base_url)
• votre numéro de matricule (registration_number)
• votre mot de passe (password en tant que variable secrète)
• tout ce que vous trouverez de pertinant si vous le souhaitez

Prenez un instant pour examiner le fichier .bru représentant votre environnement sur votre ordinateur (environments/<env_name>.bru)

Utilisez vos variables d'environnement

Vous pouvez maintenant utiliser vos variables via la syntaxe moustache : {{base_url}}

Utilisez vos variables dans toutes vos requêtes.

Dans toutes vos URLs:

Pensez à sauvegarder vos requêtes au fur et à mesure

Dans le payload de votre requête POST pour récupérer votre passeport galactique:

Pour que Bruno interprète des variables dans un body, il faut utiliser un body de type "Form URL Encoded"

Prenez un instant pour examiner le fichier .bru de votre requête pour récupérer votre passport galactique, sur votre ordinateur.

Besoin d'un coup de main ?

Les solutions à ce chapitre sont dans les dossiers solutions/chapter-4 et solutions/environments

Nous pouvons aller encore plus loin grâce à la notion de scripts.