Script CSV User FreeRADIUS

Description

Solution d'automatisation pour l'importation massive d'utilisateurs dans FreeRADIUS à partir d'un fichier CSV. Les mots de passe sont automatiquement chiffrés en MD5 et intégrés dans la configuration FreeRADIUS.

Prérequis

FreeRADIUS 3.0 ou supérieur
Accès root au serveur
Shell Bash

Installation

Étape 1 : Créer le répertoire de scripts

sudo mkdir -p /etc/script
cd /etc/script

Étape 2 : Créer le script principal d'importation

sudo nano /etc/script/csvuser.sh

Copier le contenu suivant dans le fichier puis sauvegarder (Ctrl+O, Entrée, Ctrl+X) :

#!/bin/bash

# Script pour importer des utilisateurs depuis un CSV vers FreeRADIUS
# Format du CSV: username,password (une ligne par utilisateur)

CSV_FILE="$1"
SYNC_MODE="$2"
FREERADIUS_USERS="/etc/freeradius/3.0/users"

# Vérification que le fichier CSV est fourni
if [ -z "$CSV_FILE" ]; then
    echo "Usage: $0 <fichier.csv> [--sync]"
    echo "Format du CSV: username,password"
    echo ""
    echo "Options:"
    echo "  --sync : Supprime les utilisateurs qui ne sont plus dans le CSV"
    exit 1
fi

# Vérification que le fichier CSV existe
if [ ! -f "$CSV_FILE" ]; then
    echo "Erreur: Le fichier $CSV_FILE n'existe pas"
    exit 1
fi

# Vérification des permissions root
if [ "$EUID" -ne 0 ]; then
    echo "Erreur: Ce script doit être exécuté en tant que root"
    exit 1
fi

# Compteur d'utilisateurs
ADDED=0
SKIPPED=0
DELETED=0
TOTAL=0

echo "=== Traitement du fichier CSV ==="
echo ""
echo "Fichier: $CSV_FILE"
if [ "$SYNC_MODE" = "--sync" ]; then
    echo "Mode: SYNCHRONISATION (suppression des utilisateurs absents du CSV)"
else
    echo "Mode: AJOUT UNIQUEMENT (utilisez --sync pour supprimer les absents)"
fi
echo ""

# Créer un fichier temporaire avec la liste des utilisateurs du CSV
TEMP_CSV_USERS=$(mktemp)
while IFS=',' read -r username password || [ -n "$username" ]; do
    [ -z "$username" ] && continue
    username="${username#"${username%%[![:space:]]*}"}"
    username="${username%"${username##*[![:space:]]}"}"
    echo "$username" >> "$TEMP_CSV_USERS"
done < "$CSV_FILE"

# Mode synchronisation : supprimer les utilisateurs qui ne sont plus dans le CSV
if [ "$SYNC_MODE" = "--sync" ]; then
    echo "=== Vérification des utilisateurs à supprimer ==="

    # Créer un fichier temporaire pour les utilisateurs à supprimer
    TEMP_TO_DELETE=$(mktemp)

    # Extraire tous les utilisateurs du fichier FreeRADIUS (ceux avec MD5-Password ou Cleartext-Password)
    grep -E "^[a-zA-Z0-9_.-]+ (MD5-Password|Cleartext-Password) :=" "$FREERADIUS_USERS" | awk '{print $1}' > "$TEMP_TO_DELETE.all"

    # Vérifier chaque utilisateur existant
    if [ -f "$TEMP_TO_DELETE.all" ] && [ -s "$TEMP_TO_DELETE.all" ]; then
        while read existing_user; do
            # Vérifier si l'utilisateur existe dans le CSV
            if ! grep -Fxq "${existing_user}" "$TEMP_CSV_USERS"; then
                echo "$existing_user" >> "$TEMP_TO_DELETE"
            fi
        done < "$TEMP_TO_DELETE.all"
    fi

    # Supprimer les utilisateurs identifiés
    if [ -f "$TEMP_TO_DELETE" ] && [ -s "$TEMP_TO_DELETE" ]; then
        while read user_to_delete; do
            echo "Suppression: $user_to_delete (absent du CSV)"

            # Échapper les caractères spéciaux pour sed
            escaped_user=$(printf '%s\n' "$user_to_delete" | sed 's/[[\.*^$/]/\\&/g')
            
            # Supprimer l'utilisateur et la ligne vide qui suit
            sed -i "/^${escaped_user} MD5-Password :=/d; /^${escaped_user} Cleartext-Password :=/d" "$FREERADIUS_USERS"

            DELETED=$((DELETED + 1))
        done < "$TEMP_TO_DELETE"
    else
        echo "Aucun utilisateur à supprimer"
    fi

    # Nettoyer les fichiers temporaires
    rm -f "$TEMP_TO_DELETE" "$TEMP_TO_DELETE.all"

    echo ""
fi

# Nettoyer le fichier temporaire
rm -f "$TEMP_CSV_USERS"

# Lecture du CSV et traitement ligne par ligne
while IFS=',' read -r username password || [ -n "$username" ]; do
    # Ignorer les lignes vides
    [ -z "$username" ] && continue

    TOTAL=$((TOTAL + 1))

    # Supprimer les espaces en début et fin
    username="${username#"${username%%[![:space:]]*}"}"
    username="${username%"${username##*[![:space:]]}"}"

    password="${password#"${password%%[![:space:]]*}"}"
    password="${password%"${password##*[![:space:]]}"}"

    echo "[$TOTAL] Traitement: $username"

    # Vérifier si l'utilisateur existe déjà
    if grep -q "^$username " "$FREERADIUS_USERS"; then
        echo "Utilisateur déjà existant - ignoré"
        SKIPPED=$((SKIPPED + 1))
        echo ""
        continue
    fi

    echo "  → Génération du hash MD5..."
    # Générer le hash MD5 (format identique à echo -n "password" | md5sum)
    md5_hash=$(echo -n "$password" | md5sum | cut -d' ' -f1)
    echo "  → Hash: $md5_hash"

    echo "  → Ajout au fichier FreeRADIUS..."
    # Ajouter l'utilisateur au fichier FreeRADIUS (format simple sans classe)
    cat >> "$FREERADIUS_USERS" << EOF

$username MD5-Password := "$md5_hash"
EOF

    echo "  ✓ Utilisateur ajouté avec succès"
    ADDED=$((ADDED + 1))
    echo ""

done < "$CSV_FILE"

echo "=== Résumé ==="
echo "Total traité:             $TOTAL utilisateur(s)"
echo "Ajoutés:                  $ADDED utilisateur(s)"
echo "Ignorés (déjà existants): $SKIPPED utilisateur(s)"
if [ "$SYNC_MODE" = "--sync" ]; then
    echo "Supprimés:                $DELETED utilisateur(s)"
fi
echo ""
echo "=== Prochaine étape ==="
echo "Redémarrez FreeRADIUS pour appliquer les changements:"
echo "  systemctl restart freeradius"

Rendre le script exécutable :

sudo chmod +x /etc/script/csvuser.sh

Étape 3 : Créer le fichier CSV des utilisateurs

sudo nano /etc/script/login_mdp_internet.csv

Format requis (username,password) :

user1,password123
user2,password456
user3,password789

Sauvegarder le fichier (Ctrl+O, Entrée, Ctrl+X).

Étape 4 : Créer le script de synchronisation automatique

sudo nano /etc/script/sync_radius.sh

Copier le contenu suivant dans le fichier puis sauvegarder (Ctrl+O, Entrée, Ctrl+X) :

  GNU nano 7.2                                                                                                                                                                     script/reload_csv_user.sh
#!/bin/bash

systemctl stop freeradius.service
echo "╔════════════════════════════════════════╗"
echo "║      Le service Radius est Stoppé      ║"
echo "╚════════════════════════════════════════╝"
echo ""

# Compteur avant synchronisation
for i in 5 4 3 2 1; do
    echo -ne "Démarrage de la synchronisation du CSV dans : $i seconde(s)...\r"
    sleep 1
done

echo ""
echo ""

# synchronisation du csv
cd /etc/script
./csvuser.sh login_mdp_internet.csv --sync

echo ""

# suppression des lignes vides du fichier users
cd /etc/script
./cleanlines.sh /etc/freeradius/3.0/users

# Compteur avant redémarrage
echo ""
for i in 5 4 3 2 1; do
    echo -ne "Redémarrage du service dans : $i seconde(s)...\r"
    sleep 1
done

systemctl restart freeradius.service
systemctl status freeradius.service

Rendre le script exécutable :

sudo chmod +x /etc/script/sync_radius.sh

Étape 5 : Créer le script qui permet de supprimer les lignes vides du fichier users

sudo nano /etc/script/cleanlines.sh

Copier le contenu suivant dans le fichier puis sauvegarder (Ctrl+O, Entrée, Ctrl+X) :

#!/bin/bash

# Vérifie qu'un fichier est fourni
if [ -z "$1" ]; then
    echo "Usage: $0 fichier.txt"
    exit 1
fi

FILE="$1"

# Supprime les lignes vides (ou contenant seulement des espaces)
sed -i '/^[[:space:]]*$/d' "$FILE"

echo "Lignes vides supprimées dans : $FILE"

Rendre le script exécutable :

sudo chmod +x /etc/script/cleanlines.sh

Avertissement critique

ATTENTION : Le service FreeRADIUS DOIT être arrêté avant toute modification du fichier users.

L'ajout d'utilisateurs pendant que le service est actif peut entraîner :

Corruption du fichier de configuration
Perte de données utilisateurs
Défaillance du service d'authentification
Incohérences dans la base d'utilisateurs
Nécessité de restauration depuis une sauvegarde

Toujours arrêter le service avant d'exécuter le script d'import.

Utilisation

Méthode 1 : Synchronisation automatique (recommandée)

Cette méthode gère automatiquement l'arrêt et le redémarrage du service :

sudo /etc/script/sync_radius.sh

Déroulement automatique :

Arrêt du service FreeRADIUS
Pause de 5 secondes (compte à rebours visible)
Synchronisation des utilisateurs depuis le CSV
Pause de 5 secondes avant redémarrage
Redémarrage du service FreeRADIUS
Affichage du statut final

Méthode 2 : Exécution manuelle

Mode ajout simple (sans --sync)

Ce mode ajoute uniquement les nouveaux utilisateurs présents dans le CSV.

Comportement :

Les utilisateurs déjà existants dans FreeRADIUS sont ignorés
Les utilisateurs absents du CSV mais présents dans FreeRADIUS sont conservés
Aucune suppression n'est effectuée

sudo systemctl stop freeradius.service
sudo /etc/script/csvuser.sh /etc/script/login_mdp_internet.csv
sudo systemctl start freeradius.service

Exemple de résultat :

=== Résumé ===
Total traité:             15 utilisateur(s)
Ajoutés:                  10 utilisateur(s)
Ignorés (déjà existants): 5 utilisateur(s)

Mode synchronisation (avec --sync)

Ce mode synchronise complètement la base utilisateurs avec le contenu du CSV.

Comportement :

Les nouveaux utilisateurs du CSV sont ajoutés
Les utilisateurs déjà existants sont conservés
Les utilisateurs absents du CSV mais présents dans FreeRADIUS sont SUPPRIMÉS

ATTENTION : Cette opération est irréversible. Les utilisateurs supprimés ne peuvent être récupérés que depuis une sauvegarde.

sudo systemctl stop freeradius.service
sudo /etc/script/csvuser.sh /etc/script/login_mdp_internet.csv --sync
sudo systemctl start freeradius.service

Exemple de résultat :

=== Vérification des utilisateurs à supprimer ===
Suppression: old_user1 (absent du CSV)
Suppression: old_user2 (absent du CSV)

=== Résumé ===
Total traité:             15 utilisateur(s)
Ajoutés:                  3 utilisateur(s)
Ignorés (déjà existants): 12 utilisateur(s)
Supprimés:                2 utilisateur(s)

Différences entre les modes

Caractéristique	Sans --sync	Avec --sync
Ajout de nouveaux utilisateurs	Oui	Oui
Conservation des existants	Oui	Oui
Suppression des absents du CSV	Non	Oui
Utilisation recommandée	Ajouts ponctuels	Synchronisation complète
Risque de perte de données	Aucun	Élevé si CSV incomplet

Sécurité

Protection du fichier CSV

IMPORTANT : Le fichier CSV contient des identifiants sensibles en clair.

Option recommandée : Suppression après utilisation

Pour une sécurité maximale, supprimez le fichier CSV une fois les comptes créés :

sudo rm /etc/script/login_mdp_internet.csv

Alternative : Restriction d'accès stricte

Si vous devez conserver le fichier, appliquez des permissions restrictives :

# Accès en lecture/écriture pour root uniquement
sudo chmod 600 /etc/script/login_mdp_internet.csv
sudo chown root:root /etc/script/login_mdp_internet.csv

Sauvegarde avant synchronisation

Avant toute synchronisation en mode --sync, effectuez une sauvegarde :

sudo cp /etc/freeradius/3.0/users /etc/freeradius/3.0/users.backup.$(date +%Y%m%d_%H%M%S)

Chiffrement MD5

Les mots de passe sont automatiquement chiffrés en MD5 avant insertion :

Format stocké : username MD5-Password := "5f4dcc3b5aa765d61d8327deb882cf99"

Vérification et dépannage

Vérifier le statut du service

sudo systemctl status freeradius.service

Consulter les logs

sudo tail -f /var/log/freeradius/radius.log

Tester l'authentification d'un utilisateur

sudo radtest username password localhost 0 testing123

En cas de problème

Arrêter le service : sudo systemctl stop freeradius.service
Vérifier la syntaxe du fichier users : sudo freeradius -X
Restaurer depuis la sauvegarde si nécessaire
Redémarrer : sudo systemctl start freeradius.service

Structure des fichiers

/etc/script/
├── csvuser.sh                    # Script d'import CSV
├── sync_radius.sh                # Script de synchronisation automatique
└── login_mdp_internet.csv        # Base utilisateurs

/etc/freeradius/3.0/
└── users                         # Fichier de configuration modifié

Bonnes pratiques

Toujours arrêter le service avant modification
Effectuer des sauvegardes régulières du fichier users
Tester sur un environnement de développement avant production
Utiliser le mode --sync uniquement quand nécessaire
Vérifier le fichier CSV avant exécution
Consulter les logs après chaque modification
Maintenir un historique des sauvegardes

Configuration pfSense pour l'authentification RADIUS

Une fois FreeRADIUS configuré avec vos utilisateurs, vous pouvez intégrer l'authentification RADIUS dans pfSense.

Étape 1 : Ajouter le serveur RADIUS dans pfSense

Connectez-vous à l'interface web de pfSense et accédez au menu :

System > User Manager > Authentication Servers

Cliquez sur le bouton Add pour ajouter un nouveau serveur d'authentification.

Étape 2 : Configuration du serveur RADIUS

Dans la zone Server Settings, effectuez la configuration suivante :

Descriptive name: RADIUS
Type: RADIUS

Dans la zone RADIUS Server Settings, effectuez la configuration suivante :

Protocol: PAP
Hostname or IP address: [Adresse IP de votre serveur FreeRADIUS]
Shared Secret: [Le secret partagé configuré dans clients.conf]
Services offered: Authentication and Accounting
Authentication port: 1812
Accounting port: 1813
Authentication Timeout: 5

Important : Remplacez l'adresse IP par celle de votre serveur FreeRADIUS et le secret partagé par celui que vous avez défini dans /etc/freeradius/3.0/clients.conf.

Cliquez sur Save pour enregistrer la configuration.

Étape 3 : Tester l'authentification RADIUS

Accédez au menu Diagnostics > Authentication.

Sélectionnez le serveur d'authentification RADIUS, entrez un nom d'utilisateur et son mot de passe configurés dans FreeRADIUS, puis cliquez sur Test.

Si le test réussit, vous devriez voir ce message :

User user authenticated successfully. This user is a member of groups:

Points de vérification

En cas de problème de connexion, vérifiez :

Le service FreeRADIUS est démarré : systemctl status freeradius.service
L'adresse IP dans clients.conf correspond à l'IP de pfSense
Le secret partagé est identique dans clients.conf et dans pfSense
Le nom du groupe dans pfSense correspond exactement à la valeur Class dans users
Les logs FreeRADIUS : tail -f /var/log/freeradius/radius.log
Le port 1812 est accessible depuis pfSense vers le serveur FreeRADIUS

Licence

Cette documentation est sous licence Creative Commons Attribution 4.0 International (CC BY 4.0).

Vous êtes libre de :

Partager — copier, distribuer et communiquer le matériel
Adapter — remixer, transformer et créer à partir du matériel pour toute utilisation, y compris commerciale

Selon les conditions suivantes :

Attribution — Vous devez créditer l'œuvre, intégrer un lien vers la licence et indiquer si des modifications ont été effectuées.

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
README.md		README.md

Mayse-55/Script-CSV-User-Freeradius

Folders and files

Latest commit

History

Repository files navigation

Script CSV User FreeRADIUS

Description

Prérequis

Installation

Étape 1 : Créer le répertoire de scripts

Étape 2 : Créer le script principal d'importation

Étape 3 : Créer le fichier CSV des utilisateurs

Étape 4 : Créer le script de synchronisation automatique

Étape 5 : Créer le script qui permet de supprimer les lignes vides du fichier users

Avertissement critique

Utilisation

Méthode 1 : Synchronisation automatique (recommandée)

Méthode 2 : Exécution manuelle

Mode ajout simple (sans --sync)

Mode synchronisation (avec --sync)

Différences entre les modes

Sécurité

Protection du fichier CSV

Option recommandée : Suppression après utilisation

Alternative : Restriction d'accès stricte

Sauvegarde avant synchronisation

Chiffrement MD5

Vérification et dépannage

Vérifier le statut du service

Consulter les logs

Tester l'authentification d'un utilisateur

En cas de problème

Structure des fichiers

Bonnes pratiques

Configuration pfSense pour l'authentification RADIUS

Étape 1 : Ajouter le serveur RADIUS dans pfSense

Étape 2 : Configuration du serveur RADIUS

Étape 3 : Tester l'authentification RADIUS

Points de vérification

Licence

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Packages