Le but de ce laboratoire est d'initier les étudiants au protocole derrière un SMTP, ainsi que de mettre en place le coté client de ce dernier, ensuite d'apprendre à se servir de serveur Mock pour tester notre application et vérifier son bon fonctionnement, et pour finir utiliser Docker afin de générer des images et des containers.
Pour pouvoir utiliser les fonctionnalités de ce repo, dénoter tout d'abord qu'un environnement de développement Java est nécéssaire pour lancer l'application. Si c'est déjà le cas il suffit de cloner ce repository pour commencer votre aventure avec le protocole SMTP. Ensuite, installer Docker et pour finir il faut utiliser un Mock serveur pour tester ce que l'on fait ( MockMock, mailtrap, etc..). Ici on utilise MockMock qui vous est fourni comme .jar dans le repository. Pour plus d'information aller sur MockMock.
Premièrement, il faudra ouvrir le repository sur votre IDE grâce au pom.xml (cela nécessitera d'avoir installer Maven préalablement). Notre repository est divisé en 2 directories différents: config et src. Le directory config a tous les fichiers liés aux propriétés de notre projet et le directory src contient tout le code de notre application.
Dans le directory config, vous trouverez 3 fichiers différents: Configuration qui est celui qui a les propriétés de notre application (adresse serveur, port, nombre de personnes par groupe, etc.), Messages qui est le contenu que vous désirez envoyer aux victimes (il faut à tout prix finir celui-ci avec MESSAGE_END pour qu'il soit envoyé sans souci afin de séparer les différents messages que vous voulez écrire). Pour finir, Victims qui contient les adresses mails des victimes de votre prank. Vous pouvez en ajouter autant que vous le désirez, alors ne vous gênez pas !
MockMock est un cross-plateforme Mock serveur écrit en java avec une interface web utilisé afin de vérifier le bon fonctionnement de l'envoi de mail mais sans être envoyé aux adresses mails fournies en réalité. Cela permet de tester dans notre cas notre client du protocole SMTP.
Commencer par ouvrir une invite de commande sur votre machine et aller sur l'emplacement où se trouve ce repo. Lorsque c'est fait taper la commande suivante sur l'invite : java -jar MockMock.jar pour le run avec les paramètres par défaut (port : 25 et webInterface : 8282), par contre si vous désirez le lancer avec les paramètres que vous désirez faites la commande suivante :java -jar MockMock.jar -p 2021 -h 8080, dans ce cas 2021 est le port et 8080 la webInterface définie dans le fichier des propriétés du repo. Si vous souhaitez changer le port, il vous suffit d'ouvrir le fichier configuration dans config et changer la variable smtpServerPort avec ce que vous désirez. Mais n'oubliez pas de faire de même lorsque vous lancer MockMock.
Maintenant on va utiliser Docker pour lancer notre serveur Mock sans avoir à effectuer à chaque fois l'étape précédente lorsque l'on veut relancer notre MockMock.
Il faut d'abord commencer par faire son propre Dockerfile comme montré dans le directory Docker, par contre vous pouvez changer les ports ou celui de la web interface à votre guise mais n'oublier pas de faire de même sur les configurations pour éviter de ne pas se connecter au bon serveur.
Normalement il faudrait lancer cette commande sur l'invite de commande mvn clean install --file "<path>\MockMock\pom.xml" et copier le jar sur le directory Docker du repo, mais ici le jar pour MockMock est déjà sur le repo.
Ensuite, en ligne de commande faire docker build -t <yourInput>/mockmock . qui va créer les images nécessaires à Docker (notez que le '.' à la fin est essentiel). Puis, lancer une dernière commande qui est docker run -d -p 8080:8080 -p 2021:2021 mockmock avec les valeurs que vous avez choisies pour le port et l'interface web.
Pour finir, ouvrez Docker et vous devriez voir MockMock qui run. On peut vérifier en allant sur http://localhost:8080/ mais remplacer le numéro de l'interface web avec celui que vous avez choisi.
Quand vous avez effectué les étapes précèdentes, il ne reste plus qu'à lancer notre application de prank. Pour cela, il faut que vous modifiez les fichiers dans le directory config. Ajoutez les addresses mails des victimes, combien de groupes vous souhaitez, etc.
Lorsque c'est fait, il vous suffit de simplement run l'application sur votre IDE et le tour est joué. Si dans la console vous avez le même affichage que montrer dans le directory figures alors c'est que tout a fonctionné correctement. Si chaque réponse du serveur commence par 250 c'est que tout est bon et s'il fini par 221 à la fin c'est que la déconnexion c'est faite normalement.
Ce package est celui qui s'occupe de lire les fichiers dans config et les traitent pour pouvoir ensuite les utiliser dans les autres classes de notre application. Il y a IConfigManager qui est l'interface et ConfigManager la classe qui définie les méthodes de l'interface.
Package qui s'occupe de créer une Person qui est décrite que par son adresse mail, qui ensuite l'affecte à un Group et qui va ensuite créer le faux mail que l'on doit envoyer aux victimes qui sont, dans notre cas, nos Person réparties par Group.
Les trois classes qui composent le package ont en grande partie que des méthodes setter ou getter.
Ce package est celui qui va générer les groupes de victimes en les séparants en deux genres (l'émetteur victime et les destinataires victimes), sélectionner un des messages écrits dans le directory Messages et informer le SmtpClient à qui et quoi envoyer par mail.
PrankGenerator s'occupe de créer les groupes de façon aléatoire et qui est l'émetteur du groupe. Si un groupe à moins de 3 personnes, il s'occupe de mettre ses membres dans un autre groupe. Il effectue ces opérations à l'aide de la classe Prank.
Prank s'occupe de créer et affecter chaque élément nécessaire au bon envoie du mail (La liste des victimes, le message à leur envoyer, etc).
C'est dans ce package que l'on retrouve notre implémentation du côté client d'un protocole SMTP. Il n'y qu'une seul méthode qui ne s'occupe que d'envoyer des mails à un serveur Mock tout en vérifiant que la communication entre le serveur et le client se fait correctement.
C'est la classe qui relie la totalité des autres classes ensemble et s'occupe donc de se connecter au serveur SMTP, de générer les mails de prank et d'envoyer le tout au Mock.
Si toutes les étapes du projet sont effectuées correctement et qu'on regarde bien ce que fait chaque chose dans le code on comprend bien comment les classes travaillent ensemble. Il est aussi facilement possible de s'informer sur comment fonctionne un serveur Mock et Docker. Finalement nous étions projeter dans ce laboratoire qui était à première vue assez vague avec peu ou pas de connaissances sur les outils qu'on allait utiliser, mais au fur est à mesure que l'on réalisait le projet, les choses se construisaient. En finalité, le projet n'aura pas été si compliqué à mettre en place nous aura permis d'acquérir de multiples connaissances très enrichissantes pour l'avenir.