Git on slash-root.fr

Git : How to smudge and clean ?

Sun, 27 Oct 2024 23:36:07 +0100

Préambule

Il était une fois, dans le royaume du développement, un développeur nommé John. En plein milieu d'un projet complexe, qui impliquait des fichiers de configuration .env et .yaml pour se connecter à une API tournant dans un conteneur Docker, John a commis l'impensable : il a ouvert un dépôt contenant une clé API Mailgun en clair dans un fichier .env utilisé pour la configuration du docker compose.

À peine avait-il réalisé son erreur qu'un désastre s'annonçait. Non seulement sa clé d'API avait été compromise, mais son compte Mailgun avait également été coupé, le plongeant dans un tourbillon de préoccupations. Une procédure rigoureuse devait être suivie pour le réactiver, impliquant la réinitialisation des mots de passe et des clés d'API. Une perte de temps énorme qui plongea notre petit John dans une énorme tristesse.

Face à l'urgence de partager son code Python avec un autre développeur pour résoudre un problème pressant, John a décidé d'agir. Bien que la meilleure solution aurait été de monter un vault sécurisé, le temps pressait. Il a donc opté pour un mécanisme de nettoyage et de restauration connu sous le nom de "smudge and clean".

Les faits

Il a ajouté dans le fichier .git/config de son projet, les lignes suivantes :

[filter "secrets"]
 clean = ../scripts/filter-secrets.sh clean
 smudge = ../scripts/filter-secrets.sh smudge

Ces lignes indiquaient à Git d'utiliser son script de filtrage chaque fois qu'il push ou pull des commits. Dans ce script, il a employé sed pour remplacer sa clé API par une phrase humoristique, de sorte qu'elle ne soit jamais exposée dans le dépôt.

Filter secrets

Le script de filtrage filter-secrets.sh en question ressemblait à cela :

#!/bin/bash

if [ "$1" == "clean" ]; then
 # Clean (replace sensitive data with placeholders)
 sed -e 's/XXXXXXXXX/{API_KEY_PLACEHOLDER}/g' \
 -e 's/YYYYYYYYY/{SENDING_API_KEY_PLACEHOLDER}/g' \
 -e 's/ZZZZZZZZZ/{SMTP_PASSWORD_PLACEHOLDER}/g' \
 -e 's/AAAAAAAAA/{POSTGRES_PASSWORD_PLACEHOLDER}/g' \
 -e 's/BBBBBBBBB/{TWS_USERID_PLACEHOLDER}/g' \
 -e 's/CCCCCCCCCC/{TWS_PASSWORD_PLACEHOLDER}/g'

 # Si une erreur se produit avec sed, renvoyer un code d'erreur
 if [ $? -ne 0 ]; then
 echo "Erreur lors de l'exécution du clean"
 exit 1
 fi
elif [ "$1" == "smudge" ]; then
 # Smudge (replace placeholders with sensitive data)
 sed -e 's/{API_KEY_PLACEHOLDER}/XXXXXXXXX/g' \
 -e 's/{SENDING_API_KEY_PLACEHOLDER}/YYYYYYYYY/g' \
 -e 's/{SMTP_PASSWORD_PLACEHOLDER}/ZZZZZZZZZ/g' \
 -e 's/{POSTGRES_PASSWORD_PLACEHOLDER}/AAAAAAAAA/g' \
 -e 's/{TWS_USERID_PLACEHOLDER}/BBBBBBBBB/g' \
 -e 's/{TWS_PASSWORD_PLACEHOLDER}/CCCCCCCCCC/g'

 if [ $? -ne 0 ]; then
 echo "Erreur lors de l'exécution du smudge"
 exit 1
 fi
fi
exit 0

Les attributs

Pour finaliser le tout, il a modifié un fichier .git/info/attributes où il a défini quels fichiers de configuration devaient passer par ce filtre :

config.yaml filter=secrets
.env filter=secrets

Conclusion

Grâce à son ingéniosité, John a pu collaborer sur son projet sans craindre pour la sécurité de ses informations sensibles en se donnant le temps de monter proprement un Vault. À la fin de la journée, il avait non seulement corrigé son erreur, mais aussi appris à jongler avec la sécurité dans le monde des dépôts Git. Et c'est ainsi qu'il a vécu heureux, protégé de la menace des fuites de secrets, et avec un compte Mailgun réactivé, prêt à affronter de nouveaux défis.

Terminal: Le prompt avec Powerline sous LSD

Sun, 20 Mar 2022 19:56:57 +0100

Contexte

Je cherchais à améliorer mon prompt bash dans mon terminal afin d'améliorer mon expérience.

Le résultat me satisfait pleinement. Il est épuré et agréable. De plus, cela m'a permis d'avoir une indication de la branche git sur laquelle je travaille ainsi que les codes erreurs de retour.

Exemple :

La personnalisation peut être plus avancée (se référer aux sources en bas de page).

Paramétrage

Editer son fichier .bashrc :

vi ~/.bashrc

Ajouter les lignes suivantes :

export POWERLINE_SEGMENTS="hostname pwd git git_sync status"
source ~/.powerline.bash

Télécharger le fichier powerline.bash et le déplacer dans sa home directory :

wget https://gitlab.com/bersace/powerline.bash/-/raw/master/powerline.bash
mv powerline.bash ~/.powerline.bash

Télécharger le package de polices nécessaire Hack Nerd Font :

wget https://github.com/ryanoasis/nerd-fonts/releases/download/v2.1.0/Hack.zip

Si le dossier ~/.fonts n'existe pas, le créer !

mkdir ~/.fonts

Décompresser l'archive des polices dans son dossier ~/.fonts :

unzip -d ~/.fonts Hack.zip

Supprimer l'archive Hack.zip :

rm Hack.zip

Mettre à jour le cache des polices :

fc-cache -vf ~/.fonts

Sélectionner la police Hack Nerd Font pour son terminal :

Il peut être utile de redémarrer son terminal pour avoir le choix des nouvelles polices installées 🙂

Maintenant, à l'ouverture de son terminal ce prompt apparait :

LSD

Dans mes recherches, je suis également tombé sur un projet nommé lsd (se référer aux sources en bas de page).

Celui-ci permet d'afficher des icônes sympa en fonction du type de fichiers.

Télécharger la dernière release dispo ici : https://github.com/Peltoche/lsd/releases

A l'heure où j'écris ces lignes c'est la version 0.21.0, donc pour ma Pop!_Os en 64 bits :

wget https://github.com/Peltoche/lsd/releases/download/0.21.0/lsd_0.21.0_amd64.deb

Installer le paquet :

sudo dpkg -i lsd_0.21.0_amd64.deb

Et voilà !

Il suffit de remplacer la commande ls par lsd :

Ces quelques alias peuvent être très agréables :

alias ls='lsd'
alias ll='ls -lh'
alias la='ls -ah'
alias lla='ls -lah'
alias lt='ls --tree'