UnrealIRCD

Date de publication : 25/04/2011. Date de mise à jour : 28/05/2011.

Par Olivier Locatelli
 

       Version PDF (Miroir)   Version hors-ligne (Miroir)

           

I. Préambule

I-A. Introduction

I-B. Avertissement et pré-requis

Toutes les opérations qui suivent doivent être effectuées avec un utilisateur « normal » du serveur, en aucun cas avec l'utilisateur root ou un utilisateur ayant des droits particuliers.

II. Installation

II-A. Obtenir les sources

$ wget http://www.unrealircd.com/downloads/Unreal3.2.8.1.tar.gz

II-B. Compiler les sources

$ tar xvfz Unreal3.2.8.1.tar.gz
$ cd Unreal3.2
$ ./Config
$ make

II-C. Ajout de modules

$ make custommodule MODULEFILE=module

Les modules validés par l'équipe de développement d'UnrealIRCD sont disponibles à http://www.unrealircd.com/modules.php

III. Configuration

III-A. Normes d'écriture

III-A-1. Structure

<bloc> <valeur> {
    <directive1> <valeur>;
    <directive2> <valeur> {
        <sous-directive1> <valeur>;
        <sous-directive2> <valeur>;
    };
};

Le fichier de configuration est sensible à la case (aux majuscules / minuscules) donc BLOC ou Bloc n'est pas la même chose que bloc.

III-A-2. Commentaires

• # commentaire sur une seule ligne
• // commentaire sur une seule ligne
• /* Commentaire
  multi-ligne */

III-A-3. Structure des fichiers

III-B. Fichier principal : unrealircd.conf

III-B-1. Chargement des modules

loadmodule "src/modules/commands.so";
loadmodule "src/modules/cloak.so";
loadmodule "src/modules/m_nocodes.so";
include "help.conf"

III-B-2. Définition du serveur ? M:Line

• me::name est le nom qui sera vu par les utilisateurs lorsqu'ils se connecteront sur le serveur,
• me::info est la description du serveur, à titre informatif,
• me::numeric est l'identifiant numérique du serveur sur le réseau. Il doit être unique sur le réseau et être compris entre 0 et 254

me {
   name "irc1.developpez.net";
   info "Serveur principal de l'IRC developpez.net";
   numeric 1;
};

III-B-3. Définition de l'administrateur ? A:Line

admin {
   "Olivier Locatelli";
   "olocatelli@monadresse.net";
};

III-B-4. Définition des classes ? Y:Line

Les noms des blocs sont très importants, car ils servent de référence dans d'autres blocs.

• pingfreq est la fréquence en secondes à laquelle votre serveur va envoyer des requêtes PING sur la connexion, une bonne valeur se situe entre 90 et 180,
• maxclients est le nombre maximal de connexions simultanées de ce type acceptées par le serveur,
• sendq est la taille du tampon d'envoi du serveur, il vaut mieux une valeur élevée pour la classe des connexions serveur, et une plus faible pour celle des clients. Pour ma part, je choisis un ratio de 10,
• recvq est la taille du tampon de réception, elle permet de contrôler le flood. Cette directive n'est à utiliser que pour les classes « client » et une bonne valeur se situe entre 3000 et 8000 (valeur par défaut),
• connfreq est utilisé uniquement pour les classes « serveur » et sert à définir la fréquence de tentative de connexion à un serveur du réseau lorsque celui-ci est déclaré en autoconnect.

class clients {
   pingfreq 90;
   maxclients 200;
   sendq 10000;
   recvq 8000;
};
class servers {
   pingfreq 90;
   maxclients 10;
   sendq 100000;
   connfreq 60;
};

III-B-5. Définition des autorisations ? I:Lines

• ip : le masque IP de la connexion (jokers autorisé) sous la forme utilisateur@IP,
• host : le masque de l'hôte de la connexion (jokers autorisés) sous la forme utilisateur@hote,
• password : un mot de passe de connexion (optionnel),
• class : la classe de connexion à qui s'applique la règle,
• maxperip : le nombre de connexions simultanées autorisées depuis l'adresse IP (optionnel mais recommandé),
• ipv6-clone-mask : la sensibilité aux clones lors de l'utilisation d'une adresse IPv6. La valeur par défaut est 64, ce qui signifie que deux clients dont l'adresse IPv6 ne diffèrent que par leurs derniers bits sont considérés comme des clones. Si cette valeur est passée à 128 (maximum), chaque adresse IPv6 est considérée unique. Ce réglage est optionnel,
• redirect-server : si le serveur a atteint sa capacité maximale pour la classe (clients::maxclients par exemple), cette instruction force les clients compatibles à se connecter sur le serveur de redirection (optionnel),
• redirect-port : si un serveur de redirection est défini, il est possible de définir le port de ce serveur ici. Par défaut, il s'agit du port 6667 (optionnel),
• : il est possible de mettre 4 options à un bloc d'autorisation: useip : utilise l'adresse de la connexion plutôt que l'hôte littéral, noident : ne fait pas de requête « ident » mais utilise le « username » fourni par le client, ssl : seules les connexions SSL sont autorisées, nopasscont : continue les vérifications si le mot de passe n'est pas concordant. Ceci est utile lorsque vous avez plusieurs classes utilisant des connexions avec mot de passe, la connexion n'est pas interdite tant que toutes les vérifications n'ont pas échoué.

// Premier bloc : 3 connexions autorisées pour chaque IP par défaut
allow {
   ip *;
   host *;
   class clients;
   maxperip 3;
};
// Deuxième bloc : 10 connexions autorisées pour la plage 192.168.0.*
// indépendamment de leur hôte, uniquement en SSL
allow {
   ip 192.168.0.*;
   hostname NONAME;
   class clients;
   maxperip 10;
   options {
      useip;
      ssl;
};

Notez que les directives ip et host fonctionnent avec un « OU ». Si vous voulez restreindre à une IP (ou une plage d'IPs), il vous faut mettre une valeur host qui ne sera jamais valide, et inversement pour forcer sur un host.

III-B-6. Ports d'écoute ? P:Line

• clientsonly : seules les connexions définies de type « client » peuvent utiliser cette IP et ce port,
• serversonly : seules les connexions définies de type « server » peuvent utiliser cette IP et ce port,
• ssl : ce port est réservé aux connexions SSL,
• java : ce port est compatible avec les applets Java.

listen 127.0.0.1:7000 {
   options {
      serversonly;
   };
};
listen 192.168.0.*:6660 {
   options {
      clientsonly;
      ssl;
   };
};
listen *:6665-6670;

• depuis le serveur lui-même, d'autres serveurs (services, serveurs de statistiques, ?) peuvent se connecter sur le port 7000, et seulement des serveurs,
• depuis le réseau local, des clients utilisant une connexion SSL peuvent se connecter sur le port 6660,
• n'importe qui, client ou serveur, peut se connecter sur les ports 6665 à 6670.