Skip to content

Application de boîte à outils pédagogique réseaux, conçue et développée pour le projet de Saé5.01.

Notifications You must be signed in to change notification settings

HighMax524/NetCraft

 
 

Repository files navigation


Logo

NetCraft

Application de boîte à outils pédagogique réseaux, conçue et développée pour le projet de Saé5.01.
Explorer la documentation »

TS HTML CSS JS PYTHON MYSQL DOCKER GITHUB TAILWIND DAISYUI

Sommaire
  1. Introduction
  2. Déploiement
  3. Utilisation
  4. Contributeurs

Introduction

NetCraft est une application éducative qui met a disposition une boite a outils pour s'aider dans la compréhension de la communication réseaux.

Netcraft regroupe plusieurs fonctionnalités principales. En voici une liste non exhaustive :

  • Système d'utilisateurs basique.
  • Gestion des utilisateurs par un administrateur.
  • Page de construction d'une trame ethernet.
  • Conversion d'ipv4 en binaire et/ou hexadécimal.
  • Séparation des classes de sous-réseaux.
  • ...

(Retourner au début)

Déploiement

Pour déployer le projet sur un serveur, voici les étapes a suivre :

  1. Avoir une distribution Debian sur un serveur qui a un accès a internet.
  2. Installer Docker :
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update

Puis :

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Extraire l'archive .tar.gz
mkdir NetCraft && tar -xzvf ./NetCraft.tar.gz -C ./NetCraft && cd NetCraft
  1. Créer un fichier .env a la racine du projet qui contiendra les configurations sécurisées (exemple : le mot de passe de la base de donnée)
MYSQL_DATABASE=db 
MYSQL_USER=user 
MYSQL_PASSWORD=userpassword 
MYSQL_ROOT_PASSWORD=rootpassword 
SECRETKEY='alea@!ppii'

Voici une commande qui permet de le faire automatiquement sur debian :

printf \
	"MYSQL_DATABASE=db \n\
	MYSQL_USER=user \n\
	MYSQL_PASSWORD=userpassword \n\
	MYSQL_ROOT_PASSWORD=rootpassword \n\
  SECRETKEY='alea@!ppii'" \
	> .env
  1. Lancer la construction et le lancement de l'image Docker
sudo docker compose up -d --build
  1. NetCraft est maintenant disponible depuis : http://<ip du serveur>/

Avertissement ! Si des erreurs lors de la connexion de l'utilisateur surviennents, il se peux que la base de donnée soit encore en cours de construction, attendez quelques secondes, parfois une minute est nécessaire !

Utilisation

Étudiant

  1. Inscription :

    • Accédez à la page d'inscription.
    • Remplissez le formulaire avec vos informations (adresse mail, Nom d'utilisateur, mot de passe).

    Avertissement : Le mot de passe doit contenir au minimum 6 charactères.

    • Cliquez sur le bouton "S'inscrire" pour créer votre compte.
    • Une fois inscrit, vous serez redirigé vers la page de connexion.
  2. Connexion :

    • Entrez votre nom d'utilisateur et votre mot de passe.
    • Cliquez sur "Se connecter" pour accéder à votre tableau de bord.
  3. Gestion de compte et accès aux modules :

    • Accédez à votre profil pour modifier votre mot de passe via le bouton en haut à droite de votre page.
    • Cliquez sur "Enregistrer" pour sauvegarder les modifications.
    • Pour accéder aux cours, rendez vous sur la page home. Les différents modules sont accessibles.

Admin

  1. Connexion :

    • Utilisez les identifiants par défaut pour vous connecter :
      • Nom d'utilisateur : admin
      • Mot de passe : back2root$
  2. Gestion des utilisateurs :

    • Rendez vous dans votre pannel de gestion utilisateur via le bouton en haut à droite de votre écran
    • Visualisez la liste des étudiants inscrits.
    • Sélectionnez un ou plusieurs comptes à supprimer.
    • Cliquez sur "Supprimer" pour effectuer l'action.

Outils

Tout les outils sont bien documentés et leurs utilisation est intuitive. Voici un aperçu.

Aperçu de la page de connexion

---

Contributeurs

NoXeDev
NoXeDev
EwenDev
EwenDev
ComeRegnier
ComeRegnier
HighMax524
HighMax524
ldv500
ldv500
BluenessDev
BluenessDev

About

Application de boîte à outils pédagogique réseaux, conçue et développée pour le projet de Saé5.01.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 69.1%
  • JavaScript 18.3%
  • TypeScript 11.1%
  • Python 1.1%
  • Dockerfile 0.4%