L’idée

Trop de spam ? Marre de donner son adresse email à chaque service ? Les alias mail sont là à la rescousse !

Suite à une idée d’Adrien Chinour, j’ai décidé de créer à mon tour un petit gestionnaire d’alias pour mes adresses emails. L’objectif est de pouvoir générer rapidement des alias afin de ne pas donner sa véritable adresse email lors d’inscription sur des sites divers. Ainsi, si l’on constate que le site envoie un peu trop de mail à notre goût, que l’on n’utilise plus le service, ou que réussir à se désinscrire relève du parcours du combattant, on supprime l’alias, et plus de mails indésirables !

Ayant mes domaines gérés par Gandi, j’ai regardé comment interagir avec mes adresses emails pour créer des alias depuis leur API.

Au niveau des technologies utilisées, j’ai utilisé Angular et les fonctions serverless de Netlify (en NodeJS) afin de gérer les appels à l’API Gandi.

Le principe est très simple : on s’authentifie avec un mot de passe, prédéfini dans les variables d’environnement des fonctions serverless de Netlify, on obtient un JWT Token signé avec un secret connu seulement par les fonctions serverless, et on peut ensuite considérer que l’on est authentifié. N’ayant pas besoin de gérer plusieurs utilisateurs, cela convient à mon cas d’utilisation.

Une fois authentifié, les fonctions serverless se chargent de récupérer la liste des domaines, ainsi que la liste des boites mails associées à ces domaines et on arrive ensuite sur l’écran suivant, qui nous permet de gérer les alias de chaque boite mail.

La suite

Dans le cas où d’éventuels clients de Gandi souhaiteraient utiliser ce projet, j’ai tenté d’intégrer l’Oauth2, afin de permettre de s’authentifier via Gandi. Cela m’a également permis de comprendre mieux le fonctionnement de l’Oauth2.

J’ai donc demandé la création d’une application, obtenant ainsi un applicationId et un applicationSecret me permettant de mettre en place l’authentification. Afin de tester cela en local, j’ai utilisé un mock oauth2 réalisé par le groupe AXA

Malheureusement, l’API v5 de Gandi est encore en beta et le fournisseur d’authentification ne permet pas encore d’interagir avec les domaines et boites mails. 😢

En attendant que cela soit disponible, j’ai laissé mon travail disponible sur une branche dédiée.

J’ai également ajouté un bouton de déploiement Netlify en un clic pour ceux souhaitant se servir de ce petit projet. Il faudra néanmoins générer sa propre clé d’API depuis les paramètres de son compte Gandi et renseigner quelques variables d’environnement, décrites ci-dessous.

Tableau : Variables d’environnement à renseigner

Pour générer le JWT Secret, la commande suivante peut être utile

cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1

Les sources du projet sont disponibles sur Github

Je souhaitais utiliser FontAwesome sans pour autant intégrer toute la librairie, assez lourde.

J’ai donc cherché un moyen de n’inclure que les icônes utilisées, et c’est comme cela que je suis venu à chercher comment créer un plugin Jekyll.

La documentation est assez bien fournie, ce qui m’a permis de rapidement prendre en main Jekyll.

Réalisation

Ne souhaitant qu’afficher des icônes, je me suis tourné vers 2 Tag, qui permettent de définir une balise et de lui passer des paramètres.

Ainsi, je passe à mon premier tag le type de l’icône que je souhaite utiliser (regular, solid ou brand), ainsi que son nom, et je génère la balise HTML^{note 1} correspondant à l’icône. Il ne me reste donc plus qu’à récupérer la définition SVG^{note 2} de l’icône et l’inclure dans un namespace, en bas de la page HTML.

Pour cela, j’ai ajouté aux données de la page Jekyll les icônes que j’utilise, dans un simple tableau.

C’est lors de l’usage du deuxième tag que je récupère toutes les icônes utilisées sur la page, et que je vais récupérer la définition SVG de l’icône.

J’ai tout d’abord réalisé ce plugin très simplement, en utilisant le répertoire _plugins de Jekyll. Mais une fois fonctionnel, j’ai souhaité en faire une Gem, mise à disposition sur RubyGems, pour qu’elle soit disponible pour tous, si elle venait à être utile à certains :blush:.

La création d’une Gem a été assez simple, le guide de Bundler étant très bien détaillé.

J’ai essayé d’être le plus en accord avec les conventions du langage Ruby, mais n’étant pas familier avec ce dernier, je suis ouvert à toutes remarques pour améliorer le code !

Il me reste à tester l’application de façon plus détaillée et à gérer les cas d’erreurs, qui sont pour le moment gérés de façon optimiste !

Usage

L’usage est le suivant :

Lorsque l’on souhaite afficher une icône, il faut utiliser le tag suivant. Le code ci-dessous va générer l’icône Twitter.

{% fa_svg fab.fa-twitter %}

Voici le résultat :

{% fa_svg fab.fa-twitter %}

Il faut ensuite ajouter à un endroit commun à toutes les pages (en général un footer), le tag de génération de la feuille SVG.

{% fa_svg_generate %}

Liens

Si vous voulez voir le code, il est disponible sur ce dépôt.

Pour télécharger la Gem, c’est par ici !