Secrets 🤫
Pour s'interfacer à des services externes (souvent payants ou limités), votre application a généralement besoin d'utiliser des clés d'API fournies par ces services externes.
Ces clés d'API sont considérées comme des données sensibles. Imaginez si quelqu'un de mal intentionné se retrouvait à être en possession d'une clé. Il pourrait agir en votre nom, et utiliser toutes les limites d'utilisation du service que vous utilisez. C'est généralement même recommandé de limiter l'accès à ces clés au sein d'une même équipe de développement. Il vaut donc mieux ne pas les inclure dans un repo Git.
Pour notre exemple, nous allons utiliser le service REST Countries. Créez vous un compte, et trouvez la clé d'API créée par défaut. Elle devrait commencer par rc_live. Cette clé est votre laissez-passer 🪪 pour intéragir avec l'API de REST Countries.
Si par mégarde, ça vous arrive, il faut immédiatement faire une rotation. Si ça arrive dans votre vie professionnelle, avertissez votre superviseur dans les plus brefs délais.
1. .env 🏞️
Nous allons ajouter le token dans un fichier .env à la racine du projet, qui n'est qu'une liste de clé=valeur.
REST_COUNTRIES_API_KEY=VOTRE_CLÉ_ICI!!!
Pour éviter que .env ne se retrouve dans votre repo git, ajoutons le à votre .gitignore :
// Reste des éléments ignorés
.env
2. flutter_dotenv 🐦🏞️
Le package flutter_dotenv va nous permettre d'utiliser les valeurs qui sont dans .env dans notre code.
Suivez les instructions sur la page du package pour compléter son installation. Un exemple est fourni pour utiliser la librairie.
S'il n'y a aucune clé valeur dans votre fichier .env, le lancement de l'application va échouer.