English | German | Hungarian | French | Russian | Turkish | Spanish
UnrealIRCd
http://www.unrealircd.com
Version: 3.2.10.1
Dernière mise à jour de la documentation: 2013-04-05
Développeur principal: Syzop
Développeurs: binki
Anciens développeurs et contributeurs: Stskeeps, codemastr, Luke, aquanight, WolfSage, McSkaf, Zogg, NiQuiL, assyrian, chasm, DrBin, llthangel, Griever, nighthawk
Documentation: CKnight^ (documentation initiale), Syzop (réécritures majeures), codemastr et beaucoup de contributeurs
Traduction française: Alef Burzmali - www.burzmali.com
Précédent traducteur: babass - irc.rs2i.net

Pour lire ce document vous devez avoir un navigateur compatible. Les mises à jour de ce document sont disponibles ici : http://www.vulnscan.org/UnrealIRCd/unreal32docs.fr.html ainsi que la FAQ http://www.vulnscan.org/UnrealIRCd/faq/.

INDEX / TABLE DES MATIERES
1. Introduction & Notes
---1.1. Notes sur la mise à jour et le mélange des versions 3.1.x -> 3.2
---1.2. Notes sur la mise à jour entre versions 3.2
2. Installation
3. Fonctionnalités
-- 3.1. Cloaking
-- 3.2. Modules
-- 3.3. Snomasks
-- 3.4. Alias
-- 3.5. Helpop
-- 3.6. Niveau d'accès des opérateurs
-- 3.7. Commandes opérateurs
-- 3.8. SSL
-- 3.9. IPv6
-- 3.10. Zip links
-- 3.11. Support des links avec DNS/IP dynamiques
-- 3.12. Fonctionnalités anti-flood
-- 3.13. Types de ban
-- 3.14. Spamfilter
-- 3.15. CIDR
-- 3.16. Caractères admis dans les pseudos
-- 3.17. Support de CGI:IRC
-- 3.18. Synchronisation de l'heure
-- 3.19. Types d'Authentification
-- 3.20. Autres fonctionnalités
4. Configurer votre fichier unrealircd.conf
---4.1. Explication du fichier de configuration
---4.2. Me Block -=- (M:Line)
---4.3. Admin Block -=- (A:Line)
---4.4. Class Block -=- (Y:Line)
---4.5. Allow Block -=- (I:Line)
---4.6. Listen Block -=- (P:Line)
---4.7. Oper Block -=- (O:Line)
---4.8. DRpass Block -=-(X:Line)
---4.9. Directive Include
---4.10. Directive Loadmodule
---4.11. Log Block
---4.12. TLD Block -=- (T:Line)
---4.13. Ban Nick Block -=- (Q:Line)
---4.14. Ban User Block -=- (K:Line)
---4.15. Ban IP Block -=- (Z:Line)
---4.16. Ban Server Block -=-(q:Line)
---4.17. Ban Realname Block -=- (n:Line)
---4.18. Ban Version Block
---4.19. Ban Exception Block -=- (E:Line)
---4.20. TKL Exception Block
---4.21. Throttle Exception Block
---4.22. Deny DCC Block -=- (dccdeny.conf)
---4.23. Deny Version Block -=- (V:Line)
---4.24. Deny Link Block -=- (D:Line / d:Line)
---4.25. Deny Channel Block -=- (chrestrict.conf)
---4.26. Allow Channel Block
---4.27. Allow DCC Block
---4.28. Vhost Block -=- (vhost.conf)
---4.29. Badword Block -=- (badwords.conf)
---4.30. Uline Block -=- (U:Line)
---4.31. Link Block -=- (C/N/H:Lines)
---4.32. Alias Block
---4.33. Help Block
---4.34. Official Channels Block
---4.35. Spamfilter Block
---4.36. Cgiirc Block
---4.37. Set Block
---4.38. Files Block
5. Fichiers additionnels
6. Modes utilisateurs & salons
7. Commandes utilisateurs & opérateurs
8. Conseils de sécurité/checklist
---8.1. Mots de passe
---8.2. Vulnérabilités non liées à l'Ircd
---8.3. Permissions et fichier de configuration
---8.4. Problèmes liés aux utilisateurs
---8.5. SSL/SSH & sniffing
---8.6. Denial of Service attacks (DoS) (ou: comment protéger mon hub)
---8.7. Conseils sur la divulgation d'informations
---8.8. Protection contre les exploits
---8.9. Conclusion
9. Foire au questions (FAQ)
10. Modules
---10.1. m_nopost
A. Expressions Régulières
---A.1. Litéraux
---A.2. L'opérateur Point
---A.3. Les opérateurs de répétition
---A.4. Les expressions avec crochets
---A.5. Assertions
---A.6. Alternatives
---A.7. Sousexpressions
---A.8. Références arrières (back references)
---A.9. Sensibilité à la case

1.0 – Introduction & Notes

Ce document a été écrit exclusivement pour l'utilisation d'UnrealIRCd. Utiliser ce document avec un autre logiciel, ou le distribuer avec un autre logiciel est strictement interdit sans la permission écrite de l'équipe de développement d'UnrealIRCd. Ce document peut être copié/imprimé/reproduit/publié autant de fois que vous le souhaitez, à condition que ce soit pour l'utilisation d'UnrealIRCd et qu'il ne soit jamais modifié d'une quelconque manière. – Copyright UnrealIRCd Development Team 2002-2006

Lisez ce manuel avant de demander de l'aide, vous devez aussi lire attentivement la FAQ qui répond à plus de 80% des questions/problèmes. Si vous avez encore besoin d'aide vous pouvez demander du support sur irc.unrealircd.org (port 6667) channel #unreal-support (notez que nous requerrons de votre part une parfaite connaissance de ce document et de la FAQ et que nous donnons uniquement de l'aide sur UnrealIRCD, pas sur les services !). Vous pouvez aussi utiliser le forum : http://forums.unrealircd.com. Si vous avez un réel bug (comme un crash) alors reportez le ici http://bugs.unrealircd.org.

1.1 – Notes sur la mise à jour et le mélange des versions 3.1.x -> 3.2

Au cas où vous souhaiteriez mettre à jour Unreal3.1.x vers Unreal3.2 vous noterez que l'ensemble des fichiers de configuration a changé, vous pourriez trouver cela difficile au début, mais une fois que vous aurez changé vous trouverez cela beaucoup mieux !

N'oubliez pas de lire la section 3 à propos des fonctionnalités, bien que vous connaissiez déjà la plupart d'entre elles car elles sont issues des 3.1.x, il y en a tout de même de nouvelles !

Le mieux est de ne pas utiliser une 3.1.x avec une 3.2, mais si vous souhaitez réellement le faire, vous aurez besoin d'une version 3.1.4 minimum, mais une 3.1.5 est fortement conseillée.

1.2 – Notes sur la mise à jour entre versions 3.2

Nous vous recommandons de procéder de la manière suivante pour mettre à jour :

- Linux :
  1. Renommez votre ancien dossier UnrealIRCd (sinon vous écraserez son contenu dans la prochaine étape)
  2. Extraire la nouvelle version d'UnrealIRCd et exécutez ./Config puis make
  3. Copiez vos anciens fichiers de configuration vers le nouveau répertoire (unrealircd.conf, motd, rules, server.* [SSL certs], network file, etc)
- Windows :
  1. Copiez tous vos fichiers de configuration temporairement vers un autre dossier.
  2. Lancez le désinstalleur pour toutes les précédentes versions d'Unreal que vous avez installées.
  3. Lancez l'installeur pour la nouvelle version d'Unreal.
  4. Copiez vos anciens fichiers de configuration vers le nouveau dossier.

Veuillez vérifier les RELEASE NOTES pour voir ce qui a changé. Si vous notez des changements (ou bug) entre les versions, VOUS DEVEZ ÊTRE SÛR D'AVOIR LU LES RELEASE NOTES EN PREMIER avant de reporter cela comme un bug.

2.0 - Installation

Systèmes d'exploitation testés et supportés:

- Version *NIX:
  - Linux (2.2.*, 2.4.*, 2.6.*)
  - FreeBSD (4.*, 5.*, 6.*)
  - NetBSD (2.*)
  - OpenBSD (3.7, 3.8, 3.9)
  - Solaris (9, 10)
- Version Windows:
  - Windows XP (Home, Pro)
  - Windows 2003
  - Windows 7
- Architectures testées:
  - ia32 (i386, i486, i586, i686)
  - ia64
  - amd64
  - alpha

Si vous avez Unreal3.2 et qu'il fonctionne correctement sous un autre système d'exploitation, envoyer les détails ici : coders@lists.unrealircd.org

Instructions d'installation :

- Linux :
  1. gunzip -d Unreal3.2.X.tar.gz
  2. tar xvf Unreal3.2.X.tar
  3. cd Unreal3.2
  4. ./Config
  5. Répondez aux questions avec le meilleur de vos connaissances. Généralement, si vous n'êtes pas sûr, les paramètres par défaut devraient fonctionner !
  6. make
  7. Maintenant créez votre unrealircd.conf ainsi que les autres fichiers de configuration, regardez la section 4.
- Windows :
  1. Lancez l'installateur d'Unreal
  2. Maintenant créez votre unrealircd.conf ainsi que les autres fichiers de configuration, regardez la section 4.

3.0 - Fonctionnalités

La plupart des fonctionnalités importantes ou utiles sont expliquées dans cette section. Elle fourni une vue d'ensemble, et fait parfois référence aux fichiers de configuration (quelque chose que vous n'êtes pas sensés connaitre actuellement).

Vous pouvez sauter cette section, toutefois il est suggéré de la lire avant ou après l'installation car sinon vous ne comprendrez pas certains concepts tels que le 'cloaking', les 'snomasks', etc.

3.1 - Cloaking

Le Cloaking (camouflage) vous permet de cacher le véritable host (domaine) des utilisateurs, par exemple si votre host réel est d5142341.cable.wanadoo.fr, il sera affiché (lors des join, part, whois, etc) ainsi : rox-2DCA3201.cable.wanadoo.fr. Cette fonctionnalité est utile pour empêcher les floods entre utilisateurs depuis qu'ils ne peuvent plus voir l'host ou l'IP réel.

Ceci est contrôlé par le usermode +x (comme : /mode votrepseudo +x), les administrateurs peuvent forcer le mode +x par défaut, voire interdire aux utilisateurs de l'enlever.

Un host camouflé est généré par un module de cloaking (il est obligatoire d'en avoir un chargé), il y en a un seul officiel à ce jour :
cloak : C'est le module officiel de cloaking depuis la version 3.2.1, il est plus sécurisé que l'ancien algorithme, il utilise la méthode de hachage md5 et requière trois clés set::cloak-keys:: composées de caractères alphanumériques (a-z, A-Z et 0-9) [ex: CZCBd45Q6DmtExAd8Bm2"]. Regardez example.fr.conf pour un exemple.

Ces clés DOIVENT être les mêmes sur TOUS LES SERVEURS d'un réseau. Elles doivent être gardées SECRÈTES car il est possible de déchiffrer l'host original si vous connaissez ces clés (ce qui rendrait le umode +x inutile).

Astuce: Si vous utilisez un système *UNIX et devez créer de nouvelles clés de cloaking, vous pouvez exécuter './unreal gencloak' dans votre shell, ce qui affichera trois chaînes aléatoires que vous pourrez utiliser.

3.2 - Modules

UnrealIRCd supporte des modules, ce qui est très pratique car :
- Vous pouvez les charger/décharger pendant que l'ircd est lancé (avec /rehash). Cela vous permet de corriger certains bugs ou d'ajouter de nouvelles fonctionnalités sans être obligé de redémarrer !
- D'autres personnes peuvent créer des modules tiers avec de nouvelles commandes, modes utilisateurs et même des modes channels.

UnrealIRCd est fourni avec seulement quelques modules. Regarder ici www.unrealircd.com -> modules ou utiliser Google pour trouver des modules tiers.

Vous avez besoin de charger au moins 2 modules sinon vous n'aurez pas la possibilité de lancer ircd :
- le module des commandes : commands.so (commands.dll sous windows)
- un module de cloaking: habituellement cloak.so (cloak.dll sous windows)

3.3 - Snomasks

Les Snomasks sont des masques de notice serveur (server notice masks). C'est un type spécial de usermode qui définit quelles notices vous recevrez des serveurs. (cela est utilisé le plus souvent par les opérateurs).

Cela peut être définit par: /mode votrepseudo +s SNOMASK, par exemple : /mode votrepseudo +s +cF
Pour enlever certains snomasks, utilisez quelque chose comme : /mode votrepseudo +s -c
Vous pouvez aussi enlever tous vos snomasks en écrivant simplement : /mode votrepseudo -s

Les snomasks disponibles sont :
c - les connexions locales
F - les connexions globales (exceptées celles qui proviennent des serveurs qui sont dans le bloc U:lines)
f - les notices de flood
k - les notices de kill [*]
e - les notices de 'eyes'
j - les notices de 'junk'
v - les notices de vhost
G - les notices de gline/shun
n - les changements de pseudo locaux
N - les changements de pseudo globaux
q - les notices d'utilisation de nicks interdits (Q:line)
s - recevoir les notices serveurs [*]
S - recevoir les notices de l'anti-spam
o - recevoir les notices d'identification oper
[*: ces snomasks sont aussi autorisés aux non-opérateurs]

Vous pouvez contrôler quels snomasks vous obtenez automatiquement (set::snomask-on-connect) et aussi ceux que vous obtenez avec /oper (set::snomask-on-oper, oper::snomask)

Par défaut, si un utilisateur applique uniquement le mode +s, certains snomasks sont appliqués. Pour les non-opers, il s'agit de +ks, et pour les opers, de +kscfvGqo.

3.4 - Alias

Avec les aliases vous pouvez configurer des alias de commandes au niveau du serveur. Par exemple vous pouvez faire en sorte que "/ns identify blabla" soit envoyé à Nickserv (cela sera traduit en : privmsg nickserv identify blabla). Vous pouvez bien entendu créer des alias plus compliqués comme /register qui sera envoyé à Chanserv si le premier paramètre commence par un # et sinon à Nickserv.

Les alias sont à configurer dans les alias blocks du fichier de configuration. Vous pouvez aussi inclure un fichier avec des alias par défaut adaptés à la plupart des services.

3.5 - Helpop

UnrealIRCd a un système d'aide interne accessible via /helpop. La commande /helpop est entièrement configurable via le help block dans le fichier de configuration. En supplément, un help.conf est inclus, il contient une aide basique pour toutes les commandes par défaut.
Par exemple /helpop chmodes vous donne la liste de tous les modes channels disponibles d'UnrealIRCd.
Rappelez vous que si vous êtes un opérateur (helpop) vous devrez ajouter le préfix ? aux mots clés, donc /helpop devient /helpop ? et /helpop chmodes devient /helpop ?chmodes etc..

3.6 - Niveau d'accès des opérateurs

Dans UnrealIRCd, plusieurs niveaux d'opérateurs sont accessibles et vous pouvez définir des droits supplémentaires (comme l'utilisation de /gline) pour chacun d'eux. Grâce à cela vous pouvez donner aux opérateurs les privilèges dont ils ont besoin.

Cela est contrôlé par les flags opérateurs dans l'oper block, regardez l'oper block pour plus d'informations.

3.7 - Commandes opérateurs

UnrealIRCd a beaucoup de commandes performantes pour les opérateurs qui sont expliquées dans Commandes utilisateurs et opérateurs, vous voudrez probablement lire cela après l'installation :)

3.8 - SSL

SSL (Secure Socket Layer) vous permet de sécuriser les connexions en les chiffrant. Vous pouvez l'utiliser pour sécuriser le trafic entre serveurs mais aussi le trafic client<->serveur. Habituellement, SSL est utilisé pour protéger contre le sniffing et pour l'authentification du serveur.

Pour l'utiliser, il vous faudra compiler votre IRCd avec le support SSL. Pour mettre en place un port SSL, vous devez utiliser listen::options::ssl.

Vous ne pouvez pas vous connecter normalement à un port SSL (donc ne mettez pas le port irc par défaut 6667 en SSL !), il vous faut un client ou un tunnel qui supporte le protocol SSL.

Clients supportant le SSL: XChat, irssi, mIRC (6.14 et supérieures, requiert certaines dlls additionelles)

Pour les clients ne supportant pas le SSL vous pouvez utiliser un tunnel comme stunnel. Voici un exemple de stunnel.conf ( pour stunnel 4.x) :

     client = yes
    	[irc]
    	accept = 127.0.0.1:6667
    	connect = irc.myserv.com:6697

Si vous vous connectez sur 127.0.0.1 port 6667, votre trafic sera chiffré et retourné vers irc.myserv.com port 6697 (un port SSL).

Il faut aussi que vous ayez des certificats valides quand vous vous connectez aux serveurs et ne pas les accepter aveuglément (comme dans l'exemple stunnel) sinon vous serez vulnérable aux attaques "active sniffing" (ssl redirects). Ce n'est toutefois pas l'endroit approprié pour en parler (renseignez vous sur le SSL, ne nous demandez rien). [mIRC et xchat vous donne la possibilité d'accepter ou non un certificat, ce qui est parfait].

3.9 - IPv6

UnrealIRCd supporte l'IPv6 et depuis la beta15 cela semble être stable.
Votre OS a besoin d'avoir le support IPv6 et il faut activer le support IPv6 durant le ./Config.

Bien que Microsoft ait une implantation expérimentale de l'IPv6 pour w2k/XP, cela n'est pas (encore) supporté par UnrealIRCd.

3.10 - Zip links

Les Zip links peuvent être activés pour les transferts entre serveurs (links). Cela compresse les données en utilisant zlib et peut sauvegarder entre 60 et 80% de votre bande passante ... C'est donc très utile pour les links avec des bandes passantes faibles ou des links avec énormément d'utilisateurs, et peut être très bénéfique lorsque vous liez deux serveurs, car de nombreuses données sont échangées sur chaque utilisateur, salon, etc.

Pour compiler avec le support des zip links, il faudra répondre Yes lors de la question portant sur le zlib pendant le ./Config et ajouter dans votre link block link::options::zip (sur les deux serveurs).

3.11 - Support des links avec IP/DNS dynamiques

UnrealIRCd a quelques (nouvelles) fonctionnalités qui aideront les utilisateurs ayant des IP dynamiques et qui utilisent des DNS dynamiques (comme exemple.dyndns.org). Si vous linkez 2 hosts DNS dynamiques, alors ajoutez link::options::nodnscache et link::options::nohostcheck.

3.12 - Fonctionnalités Anti-Flood

Throttling
Le Throttling est une méthode qui vous permet de déterminer le temps minimum pour qu'un client se reconnecte après une déconnexion à votre serveur. Vous pouvez configurer cela dans votre set::throttle block pour autoriser X connexions toutes les Y secondes depuis la même IP.
Modes des salons
Certains modes salons sont aussi très efficaces contre le flood. En voici quelque uns :
K = /knock interdit, N = changement de pseudo interdit, C = CTCP interdit, M = seuls les utilisateurs enregistrés peuvent parler, j = join throttling (par utilisateur).
Depuis la beta18, il y a un mode channel beaucoup plus avancé +f ...
Mode salon f
À la place d'utiliser des scripts ou des bots pour vous protéger du flood, cela est maintenant disponible directement dans l'ircd.
Un exemple du mode +f est : *** Blabla sets mode: +f [10j]:15
Cela signifie que seuls 10 joins toutes les 15 secondes sont autorisés sur le salon, si la limite est atteinte, le salon va mettre automatiquement le mode +i.
Les types suivants sont disponibles :

Type: | Nom: | Action par défaut: | Autres actions possibles: | Commentaires
--- | --- | --- | --- | ---
c | CTCPs | auto +C | m, M |
j | joins | auto +i | R |
k | knocks | auto +K |  | (comptés uniquement pour les clients locaux)
m | messages/notices | auto +m | M |
n | nickchanges | auto +N |  |
t | text | kick | b | par messages/notices utilisateurs comme l'ancien +f. Kick ou ban l'utilisateur.

Exemple :

     *** ChanOp sets mode: +f [20j,50m,7n]:15
    	<ChanOp> lalala
    	*** Evil1 (~fdsdsfddf@Clk-17B4D84B.blah.net) has joined #test
    	*** Evil2 (~jcvibhcih@Clk-3472A942.xx.someispcom) has joined #test
    	*** Evil3 (~toijhlihs@Clk-38D374A3.aol.com) has joined #test
    	*** Evil4 (~eihjifihi@Clk-5387B42F.dfdfd.blablalba.be) has joined #test
    	-- XX lignes --
    	*** Evil21 (~jiovoihew@Clk-48D826C3.e.something.org) has joined #test
    	-server1.test.net:#test *** Channel joinflood detected (limit is 20 per 15 seconds), putting +i
    	*** server1.test.net sets mode: +i
    	<Evil2> fsdjfdshfdkjfdkjfdsgdskjgsdjgsdsdfsfdujsflkhsfdl
    	<Evil12> fsdjfdshfdkjfdkjfdsgdskjgsdjgsdsdfsfdujsflkhsfdl
    	<Evil15> fsdjfdshfdkjfdkjfdsgdskjgsdjgsdsdfsfdujsflkhsfdl
    	<Evil10> fsdjfdshfdkjfdkjfdsgdskjgsdjgsdsdfsfdujsflkhsfdl
    	<Evil8> fsdjfdshfdkjfdkjfdsgdskjgsdjgsdsdfsfdujsflkhsfdl
    	-- XX lignes --
    	-server1.test.net:#test *** Channel msg/noticeflood detected (limit is 50 per 15 seconds), putting +m
    	*** server1.test.net sets mode: +m
    	*** Evil1 is now known as Hmmm1
    	*** Evil2 is now known as Hmmm2
    	*** Evil3 is now known as Hmmm3
    	*** Evil4 is now known as Hmmm4
    	*** Evil5 is now known as Hmmm5
    	*** Evil6 is now known as Hmmm6
    	*** Evil7 is now known as Hmmm7
    	*** Evil8 is now known as Hmmm8
    	-server1.test.net:#test *** Channel nickflood detected (limit is 7 per 15 seconds), putting +N
    	*** server1.test.net sets mode: +N

En fait, cela peut être plus avancé et complexe:
À la place de l'action par défaut, vous pouvez spécifier d'autres types de flood, par exemple : +f [20j#R,50m#M]:15
Cela mettra le salon en +R si la limite de joins est atteinte (>20 joins en 15 secondes), et mettra le salon en +M si la limite de messages est atteinte (>50 messages en 15 secondes).
Il y a également des paramètres que vous pouvez ajouter pour enlever les modes après X minutes : +f [20j#R5]:15 mettra le salon en +R si la limite est atteinte et l'enlevera après 5 minutes.
Un serveur peut avoir un temps par défaut pour l'enlèvement de ces modes (set::modef-default-unsettime) donc si vous écrivez +f [20j]:15, celà pourra être transformé en +f [20j#i10]:15. C'est juste par défaut, vous pouvez toujours mettre [20j#i2]:15 ou quelque chose dans le genre, et vous pouvez aussi annuler complétement le retrait automatique en faisant : +f [20j#i0]:15 (un 0 explicite).
L'ancien mode +f (msgflood par un utilisateur) est aussi toujours disponible via 't', +f 10:6 est maintenant appelé +f [10t]:6 et +f *20:10 est maintenant +f [20t#b]:10. Actuellement l'ircd devrait automatiquement convertir l'ancien mode +f vers le nouveau. Notez qu'il n'y a aucun unsettime disponible pour les bans via 't' ([20t#b30]:15 ne fonctionne pas).
Le meilleur mode +f dépend fortement du salon ... combien d'utilisateurs a-t-il ? Avez vous un jeu qui fait que les utilisateurs envoient beaucoup de messages (par exemple un trivia) ? Est-ce un genre de salon principal ou en auto-join ? etc ...
Il n'y a pas un mode +f parfait pour tous les salons, mais pour commencer regardez l'exemple suivant et modifiez le en fonction de vos besoins :
+f [30j#i10,40m#m10,7c#C15,10n#N15,30k#K10]:15
30 joins toutes les 15 secondes, si la limite est atteinte, le salon met le mode +i pour 10 minutes.
40 messages toutes les 15 secondes, si la limite est atteinte, le salon met le mode +m pour 10 minutes.
7 ctcps toutes les 15 secondes, si la limite est atteinte, le salon met le mode +C pour 15 minutes.
10 changements de pseudo toutes les 15 secondes, si la limite est atteinte, le salon met le mode +N pour 15 minutes.
30 knocks toutes les 15 secondes, si la limite est atteinte, le salon met le mode +K pour 10 minutes.
Si le salon a beaucoup d'utilisateurs (>75 ?) vous devrez augmenter la sensibilité du join (par ex: 50) et bien entendu la limite de messages (par ex: 60 ou 75).
Le temps de retrait des modes est en particulier une question de goût personnel. Que faire si aucun op n'est disponible quand un événement se produit, voudrais-je que le salon soit bloqué pendant 15 minutes (= pas agréable pour les utilisateurs) ou 5 minutes (= la fautif n'ayant qu'à attendre 5 min et flooder à nouveau). Ça dépend aussi du type de flood, empêcher les utilisateurs de rejoindre le salon (+i) ou de parler (+m) est pire que de les empecher de changer leur pseudo (+N) ou d'envoyer des ctcps au salon (+C), donc vous devrez établir différents temps de retrait des modes.
Mode salon j
Le mode +f inclus un dispositif permettant d'empêcher les join floods, toutefois ce dispositif est "global". Par exemple, si il est reglé à 5:10 et que 5 utilisateurs différents joignent en 10 secondes, la protection contre le flood est activée.
Le mode de salon +j est différent. Ce mode fonctionne sur la base d'un utilisateur. Plutôt que de protéger contre les join floods, il est fait pour protéger contre les join-part floods. Le mode prend un paramètre de la forme X:Y où X est le nombre de joins et Y est le nombre de secondes. Si un utilisateur dépasse la limite, il ne pourra plus rejoindre le salon.

3.13 - Types de ban

Les types de ban basiques et les cloaked hosts
UnrealIRCd supporte les types de ban basiques comme +b nick!user@host.
Mais aussi, si l'host masqué de quelqu'un est 'rox-ACB17294.isp.com' et que vous bannissez *!*@rox-ACB17294.isp.com, alors même si l'utilisateur enlève le mode x (/mode votrepseudo -x) (et son host devient par exemple 'dial-123.isp.com') le ban fonctionnera toujours. Les bans sont toujours vérifiés pour les hosts réels ET les hosts masqués.
Les bans avec des IP sont aussi disponibles (ex: *!*@128.*) et sont aussi toujours vérifiés.
Les bans sur les IPs masquées requièrent quelques explications, :
Si l'IP d'un utilisateur est 1.2.3.4, son cloaked host pourrait être 341C6CEC.8FC6128B.303AEBC6.IP.
Si vous bannissez *!*@341C6CEC.8FC6128B.303AEBC6.IP vous bannirez donc aussi *!*@1.2.3.4 (ce qui semble évident...)
Si vous bannissez *!*@*.8FC6128B.303AEBC6.IP vous bannissez *!*@1.2.3.*
Si vous bannissez *!*@*.303AEBC6.IP vous bannissez *!*@1.2.*
Cela devrait vous aider à savoir comment un ban doit être établi le moment venu.
Types de ban étendus
Les bans étendus ressemble à ~<type>:<parameter>. Ils vous permettent de bannir (ou exempter de ban) quelqu'un en vous basant sur quelque chose de différent du traditionnel masque nick!user@host. Ils permettent aussi des choses comme rendre muet un utilisateur.
Ces types de bans précisent quelles actions sont associées à un ban :

Type | Nom : | Explications :
--- | --- | ---
~q | quiet | Les personnes correspondants à ces bans peuvent rejoindre le salon mais ne peuvent pas parler, sauf s'ils ont le flag +v ou plus. Ex : ~q:*!*@*.aol.com
~n | nickchange | Les personnes correspondants à ces bans ne peuvent pas changer de pseudo, sauf s'ils ont le flag +v ou plus. Ex: ~n:*!*@*.aol.com

~j

join

Si un utilisateur correspond à ce ban, il ne pourra pas rejoindre le salon. Par contre, s'il est déjà dessus, il pourra faire ce qu'il veut, comme parler ou changer de pseudo.
Ex: ~j:*!*@*.aol.com
Ceci peut être pratique pour empêcher les utilisateurs d'un FAI particulier de rejoindre le salon, mais leur permettre quand même de l'utiliser librement une fois dessus, comme par exemple après un /invite

Ces types de bans introduisent de nouveux critères de sélection :

Type | Nom : | Explications :
--- | --- | ---

~c

channel

Si l'utilisateur est présent sur le salon désigné par ce ban, alors il ne pourra pas joindre le salon dans lequel ce ban a été placé. Un préfixe peut aussi être spécifié (+/%/@/&/~), pour ne désigner que les utilisateurs ayant au moins le flag spécifié sur le salon considéré.
Ex: +b ~c:#lamers, +e ~c:@#trusted
Ceci empêchera à tous les utilisateurs présents sur #lamers, sauf s'ils sont aussi au moins opérateurs de #trusted de venir sur le salon sur lequel est placé ce ban.

~r | realname | Si le realname d'un utilisateur correspond, il ne pourra pas joindre ce salon. Ex: ~r:*Stupid_bot_script* NOTE : un underscore ('_') correspond à la fois à un espace (' ') et à un underscore ('_'), donc 'Stupid bot script v1.4' sera bloqué par ce ban.
~R | registered | Si l'utilisateur s'est identifié auprès des services (habituellement NickServ) et correspond à ce nick, alors ce ban le désignera. Par conséquent, ce ban est uniquement utile pour les exceptions (+e). Ex: +e ~R:Nick autorisera Nick sur le salon, même s'il correspond à un ban, s'il s'est identifié auprès de NickServ et utilise le pseudo Nick.

~a

account

s'est identifié auprès des services (habituellement NickServ) avec ce compte, ce ban le désignera.
Ce ban est légèrement différent de ~R, puisqu'un utilisateur de nick ABC peut être connecté avec le compte XYZ. Tous les services ne supportent pas cette option, et dans ce cas, vous devrez utiliser ~R à la place.
Ex: +e ~a:UnCompte autorisera le(s) utilisateur(s) se connectant au compte UnCompte à rejoindre le salon en ignorant les bans.

Vous pouvez cumuler les bans étendus du premier groupe avec ceux du deuxième groupe. Par exemple, +b ~q:~c:#lamers rendra silencieux tous les membres de #lamers.
Les bans du second groupe peuvent aussi ètre utilisés avec le mode +I (Invite exceptions), comme par exemple : +I ~c:#trusted et +I ~a:accountname.
Certains modules peuvent ajouter d'autres types de ban étendus.

3.14 - Spamfilter

Le Spamfilter est un nouveau système de lutte contre le spam, la publicité, les worms et plein d'autres choses. Il fonctionne un peu comme que le système de badwords mais il a de nombreux avantages.

Les filtres sont ajoutés grâce à la commande /spamfilter qui utilise la syntaxe suivante:
/spamfilter [add|del|remove|+|-] [type] [action] [duree] [raison] [regex]

[type]

Spécifie le type de la cible:

Car. | Objet : | Description :
--- | --- | ---
c | channel | Message sur un salon
p | private | Message privé entre utilisateurs
N | channel-notice | Notice sur un salon
n | private-notice | Notice privée entre utilisateurs
P | part | Raison de /part
q | quit | Raison de /quit
d | dcc | Nom de fichier DCC
a | away | Message d'away
t | topic | Topic d'un salon
u | user | Ban utilisateur, serra comparé à nick!user@host:realname

Vous pouvez spécifier plusieurs cibles, comme : cpNn

[action]

Spécifie l'action devant être prise (seule 1 action peut être indiquée)

Action | Description :
--- | ---
kill | Kill l'utilisateur
tempshun | Shun la session courante de l'utilisateur (si il se reconnecte le shun est enlevé)
shun | Met un shun sur l'host
kline | Met une kline sur l'host
gline | Met une gline sur l'host
zline | Met une zline sur l'host
gzline | Met sur une gzline (zline globale) sur l'host
block | Ne faire que bloquer le message
dccblock | Empêche l'utilisateur donc d'envoyer d'autres DCCs
viruschan | Éjecte l'utilisateur de tous les salons, le force à rejoindre le salon défini par set::spamfilter::virus-help-channel et désactive toutes les commandes sauf PONG, ADMIN et les messages et notices vers le salon set::spamfilter::virus-help-channel
warn | Envoie une notice aux IRCOps (avec le snomask spamfilter) et prévient l'utilisateur que son message a été intercepté. Aucune autre action n'est effectuée et le message n'est pas bloqué.

[duree] | Durée de la *line/shun ajoutée par le filtre, utilisez '-' pour mettre la valeur par défaut ou pour ignorer le paramètre (par ex: si action = 'block')
[raison] | Raison du Block, de la *line ou du shun ... Vous NE POUVEZ PAS utiliser d'espaces dedans, mais les underscores ('_') seront remplacés par des espaces lors de l'utilisation. De même, un double underscore ('__') sera remplacé par un underscore ('_'). Encore une fois, utilisez '-' pour utiliser la valeur par défaut.
[regex] | Ceci est l'expression régulière correspondant au terme qui doit être bloqué.

Voici un exemple: /spamfilter add pc gline - - Come watch me on my webcam
Si le texte come watch me on my webcam est trouvé dans un message privé ou sur un salon alors le message sera bloqué et une gline sera immédiatement ajoutée.
Un autre exemple: /spamfilter add pc block - - come to irc\..+\..+
Ceci est une expression régulière qui détectera les messages du genre Hi, come to irc.blah.net et les bloquera.
Et un dernier exemple avec un temps/raison : /spamfilter add p gline 3h Please_go_to_www.viruscan.xx/nicepage/virus=blah Come watch me on my webcam
Si come watch me on my webcam est trouvé dans un message privé alors l'utilisateur est gliné pour 3 heures avec comme raison : Please go to www.viruscan.xx/nicepage/virus=blah.

Les filtres antispams ajoutés avec /spamfilter sont globaux. Ils fonctionnent que l'utilisateur/salon ait le mode +G défini ou pas, seuls les opérateurs et les ulines (services) sont exemptés de filtrage.
Vous pouvez aussi ajouter des filtres dans le fichier de configuration mais ceux ci seront des filtres locaux (non globaux, mais vous pouvez utiliser des inclusions distantes pour cela). La syntaxe de ces spamfilters block est expliquée ici.
Exemple:

     spamfilter {
    		regex "//write \$decode\(.+\|.+load -rs";
    		target { private; channel; };
    		reason "Generic $decode exploit";
    		action block;
    	};

set::spamfilter::ban-time vous permet de modifier la durée par défaut pour les *lines ajoutées par le spamfilter (défaut: 1 jour)
set::spamfilter::ban-reason vous permet de spécifier une raison par défaut (défaut: 'Spam/advertising')
set::spamfilter::virus-help-channel vous permet de spécifier le salon à joindre pour l'action 'viruschan' (défaut: #help)
set::spamfilter::virus-help-channel-deny vous permet de bloquer tout join normal au virus-help-channel (défaut: no)

Slow Spamfilter Detection
Une expression régulière utilisée dans un filtre anti-spam peut considérablement ralentir l'IRCd. Cela dépend de l'expression régulière (et de comment le moteur de regex la gère), certains sont très rapides et UnrealIRCd peut en exécuter des milliers par seconde. D'autres peut être extrèmement lentes, prendre plusieures secondes à s'exécuter et faire freezer l'IRCd.
Afin de limiter ce phénomène, Unreal dispose d'une Slow Spamfilter Detection : pour chaque filtre, Unreal vérifie le temps qu'il met à être exécuté à chaque fois qu'il l'utilise. Lorsqu'un certain seuil est atteint, Unreal peut avertir voire supprimer ce filtre.
L'avertissement est configuré grâce à set::spamfilter::slowdetect-warn (défaut : 250ms) et la suppression automatique grâce à set::spamfilter::slowdetect-fatal (defaut : 500ms). Vous pouvez mettre les deux à 0 (zéro) pour désactiver la détection
Cette fonctionnalité n'est pas encore disponible sur Windows.

3.15 - CIDR

UnrealIRCd a maintenant un support pour le CIDR (Classless Interdomain Routing). Le CIDR vous permet de bannir des plages d'IP. Des Ips sont allouées aux FAI en utilisant CIDR, cela vous permet en plaçant un ban basé sur le CIDR de bannir facilement un FAI. Unreal supporte le CIDR pour l'IPv4 et l'IPv6. Les masques CIDR peuvent être utilisés dans allow::ip, oper::from::userhost, ban user::mask, ban ip::mask, except ban::mask, except throttle::mask et except tkl::mask (pour gzline, gline, et shun). De plus, le CIDR peut être utilisé dans les /kline, /gline, /zline, /gzline, et /shun. Unreal utilise la syntaxe standard d'IP/bits, 127.0.0.0/8 (correspond à la plage 127.0.0.0 - 127.255.255.255) et fe80:0:0:123::/64 (correspond à fe80:0:0:123:0:0:0:0 - fe80:0:0:123:ffff:ffff:ffff:ffff).

3.16 - Caractères admis dans les pseudos

UnrealIRCd a maintenant la capacité de spécifier quels caractères/langages doivent être autorisés dans les pseudos. Vous appliquez cela avec set::allowed-nickchars.

Pour le français, le choix conseillé est latin1 qui reprend tous les caractères (notamment les accents) d'Europe de l'Ouest.
Voici les choix possibles :

Nom : | Description: | Jeu de caractères/encodage:
--- | --- | ---
catalan | Caractères catalans | iso8859-1 (latin1)
danish | Caractères danois | iso8859-1 (latin1)
dutch | Caractères néerlandais | iso8859-1 (latin1)
french | Caractères français | iso8859-1 (latin1)
german | Caractères allemands | iso8859-1 (latin1)
swiss-german | Caractères Suisse-Allemand (non es-zett) | iso8859-1 (latin1)
icelandic | Caractères islandais | iso8859-1 (latin1)
italian | Caractères italiens | iso8859-1 (latin1)
spanish | Caractères espagnols | iso8859-1 (latin1)
swedish | Caractères suédois | iso8859-1 (latin1)
latin1 | Français, catalan, danois, néerlandais, allemand, suisse-allemand, islandais, italien et suédois | iso8859-1 (latin1)
hungarian | Caractères hongrois | iso8859-2 (latin2), windows-1250
polish-iso | Caractères polonais (attention : polish-w1250 est plus souvent utilisé) | iso8859-2 (latin2)
romanian | Caractères roumains | iso8859-2 (latin2), windows-1250, iso8859-16
latin2 | Hongrois, polonais (polish-iso) et roumain | iso8859-2 (latin2)
polish-w1250 | Caractères polonais, variante windows | windows-1250
slovak-w1250 | Caractères slovaques, variante windows | windows-1250
czech-w1250 | Caractères tchèques, variante windows | windows-1250
windows-1250 | Polonais (polish-w1250), slovaque (slovak-w1250), tchèque (czech-w1250), hongrois et roumain | windows-1250
russian-w1251 | Caractères russes | windows-1251
belarussian-w1251 | Caractères belarusses | windows-1251
ukrainian-w1251 | Caractères ukrainiens | windows-1251
windows-1251 | Russe, belarusse et ukrainien | windows-1251
greek | Caractères grecques | iso8859-7
turkish | Caractères turcs | iso8859-9
hebrew | Caractères hébreux | iso8859-8-I/windows-1255
chinese-simp | Chinois simplifié | Multibyte: GBK/GB2312
chinese-trad | Chinois traditionnel | Multibyte: GBK
chinese-ja | Japonnais Hiragana/Pinyin | Multibyte: GBK
chinese | Caractères chinese-* | Multibyte: GBK
gbk | Caractères chinese-* | Multibyte: GBK

Note 1 : Attention, certaines combinaisons peuvent poser des problèmes. Par exemple, vous ne pouvez pas combiner latin* et chinese-*, UnrealIRCd affichera une erreur. Mixer d'autres charsets pourra poser des problèmes d'affichage, donc Unreal affichera un message d'avertissement si vous essayez de mixer latin1/latin2/greek/autres groupes incompatibles.

Note 2 : Le casemapping (la différence entre un caractère minuscule accentué et sa variante majuscule) est fait en accord avec l'US-ASCII, ceci signifie que ö et Ö ne seront pas reconnu comme le même caractère et par conséquent quelqu'un peut avoir un pseudo avec Bär et quelqu'un d'autre BÄr au même moment. Ceci est une limitation du système et des standards IRC qui ne pourra pas être résolue dans un avenir proche. Les gens doivent être au courant de cette limitation. Notez que celle-ci a toujours été appliquée aux salons sur lesquels presque tous les symboles étaient permis et le casemapping était appliqué.

Note 3 : Les caractères basiques de pseudo (a-z A-Z 0-9 [ \ ] ^ _ - { | }) sont toujours permis.

Exemple 1 : pour les personnes d'Europe de l'Ouest :

     set { allowed-nickchars {	latin1; }; };

Exemple 2 : si vous avez principalement des utilisateurs chinois et voulez autoriser les caractères chinois normaux :

     set { allowed-nickchars { chinese-simp; chinese-trad; }; };

3.17 - Support de CGI:IRC

UnrealIRCd inclut le support pour le host spoofing de CGI:IRC. Cela signifie que vous pourrez indiquer des passerelles CGI:IRC auquelles vous faites confiance, ce qui aura pour effet d'autoriser l'IRCd à afficher les host/ip des utilisateurs partout sur IRC, au lieu de l'host/ip de la passerelle CGI:IRC.

Voyez la section cgiirc block pour avoir des informations sur la configuration de ceci.

3.18 - Synchronisation de l'heure

Avoir l'heure exacte est extrêmement important pour les serveurs IRC. Sans cela, des salons peuvent se désynchroniser, des utilisateurs innocents peuvent être victimes de kill, des salons peuvent ne pas s'afficher correctement dans /LIST, en résumé : d'énormes problèmes peuvent survenir.

UnrealIRCd dispose d'une synchronisationation temporelle interne. Bien qu'elle ne soit pas optimale (il peut encore exister des décalages de quelques secondes), elle devrait venir à bout de la plupart des écarts de temps. Si cela vous est possible, il vous est fortement recommendé de faire tourner un logiciel de synchronisation du temps tel que ntpd sous *NIX ou le service de synchronisation de l'heure sous Windows (dans ce cas, vous pouvez arrêter celui d'Unreal, voir ci-après).

Ce que fait UnrealIRCd (par défaut) est une seule tentative de synchronisation au lancement. Il envoie (par défaut) une requête à de multiples serveurs de temps et lorsqu'il recoit la première réponse (la plus rapide), il ajuste l'horloge interne de l'ircd (pas l'horloge système). Si, pour certaines raisons, Unreal ne recoit pas de réponse du serveur dans les 3 secondes, l'IRCd continuera la lancement malgré tout (cela devrait être très rare).

La synchronisation du temps se configure (et peut être désactivée) via le bloc set::timesynch, voir la documentation sur les set blocks pour plus d'information.

3.19 - Types d'Authentication

En plusieurs endroits du fichier de configuration, par exemple dans les oper block, allow block et link block, vous pouvez authentifier des clients par un mot de passe ou d'autres moyens.

Vous pouvez spécifier le mot de passe en clair, mais vous pouvez aussi utiliser spécifier un autre type d'authentification.
Les auth-types suivants sont disponibles :

Auth-type | Description | Dépendances | Comment générer
--- | --- | --- | ---
crypt | UNIX crypt | Windows: OpenSSL requis | /MKPASSWD crypt :password
md5 | MD5 avec un salt | Toujours disponible | /MKPASSWD md5 :password
sha1 | SHA1 avec un salt | OpenSSL requis | /MKPASSWD sha1 :password
ripemd160 | RIPEMD160 avec un salt | OpenSSL requis | /MKPASSWD ripemd160 :password
sslclientcert | Certificat client SSL | OpenSSL requis | Chemin vers le fichier .pem du certificat public.
sslclientcertfp | Empreinte du certificat client SSL | OpenSSL requis | openssl x509 -in nom-du-fichier-pem.pem -sha256 -noout -fingerprint

La commande /MKPASSWD peut être utilisée directement une fois connecté en temps qu'IRCop. Sinon, vous pouvez l'utiliser depuis la ligne de commande du shell :
`./unreal mkpasswd hashtype password`

Tous les types d'authentification ne sont pas disponibles sur tous les systèmes, voir les dépendances et prérequis dans la table ci-dessus.

Exemple : mot de passe hashé en MD5 dans un bloc vhost

1. Supposons que vous voulez utiliser le mot de passe test et voulez le hasher en md5.
   Si vous êtes un IRCop, alors vous pouvez simplement taper /MKPASSWD md5 :test
   Sinon, vous pouvez exécuter la commande suivante dans le shell : ./unreal mkpasswd md5 test

   Quelque soit la méthode, le hash généré ressemblera à $NIV0bSfG$UTMvI/KdMwe4cZqmT/23qw== (la chaîne exacte peut varier !)

2. Maintenant, mettez cette chaîne dans votre bloc vhost et informez UnrealIRCd qu'il s'agit d'un hash md5.
   Exemple :

       vhost {
       		vhost I.love.Tux;
       		from { userhost *@*; };
       		login Tux;
       		password "$NIV0bSfG$UTMvI/KdMwe4cZqmT/23qw==" { md5; };
       };

3. Pour utiliser cette vhost, tapez /VHOST Tux test

Exemple : authentification par un certificat client SSL

`sslclientcert` et `sslclientcertfp` sont deux types d'authentification qui peuvent être utiliser pour authentifier des utilisateurs connectés en SSL par leur certificat client. Voici un exemple de comment l'utiliser pour le bloc oper :

1. Créez un certificat SSL client si vous n'en avez pas déjà un (cherchez sur le web "create ssl certificate" si vous ne savez pas comment faire).

2. Prenez le hash SHA256 du certificat en exécutant : `openssl x509 -in nom-du-fichier-pem.pem -sha256 -noout -fingerprint`

3. Dans le fichier de configuration, remplacez le mot de passe d'origine (test dans notre exemple) avec par ce hash et indiquez le type `sslclientcertfp`.
   Voici un exemple :

       oper test {
         password "E7:4D:46:F1:9F:F4:68:F5:E8:E3:49:CC:28:5D:F9:65:85:BA:4F:16:B6:49:02:E3:34:E6:E7:6A:FE:76:A7:98" { sslclientcertfp; };
         flags { global; can_override; };
         class clients;
       };

4. Rehashez le serveur (/REHASH)

5. Maintenant, connectez vous avec votre client SSL et assurez vous qu'il utilise le certificat de l'étape 2.

6. Vous pouvez maintenant vous connecter comme oper avec /oper test x

   Vous devez toujours mettre un mot de passe, même s'il ne correspond à rien (par exemple : x).
   Il est ignoré car le certificat est utilisé pour l'authentification.

7. Félicitations ! Vous utilisez désormais la méthode d'authentification la plus sécurisée disponible sur UnrealIRCd.

Un autre endroit très utile pour utiliser `sslclientcertfp` est dans link::password-receive

3.19 - Autres fonctionnalités

UnrealIRCd a énormément de fonctionnalités donc tout ne peut pas être exposé ici ... Vous découvrirez tout cela par vous même.

4.0 - Configurer votre unrealircd.conf

Tout d'abord, créer votre premier unrealircd.conf vous prendra du temps (disons entre 15 et 60 minutes). Créer un bon unrealircd.conf prendra encore plus de temps. Vous ne devriez pas vous dépêcher pour lancer l'IRCd le plus vite possible, mais au contraire y aller étape par étape. Si vous avez un problème, vérifiez votre syntaxe, regardez dans le manuel, regardez la FAQ avant de demander de l'aide ou de rapporter un bug.

4.1 Explication du fichier de configuration

Le nouveau système utilise un format basé sur des blocs. Chaque entrée, ou bloc, dans le nouveau format a un format spécifique. Celui-ci est du type :

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

<nom-bloc> est le type du bloc, tel que me, ou admin. <valeur-bloc> indique parfois une valeur, telle que "oper LoginOper", ou sinon un sous-type de bloc, comme dans "ban user".

<directive> est une variable individuelle spécifique au bloc, et <valeur-directive> est la valeur de cette variable. Si <valeur-directive> contient des espaces ou des caractères représentant un commentaire, vous devez le placer entre guillements ("). Si vous voulez utiliser un guillement à l'intérieur d'une chaine délimitée par des guillements, vous devez utiliser \".

Une <directive> peut elle-même contenir des <sous-directive>. Si c'est le cas les sous-directives seront contenues dans des accolades. Certains blocs n'ont pas de directives et sont justes spécifiés par "<nom-bloc> <valeur-bloc>", comme par exemple include. Notez aussi qu'il n'y a pas de format défini, cela veut dire qu'un bloc peut tenir sur une seule ligne comme sur plusieurs lignes. Le format ci-dessus est ce qui est normalement utilisé (et qui sera utilisé dans ce document) parce qu'il est facile à lire.

Note : le fichier de configuration est sensible à la case (aux majuscules / minuscules) donc NOM-DU-BLOC n'est pas la même chose que nom-du-bloc.

Il y a une notation spéciale utilisée pour parler d'entrées dans le fichier de configuration. Par exemple pour parler de la <directive1> dans l'exemple ci-dessus, vous devrez dire <nom-bloc>::<directive1>. De même pour désigner une sous-directive, vous ajouterez un autre :: et le nom de la sous-directive.

Pour parler d'une directive non nommée vous devrez mettre <nom-bloc>:: qui voudra dans ce cas dire <valeur-bloc>, ou cela pourra être une entrée dans un sous bloc qui n'a pas de nom.

Trois types de commentaires sont supportés :

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

Maintenant que vous savez comment ça fonctionne, copiez doc/example.fr.conf dans votre dossier UnrealIRCd (ex: /home/user/Unreal3.2) et renomez le en unrealircd.conf (OU créez votre unrealircd.conf depuis zéro). Il est recommandé d'y aller pas à pas avec les différents blocs et de suivre ce manuel de référence.

4.2 - Me Block OBLIGATOIRE (Connu précédemment comme M:Line)

Syntaxe :

    me {
    	name <nom du serveur>;
    	info <description du server>;
    	numeric <identifiant du serveur>;
    };

Ces valeurs sont plutôt claires. Le name définit le nom du serveur, info définit la description du serveur, numeric définit un identifiant numérique propre serveur. Ce dernier doit avoir une valeur comprise entre 0 et 254 qui est SPÉCIFIQUE au serveur, ce qui signifie qu'aucun autre serveur du réseau ne doit avoir le même identifiant.

Exemple :

    me {
    	name "irc.foonet.com";
    	info "FooNet Server";
    	numeric 1;
    };

4.3 - Admin Block OBLIGATOIRE (Connu précédemment comme A:Line)

Syntaxe:

    admin {
    	<text-line>;
    	<text-line>;
    };

Ce bloc défini le texte qui sera affiché lors d'une requête /admin. Vous pouvez spécifier autant de lignes que vous le souhaitez et elles peuvent contenir toutes les informations que vous voulez, mais il est habituel d'indiquer les pseudos et email des admins au minimum. Vous pouvez également inclure d'autres moyens de contact que vous désirez donner.

Exemple :

    admin {
    	"Bob Smith";
    	"bob";
    	"widely@used.name";
    };

4.4 - Class Block OBLIGATOIRE (Connu précédement comme Y:Line)

Syntaxe :

    class <name> {
    	pingfreq <ping-frequency>;
    	connfreq <connect-frequency>;
    	maxclients <maximum-clients>;
    	sendq <send-queue>;
    	recvq <recv-queue>;
    };

Les blocs Class sont les classes dans lequelles les connexions seront placées (par exemple pour les allow blocks ou les serveurs des link blocks), vous avez généralement plusieurs class blocks (exemple : pour les serveurs, clients, opers).

name est une description, comme "clients" ou "serveurs", ce nom est utilisé comme référence pour les classes dans les allow/link/oper/etc blocks.

pingfreq est le nombre de secondes entres les PINGs depuis le server (quelquechose entre 90 et 180 secondes est recommandé).

connfreq est utilisé uniquement pour les serveurs et représente le nombre de secondes entre 2 tentatives de connexions si l'autoconnexion est activée.

maxclients spécifie le nombre maximum de clients / serveurs pouvant faire partie de cette classe.

sendq spécifie la quantité d'informations pouvant être dans la file d'envoi (send queue) (très grand pour les serveurs avec une faible bande passante, moyen pour les clients).

recvq spécifie la quantité d'informations pouvant être dans la file de reception (receive queue) et est utilisé pour contrôler le flood (cela s'applique uniquement aux utilisateurs normaux, essayez avec des valeurs comprises entre 3000 et 8000, 8000 est la valeur par défaut).

Exemples :

    class clients {
    	pingfreq 90;
    	maxclients 500;
    	sendq 100000;
    	recvq 8000;
    };

    class servers {
    	pingfreq 90;
    	maxclients 10; /* Nombre maximal de serveur pouvant être linké au même moment */
    	sendq 1000000;
    	connfreq 100; /* Combien de secondes entre 2 tentatives de connexions */
    };

4.5 - Allow Block OBLIGATOIRE (connu précédemment comme I:Line)

Syntaxe :

    allow {
    	ip <user@ip-connection-mask>;
    	hostname <user@host-connection-mask>;
    	class <connection-class>;
    	password <connection-password> { <auth-type>; };
    	maxperip <max-connections-per-ip>;
    	ipv6-clone-mask <number-of-bits>;
    	redirect-server <server-to-forward-to>;
    	redirect-port <port-to-forward-to>;
    	options {
    		<option>;
    		<option>;
    		...
    	};
    };

C'est ici que vous spécifiez qui peut se connecter à ce serveur. Vous pouvez avoir plusieurs allow blocks.

A propos des correspondances
Le contrôle des accès fonctionne comme ceci : concordances des ip OU des host, donc avec "hostname *@*"; et "ip *@1.2.3.4"; cela concordera toujours. Les allow blocks sont lus de haut en bas et seul le dernier concordant est considéré, donc vous devez spécifier les host/ip particuliers APRÈS votre allow block général *@*. De plus, si vous voulez spécifier un bloc basé uniquement sur la correspondance à un ip, alors mettez pour l'hostname quelque chose d'invalide, tel que "hostname PERSONNE;", cela permettra au bloc de ne vérifier que la correspondance de l'ip.

ip
L'ip mask est de la forme user@ip, user est l'ident et souvent est défini par *, ip est l'ipmask. Quelques exemples : *@* (depuis n'importe où), *@192.168.* (seulement depuis les adresses commençant par 192.168), etc.

host
Également un user@host hostmask, user est souvent défini par *. Quelques exemples : *@* (n'importe où), *@*.wanadoo.fr (seulement depuis wanadoo.fr).

password (optionnel)
Requiert un mot de passe à la connexion. Vous pouvez également spécifier une méthode de chiffrage des mots de passe ici.

class
Spécifie le nom de la classe dans laquelle les connexions correspondant à cet allow block sont placées.

maxperip (optionnel, mais recommendé)
Vous permet de spécifier combien de connexions à ce serveur sont autorisées par une même ip (exemple : maxperip 4;).

ipv6-clone-mask (optionnel, par défaut set::default-ipv6-clone-mask)
Cette option contrôle la détection des clônes. Si deux clients se connectent depuis deux adresses IPv6 qui ne diffèrent que par leurs derniers bits, il est presque garanti que ces deux clients sont une seule et même personne. Cette option ne fait qu'affecter le fonctionnement deallow::maxperip. Par exemple, si vous définissez cette option à 128, alors toutes les adresses IPv6 seront considérées comme uniques. En raison de la politique actuelle d'attribution des adresses IP, il est recommandé que votre Allow block le plus général utilise une valeur de 64.

redirect-server (optionnel)
Si la classe est pleine, les utilisateurs seront redirigés vers ce serveur (si les clients le supporte [mIRC 6 le fait]).

redirect-port (optionnel)
Si un serveur de redirection est spécifié vous pouvez définir le port ici, sinon ce sera le 6667.

options block (optionnel)
Les options valides sont :
useip toujours afficher l'ip à la place de l'hostname
noident n'utilise pas d'ident mais l'username spécifié par le client
ssl ne fonctionne que si le client est connecté via ssl
nopasscont continue de tester les concordances si aucun mot de passe n'est donné (ainsi vous pourrez mettre des clients dans des classes spéciales si ils fournissent un mot de passe).

Exemples :

    allow {
    	ip *;
    	hostname *;
    	class clients;
    	maxperip 5;
    };

    allow {
    	ip *@*;
    	hostname *@*.passworded.ugly.people;
    	class clients;
    	password "f00Ness";
    	maxperip 1;
    };

4.6 - Listen Block OBLIGATOIRE (Connu précédemment comme P:Line)

Syntaxe :

    listen <ip:port> {
    	options {
    		<option>;
    		<option>;
    		...
    	};
    };

Ce bloc vous permet de spécifier les ports d'écoute de votre IRCd. Si aucune option n'est requise, vous pouvez le spécifier sans aucune directive sous la forme listen <ip:port>;.

IP et port
Vous pouvez mettre * comme valeur pour IP pour toutes les accepter, ou en spécifier une pour accepter uniquement les connexions sur cette ip (habituellement requis chez des loueurs de shell). Le port est le port que vous voulez écouter. Vous pouvez également spécifier un intervalle de ports à la place d'une valeur unique. Par exemple, 6660-6669 écoutera du port 6660 au port 6669 (inclus). Pour les utilisateur d'IPv6, voir ci-dessous.

Info pour les utilisateurs de l'IPv6
Si vous avez un serveur IPv6 vous devrez inclure les IP entre crochets, par exemple [::1]:6667 (écouter en localhost sur le port 6667). Si vous utilisez l'IPv6 et que vous voulez écouter une adresse Ipv4 spécifique vous devrez utiliser ::ffff:<IPv4ip>. Par exemple : [::ffff:203.123.67.1]:6667 qui écoutera l'IP 203.123.67.1 sur le port 6667. Évidemment, vous pouvez aussi utiliser *.

options block (optionnel)
Vous pouvez préciser des options spéciales pour ce port si vous le souhaitez, les options possibles sont :

clientsonly | Port réservé aux clients
serversonly | Port réservé aux serveurs
java | Support CR java
ssl | Port SSL

Exemples :

    listen *:6601 {
    	options {
    		ssl;
    		clientsonly;
    	};
    };

    // Si il n'y a pas d'options :
    listen *:8067;
    listen 213.12.31.126:6667;
    listen *:6660-6669;

4.7 - Oper Block RECOMMENDE (Connu précédemment comme O:Line)

Syntaxe :

    oper <name> {
    	from {
    		userhost <hostmask>;
    		userhost <hostmask>;
    	};
    	password <password> { <auth-type>; };
    	require-modes <modes>
    	class <class-name>;
    	flags <flags>;
    	flags {
    		<flag>;
    		<flag>;
    		...
    	};
    	swhois <whois info>;
    	snomask <snomask>;
    	modes <modes>;
    	maxlogins <num>;
    };

L'oper block vous permet d'assigner des Opérateurs IRC (IRCop ou oper) pour votre serveur. Le oper:: spécifie le login pour la commande /oper. Le oper::from::userhost est le masque user@host auquel l'utilisateur doit correspondre, vous pouvez spécifier plus qu'un seul hostmask en créant plusieurs oper::from::userhost. Le paramètre facultatif oper::require-modes vous permet de spécifier des modes (tels quer ou z) qu'un utilisateur doit avoir avant d'être autorisé à se connecter comme opérateur. Ceci peut être utilisé pour forcer les utilisateurs à se connecter avec Nickserv ou d'utiliser des connexions sécurisées avant de pouvoir devenir opérateurs.

Le oper::password:: est le mot de passe que l'opérateur doit indiquer. oper::password::auth-type vous permet de spécifier une méthode d'authentification du mot de passe. Ne précisez pas d'oper::password::auth-type pour un mot de passe en clair.
Les auth-types valides, ainsi qu'un exemple de comment les utiliser avec un bloc oper, peuvent être trouvés dans la section Types d'Authentication.

Attention : les login et mot de passe sont tous deux sensibles à la case : les majuscules et les minuscules ont leur importance.

La directive oper::class spécifie le nom d'une classe préexistante (donc qui apparaît avant dans le fichier de configuration) que le oper block utilisera.

La directive oper::flags a deux formats. Si vous voulez utiliser l'ancien style d'oper flags, par exemple `OAa`, vous utilisez la méthode flags <flags>;, si vous voulez utiliser la nouvelle méthode, alors vous utiliserez la méthode flags { <flag1>; <flag2>; }; Ci-dessous ce trouve la liste des flags (dans les deux formats) et leurs correspondances.

Ancien Flag | Nouveau Flag | Description
--- | --- | ---
o | local | Fait de vous un Local Operator (oper du serveur)
O | global | Fait de vous un Global Operator (oper sur tous les serveurs du réseau)
C | coadmin | Fait de vous un Coadmin
A | admin | Fait de vous un Admin
a | services-admin | Fait de vous un Services Admin
N | netadmin | Fait de vous un Network Admin
r | can_rehash | Oper pouvant utiliser /rehash
D | can_die | Oper pouvant utiliser /die
R | can_restart | Oper pouvant utiliser /restart
h | helpop | Oper avec le usermode +h (helpop)
w | can_wallops | Oper pouvant envoyer des /wallops
g | can_globops | Oper pouvant envoyer des /globops
c | can_localroute | Peut se connecter aux serveurs localement
L | can_globalroute | Peut se connecter aux serveurs globalement
k | can_localkill | Peut /kill les utilisateurs locaux
K | can_globalkill | Peut /kill les utilisateurs globaux
b | can_kline | Peut utiliser /kline user@host
B | can_unkline | Peut utiliser /kline -user@host
n | can_localnotice | Peut envoyer des notices sur le serveur local
G | can_globalnotice | Peut envoyer des notices globales
z | can_zline | Peut utiliser /zline
t | can_gkline | Peut utiliser /gline, /shun et /spamfilter
Z | can_gzline | Peut utiliser /gzline
W | get_umodew | Met le umode +W lorsque vous vous oper
H | get_host | Vous applique un oper host
v | can_override | Peut utiliser l'OperOverride
q | can_setq | Peut utiliser l'usermode +q
X | can_addline | Peut utiliser /addline
d | can_dccdeny | Peut utiliser /dccdeny et /undccdeny

Certains flags vous en donnent d'autres par défaut :

local | global | admin/coadmin | services-admin | netadmin
--- | --- | --- | --- | ---
can_rehash | can_rehash | can_rehash | can_rehash | can_rehash
helpop | helpop | helpop | helpop | helpop
can_globops | can_globops | can_globops | can_globops | can_globops
can_wallops | can_wallops | can_wallops | can_wallops | can_wallops
can_localroute | can_localroute | can_localroute | can_localroute | can_localroute
can_localkill | can_localkill | can_localkill | can_localkill | can_localkill
can_kline | can_kline | can_kline | can_kline | can_kline
can_unkline | can_unkline | can_unkline | can_unkline | can_unkline
can_localnotice | can_localnotice | can_localnotice | can_localnotice | can_localnotice
| can_globalroute | can_globalroute | can_globalroute | can_globalroute
| can_globalkill | can_globalkill | can_globalkill | can_globalkill
| can_globalnotice | can_globalnotice | can_globalnotice | can_globalnotice
|  | global | global | global
|  | can_dccdeny | can_dccdeny | can_dccdeny
|  |  | can_setq | can_setq
|  |  |  | admin
|  |  |  | services-admin

La directive oper::swhois vous permet d'ajouter une ligne supplémentaire dans le whois d'un oper. [optionnel]

La directive oper::snomask vous permet d'obtenir automatiquement les snomaks que vous souhaitez lors d'un /oper. Pour avoir la liste des Snomasks disponibles reportez vous à la Section 3.3. [optionnel]

La directive oper::modes vous permet de prédéfinir des usermodes pour l'oper lors de l'identification. [optionnel]

La directive oper::maxlogins vous permet de restreindre le nombre de login oper concurrent pour un host, par exemple si vous définissez 1 alors, une seule personne pourra se connecter avec ce bloc. [optionnel]

Exemple :

    oper bobsmith {
    	class clients;
    	from {
    		userhost bob@smithco.com;
    		userhost boblaptop@somedialupisp.com;
    	};
    	password "f00";
    	flags {
    		netadmin;
    		can_gkline;
    		can_gzline;
    		can_zline;
    		can_restart;
    		can_die;
    		global;
    	};
    	swhois "Example of a whois mask";
    	snomask cFfkoSsqNG;
    };

Quelques petites informations à propos de l'OperOverride :
L'OperOverride permet aux opers des choses comme joindre un salon malgré les modes +ikl et passer outre les bans (vous devrez d'abord vous inviter avec /invite Pseudo #salon), vous mettre opérateur du salon, etc ...
Le flag can_override a été ajouté de manière à éviter les abus de pouvoirs d'opérateurs IRC. Aucun oper n'est capable d'override par défaut, vous devez leur donner explicitement le flag can_override.

4.8 - DRpass Block RECOMMENDE (connu précédemment comme X:Line)

Syntaxe :

    drpass {
    	restart <restart-password> { <auth-type>; };
    	die <die-password> { <auth-type>; };
    };

Ce bloc définit les mots de passe nécessaire pour utiliser les commandes /restart et /die avec respectivement drpass::restart et drpass::die. Au lieu d'un mot de passe en clair, vous pouvez aussi utiliser d'autres Types d'Authentication

Exemple :

    drpass {
    	restart "I-love-to-restart";
    	die "die-you-stupid";
    };

4.9 - Directive Include

Syntaxe :

    include <file-name>;

Cette directive spécifie le nom de fichier devant être chargé comme fichier de configuration séparé. Ce fichier peut contenir n'importe quel type de bloc de configuration et peut également inclure d'autres fichiers. Les wildcards (*) sont supporté dans le nom du fichiers pour vous permettre de charger plusieurs fichiers en une fois.

tld or files block

Exemple 1 : un fichier réseau :

    include mynetwork.network;

Ce sera la syntaxe à utiliser si vous voulez utiliser un fichier réseau séparé. Les fichiers réseaux séparés ne sont plus requis et tous les paramètres réseaux peuvent être insérés directement dans unrealircd.conf. Ou vous pouvez mettre un include pour les charger depuis le fichier.

Exemple 2 : définir des alias :

    include aliases/ircservices.conf;

Vous pouvez par exemple inclure des alias blocks. UnrealIRCd est fourni avec des fichiers contenant les alias correspondants à différents services :

- aliases/ircservices.conf (IRCServices, Daylight)
- aliases/epona.conf (Epona)
- aliases/anope.conf (Anope)
- aliases/auspice.conf (Auspice)
- aliases/generic.conf (Magick, Sirius, Wrecked)
- aliases/cygnus.conf (Cygnus)
- aliases/operstats.conf (OperStats)
- aliases/genericstats.conf (GeoStats, NeoStats)

4.10 - Directive LoadModule OBLIGATOIRE

Syntaxe :

    loadmodule <file-name>;

Reportez-vous ici pour voir pourquoi les modules sont pratiques et utiles.

Modules fournis avec Unreal3.2 :

- commands.so / commands.dll : Toutes les commandes du serveur (en réalité pas encore toutes, mais le sera probablement) OBLIGATOIRE
- cloak.so / cloak.dll : Module de Cloaking par défaut OBLIGATOIRE (ou n'importe quel autre module de cloaking)

Vous voulez être sûr que ces deux modules sont chargés :

    // sur *UNIX :
    loadmodule "src/modules/commands.so";
    loadmodule "src/modules/cloak.so";

    // OU sur Windows :
    loadmodule "modules/commands.dll";
    loadmodule "modules/cloak.dll";

4.11 - Log Block RECOMMANDE

Syntaxe :

    log <file-name> {
    	maxsize <max-file-size>;
    	flags {
    		<flag>;
    		<flag>;
    		...
    	};
    };

Le log block vous permet d'assigner différents fichiers de log pour différentes actions. Le log:: contient le nom du fichier de log. log::maxsize est une directive optionnelle vous permettant de spécifier la taille à laquelle vous voulez que le fichier soit effacé et relancé. Vous pouvez utiliser MB pour méga-octets (megabytes), KB pour kilo-octets, GB pour giga-octets. Le log::flags spécifie quel type d'information sera dans ce log. Ci-dessous la liste des flags disponibles.

Vous pouvez également avoir plusieurs log block, pour loguer différentes choses dans des fichiers différents.

Flags disponibles:

errors | erreurs de l'IRCd
kills | notices de /kill
tkl | infos sur les *lines (/kline, /zline, etc), shun et filtres spamfilter (ajout/suppression/expiration)
connects | connexions et déconnexions des utilisateurs
server-connects | connexions et squit des serveurs
oper | tentatives de s'oper (réussies et ratées)
sadmin-commands | utilisations des commandes /sa* (samode, sajoin, sapart, etc)
chg-commands | utilisations des commandes /chg* (chghost, chgname, chgident, ect.)
oper-override | utilisations des OperOverrides
spamfilter | concordances aux filtres spamfilter

Exemple :

    log ircd.log {
    	maxsize 5MB;
    	flags {
    		errors;
    		kills;
    		oper;
    		tkl;
    	};
    };

4.12 - TLD Block OPTIONNEL (connu précédemment comme T:Line)

Syntaxe :

    tld {
    	mask <hostmask>;
    	motd <motd-file>;
    	rules <rules-file>;
    	shortmotd <shortmotd-file>;
    	opermotd <opermotd-file>;
    	botmotd <botmotd-file>;
    	channel <channel-name>;
    	options {
    		ssl;
    	};
    };

Le tld block vous permet de spécifier un motd (message d'accueil à la connexion au serveur), des rules (règles) et salon par défaut pour un utilisateur en se basant sur son host. C'est utile si vous voulez différents motd pour différentes langues.

Le tld::mask est un masque user@host auquel l'username et l'host de l'utilisateur doivent correspondre. Les tld::motd, tld::shortmotd,tld::opermotd,tld::botmotd et tld::rules spécifient respectivement les fichiers motd, shortmotd, opermotd, botmotd et rules qui doivent être affichés pour un hostmask. Les tld::shortmotd, tld::opermotd, et tld::botmotd sont optionnels. tld::channel est aussi optionnel et vous permet de spécifier un salon que cet utilisateur sera forcé de joindre à sa connexion. S'il est présent, il remplacera le auto-join channel par défaut (défini par set::auto-join).

Le bloc tld::options vous permet de définir des exigences supplémentaires, actuellement seules tld::options::ssl qui affiche seulement le fichier pour les usagers SSL et tld::options::remotes qui affiche seulement le fichier pour les utilisateurs distants existent.

Les entrées TLD sont vérifiées de haut en bas.

Exemple :

    tld {
    	mask *@*.fr;
    	motd "ircd.motd.fr";
    	rules "ircd.rules.fr";
    };

4.13 - Ban Nick Block OPTIONNEL (connu précédemment comme Q:Line)

Syntaxe :

    ban nick {
    	mask <nickname>;
    	reason <raison-du-ban>;
    };

Ce bloc vous permet d'interdire l'utilisation d'un pseudo sur le serveur. Le ban::mask permet des masques avec joker (*), afin de correspondre à plusieurs pseudos, et ban::reason vous permet de spécifier la raison pour laquelle ce ban a été placé. Le plus souvent ces blocs sont utilisés pour bannir l'usage de pseudos généralement utilisés par des services réseaux, comme NickServ.

Exemple :

    ban nick {
    	mask "*C*h*a*n*S*e*r*v*";
    	reason "Reserved for Services";
    };

4.14 - Ban User Block OPTIONNEL (connu précédemment comme K:Line)

Syntaxe :

    ban user {
    	mask <user@host>;
    	reason <raison-du-ban>;
    };

Ce bloc vous permet de bannir un masque user@host à sa connexion au serveur. Le ban::mask est une version avec joker du user@host à bannir et ban::reason est la raison pour laquelle ce ban a été placé. Notez que ceci est uniquement un ban local et l'utilisateur peut toujours se connecter à un autre serveur pour rejoindre le réseau.

Exemple :

    ban user {
    	mask *tirc@*.saturn.bbn.com;
    	reason "Idiot";
    };

4.15 - Ban IP Block OPTIONNEL (connu précédemment comme Z:Line)

Syntaxe :

    ban ip {
    	mask <ipmask>;
    	reason <raison-du-ban>;
    };

Ce bloc vous permet de bannir une IP lorsqu'il se connecte au serveur. Cela inclus aussi bien les utilisateurs que les serveurs qui essayent de se connecter. Le paramètre ban::mask est un IP pouvant contenir un joker (*) et ban::reason est la raison pour laquelle ce ban a été placé. Comme ce ban affecte les serveurs, il doit être utilisé très prudemment.

Exemple :

    ban ip {
    	mask 192.168.1.*;
    	reason "Get a real ip u lamer!";
    };

4.16 - Ban Server Block OPTIONNEL (connu précédemment comme q:Line)

Syntaxe :

    ban server {
    	mask <server-name>;
    	reason <raison-du-ban>;
    };

Ce bloc empêche un serveur de se connecter au réseau. Si le serveur se link directement à votre serveur, le link sera rejeté. Si le serveur se link à un autre serveur, le serveur local se déconnectera du réseau. Le champ ban::mask spécifie un masque avec joker à confronter au nom du serveur tentant de se connecter et ban::reason spécifie la raison pour laquelle ce ban a été placé.

Exemple :

    ban server {
    	mask broken.server.my.network.com;
    	reason "Its broken!";
    };

4.17 - Ban RealName Block OPTIONNEL (connu précédemment comme n:Line)

Syntaxe :

    ban realname {
    	mask <realname-mask>;
    	reason <raison-du-ban>;
    };

Le ban realname block vous permet de bannir un client basé sur le champs GECOS (realname). Cela est utilisé pour empêcher les flood de clônes car souvent les bots clônes utilisent le même realname. Le ban::mask spécifie le realname devant être banni. Le masque peut contenir un joker. Le ban::reason spécifie pour ce ban a été placé.

Exemple :

    ban realname {
    	mask "Bob*";
    	reason "Bob sucks!";
    };

4.18 - Ban Version Block OPTIONNEL

Syntaxe :

    ban version {
    	mask <version-mask>;
    	reason <raison-du-ban>;
    	action [kill|tempshun|shun|kline|zline|gline|gzline];
    };

Le ban version block vous permet de bannir un utilisateur pour l'utilisation du client IRC qu'il utilise. Ceci se base sur la réponse au CTCP version envoyé au client. Il est donc bien entendu que si le client n'envoie pas de réponse au CTCP version, le ban ne fonctionnera pas. Cette fonction vous permet de bloquer des scripts dangereux.

Le ban::mask spécifie la version devant être bannie. Le mask peut contenir un joker. Le ban::reason spécifie la raison pour laquelle le ban a été placé. Vous pouvez également spécifier ban::action, kill est la valeur par défaut, tempshun shunera uniquement la connexion de l'utilisateur et devrait fonctionner très efficacement contres les bots/zombies avec des IPs dynamiques car il n'affectera pas les utilisateurs innocents. shun/kline/zline/gline/gzline placeront un ban de ce type sur l'ip (*@IPADDR), la durée de ce ban peut être configurée avec set::ban-version-tkl-time et est de 1 jour par défaut.

Exemples :

    ban version {
    	mask "*SomeLameScript*";
    	reason "SomeLameScript contains backdoors";
    };
    ban version {
    	mask "*w00tZombie*";
    	reason "I hate those hundreds of zombies";
    	action zline;
    };

4.19 - Ban Exceptions Block OPTIONNEL (connu précédemment comme E:Line)

Syntaxe :

    except ban {
    	mask <hostmask>;
    };

L'except ban block vous permet de spécifier un user@host qui outrepassera un ban {}, une Kline ou une Zline placés sur une plage de host. Ceci est très utile lorsque vous voulez bannir un FAI, mais que vous voulez que certains utilisateurs spécifiques puissent toujours se connecter. La directive except::mask spécifie le masque user@host du client qui sera autorisé à se connecter.

NOTE : Si vous voulez exempter complètement un host de toutes les formes de bans possibles (sauf un ban de spamfilter), vous aurez besoin à la fois d'un bloc 'except ban' et d'un bloc 'except tkl'.

Exemple :

    except ban {
    	mask myident@my.isp.com;
    };

4.20 - TKL Exceptions Block OPTIONNEL

Syntaxe :

    except tkl {
    	mask <hostmask>;
    	type <type>;
    	type {
    		<type>;
    		<type>;
    		...
    	};
    };

L'except tkl block vous permet de spécifier un user@host qui pourra outrepasser un ban TKL placé sur une plage de host. Ceci est très utile lorsque vous voulez bannir un FAI, mais que vous voulez que certains utilisateurs spécifiques puissent toujours se connecter. La directive except::mask spécifie le masque user@host du client qui sera autorisé à se connecter. L' except::type spécifie quel type de ban pourra être outrepassé. Les types valides sont gline, gzline, qline, gqline, shun et all qui feront respectivement une exception pour les Glines, Global Zlines, Qlines, Global Qlines, Shuns et tous les types, sauf les Klines et les Zlines. Si le format {} est utilisé, plusieurs types peuvent être spécifiés.

NOTE : Si vous voulez exempter complètement un host de toutes les formes de bans possibles (sauf un ban de spamfilter), vous aurez besoin à la fois d'un bloc 'except ban' et d'un bloc 'except tkl'.

Exemple :

    except tkl {
    	mask myident@my.isp.com;
    	type gline;
    };

4.21 - Throttle Exceptions Block OPTIONNEL

Syntaxe :

    except throttle {
    	mask <ipmask>;
    };

L'except throttle block vous permet de spécifier une IP qui pourra outrepasser le throttling system. Ceci fonctionne uniquement si vous avez choisi d'activer le throttling. L'except::mask spécifie l'IP qui ne sera pas bannie à cause du throttling.

Exemple :

    except throttle {
    	mask 192.168.1.*;
    };

4.22 - Deny DCC Block OPTIONNEL (connu précédemment comme dccdeny.conf)

Syntaxe :

    deny dcc {
    	filename <file-to-block>;
    	reason <raison-du-ban>;
    	soft [yes|no];
    };

Le deny dcc block vous permet de spécifier un nom de fichier qui ne pourra être envoyé par DCC via le serveur. Ceci est très utile pour stopper la propagation de virus et/ou trojans.

Le paramètre deny::filename spécifie un masque avec joker du nom de fichier à rejeter et deny::reason spécifie la raison pour laquelle ce fichier est bloqué.

Il existe aussi une option deny::soft . Si elle a la valeur 'yes' (oui) le dcc sera bloqué à moins que l'utilisateur le permette explicitement via /DCCALLOW + pseudo-essayant-d'envoyer. Regardez le dccallow.conf pour avoir un bon exemple de configuration pour dccallow.

Exemples:

    deny dcc {
    	filename virus.exe;
    	reason "This is a GD Virus";
    };

    deny dcc {
    	filename "*.exe";
    	reason "Executable content";
    	soft yes;
    };

4.23 - Deny Version Block OPTIONNEL (connu précédemment comme V:Line)

Syntaxe :

    deny version {
    	mask <server-name>;
    	version <version-number>;
    	flags <compile-flags>;
    };

Ce bloc vous permet d'interdire à un serveur de se linker en fonction de sa version d'Unreal et des options de compilations. Le format pour ce bloc est un peu complexe mais il n'est pas trop difficile à comprendre. La directive deny::mask spécifie le nom du serveur (avec joker) auquel il s'applique.

Le deny::version spécifie le numéro de protocole de la version qu'on veut interdire. Par exemple, 3.0 est 2301, 3.1.1/3.1.2 est 2032, 3.2 est 2303. Le premier caractère de ce paramètre peut être un des suivant >, <, =, !. Ce caractère dit à l'IRCd comment interpréter la version. Si ce caractère est un > alors toutes les versions supérieures à celle spécifiée seront interdites. Si c'est un < toutes les versions inférieures seront interdites. Si c'est un = seulement cette version sera interdite. Si c'est un ! alors toutes les versions seront interdites exceptée celle spécifiée.

La directive deny::flags vous permet de spécifier quelles options de compilations flag le serveur doit ou ne doit pas avoir. Les flags sont placés l'un après l'autre sans séparation entre eux. Si un caractère est précédé d'un !, le serveur ne doit pas être compilé avec ce flag, sinon s'il n'y a pas de préfixe ! alors le serveur doit être compilé avec ce flag.

4.24 - Deny Link Block OPTIONNEL (connu précédemment comme D/d:Line)

Syntaxe :

    deny link {
    	mask <server-name>;
    	rule <crule-expression>;
    	type <type-of-denial>;
    };

Ce bloc vous permets d'utiliser des règles spécifiques pour interdire le link d'un serveur. Le deny::mask spécifie un nom de serveur (avec joker) auquel cette règle s'applique. La directive deny::rules est très complexe.

Une expression "crule" vous permet de contrôler le link en détail, et s'écrit comme une ligne d'un langage de programmation. Quatre opérateurs sont supportés :

- connected(<servermask>) : retourne vrai si un serveur correspondant au servermask est connecté
- directcon(<servermask>) : retourne vrai si un serveur correspondant au servermask est directement connecté à ce serveur
- via(<viamask>,<servermask>) : retourne vrai si un serveur correspondant au servermask est connecté sur un serveur correspondant au viamask
- directop() : si l'IRCop utilisant /connect est directement connecté sur ce serveur

Ces opérateurs peuvent être combinés en utilisant && (et) et || (ou), les items peuvent également être mis entre parenthèses pour permettre le regroupement. De plus, un opérateur précédé d'un ! vérifie si l'opérateur retourne faux. Si l'expression est évaluée comme entièrement vraie, alors le link est refusé.

Le deny::type permet deux valeurs différentes, auto (s'applique uniquement aux autoconnexions, /connect fonctionnera toujours), et all (s'applique à toutes les tentatives de connexion).

4.25 - Deny Channel Block OPTIONNEL (connu précédemment comme chrestrict.conf)

Syntaxe :

    deny channel {
    	channel "<channel-mask>";
    	reason <raison-du-ban>;
    	redirect "<channel-name>";
    	warn [on|off];
    };

Le deny channel block vous permet d'interdire aux utilisateurs de rejoindre un salon. La directive deny::channel spécifie le nom d'un salon (avec joker) que les utilisateurs ne pourront rejoindre et le deny::reason spécifie la raison pour laquelle le salon ne peut être rejoint. De plus, vous pouvez spécifier un deny::redirect. Si celui-ci est spécifié, lorsqu'un utilisateur essaye de rejoindre un salon correspondant à un deny::channel, il sera redirigé vers deny::redirect. Et il y a également deny::warn qui (si il est activé) enverra une opernotice (au EYES snomask) si un utilisateur essaye de rejoindre le salon.

Exemples :

    deny channel {
    	channel "#unrealsucks";
    	reason "No it don't!";
    };
    deny channel {
    	channel "#*teen*sex*";
    	reason "You == dead";
    	warn on;
    };
    deny channel {
    	channel "#operhelp";
    	reason "Our network help channel is #help, not #operhelp";
    	redirect "#help";
    };

4.26 - Allow Channel Block OPTIONNEL

Syntaxe :

    allow channel {
    	channel "<channel-mask>";
    };

Le allow channel block vous permet de spécifier des salons que les utilisateurs pourront joindre, même s'ils sont bloqués par un deny::channel. La directive allow::channel spécifie les noms de salon avec joker pouvant être rejoint.

Exemple :

    allow channel {
    	channel "#something";
    };

4.27 - Allow DCC Block OPTIONNEL

Syntaxe :

    allow dcc {
    	filename "<filename-mask>";
    	soft [yes|no];
    };

Le allow dcc block vous permet de spécifier des exceptions au deny dcc block, les jokers sont permis. Si allow dcc::soft est mis à 'yes' il s'applique à la liste des 'soft dcc bans', si il est mis à 'no' il s'applique à la liste des dcc bans normaux ('hard').

Exemple :

    allow dcc {
    	filename "*.jpg"; /* Les images sont généralement sans danger */
    	soft yes;
    };

4.28 - Vhost Block OPTIONNEL (connu précédemment comme vhosts.conf)

Syntaxe :

    vhost {
    	vhost <vhost>;
    	from {
    		userhost <hostmask>;
    		userhost <hostmask>;
    		...
    	};
    	login <login-name>;
    	password <password> { <auth-type>; };
    	swhois "<swhois info>";
    };

Le vhost block vous permet de spécifier un login/mot de passe pouvant être utilisé avec la commande /vhost pour obtenir un faux hostname. Le paramètre vhost::vhost peut être un user@host ou juste un host que l'utilisateur recevra après un /vhost réussi. Le vhost::from::userhost contient un user@host auquel l'utilisateur doit correspondre pour être éligible pour un vhost. Vous pouvez spécifier plus d'un hostmask.

Le vhost::login est le login que l'utilisateur doit rentrer et vhost::password est le mot de passe devant être entré Le vhost::password:: vous permet de spécifier le type d'authentification utilisé par cet élément. Voir Types d'Authentication pour la liste des types disponibles.

Enfin, vhost::swhois vous permet d'ajouter un ligne supplémentaire au whois des utilisateurs, exactement comme dans le oper block oper::swhois.

Exemple :

    vhost {
    	vhost my.own.personal.vhost.com;
    	from {
    		userhost my@isp.com;
    		userhost myother@isp.com;
    	};
    	login mynick;
    	password mypassword;
    	swhois "Im Special";
    };

4.29 - Badword Block OPTIONNEL (connu précédemment comme badwords.*.conf)

Syntaxe :

    badword <type> {
    	word <text-to-match>;
    	replace <replace-with>;
    	action <replace|block>;
    };

Le badword block vous permet de manipuler la liste utilisée pour le mode utilisateur et salon +G pour censurer les 'mauvais mots'.

badword:: spécifie le type de messages auquel ce filtre s'applique. Les types valides sont :

- `channel` s'applique aux messages à l'intérieur des salons +G
- `message` s'applique aux messages privés reçus par un utilisateur +G
- `quit` s'applique à tous les messages de quit
- `all` correspond à ces trois situations

Le badword::word peut être un simple mot ou une expression régulière à rechercher. Le badword::replace est ce par quoi le mot doit être remplacé. Si badword::replace n'est pas spécifié, le mot est remplacé par <censored>. Le badword::action défini quelle action doit être réalisée si un mauvais mots est trouvé. Si vous spécifiez replace, alors seul le mot censuré est remplacé, si vous spécifez block, le message entier sera bloqué. Si vous ne spécifiez pas de badword::action, le mot sera remplacé.

Exemple :

    badword channel {
    	word shit;
    	replace shoot;
    };

4.30 - ULines Block OPTIONNEL (connu précédemment comme the U:Line)

Syntaxe :

    ulines {
    	<server-name>;
    	<server-name>;
    	...
    };

Le ulines block vous permet de définir certains serveurs comme ayant des possibilités supplémentaires. Ceci doit uniquement être utilisé pour des serveurs comme les services et les stats. Ceci ne doit pas être appliqué à un serveur normal. Chaque entrée est le nom du serveur qui recevra les possibilités supplémentaires.

Exemple :

    ulines {
    	services.mynetwork.com;
    	stats.mynetwork.com;
    };

4.31 - Link Block OPTIONNEL (connu précédemment comme C/N/H:Lines)

Syntaxe :

    link <server-name> {
    	username <usermask>;
    	hostname <ipmask>;
    	bind-ip <ip-to-bind-to>;
    	port <port-to-connect-on>;
    	password-connect <password-to-connect-with>;
    	password-receive <password-to-receive> { <auth-type>; };
    	hub <hub-mask>;
    	leaf <leaf-mask>;
    	leafdepth <depth>;
    	class <class-name>;
    	ciphers <ssl-ciphers>;
    	options {
    		<option>;
    		<option>;
    		...
    	};
    };

C'est le bloc dont vous avez besoin pour linker les serveurs, s'il vous plaît prenez le temps de lire tout ceci car c'est l'une des parties les plus difficiles et les utilisateurs font souvent des erreurs. ;P

D'abord server-name est le nom du serveur distant, le nom que le serveur distant a dans son bloc me { }, tel que hub.blabla.com (ce n'est pas l'IP et peut être différent de l'hostname).

username
Vous pouvez le spécifier si vous utilisez l'ident pour l'authentification, normalement vous mettrez "*".

hostname
L'host ou l'IP du serveur distant. Ceci est utilisé pour la connexion et pour l'authentification / vérification du coté entrant. Quelques exemples :

1.2.3.4 | IP normale
hub.blah.com | host: seulement pour une connexion sortante, ne peut accepter de connexion entrante sans la présence de link::options::nohostcheck
* | ne peut pas se connecter mais accepte la connexion de n'importe quel serveur (avec le bon mot de passe)
::ffff:1.2.3.4 | pour linker de l'IPv6 à de l'IPv4.

bind-ip (optionnel)
Peut être utilisé pour spécifier une IP (ex. : 192.168.0.1) depuis laquelle nous devons nous connecter, presque jamais utilisé.

port
Port auquel on se connecte (celui que le serveur distant écoutera).

password-connect
Le mot de passe utilisé pour se connecter au serveur distant, doit être écrit en clair.

password-receive
Le mot de passe utilisé pour valider le lien entrant. Il est très fortement recommandé d'utiliser des mots de passe hashés ou le type d'authentification `sslclientcertfp`. Voir Types d'Authentication pour plus d'informations.

hub et leaf
Un hub a plusieurs serveurs linké à lui, un leaf n'a qu'un seul link ... vers vous. Un serveur est un leaf à moins qu'il n'ait une directive hub. C'est également un leaf si la directive leaf est *, ou si leafdepth a comme valeur 1.

hub (optionnel)
Cette valeur est un masque des serveurs auquelx ce hub peut se connecter (ex. : *.my.net).

leaf (optionnel)
Cette valeur est un masque des serveurs auquels ce hub ne peut pas se connecter. Mettre * ici sera pareil à ne pas avoir de directive hub.

leafdepth (optionnel)
Cette valeur spécifie la profondeur (nombre de sauts) que ce serveur peut avoir en dessous de lui. Par exemple, 1 signifie que le serveur ne peut avoir aucun lien en dessous de lui (un leaf), 2 signifie qu'il peut être lié à des serveurs mais que ceux-ci ne peuvent avoir rien du tout en dessous d'eux (cela signifie que ce hub peut uniquement être relié à des leaf). Une valeur de O signifie aucune limite, et c'est la valeur par défaut.

class
La classe dont ce serveur fait partie, souvent une classe de serveurs séparée est utilisé pour ceci.

compression-level (optionnel)
Spécifie le taux de compression (1-9) pour ce link. Seulement utilisé si link::options::zip est activé.

ciphers (optionnel)
Specifie le chiffrement SSL a utiliser pour ce link. Pour obtenir une liste des chiffrements disponibles, utilisez la commande `openssl ciphers`. Les chiffrement doivent être spécifiés comme une liste séparée par des `:` .

options block
Une ou plusieurs options utilisées pour se connecter à ce serveur. Parfois non requises.

ssl | si vous êtes connecté à un port ssl.
autoconnect | le serveur essayera de se connecter automatiquement, la fréquence est spécifiée dans votre class::connfreq (il est mieux d'activer ceci seulement dans un sens, comme leaf->hub)
zip | si vous voulez des links compressés, vous devez compiler les deux serveurs concernés avec l'option zip activé
nodnscache | ne pas mettre en cache l'IP pour les connexions des serveurs sortants, utilisez cela pour des serveurs dont l'host change souvent (comme dyndns.org)
nohostcheck | ne pas valider l'host distant (link::hostname), utilisez cela pour des serveurs dont l'host change souvent (comme dyndns.org)
quarantine | les opers sur ce serveur ne pourront pas accéder au status de globop (ils seront killés), utilisés pour tester des serveurs et autres.

Exemple :

    link hub.mynet.com {
    	username *;
    	hostname 1.2.3.4;
    	bind-ip *;
    	port 7029;
    	hub *;
    	password-connect "LiNk";
    	password-receive "LiNk";
    	class servers;
    	options {
    		autoconnect;
    		ssl;
    		zip;
    	};
    };

4.32 - Alias Block OPTIONNEL

Syntaxe des alias standards :

    alias <name> {
    	target <nick-to-forward-to>;
    	type <type-of-alias>;
    	spamfilter <yes|no>;
    };

(Note 1 : la notation "alias::" fait référence à <name>)
(Note 2 : référez-vous à la direction include pour une description des fichiers d'alias dont UnrealIRCd dispose)

Le bloc alias (alias standard) vous permet de rediriger une commande à un utilisateur, par exemple /chanserv envoie un message à l'utilisateur chanserv.

- alias:: indique le nom de la commande qui servira d'alias (par exemple : chanserv)
- alias::target est le pseudo ou le salon dans lequel ce sera redirigé. Si alias:: est identique au nom de la cible, alias::target peut être omis.
- alias::type spécifie le type de l'alias. Les types valides sont :
  - services (l'utilisateur est sur le serveur des services)
  - stats (l'utilisateur est sur le serveur de statistiques)
  - normal (l'utilisateur est un utilisateur normal sur n'importe quel serveur)
  - channel (la cible est un salon)
  - command (ceci n'est pas un "alias standard", voirci-après)
- alias::spamfilter (optionnel) : si défini sur yes (oui), le message sera vérifié par Spamfilter (valeur par défaut : 'no').

Syntaxe des alias de commandes :

    alias <name> {
    	/* Pour un alias à envoyer aux utilisateurs/salons (alias standard) */
    	format <regex-expression> {
    		target <pseudo-sur-lequel-redirigernick-to-forward-to>;
    		type <type-of-alias>;
    		parameters <parameter-string>;
    	};

    	/* Pour les 'vrais alias' (alias de commande) */
    	format <regex-expression> {
    					command <command>;
    					type real;
    					parameters <parameter-string>;
    	};

    	/* Etc... Vous pouvez avoir autant de bloc format que nécesaire ... */
    	format <regex-expression> {
    		...
    	};

    	type command;
    	spamfilter <yes|no>;
    };

Lorsqu'un alias block a un alias::type avec la valeur command, comme montré ci-dessus, il devient un alias de commande. Utilisé dans ce format, le bloc devient beaucoup plus flexible. Par exemple, vous pouvez créer une commande /identify avec.

- alias:: indique le nom de la commande qui sert d'alias, comme pour un alias standard.
- alias::format spécifie une expression régulière qui sert à tester les arguments envoyés sur la commande qui sert d'alias. Le sous-bloc du premier alias::format rencontré correspondant aux paramètres sera utilisé. Par conséquent, vous pouvez avoir plusieurs alias::format pour que la commande fasse des choses différentes en fonction des paramètres qu'elle reçoit.
- alias::format::target est la cible à laquelle l'alias est envoyé. Cette valeur n'est pas utilisée si alias::format::type est défini sur "real".
- alias::format::type spécifie le type de la cible à laquelle l'alias est envoyé. En plus des types mentionnés pour les alias standards, le type "real" peut être utilisé pour un "vrai alias" (un alias qui peut être autre chose qu'une commande PRIVMSG).
- alias::format::parameters (pour les "vrais alias") est ce qui sera envoyé à la commande comme paramètres.
  Pour spécifier un des paramètres envoyés à l'alias, utilisez % suivi du nombre correspondant à la place du paramètre. Par exemple, %1 correspond au premier paramètre.
  Pour récupérer tous les paramètres à partir d'un certain rang, utilisez % suivit du rang en question puis de -. Par exemple, %2- retourne tous les paramètres du deuxième jusqu'au dernier.
  De plus, vous pouvez utiliser %n qui sera remplacé par le pseudo de l'utilisateur exécutant la commande.

Pour des exemples d'utilisation des alias blocks dans le format des alias de commandes, regardez doc/example.fr.conf.

4.33 - Help Block OPTIONNEL

Syntaxe :

    help <name> {
    	<text-line>;
    	<text-line>;
    	...
    };

(Note : normalement vous ne faites qu'inclure help.conf)

L'help block vous permet des créer des entrées à utiliser dans /helpop. L' help:: est la valeur qui doit être passée en paramètre de /helpop, si help:: est laissé vide, alors il sera utilisé lorsqu'aucun paramètre n'est précisé pour /helpop.

Les entrées pour l'help block sont les textes qui seront affichés lorsque l'utilisateur utilisera /helpop.

4.34 - Official Channels Block OPTIONNEL

Syntaxe :

    official-channels {
    	"#channel" { topic "The default topic"; };
    };

Les salons officiels sont affichés dans /list même si aucun utilisateur n'y est présent. Le topic est optionnel et n'est montré dans la /list que si il n'y a aucun utilisateur (sinon, le topic courant du salon sera utilisé).

Exemple :

    official-channels {
    	"#Help" { topic "The official help channel, if nobody is present type /helpop helpme"; };
    	"#Home";
    	"#Main" { topic "The main channel"; };
    };

4.35 - Spamfilter Block OPTIONNEL

Le spamfilter block vous permet d'ajouter un filtre anti-spam local (pas au niveau du réseau).
Voir cette section pour plus d'information à propos des filtres anti-spam.

Syntaxe :

    spamfilter {
    	regex <word>;
    	target { <target(s)> };
    	action <action>;
    	reason <reason>;
    	ban-time <time>;
    };

regex est l'expression régulière à lauqlle le mot doit correspondre.
target spécifie les cibles, reportez-vous ici pour obtenir la liste des types disponibles (ex: 'channel').
action spécifie l'action à effectuer, reportez-vous ici pour obtenir la liste des types disponibles (ex: 'gline')
reason (optionnel) : spécifie la raison du ban ou du blocage, sinon la raison par défaut est utilisée.
ban-time (optionnel) : spécifie la durée d'un ban *line ou d'un shun, sinon la valeur par défaut est utilisée (1 jour).

Exemples :

    spamfilter {
    	regex "Come watch me on my webcam";
    	target { private; channel; };
    	action gline;
    	reason "You are infected, please go to www.antivirus.xx/blah/virus=GrrTrojan";
    	ban-time 6h;
    };

    spamfilter {
    	regex "come to irc\..+\..+";
    	target { private; channel; };
    	action gline;
    	action gline;
    	reason "No spamming allowed";
    };

4.36 - Cgiirc Block OPTIONNEL

Le bloc cgiirc vous permet de configurer l'host spoofing pour les passerelles CGI:IRC auquelles vous faites confiance (plus d'info).

Syntaxe :

    cgiirc {
    	type <webirc|old>;
    	username <mask>; /* optionnel */
    	hostname <mask>;
    	password <password>; /* seulement pour le type webirc */
    };

type peut être 'webirc' ou 'old'.
username est comparé avec l'ident (si il est présent). Si il n'est pas spécifié, il est supposé égal à "*".
hostname est l'hostmask auquel il faut correspondre.
password est le mot de passe webirc, uniquement utilisé pour le type 'webirc'.

Comment configurer avec la méthode 'webirc' ? (méthode recommandée)
Dans votre fichier de configuration de CGI:IRC (cgiirc.conf) vous assignez à webirc_password un bon mot de passe.
Ensuite, dans votre unrealircd.conf vous ajoutez un bloc cgiirc pour permettre cet host et ce mot de passe et vous donnez à cgiirc::type la valeur "webirc".

Exemple :
Dans votre fichier de configuration de CGI:IRC (cgiirc.conf) vous ajoutez :

    webirc_password = LpT4xqPI5

Ensuite, dans votre unrealircd.conf vous ajoutez un bloc cgiirc :

    cgiirc {
    	type webirc;
    	hostname "1.2.3.4";
    	password "LpT4xqPI5";
    };

Comment configurer avec la méthode 'old' ?
Note : Ce n'est pas la méthode recommandée car elle a deux désavantages : cette méthode va envoyer l'IP/host à transmettre à la place du mot de passe serveur, signifiant que vous ne pouvez pas spécifier un mot de passe serveur en tant qu'utilisateur de CGI:IRC. De plus, le contrôle des accès est uniquement basé sur les IP et ne nécessite pas de mot de passe supplémentaire comme la méthode 'webirc'. En résumé, vous ne devriez pas utiliser cette méthode sauf en cas de bonne raison.

Dans votre fichier de configuration de CGI:IRC (cgiirc.conf) vous assignez à realhost_as_password la valeur 1.
Ensuite, dans votre unrealircd.conf vous ajoutez un bloc cgiirc pour permettre cet host.

Exemple :
Dans votre fichier de configuration de CGI:IRC (cgiirc.conf) vous ajoutez :

    realhost_as_password = 1

Ensuite, dans votre unrealircd.conf vous ajoutez un bloc cgiirc :

    cgiirc {
    	type old;
    	hostname "1.2.3.4";
    };

4.37 - Set Block OBLIGATOIRE (connu précédemment comme unrealircd.conf/networks file)

Sur des réseaux composés d'un seul serveur, plutôt que d'avoir 3 fichiers idfférents, vous pouvez mettre tout mettre dans unrealircd.conf. Sur des réseaux de plusieurs serveurs, nous vous recommandons d'utiliser un fichier networks distint (voir ci-dessus).

Si votre serveur est sur un réseau, il y a des chances que vous utilisiez le même set block pour tous les serveurs. Par conséquent, il est plus logique d'avoir un fichier networks, qui sera inclus avec la directive include. Vous trouverez la liste de toutes les directives set disponibles ci-dessous.

Dans cette documentation, nous nous référons aux réglages / directives avec la notation <block-name>::<block-directive>. Ce format n'est pas celui à utiliser dans le fichier de configuration ! Il doit être converti dans le format ci-dessous :

Syntaxe :

    set {
    	<entry> <value>;
    	<entry> <value>;
    	...
    };

Le set block définit des options pour des fonctionnalités indépendantes. Chaque entrée fait quelque chose de différent et donc toutes seront décrites ici. Certaines directives ont des sous-blocs qui seront aussi décrits.

Il y a beaucoup de réglages différents à couvrir, toutes les directives ci-dessous peuvent être placées dans le même bloc set. Si une directive a des options, celles-ci sont à préciser dans cet unique bloc set.

Exemple :

    set {
    	kline-address my@emailaddress.com;
    	auto-join #welcome;
    	options {
    		hide-ulines;
    	};
    	hosts {
    		local LocalOp.MyNet.com;
    		global globalop.mynet.com;
    	};
    };

Maintenant, si vous voulez faire des blocs set séparés, préférez la notation sur une seule ligne.
Exemple :

    set { options { hide-ulines; show-connect-info; }; };

set::kline-address <email-address>;
L'adresse email à laquelle doivent être envoyées les questions sur les K:line. Cette valeur doit être spécifiée.

set::gline-address <email-address>;
L'adresse email à laquelle doivent être envoyées les questions sur les G:line.

set::modes-on-connect <+modes>;
Les modes qui seront appliqués à un utilisateur à la connexion.

set::snomask-on-connect <+modes>
Les snomask qui seront appliqués à un utilisateur à la connexion.

set::modes-on-oper <+modes>;
Les modes qui seront appliqués à un utilisateur lorsqu'il s'/oper.

set::snomask-on-oper <+modes>;
Les snomask qui seront appliqués à un utilisateur lorsqu'il s'/oper.

set::modes-on-join <+modes>;
Les modes qui seront appliqués à un salon lors de sa création. Tous les modes ne peuvent pas être utilisés par cette commande. +qaohvbeOAzlLk ne peuvent être appliqués par cette commande.

set::level-on-join <none|voice|halfop|op|protect|owner>;
Le mode qui sera appliqué à un utilisateur lorsqu'il sera le premier à rejoindre le salon. La valeur par défaut est 'op' (opérateur du salon).

set::restrict-usermodes <modes>
Empêche les utilisateurs d'appliquer / enlever les usermodes listés ici (n'utilisez pas + ou -). Par exemple, vous pouvez mettre le +G en modes-on-connect et G en restrict-usermodes, de cette façon vous obligez tous les utilisateurs à avoir le mode +G et les empêcher de se mettre en -G.

set::restrict-channelmodes <modes>
Empêche les utilisateurs d'appliquer / enlever les modes de salon listés ici (n'utilisez pas + ou -). Par exemple, vous pouvez mettre le +G en modes-on-join et G en restrict-channelmodes, de cette façon vous obligez tous les (nouveaux) salons à avoir le mode +G et les empêcher de se mettre en -G.
NOTE : il peut toujours être possible d'utiliser ces modes de salon en passant par les services (en utilisant MLOCK). Malheureusement, nous ne pouvons pas faire grand chose pour l'empêcher, vous devrez demander aux codeurs de vos services d'implémenter une option restrict-channelmodes également.

set::restrict-extendedbans <types|*>
Ne permet pas aux utilisateurs d'utiliser des bans étendus ("*") ou en empêche certains (ex. : "qc").

set::auto-join <channels>;
Les salons qu'un utilisateur est forcé de rejoindre à la connexion. Pour spécifier plus d'un salon, utilisez une virgule pour les séparer.
Note : n'oubliez pas d'ajouter des quotes comme : auto-join "#chan";

set::oper-auto-join <channels>;
Les salons qu'un utilisateur sera forcé de rejoindre après /oper. Pour spécifier plus d'un salon, utilisez une virgule pour les séparer.
(Note: n'oubliez pas d'ajouter des quotes comme : oper-auto-join "#chan";)

set::anti-spam-quit-message-time <timevalue>;
Cette durée spécifie la durée minimale pendant laquelle l'utilisateur doit être connecté avant de pouvoir afficher un message /quit. Utilisé pour prévenir le spam. Une durée est une valeur numérique avec d pour jour, h pour heure, m pour minutes, et s pour secondes, par exemple 1d2h3m signifie 1 jour, 2 heures, 3 minutes.

set::prefix-quit <text-to-prefix-quit>;
Définit le texte qui sera affiché devant le message de quit. Si la valeur est 0, alors le texte standard "Quit:" sera appliqué.

set::static-quit <quit message>;
Définit le message de quit qui sera envoyé quelque soit le message envoyé par le client lorsqu'il quitte le réseau. Ceci élimine le besoin de recourir à l'anti-spam-quit-message-time, ainsi que le set::prefix-quit. Cela NE remplacera PAS les ERREURS par le message static-quit.

set::static-part <no|yes|part message>;
Le 'yes' empêchera toutes les raisons de part, le 'no' laissera fonctionner les part comme d'habitude, n'importe quoi d'autre sera utilisé comme commentaire de part (ex. : static-part "Bye!") mais ca peut être assez ennuyeux, alors utilisez le prudemment.

set::who-limit <limit>;
Définit le nombre maximum de réponses retournées lors d'un /who. Si cette option n'est pas spécifiée, il n'y aura pas de limite.

set::silence-limit <limit>;
Définit le maximum d'entrées dans la SILENCE list. Si la directive n'est pas spécifiée, une limite de 15 sera appliquée.

set::maxbans <limit>;
Fixe une limite pour le nombre maximum de ban (+b) autorisés par salon. La valeur par défaut est 60. Si vous la changez, prennez également attention au maxbanlength (voir ci-après) !

set::maxbanlength <limit>;
Similaire au précédent, mais fixe le nombre maximum de caractères pour tous les bans ajoutés l'un à l'autre. Donc, en pratique, ceci fixe une limite sur la quantité (semi-)maximum de mémoire que tous les bans sur un salon peuvent prendre. La valeur par défaut est 2048 (bytes). Avec une valeur par défaut pour le set::maxbans de 60 ceci permet 2048:60=34 caractères par ban en moyenne.

set::oper-only-stats <stats-list>;
Spécifie une liste de flags stats (sans séparateur) qui définit les flags stats que seuls les opérateurs pourront utiliser. Ne donnez pas de valeur si vous voulez permettre aux utilisateurs d'utiliser tous les flags, ou spécifiez * pour que les utilisateurs ne puissent en utiliser aucun. Seuls les flags stats courts peuvent être utilisés ici.

set::oper-only-stats {<stats-flag>; <stats-flag>;};
Spécifie une liste de flags stats pouvant être utilisés uniquement par les opérateurs. Ceci ne marche qu'avec les flags stats longs.

set::maxchannelsperuser <amount-of-channels>;
Spécifie le nombre de salons sur lesquels un utilisateur peut être en même temps.

set::maxdccallow <amount-of-entries>;
Spécifie le nombre maximum d'entrées qu'un utilisateur peut avoir dans sa liste DCCALLOW.

set::channel-command-prefix <command-prefixes>;
Spécifie les caractères de préfixe pour les commandes de salon des services. Les messages commençant par l'un des caractères spécifiés seront envoyés même si le client est en +d. La valeur par défaut est "`!.".

set::allowed-nickchars { <list> };
Jeux de caractères autorisés dans les pseudos, voir Caractères admis dans les pseudos.

set::allow-userhost-change [never|always|not-on-channels|force-rejoin]
Spécifie ce qu'il arrive quand un user@host change (+x/-x/chghost/chgident/setident/vhost/etc).
never supprime toutes les commandes, always le permet toujours même si le client est sur un salon (peut causer le desync du client) [défaut] not-on-channels le permet uniquement si l'utilisateur n'est sur aucun salon, force-rejoin forcera à rejoindre tous les salons avec re-op/voice/etc si nécessaire.

set::options::hide-ulines;
Si il est présent, les serveurs avec Uline seront cachés dans une requête /links envoyée par les non-opers.

set::options::flat-map;
Si il est présent, tous les serveurs apparaîtront comme directement linkés dans /map et /links, ainsi vous ne pourrez plus voir quel serveur est linké directement auquel. C'est une petite aide contre les attaque (D)DoS parce que les personnes mal-intentionnées ne peuvent plus voir facilement les 'points faibles'.

set::options::show-opermotd;
Si il est présent, l'opermotd sera montré aux utilisateurs une fois qu'ils se seront /oper avec succès.

set::options::identd-check;
Si il est présent, la présence d'un serveur d'identd sera vérifiée et la valeur retournée sera utilisée comme username. Si aucune requête d'ident n'est retournée ou si le serveur d'identd n'existe pas, l'username de l'utilisateur spécifié sera préfixé d'un ~. Si cette valeur est omise, aucune vérification ne sera faite.

set::options::show-connect-info;
Si il est présent, les notices "ident request", "hostname lookup", etc seront affichées à la connexion de l'utilisateur.

set::options::dont-resolve;
Si il est présent, les hosts des utilisateurs entrants ne seront pas résolus, peut être utile si beaucoup de vos utilisateur n'ont pas d'host pour accélérer la connexion.
Notez que depuis que le 'non resolving' existe vous pouvez également avoir des allow blocks basés sur les hosts.

set::options::mkpasswd-for-everyone;
Fait en sorte que le /mkpasswd puisse être utilisé par tout le monde à la place des opers uniquement, l'usage de cette commande par les non-opers est envoyé aux EYES snomask.

set::options::allow-part-if-shunned;
Permet aux utilisateurs shun d'utiliser /part.

set::options::fail-oper-warn;
Si il est présent, un utilisateur sera prévenu que sa tentative de /oper manquée a été enregistrée.

set::options::allow-insane-bans;
Autorise des bans étendus déraisonables tels que /GLINE *@*.fr Avec ceci, vous pouvez très facilement bannir tout le monde de votre réseau, donc faites très attention !

set::options::disable-cap;
Désactive les Client Capabilities Extensions (CAP). Notez que ceci rend SASL et d'autres fonctionnalités indisponibles ou plus difficiles à utiliser pour les clients.

set::nopost::ban-action (requière m_nopost)
Action à effectuer si un utilisateur essaye d'utiliser une commande HTTP POST. Les valeurs autorisées sont : kill, gline, gzline, kline, zline, shun et tempshun. La valeur par défaut est kill. Si vous utilisez une *line ou shun, prenez note que si un utilisateur crédule s'est fait piéger et visite un site générant une attaque XPS IRC spamming, il sera affecté par le shun ou la *line sur toutes ses autres connexions. La valeur par défaut kill évite ce genre d'accidents, mais l'utilisation d'une *line et surtout d'une gzline peut être nécessaire dans certains cas.

set::nopost::ban-reason (requière m_nopost)
La raison du ban à utiliser lorsque m_nopost déconnecte ou bannit un utilisateur.

set::nopost::ban-time (requière m_nopost)
La durée des shuns, glines, gzlines, klines et zlines placés par m_nopost. La valeur par défaut est 4h.

set::nopost::except-hosts (requière m_nopost)
Une liste des hostmasks exemptés des kill et des *lines de m_nopost. Vous ne devriez jamais avoir besoin d'utiliser cette option.

set::dns::timeout <timevalue>; (PAS IMPLEMENTE)
Une valeur de temps spécifie la durée qu'un serveur DNS a pour répondre. Une valeur de temps est un numérique avec d pour jour, h pour heure, m pour minutes, et s pour secondes, par exemple 1d2h3m signifie 1 jour, 2 heures, 3 minutes.

set::dns::retries <number-of-retries>; (PAS IMPLEMENTE)
Une valeur numérique spécifie le nombre de fois que la résolution de DNS reprendra en cas d'échec.

set::dns::nameserver <name-of-dns-server>; (PAS IMPLEMENTE)
Spécifie l'hostname du serveur qui sera utilisé pour la résolution de DNS.

set::dns::nameserver <name-of-dns-server>;
Spécifie l'adresse IP du serveur qui sera utilisé pour la résolution DNS. N'est utilisé que si c-ares n'arrive pas à deviner les serveurs de noms (par exemple car /etc/resolv.conf est vide).

set::dns::bind-ip <ip>;
Spécifie l'IP à relier au résolveur, presque jamais requis.

set::network-name <name-of-network>;
Spécifie le nom du réseau sur lequel ce serveur tourne. Cette valeur devrait être exactement la même sur tous les serveurs d'un réseau.

set::default-server <server-name>;
Défini le nom au serveur par défaut à indiquer aux utilisateurs pour se connecter si celui-ci est plein.

set::default-ipv6-clone-mask
Le masque de détection des clônes IPv6 par défaut. Voir allow::ipv6-clone-mask. La valeur par défaut est 64.

set::services-server <server-name>;
Indique le nom du serveur auquel les bots des services sont connectés. C'est un paramètre obligatoire, donc mettez quelque chose comme services.votrereseau.com si vous n'avez pas de services.

set::stats-server <server-name>;
Indique le nom du serveur auquel le bot des statistiques se connecte. S'il n'y a pas de statistiques, cette valeur peut être omise.

set::sasl-server <server-name>;
Indique le nom du serveur auquel les messages d'authentification SASL doivent être envoyés.

set::help-channel <network-help-channel>;
Spécifie le nom du salon d'aide du réseau.

set::cloak-keys { "key1"; "key2"; "key3"; };
Spécifie les clés qui seront utilisés pour générer les +x hosts. Cette valeur doit être la même sur tous les serveurs d'un réseau. Si ce n'est pas le cas, les serveurs ne pourront plus linker. Les 3 set::cloak-keys:: doivent être des strings de 5 à 100 caractères (10 à 20, c'est bien), elles doivent contenir des minuscules (a-z), des majuscules (A-Z) et des chiffres (0-9). Noter que cela dépend du module de cloaking que vous utilisez, d'autres règles peuvent être appliquées.

set::hiddenhost-prefix <prefix-value>;
Définit le préfixe utilisé pour les +x hosts. Il est généralement composé de trois ou quatre lettres représentant le nom du réseau. Les différents serveurs d'un réseau doivent avoir le même hiddenhost-prefix pour que les bans des salons fonctionnent correctement.

set::hosts::local <locop-host-name>;
Définit l'hostname qui sera assigné aux opérateurs locaux quand ils se mettent le umode +x. Vous pouvez optionnellement specifier un username@host pour cette valeur.

set::hosts::global <globop-host-name>;
Définit l'hostname qui sera assigné aux opérateurs globaux quand ils se mettent le umode +x. Vous pouvez optionnellement specifier un username@host pour cette valeur.

set::hosts::coadmin <coadmin-host-name>;
Définit l'hostname qui sera assigné aux co-admins quand ils se mettent le umode +x. Vous pouvez optionnellement specifier un username@host pour cette valeur.

set::hosts::admin <admin-host-name>;
Définite l'hostname qui sera assigné aux admins quand ils se mettent le umode +x. Vous pouvez optionnellement specifier un username@host pour cette valeur.

set::hosts::servicesadmin <servicesadmin-host-name>;
Définit l'hostname qui sera assigné aux services-admins quand ils se mettent le umode +x. Vous pouvez optionnellement specifier un username@host pour cette valeur.

set::hosts::netadmin <netadmin-host-name>;
Définit l'hostname qui sera assigné aux netadmins quand ils se mettent le umode +x. Vous pouvez optionnellement specifier un username@host pour cette valeur.

set::hosts::host-on-oper-up <yes/no>;
Si vous mettez yes, le flag H/get_host sera honoré et le umode +x sera automatiquement mis quand vous vous /oper. Si vous mettez no, l'utilisateur doit se mettre le umode +x manuellement pour recevoir l'oper host.

set::ssl::egd <filename>;
Spécifie que le support de l'EGD (Entropy Gathering Deamon) devrait être activé. Si vous utilisez OpenSSL 0.9.7 ou une version postérieure, alors /var/run/egd-pool, /dev/egd-pool, /etc/egd-pool et /etc/entropy seront recherchés par défaut donc aucun nom de fichier n'est nécessaire, vous pouvez simplement spécifier set::ssl::egd sans valeur. Si vous utilisez une version d'OpenSSL antérieure à la 0.9.7 ou vous voulez utiliser un socket EGD placé ailleurs que dans la liste des emplacements listés ci-dessus, vous pouvez spécifier le nom de fichier de l'UNIX Domain Socket qu'un EGD écoute.

set::ssl::certificate <filename>;
Spécifie le nom de fichier où le certificat SSL du serveur est situé.

set::ssl::key <filename>;
Spécifie le nom de fichier où la clé privée SSL du serveur est située.

set::ssl::trusted-ca-file <filename>;
Spécifie le nom de fichier où les certificats des CAs de confiance sont stockés.

set::ssl::server-cipher-list <cipherlist>;
Spécifie quel chiffrement est autorisé, par défaut, on laisse ce choix à OpenSSL. Voir http://www.openssl.org/docs/apps/ciphers.html pour savoir comment spécifier une liste de chiffrement.

set::ssl::renegotiate-bytes <value>;
Spécifie après combien d'octets une session SSL devrait être renégotiée (ex: 20m pour 20 Mo).

set::ssl::renegotiate-timeout <timevalue>;
Spécifie après combiend de temps une session SSL devrait être renégotiée (ex: 1h pour 1 heure).

set::ssl::options::fail-if-no-clientcert;
Refuse les connexions de clients qui n'ont pas de certificat.

set::ssl::options::no-self-signed;
Refuse les connexions de clients avec des certificats auto-signés.

set::ssl::options::verify-certificate;
Force Unreal à vérifier si le certificat SSLÂ est valide avant d'accepter une connexion.

set::ssl::options::no-starttls;
Désactive le STARTTLS. STARTTLS autorise les clients à utiliser SSL sur des ports normaux (non SSL).

set::throttle::period <timevalue>
Combien de temps un utilisateur doit attendre avant de se reconnecter plus que set::throttle::connections fois.

set::throttle::connections <amount>;
Combien de fois un utilisateur doit se connecter avec le même host avant d'être bloqué par le throttle.

set::ident::connect-timeout <amount>;
Nombre de secondes avant de renoncer à la connexion au serveur d'ident (défaut : 10s).

set::ident::read-timeout <amount>;
Nombre de secondes avant de renoncer à une réponse du serveur d'ident (défaut : 30s).

set::anti-flood::unknown-flood-bantime <timevalue>;
Spécifie combien de temps une connexion inconnue d'un floodeur est bannie.

set::anti-flood::unknown-flood-amount <amount>;
Spécifie la quantité de données (en kilo-octets) que la connexion inconnue doit envoyer pour que l'utilisateur soit killé.

set::anti-flood::away-flood <count>:<period>
Protection contre le flood d'away : limite le nombre de /away par "périod" (en secondes). Ceci réclame que le NO_FLOOD_AWAY soit activé dans le config.h. Exemple : away-flood 5:60s; signifie maximum 5 changements en 60 secondes.

set::anti-flood::nick-flood <count>:<period>
Protection contre le NickFlood : limite le nombre de changements de pseudo par "period" en secondes. Par exemple nick-flood 4:90 signifie 4 en 90 secondes, le défaut est 3 en 60 secondes.

set::default-bantime <time>
Le bantime par défaut quand vous faites /kline, /gline, /zline, /shun, etc sans paramètre de temps (comme /gline *@some.nasty.isp), par défaut, celui ci est permanent (0). Exemple: default-bantime 90d;

set::modef-default-unsettime <value>
Pour le chmode +f vous pouvez spécifier un unsettime par défaut, si vous spécifiez 10 par exemple, alors +f [5j]:15 sera transformé en [5j#i10]:15. La valeur par défaut est pas d'unsettime.

set::modef-max-unsettime <value>
Le nombre maximum de minutes pour l'unsettime du mode +f (dans +f [5j#i<TIME>]:15), c'est une valeur comprise entre 0 et 255. Par défaut, ceci est à 60 (= 1 heure).

set::ban-version-tkl-time <value>
Si vous spécifiez une 'action' comme zline/gline/etc dans les ban version, alors vous pouvez spécifier ici combien de temps l'ip va être bannie, par défaut, ceci est mis à 86400 (1 jour).

set::spamfilter::ban-time <value>
Même chose qu'au dessus mais pour les *lines/shuns ajoutés par le spamfilter.

set::spamfilter::ban-reason <reason>
La raison utilisée pour l'ajout de bans par le spamfilter.

set::spamfilter::virus-help-channel <channel>
Le salon a utiliser pour l'action 'viruschan' dans le spamfilter.

set::spamfilter::virus-help-channel-deny <yes|no>
Si vous mettez yes (ou "1") cela enverra "invite only" à tous les utilisateurs normaux essayant de rejoindre le virus-help-channel. Seuls les opérateurs, les personnes forcé par le spamfilter et les personnes qui sont /invite peuvent le rejoindre.

set::spamfilter::except <target(s)>
Ces cibles sont exemptés du spamfilter (aucun filtre ne sera appliqué), cela peut être une simple cible, ou une liste séparé par des virgules. Ex: except "#help,#spamreport".

set::spamfilter::slowdetect-warn <value>
Si un filtre de spamfilter prend plus de temps que cette durée en millisecondes (1000ms = 1s) pour s'exécuter, alors un avertissement sera envoyé à tous les opérateurs (par défaut : 250). Voir aussi Slow Spamfilter Detection.

set::spamfilter::slowdetect-fatal <value>
Si un filtre de spamfilter prend plus de temps que cette durée en millisecondes (1000ms = 1s) pour s'exécuter, alors ce filtre sera enlevé (default: 500). Voir aussi Slow Spamfilter Detection.

set::check-target-nick-bans <yes|no>
A chaque fois qu'un utilisateur change son pseudo, vérifie si le nouveau pseudo est banni. Si c'est le cas, le changement de pseudo n'est pas autorisé. La valeur par défaut est "yes".

set::timesynch::enabled <yes|no>
Active ou désactive la synchronisation du temps au démarrage. Yes par défaut.

set::timesynch::server <IP>
Serveur avec lequel synchroniser le temps. Peut comporter jusqu'à 4 IP séparées par des virgules. Les serveurs doivent supporter le protocole NTP version 4. La valeur par défaut est le support de 3 serveurs (US, EU, AU). Les requètes sont envoyées en parallèle, celui qui répond le plus rapidement gagne.

set::timesynch::timeout <time>
Durée maximum pendant laquelle attendre la réponse du serveur. Cette valeur est entre 1 et 5, plus ce n'est pas possible car cela crée trop d'incohérences. Ce paramètre est réglé par défaut à 3 et il n'y a a priori aucune bonne raison de la changer.

set::ping-cookie <yes|no>
Envoie un challenge avec PING, auquel les clients répondent par un PONG. Très utile pour éviter entre autres des attaques par HTTP-POST, ainsi que pour empêcher le spoofing TCP sur d'anciens systèmes d'exploitation avec des piles TCP bugguées. La valeur par défaut est 'yes'.

set::pingpong-warning <yes|no>
Lorsque set::ping-cookie est activé (généralement sous Windows), envoie un avertissement à chaque utilisateur, d'utiliser '/quote pong ...' si ils ont des problèmes pour se connecter. La valeur par défaut est 'no'.

set::watch-away-notification <yes|no>
Vous permet d'activer et de désactiver les notifications d'AWAY dans WATCH. La valeur par défaut est 'yes'.

4.38 - Files Block OPTIONNEL

Vous n'avez pas besoin d'utiliser un TLD block pour vos fichiers de MOTDs et de règles. Ce bloc définit les paramètres par défaut pour ceux-ci, en plus du pidfile et du fichier irc.tune. Tout ce qui n'est pas indiqué ici aura pour valeur par défaut celle mentionnée dans la section Fichiers Additionnels.

Les chemins relatives seront interprétés par rapport au dossier racine de UnrealIRCd, qui est normalement celui contenant `unrealircd.conf`. Ce bloc peut être utilisé pour exécuter plus d'une instance de IRCd depuis le même répertoire. Dans ce cas, vous devriez au moins spécifier un pidfile et un irc.tune pour chaque serveur.

Syntaxe :

    files {
    	motd <motd file>;
    	shortmotd <short motd file>;
    	opermotd <oper motd file>;
    	svsmotd <services motd file>;
    	botmotd <bot motd file>;

    	rules <rules file>;

    	tunefile <tune file>;
    	pidfile <pid file>;
    };

Exemple :

    files {
    	motd /etc/motd;
    	pidfile /var/lib/run/unrealircd.pid;
    };

5 – Fichiers additionnels

En plus des fichiers de configuration, Unreal compte quelques autres fichiers comme MOTD, OperMOTD, BotMOTD et les règles (Rules). Ci-dessous ce trouve la liste des fichiers et leurs utilités.
Notez que les fichiers motd (tous les types) et les fichiers de règles peuvent aussi être spécifiés dans un tld block ou un files block, ce sont juste les fichiers utilisés par défauts (et pour les MOTD / Rules distants).

ircd.motd | Affiché lorsqu'un /motd est exécuté et (si ircd.smotd n'est pas présent) lorsqu'un utilisateur se connecte
ircd.smotd | Affiché à la connexion uniquement (MOTD court)
ircd.rules | Affiché lorsqu'un /rules est exécuté
oper.motd | Affiché lorsqu'un /opermotd est exécuté ou lorsqu'un utilisateur s'identifie avec /oper
bot.motd | Affiché lorsqu'un /botmotd est exécuté

6 – Modes des salons et des utilisateurs

Modes des salons
Mod | Description
--- | ---
A | Seuls les administrateurs peuvent rejoindre le salon
a <nick> | Rend l'utilisateur administrateur du salon
b <nick!user@host> | Banni du salon l'utilisateur spécifié
c | Aucune couleur ANSI ne peut être envoyé sur le salon
C | Aucun CTCP n'est accepté sur le salon
e <nick!user@host> | Exception ban : l'utilisateur spécifié peut rejoindre le salon même s'il en est banni
f [<number><type>]:<seconds> | Protection des salons contre le flood. Voir la section 3.12.
G | Applique le remplacement des mots spécifiés dans les Badword Blocks.
h <nick> | Donne le statut de half-op à l'utilisateur
i | Le salon ne peut être rejoint que sur invitation
I <nick!user@host> | Invite exceptions ("invex") - Si quelqu'un correspond à ceci, il pourra outrepasser le +i pour entrer sur le salon.
j <joins:secondes> | Limite les joins par utilisateur à joins par secondes secondes
K | /knock n'est pas autorisé
k <key> | Attribue un mot de passe à spécifier pour rejoindre le salon
l <##> | Spécifie le nombre maximum d'utilisateurs
L <Chan> | Si le maximum spécifié par +l est atteint, les utilisateurs seront redirigés vers ce salon
M | Seuls les utilisateurs dont le pseudo est enregistré (+r) peuvent parler sur le salon
m | Salon modéré. Seuls les utilisateurs +v/h/o/a/q peuvent parler
N | Aucun changement de pseudo n'est autorisé
n | Aucun message ne peut être envoyé de l'extérieur du salon
O | Seuls les IRCops peuvent joindre le salon
o <nick> | Donne le statut d'opérateur à l'utilisateur
p | Rend le salon privé (n'apparaît plus dans les /whois)
q <nick> | Rend l'utilisateur "owner" (propriétaire) du salon
Q | Seuls les U:Lined peuvent kicker les utilisateurs
r | Ce salon est enregistré (ne peut être mis que par les services)
R | Seuls les utilisateurs enregistrés peuvent rejoindre le salon
S | Supprime toutes les couleurs
s | Rend le salon secret (n'apparaît plus dans /list et dans les /whois)
t | Seuls les halfops, les chanops ou plus peuvent changer le topic
T | Aucune notice ne peut être envoyée sur le salon
u | Auditorium : Les commandes /names et /who #chan n'affichent que les opérateurs
V | /invite n'est pas autorisé
v <nick> | Donne le statut de voice à l'utilisateur (peut parler quand le salon est modéré, +m)
z | Seuls les utilisateurs avec une connexion sécurisée (SSL) peuvent joindre le salon

Z

Mis en place par le serveur pour indiquer que tous les utilisateurs du salon sont sur une connexion sécurisée (SSL). N'est actif que si le mode +z est actif. Les ULines (par exemple : BotServ) sont ignorés lors de la vérification des utilisateurs "non sécurisés". Les admins des serveurs sont toujours responsables de la sécurité des tranferts entre les serveurs (par exemple en utilisant SSL, mais aussi un VPN, l'interface de loopback, un chiffrement quantique, etc), l'IRCd ne le détecte pas et ne peut pas le faire.

Modes des utilisateurs
Mode | Description
--- | ---
A | Server Admin (défini dans Oper Block)
a | Services Admin (défini dans Oper Block)
B | Vous marque comme étant un bot
C | Co-Admin (défini dans Oper Block)
d | Fait en sorte que vous ne puissiez pas recevoir de message provenant des channels (à l'exception de texte commencant par certains caractères, voir set::channel-command-prefix)
G | Filtre tous les badwords définis par configuration
g | Peut envoyer et lire les globops et locops
H | Cache le status d'IRCop (IRCop uniquement)
h | Disponible pour aide (HelpOp) (défini dans Oper Block)
I | Cache le temps d'inactivité d'un IRCop dans les WHOIS pour les utilisateurs normaux
i | Invisible (n'est pas montré dans un /who)
N | Network Administrator (défini dans Oper Block)
O | Local IRC Operator (défini par Oper Block)
o | Global IRC Operator (défini par Oper Block)
p | Cache les canaux sur lesquels vous êtes dans les /whois
q | Seuls les U:Lines peuvent vous kicker (Services Admin uniquement)
R | Vous permet de ne recevoir de messages privés et de notices que d'utilisateurs enregistrés (+r)
r | Identifie le pseudo comme étant enregistré
S | Utilisé pour protéger les Services Daemons
s | Peut lire les server notices
T | Vous empêche de recevoir des CTCPs
t | Dis que vous utilisé un /vhost
V | Vous marque comme un utilisateur de WebTV
v | Reçoit les notices de refus de DCC infectés
W | Vous laisse voir quand quelqu'un vous /whois (IRCop uniquement)
w | Peut lire les wallops
x | Donne à l'utilisateur un hostname caché
z | Indique que vous êtes un client SSL

7 – Commandes utilisateurs et opérateurs

Notez que la documentation fournie par /helpop est plus récente, utilisez /helpop commande (ou /helpop ?commande si vous êtes oper) pour avoir des informations sur une commande.

Commande | Description | Qui
--- | --- | ---
nick <newnickname> | Change votre pseudo. Averti les autres de votre changement de pseudo | Tous
whois <nick> | Affiche les informations sur l'utilisateur ciblé. Inclus le pseudo, l'host, les salons sur lesquels il se trouve et son statut d'Oper. Si vous êtes un IRCOP, vous avez accès à plus d'informations tel que les umodes de l'utilisateur. | Tous

whois <nick> <nick>

Réalise une commande WHOIS distante. Si un utilisateur n'est pas sur le même serveur que vous, un WHOIS simple n'affichera pas toutes les informations fournies habituellement par WHOIS. Par exmple, les temps d'inactivité ne sont pas affichés dans ce cas. Pour exécuter une commande WHOIS distante, faites un WHOIS en précisant le pseudo de l'utilisateur distant en premier et en deuxième paramètres.

Tous

who <mask> | Vous permet de chercher des utilisateurs. Masques inclus : pseudo, #salon, hostmask (*.attbi.com) | Tous
whowas <nick> <max de réponses> | Affiche les informations sur un pseudo qui n'est plus connecté. Le nombre maximum de réponses est facultatif et limite le nombre d'enregistrements qui seront retournés | Tous
ison <nick1 nick2 nick3 ...> | Vous permet de vérifier qu'un utilisateur (ou plusieurs) est connecté. Réponse simple, meilleur usage pour les scripts. | Tous
join <channel1,channel2, ...> | Vous permet de rejoindre des salons. Utiliser /join #salon1,#salon2,#salon3 vous permettra de rejoindre plus d'un salon en une fois. La commande /join 0 vous fait partir (PART) de tous les salons. | Tous
cycle <channel1, channel2, ...> | Cycle les salons spécifiés. Cette commande équivaut à faire un PART suivi d'un JOIN. (Pour les utilisateurs de mIRC, la commande /hop est équivalente) | Tous
motd <server> | Affiche le motd du serveur. Vous pouvez spécifier un nom de serveur si vous souhaitez voir le motd d'un serveur particulier sur un réseau. | Tous
rules <server> | Affiche le ircd.rules d'un serveur. Ajouter le nom d'un serveur. Vous pouvez spécifier un nom de serveur si vous souhaitez voir le ircd.rules d'un serveur particulier sur un réseau. | Tous
lusers <server> | Affiche le nombre actuel et maximum d'utilisateurs, en global et local. Vous pouvez spécifier un nom de serveur si vous souhaitez voir les statistiques d'un serveur particulier sur un réseau. | Tous
map | Affiche la carte (map) du réseau | Tous
quit <reason> | Vous déconnecte du serveur. Si vous ajoutez une raison, elle sera affichée sur tous les salons, lorsque vous quitterez. | Tous
ping <user> | Envoie une requête de PING à l'utilisateur. Utilisé pour vérifier une connexion et son lag. Les serveurs envoient des pings à des moments déterminés pour vérifier que les utilisateurs sont toujours connectés. | Tous
version <nick> | Cela envoie une requête de CTCP Version à l'utilisateur. Si il est configuré pour, le client renverra sa version en réponse. | Tous
links | Affiche la liste de tous les serveurs reliés au réseau. | Tous
Admin <server> | Affiche les "admin info" du serveur. Si un nom de serveur est inclus, il affichera les infos de ce serveur. | Tous
userhost <nick> | Affiche les userhost du pseudo spécifié. Généralement utilisé pour les scripts. | All
topic <salon> <topic> | Topic <salon> affichera le topic courrant du salon spécifié. Topic <salon> <topic> changera le topic du salon spécifié. | Tous
invite <nick> <channel> | Invite l'utilisateur spécifié à rejoindre le salon spécifié. (Vous devez être channel Op) | ChanOp
kick <channel, channel> <user, user> <reason> | Kick le ou les utilisateurs spécifiés du ou des salons spécifiés. Une raison peut également être précisée. | ChanOp
away <raison> | Vous marque comme étant absent. Une raison peut également être spécifiée. | Tous

Watch [+|-]<nick> [+|-]<nick>

Watch est un nouveau système de "notify-type" dans UnrealIRCd qui est en même temps plus rapide et moins gourmant en ressources du réseau qu'aucun autre ancien système de notification. Le serveur vous envoie un message lorsqu'un pseudo de votre watch list se connecte ou se déconnecte. La watch list NE RESTE PAS ENTRE 2 SESSIONS - vous (ou votre script ou client) devez ajouter les pseudos dans la watch list à chaque fois que vous vous connectez sur un serveur IRC.

Tous

helpop <topic> ou ?<topic> ou !<topic>

HelpOp est un nouveau système pour avoir l'aide d'un serveur IRC. Vous tapez soit /HELPOP ? <sujet du système d'aide> ou /HELPOP ! <question> Le "?" dans /HELPOP veut dire interroger le système d'aide et si vous n'avez pas de réponse, "!" enverra la question à un Opérateur connecté. Utiliser ni ? ni ! signifie que la question sera d'abord envoyée au système d'aide et que si aucune réponse n'est trouvée, elle sera envoyée à un Opérateur.

Tous

list <élément recherché>

Si vous ne spécifiez pas d'élément recherché, par défaut toute la liste des salons vous serra envoyée. Ci-dessous, les options que vous pouvez utiliser, et ce que la liste des salons vous reverra lorsque vous les utiliserez.
>nombre affichera la liste des salons comptant plus de <nombre> utilisateurs.
<nombre affichera la liste des salons comptant moins de <nombre> utilisateurs.
C>nombre affichera les salons créés depuis <nombre> minutes.
C<nombre affichera les salons créés avant <nombre> minutes.
T>nombre affichera les salons dont le topic n'a plus été changé depuis au moins <nombre> minutes
T<nombre affichera les salons dont le topic a été changé depuis moins de <nombre> minutes.
*mask* affichera les salons comprennant *mask*
!*mask* affichera les salons ne comprennant pas *mask*

Tous

Knock <salon> <message> | Vous permet de "frapper à la porte" d'un salon sous invitation (+i) pour demander le droit de le rejoindre. Ne fonctionnera pas sur les salons ayant les modes suivants : +K +V. Ne fonctionnera pas non plus si vous êtes banni. | Tous
setname | Permet aux utilisateurs de changer leur "Real Name" sans avoir à se reconnecter. | Tous
vhost <login> <mot de passe> | Cache votre host en utilisant une vhost fournie par le serveur. | Tous
mode <salon/pseudo> <mode> | Vous permet de changer les modes des salons et des utilisateurs. Voir Modes des salons et des utilisateurs pour avoir la liste. | Tous
credits | Affiche la liste de toutes les personnes ayant aider à créer UnrealIRCd. | Tous
license | Affiche la licence GNU. | Tous
time <server> | Affiche la date et l'heure du serveur. Spécifier un nom de serveur vous permet d'interroger un autre serveur. | Tous
botmotd <server> | Affiche le motd du serveur de bot. Spécifier un nom de serveur vous permet d'interroger un autre serveur. | Tous
identify <mot de passe> | Envoie votre mot de passe aux services pour identifier votre pseudo. | Tous
identify <salon> <mot de passe> | Envoie votre mot de passe aux services pour vous identifier en tant que "founder" (fondateur) d'un salon. | Tous
dns <option> | Renvoie les informations concernant les DNS cache du serveur IRC. Notez que depuis, certains clients ont leur propre commande DNS, vous pourrez alors utiliser /raw DNS. Les Opérateurs peuvent spécifier un "l" comme premier paramètre dans la commande pour recevoir une liste d'entrée dans le DNS cache. | Tous
userip <nick> | Retourne l'adresse IP de l'utilisateur en question. | Tous
silence [+|-]<nick> | Permet d'ignorer tous les messages d'un utilisateur ou d'une liste d'utilisateurs depuis le serveur lui-même. | Tous
oper <login> <mot de passe> | Commande pour donner le status d'Opérateur à un utilisateur si les spécifications correspondent à un Oper Block. | IRCop
wallops <message> | Envoie un message à tous les utilisateurs +w | IRCop
globops <message> | Envoie un message à tous les IRCops globaux | IRCop
chatops <message> | Envoie un message à tous les IRCops (locaux et globaux) | IRCop
locops <message> | Envoie un message à tous les IRCops locaux | IRCop
adchat <message> | Envoie un message à tous les Admins | IRCop
nachat <message> | Envoie un message à tous les NetAdmins | IRCop
kill <nick> <raison> | Kill l'utilisateur du réseau | IRCop

kline [+|-]<user@host | nick> [<durée du ban> <raison>]

Bannir le hostmask du serveur sur lequel la commande a été utilisée. Une kline n'est pas un ban global.
La durée du ban peut être: a) une valeur en seconde, b) une durée, comme "1d" pour un jour (day) c) "0" pour permanent. Le temps et la raison sont optionnels, si rien n'est spécifié, ce sera set::default-bantime (défaut : 0 / permanent) et "no reason" qui seront utilisés.
Pour enlever une kline, utilisez /kline -user@host.

IRCop

zline [+|-]<*@ip> [<durée du ban> <raison>] | Bannir une adresse ip du serveur local sur lequel la commande a été utilisée (pas global). Regardez kline pour plus d'informations. Utilisez /zline -*@ip pour l'enlever. | IRCop
gline [+|-]<user@host | nick> [<durée du ban> <raison>] | Ajoute un ban global sur l'utilisateur spécifié. Regardez kline pour plus d'informations. Utilisez /gline -user@host pour l'enlever. | IRCop
shun [+|-]<user@host | nick> [<durée du shun> <raison>] | Empêche un utilisateur d'utiliser n'importe quelle commande et de parler. Les shuns sont globaux (comme les glines). Regardez kline pour plus d'informations. Utilisez /shun -user@host pour l'enlever. | IRCop
gzline [+|-]<ip> <durée du ban> :<raison> | Ajoute une zline globale. Regardez kline pour plus d'informations. Utilisez /gzline -*@ip pour l'enlever. | IRCop

rehash <server|-global> –<flags>

Rehash le fichier de configuration des serveurs. Spécifier un nom de serveur, vous permet de rehasher le fichier de configuration d'un serveur distant et spécifier -global le fait sur tous les serveurs du réseau (ces deux options sont réservées aux NetworkAdmins). De nombreux flags sont disponibles. Ils incluent :
-dns - réinitialise et recharge le résolveur
-motd - recharge les fichiers MOTD, BOTMOTD, OPERMOTD et RULES (notamment ceux précisés dans un TLD blocks)
-garbage - force le nettoyage de la mémoire
-ssl - recharge les certificats SSL

IRCop

restart <mot de passe> <raison> | Relance le processus IRCd. Le mot de passe est requis si drpass est présent. Vous devez aussi spécifier une raison. | IRCop
die <mot de passe> | Arrête le process IRCD. Le mot de passe est requis si drpass est présent. | IRCop
lag <server> | Cette commande est comme un sonar ou un traceroute pour serveur IRC. Vous tapez /LAG irc.rs2i.net et il répondra de chaque serveur qu'il rencontre avec le temps. Utile lorsque vous cherchez d'où viens le lag et les TS futurs et passés. | IRCop
sethost <nouveau host> | Vous permet de changer votre vhost. | IRCop
setident <nouvel ident> | Vous permet de changer votre ident. | IRCop
chghost <nick> <nouvel host> | Vous permet de changer l'hostname d'un utilisateur connecté. | IRCop
chgident <nick> <nouvel ident> | Vous permet de changer l'ident d'un utilisateur connecté. | IRCop
chgname <nick> <nouveau nom> | Vous permet de changer votre le realname d'un utilisateur connecté. | IRCop
squit <server> | Déconnecte un serveur du réseau. | IRCop
connect <server> <port> <server> | Si un seul serveur est précisé, le serveur sur lequel vous êtes va tenter de se connecter au serveur spécifié. Si 2 serveurs sont précisés, ils vont tenter de se connecter l'un à l'autre. Mettre le hub en deuxième position. | IRCop
dccdeny <filemask> <reason> | Ajoute un DCCDENY pour ce filemask. Empêche ce fichier d'être envoyé. | IRCop
undccdeny <filemask> | Enlève un DCCDENY | IRCop
sajoin <nick> <channel>, <channel> | Force l'utilisateur à joindre le, les salons. Accessible par les services et network admins seulement. | IRCop
sapart <nick> <channel>, <channel> | Force l'utilisateur à partir du, des salons. Accessible par les services et network admins seulement. | IRCop
samode <channel> <mode> | Permet aux services et network admins de changer les modes d'un salon sans en être ChanOp. | IRCop
rping <servermask> | Calcule en millisecondes le lag entre les serveurs. | IRCop
trace <servermask|nickname> | Quand elle est utilisée sur un utilisateur, elle vous donnera les informations sur la classe et le lag. Si elle est utilisée sur un serveur, elle vous donnera les informations sur le classe, la version et le link. | IRCop
opermotd | Affiche le fichier OperMotd des serveurs. | IRCop
addmotd :<text> | Ajoute le texte donné à la fin du Motd | IRCop
addomotd :<text> | Ajoute le texte donné à la fin du OperMotd | IRCop
sdesc <nouvelle description> | Permet aux administrateurs de changer la description de leur serveur sans avoir à le relancer. | IRCop
addline <texte> | Vous permet d'ajouter des lignes à unrealircd.conf. Vous devez charger le module m_addline pour utiliser cette commande depuis UnrealIRCd-3.2.9 | IRCop
mkpasswd <auth-type> <password> | Va chiffrer <password> en utilisant la méthode de hash <auth-type>. Voir la section Types d'Authentication pour une liste des méthodes de hash disponibles. | IRCop
tsctl offset +/- <time> | Ajuste l'horloge interne de l'IRCD (NE PAS utiliser si vous ne savez pas exactement ce que vous faites). | IRCop
tsctl time | Donnera un rapport TS. | IRCop
tsctl alltime | Donnera un rapport TS de tous les serveurs. | IRCop
tsctl svstime <timestamp> | Applique le temps TS à tous les serveurs (NE PAS utiliser si vous ne savez pas exactement ce que vous faites). | IRCop

htm <option>

Réglages relatifs au mode "high traffic". Le mode "high traffic" (HTM) désactive certaines commandes comme : list, whois, who, etc. en réponse à un traffic important sur le serveur. Les options sont :
-ON Force le passage du serveur en HTM
-OFF Force la sortie du serveur du HTM
-NOISY Active l'avertissement des utilisateurs / admins lorsque le serveur entre / sort du HTM
-QUIT Désactive l'avertissement des utilisateurs / admins lorsque le serveur entre / sort du HTM
-TO <valeur> Dis au HTM, à quel taux il doit s'activer

IRCop

stats <option>

B - banversion - envoie la liste des versions de ban
b - badword - envoie la liste des mots censurés
C - link - envoie la liste des link block
d - denylinkauto - envoie la liste des links block (auto) interdits
D - denylinkall - envoie la liste des links block (tous) interdits
e - exceptthrottle - envoie la liste des except throttle block
E - exceptban - envoie la liste des except ban et except tkl block
f - spamfilter - envoie la liste des spamfilter
F - denydcc - envoie la liste des deny dcc block
G - gline - envoie la liste des gline et des gzline
Flags secondaires: [+/-mrs] [masque] [raison] [mis par]
m Renvoie les glines contenant / ne contenant pas la mask spécifié
r Renvoie les glines dont la raison est / n'est pas celle spécifiée
s Renvoie les glines mis / n'ont mis par la personne spécifiée
I - allow - envoie la liste des allow block
j - officialchans - envoie la liste des salons officiels
K - kline - envoie la liste des ban user / ban ip / except ban
l - linkinfo - envoie les informations sur le link
L - linkinfoall - envoie les informations sur les links
M - command - envoie le nombre de fois que les commandes ont été utilisées
n - banrealname - envoie la liste des ban realname block
O - oper - envoie la liste des oper block
P - port - envoie les informations concernant les ports
q - sqline - envoie la liste des SQLINE
Q - bannick - envoie la liste des ban nick block
r - chanrestrict - envoie la liste des chans deny / allow block
R - usage - envoie les informations d'usage
S - set - envoie la liste des set block
s - shun - envoie la liste des shuns
Flags secondaires: [+/-mrs] [masque] [raison] [mis par]
m Renvoie les glines contenant / ne contenant pas la mask spécifié
r Renvoie les glines dont la raison est / n'est pas celle spécifiée
s Renvoie les glines mis / n'ont mis par la personne spécifiée
t - tld - envoie la liste des tld block
T - traffic - envoie les informations sur le traffic
u - uptime - envoie l'uptime du serveur et le nombre de connexions
U - uline - envoie la liste des ulines block
v - denyver - envoie la liste des deny version block
V - vhost - envoie la liste des vhost block
X - notlink - envoie le liste des serveurs qui ne sont pas actuellement linkés
Y - class - envoie la liste des class block
z - zip - envoie les informations sur la compression des serveurs ziplinked (si ils ont été compilés avec le support ziplink)
Z - mem - envoie les informations sur la mémoire utilisée

Tous

module | Liste tous les modules chargés | Tous
close | Cette commande déconnectera toutes les connexions inconnues du serveur IRC. | IRCop

8 – Conseils de sécurité/checklist

Si vous êtes concernés par la sécurité, et vous le devriez, cette section vous donnera un aperçu des risques possibles et leurs niveaux de risques. Vous pouvez également utiliser celle-ci comme une checklist pour parcourir la configuration de votre réseau et le rendre plus sécurisé.

Cette liste est ordonnée suivant la popularité, le niveau de risque et les méthodes les plus souvent utilisées.

8.1 – Mots de passe

Choisissez de bons mots de passe oper, link, etc. :
- mélangez les lettres (majuscules et minuscules) et les chiffres ("Whbviwf5") et/ou quelque chose de long ("blaheatsafish", "AlphaBeta555").
- N'UTILISEZ PAS vos mots de passe oper, link pour autre chose comme votre compte mail, bot, forums, etc ...

8.2 – Vulnérabilités non liées à l'IRCd

Il y a beaucoup plus de chance qu'un serveur se fasse pirater à cause d'une vulnérabilité non-ircd qu'à cause d'un bug UnrealIRCd. Si vous faites tourner sur la même machine des serveurs http, dns, smpt ou ftp par exemple, vous avez de plus grands risques. Aussi, si vous êtes sur une machine Multi-Utilisateurs (ex. : vous louez un shell) il y a des risques de failles locales ou mauvaises permissions (voir plus loin). Le risque est grand donc soyez prudent lors du choix de votre loueur de shell.

8.3 – Permissions et fichier de configuration

Soyez toujours sur que vos dossiers home et UnrealIRCd ont des permissions correctes, les autres groupes ne doivent pas avoir la permission de les lire. Sinon un utilisateur local pourra ouvrir votre fichier de configuration et chercher les mots de passe ... Vous pouvez faire : chmod -R go-rwx /path/to/Unreal3.2 si vous n'en êtes pas sûr.
Autres choses dans le même style : ne mettez jamais votre UnrealIRCd dans un webroot ou un autre type de fichier partagé. Et pour les backups (sauvegardes), assurez vous qu'elles aient les bonnes permissions également (il arrive assez souvent que tout est bien sécurisé mais qu'il y a un backup.tar.gz quelque part lisible par tout le monde).

Vous voulez probablement également crypter les mots de passe lorsque ce sera possible, si vous compilez avec le support de OpenSSL (Ce que vous faites depuis que vous êtes interessé par les problèmes de sécurité, n'est-ce pas ?) je vous suggère donc d'utiliser l'encrytion des mots de passe en sha1 ou ripemd160 ou encore md5. Si il vous reste encore des oper block encrypté avec Unreal3.2.1 ou avant, je vous suggère de ré-encrypter ceux-ci (réutilisez juste /mkpasswd), car 3.2.1 introduit certaines caractéristiques anti-cracks intéréssantes (basiquement une diminution de 14x la vitesse de crack et rend impossible le crack par stored-plain-ciphertext)

Notez que même si ceci n'est "qu'une autre couche de sécurité", beaucoup de mots de passe faibles être craqués facilement, et si quelqu'un s'empare de votre fichier de configuration, il pourra y trouver des choses intéréssante pour planifier une attaque comme link::password-connect.

8.4 – Problèmes liés aux utilisateurs

Tout comme beaucoup des choses dites ici, ceci n'est pas spécifique à UnrealIRCd, mais ...
Choisissez toujours bien vos opers et admins. Et rappelez-vous le concept du maillon faible. Même si vous êtes prudents et suivez la documentation, peut-être qu'un de vos amis oper fera quelque chose de stupide. Comme partager son disque dur via netbios/kazaa/morpheus/..., avoir un trojan, utiliser un mauvais mot de passe, etc ... Malheureusement, ce n'est pas toujours sous votre contrôle.
Une chose que vous pouvez tout de fois faire est choisir soigneusement de quels privilèges chacun a besoin (oper::flags).

8.5 – SSL/SSH & sniffing

Utilisez des connexions SSL entre les serveurs et pour les opers, cela vous protègera contre le "sniffing". Le sniffing est possible si quelqu'un attaque un serveur entre vous et votre serveur ircd, il pourra voir tout votre trafic qui passe par ce serveur. Lire les conversations, récupérer les mots de passe (les logins oper, nickserv, etc ...) ... Pour les mêmes raisons, utilisez toujours ssh à la place de telnet.

8.6 – Denial of Service attacks (DoS) [ou: comment protéger mon hub]

Beaucoup de réseaux ont expérimenté combien était "fun" un flood ou une (D)DoS attaque, vous pouvez toutes fois faire certaines choses permettant d'en réduire les dommages. La plupart des réseaux ont un serveur hub, ce que certaines personnes oublient, c'est qu'il est assez facile de protèger le hub contre des attaques.
Je vais l'expliquer ici :

1. - Choissisez pour le hub un hostname qui n'existe pas (ex. : hub.yournet.com), mais n'ajoutez pas un enregistrement de dns pour lui.
     De cette manière, un attaquant ne pourra ni resoudre son host ni le flooder.
   - Ensuite, linkez vos serveurs au hub en spécifiant l'ip ou un hostname non publique
   - Exemple 1: link visibiblename.yournet.com { hostname 194.15.123.16; [etc] };.
   - Exemple 2: link visibiblename.yournet.com { hostname thehostnamethatworks.yournet.com; [etc] };.
   - Remarque : pour le dernier exemple, vous devez être sûr que votre nom de serveur ne permet pas de zones de transfert, mais ceci nous éloigne du sujet.
2. - Une autre étape importante est alors de cacher "/stats c" et autres informations "stats" sinon les attaquants pourront simplement lister vos links blocks.
   - Si vous êtes paranoyaque,vous pouvez simplement faire : set { oper-only-stats "*"; }; pour restreindre l'utulisation de tous les /stats.
   - Si vous ne voulez pas cela, cachez seulement "CdDlLXz". Vous en verrez plus sur ce sujet dans la section suivante.

Évidemment, ces techniques sont moins utiles si elles ne sont pas appliquées dès le lancement du serveur puisque l'IP peut déjà être connu de quelqu'un de malveillant, qui attend que ça vaille le coup d'attaquer.

Notez aussi que les attaquants peuvent toujours flooder les serveurs qui ne sont pas des Hubs, mais cela demande plus d'efforts que juste attaquer 1 ou 2 points faibles (les hubs), aussi de cette manière vos hubs et services resteront saufs :).

8.7 – Conseils sur la divulgation d'informations

STATS
La commande /stats fournit beaucoup d'informations, vous voulez probablement restreindre son usage le plus possible. Une question que vous devez vous poser est "Qu'est ce que je veux que mes utilisateurs voient ?". La plupart des gros réseaux choisissent "rien", lorsque d'autres préfèrent que leurs clients puisse faire "/stats g" et "/stats k".
Je vous suggère d'utiliser set { oper-only-stats "*"; }; pour empêcher tous /stats pour les non-opers, mais si vous ne voulez pas cela, inspectez la liste des "/stats" et empèchez l'accès à tout ce que vous voulez ... (en cas de doute, empêcher... Pourquoi auraient-ils besoin de savoir cela ?)

Pour vous donner quelques exemples :

- /stats o: vous donne le noms des opers (avec la 'case' correcte) et leurs hostmasks.
- /stats c: vous donne une idée des links et qui peut être utilisée comme backup, etc ...
- /stats g, /stats k: en général utilisés pour bannir les proxys ... donc cela donnera juste aux attaquants une liste de proxys qu'ils peuvent utiliser.
- /stats E, /stats e: informations plus sensibles, spécialement si un attaquant peut utiliser ces adresses.
- /stats i, /stats y: peut aider un attaquant à trouver des hosts permettant beaucoup de connexions.
- /stats P: aide à trouver des ports serveronly
- etc c...

MAP / LINKS
Beaucoup de personnes ont demandé si il était possible de désactiver /map ou /links. Notre position sur ce sujet est que c'est bête et donne un mauvais sens à la sécurité, laissez moi vous expliquer... Cacher les serveurs sur lesquels les utilisateurs sont connectés est inutile vu qu'ils les connaissent déjà (sinon comment s'y seraient-ils connectés ?). Pour les serveurs sur lesquels vous ne voulez aucuns utilisateurs, reportez vous à la section 8.6.

Maintenant, que POUVEZ vous faire ? Depuis la version 3.2.1, il existe une option appelée 'flat map' (set::options::flat-map), cela fera apparaître tous les serveurs comme 'directement connectés' dans /map et /links, comme cela les utilisateurs ne sauront plus voir quel serveur est lié auquel ... Ça peut être une bonne couche supplémentaire de protection car ainsi une personne ne pourra pas repérer les 'points faibles' avec /map ou /links. Donc, utiliser cela est recommandé. Notez que cela n'élimine pas totalement les risques ... Si un split arrive, quelqu'un peut toujours voir quel serveur est linké auquel, et ceci est aussi valable pour d'autres choses.

UTILISATEURS NORMAUX ET SNOMASKS
Une chose qui n'est pas toujours connues est que les utilisateurs normaux peuvent également s'appliquer certains snomask limités, +s et +k. Grâce à cela, ils peuvent voir des choses comme les rehashes, les kills et d'autres messages variés. Pour désactiver cela, vous pouvez utiliser set::restrict-usermodes comme ceci : set { restrict-usermodes "s"; };.

Évidement tout ceci n'est que de la "dissimulation d'informations", ce n'est pas de la "vraie" sécurité. Cela rendra plus difficiles / importants les efforts requis pour attaquer / pirater.

8.8 – Se protéger des exploits

Il y a des patches de kernel qui rendent plus difficiles les stack et heap exploits. Ceci est très bien mais ne doit pas être votre principal point d'inquiétude, vous avez des risques de loin plus importants d'être attaqué par d'autres points que celui-ci... Pour des raisons variées.

Une autre option est l'activation du chrooting (*NIX uniquement), ce qui signifie que lors d'un exploit réussi, l'utiliateur est confiné dans le dossier UnrealIRCd et ne peut accèder à aucun autre fichier. Ceci requière un accès root, la modification de include/config.h (la recherche du CHROOTDIR ainsi que la définition de IRC_USER et IRC_GROUP), et une recompilation.

Il y a une chose que vous devez toujours faire, c'est TOUJOURS UTILISER LA DERNIÈRE VERSION, inscrivez vous à la unreal-notify mailinglist tout de suite et vous recevrez les annonces de release (la unreal-notify est pour les annonces de release uniquement, d'où seulement 1 mail tout les X mois). En général il est explicitement mentionné dans l'annonce si la release permet de fixer (de hauts risques) de sécurité, mais il est malgré tout bon d'upgrader dès que possible.

8.9 – Conclusion

Comme vous l'aurez je l'espère maintenant compris, vous ne pouvez jamais être 100% sécurisé. Vous (et nous) devons trouver et éliminer toutes les failles car un attaquant a juste besoin de trouver une faille sur un serveur. Tout ce qui a été expliqué ici DOIT de toutes façons aider à minimiser les risques considérablement. Prenez le temps de sécuriser votre réseau et éduquer vos opers. Beaucoup de personne ne font pas attention à la sécurité, jusqu'à ce qu'ils se fassent attaquer, essayez d'éviter ca :).

9 – Foire aux Questions (FAQ)

La FAQ est disponible en ligne ici

10 – Modules

Voici la description de quelques modules fournis avec UnrealIRCd. Malheureusement, un seul d'entre eux est documenté pour le moment.

10.1 – m_nopost

Ce module bannit automatiquement les utilisateurs essayant d'envoyer une requête de type HTTP. Il a été écrit par Syzop pour contrer l'attaque XPS touchant Firefox, grâce à laquelle les navigateurs supportant l'AJAX peuvent agir comme robots spammeurs sur IRC. Pour choisir ce que m_nopost doit faire lorsqu'il reÃ§oit une telle requête, configurez set::nopost::ban-action et set::nopost::ban-time (et leurs amis).

Ce module est une nouveauté de UnrealIRCd 3.2.9 et est compilé dans commands.so. Par conséquent, il est chargé par dé dans la plupart des cas.

A – Expressions Régulières

Les expressions régulières sont utilisées à beaucoup d'endroits dans Unreal, dont les badwords, spamfilter, et aliases. Elles sont un outil très complexe utilisé comme modèle de comparaison. Elles sont parfois appellées "regexp" ou "regex". Unreal utilise la librairie d'expressions régulières TRE pour ses regex. Cette librairie supporte quelques expressions très complexes et avancées pouvant être confuses. Les informations suivantes vous aiderons à comprendre comment les regexps fonctionnent. Si vous êtes intéressé par des informations plus techniques et détaillées au sujet de la syntaxe des regexp utilisés par Unreal, visitez le site de TRE.

A.1 – Litéraux

Les litéraux sont les composents les plus basiques d'un regexp. Fondamentalement, ce sont des caractères qui sont traités comme du texte simple. Par exemple, le modèle "test" correspond aux quatres lettres, "t", "e", "s", et "t". Dans Unreal, les litéraux sont traités sans respect de la case, donc le regex précédent correspondra aussi bien à "test" qu'à "TEST". Chaque caractère n'étant pas un "méta caractère" (expliqué dans les sections suivantes) est traité comme un litéral. Vous pouvez également rendre explicitement un caratère litéral en utilisant un backslash (\). Par exemple, le point (.) est un métacaractère. Si vous voulez inclure le litéral ., utilisez simplement \. et Unreal le traitera comme un point. Il est également possible que vous vouliez rechercher un caractère qui n'est pas facilement écrivable, comme la caractère ASCII 3 (coloré). Plutôt que de devoir vous débattre avec un client IRC pour créer ce caractère, vous pouvez utiliser une séquence spéciale, le \x. Si vous tappez \x3, alors il sera interprété comme étant le caractère ASCII 3. Le nombre après le \x est représenté par un hexidécimal et peut être dans l'interval de \x0 à \xFF.

A.2 – L'opérateur Point

L'opérateur point (.) est utilisé pour correspondra à "n'importe quel caractère". Il correspond à un caractère simple qui n'a pas de valeur particulière. Par exemple, la regex "a.c" correspondra à "abc", "adc", etc. Cependant, il ne correspondra pas à "abd" car "a" et "c" sont des litéraux devant correspondre exactement.

A.3 – Les opérateurs de Répétition

L'une des erreurs communes faites par les personnes utilisant les regex est de présumer qu'ils fonctionnent juste comme des wildcards. Ce sont, les caractères * et ? qui fonctionnent juste comme une wildcard. Alors que ces caractères ont une signification similaire dans un regex, ils ne sont pas exactement identiques. De plus, les expressions régulières supportent également d'autres méthodes plus avancées de répétition.

L'opérateur de répétition le plus basique est le ?. Cet opérateur correspond à 0 ou 1 fois le caractère précédent. Le ? dans une regex diffère d'une wildcard. Dans une wildcard, l'expression "a?c" correspond à un "a" suivi par n'importe quel caractère (ou aucun caractère), suivi par un "c". Dans une regex, cela a un signification différente. Il correspond à 0 ou 1 fois la lettre "a" suivi par la lettre "c". Basiquement, le ? modifie le a en spécifiant combien de a doivent être présents. Pour émuler le ? d'une wildcard, l'opérateur point . est utilisé. Le regex "a.?c" est équivalent à la wildcard préalablement mentionnée. Il correspond à la lettre "a" suivi par 0 ou 1 fois n'importe quel caractère (le ? modifie le .), suivi par un "c".

L'opérateur de répétition suivant est le *. A nouveau, cet opérateur est similaire à une wildcard. Il correspond à 0 ou plusieurs fois le caractère précédent. Notez que ce "caractère précédent" est caractéristique à tous les opérateurs de répétition. Le regex "a*c" correspond à 0 ou plusieurs a suivi par un "c". Par exemple, "aaaaaac" correspond. Encore une fois, pour que ceci fonctionne comme une wildcard, vous devrez utiliser "a.*c" ce qui forcera la * a modifier le . (n'importe quel caractère) plutôt que le "a").

L'opérateur + est très similaire au *. Cependant, au lieu de correspondre à 0 ou plus, il correspond à 1 ou plus. Basiquement, "a*c" correspondra à "c" (0 a suivi par un c), là où "a+c" ne le fera pas. Le "a+" signifie qu'il doit y avoir "au moins" 1 a. Donc "c" ne correspond pas mais "ac" et "aaaaaaaaac" oui.

L'opérateur de répétition le plus avancé est une "borne". Une borne vous laisse définir des contraintes exactes sur le nombre de fois que le caractère précédent doit être présent. Par exemple, vous pouvez vouloir rechercher exactement 8 a, ou au moins 8 a, ou entre 3 et 5 a. La borne vous permet de réaliser tout cela. La syntaxe basique est {M,N} où M est la borne inférieure, et N est la borne suppérieure. Par exemple, pour rechercher de 3 à 5 a, vous devrez mettre "a{3,5}". Cependant, vous êtes pas obligés de spécifier les 2 nombres. Si vous mettez "a{8}" cela signifie qu'il doit y avoir exactement 8 a. Ainsi, "a{8}" est équivalent à "aaaaaaaa". Pour spécifier l'exemple "au moins", vous créez simplement un intervalle qui a uniquement une borne inférieure. Donc pour au moins 8 a, vous devrez mettre "a{8,}".

Par défaut, tous les opérateurs de répétition sont "gourmands". La gourmandise est une notion quelque peu complexe. Basiquement, cela signifie qu'un opérateur correspondra à autant de caractères qu'il pourra. Il est plus simple d'expliquer avec un exemple.

Disons que nous avons le texte suivant :
HELLO
Et le regex suivant :
.+L

Dans cet exemple, vous pourriez penser que le .+ correspond à "HE". Cependant, ceci est incorrect. Car le + est gourmand, il correspond à "HEL". La raison est qu'il choisi la plus large portion du texte entré pouvant correspondre au regex. Dans cet exemple, il choisi "HEL" car la seule autre condition est que le caractère après le texte correspondant au .+ doit être un "L". Etant donné que le texte est "HELLO", "HEL" est suivi par un "L", et donc ca correspond.

Parfois, cependant, il est utile d'utiliser un opérateur non 'gourmand'. Ceci peut être effectué en ajoutant un caractère ? après l'opérateur de répétition. En modifiant ce que nous avions en ".+?L", le .+? correspondra maintenant à "HE" plutôt qu'à "HEL" étant donné qu'il a été rendu 'non gourmand'. Le ? peut être ajouté à n'importe quel caractère de répétition : ??, *?, +?, {M,N}?.

A.4 – Expressions Avec Crochets

Les expressions avec crochets fournissent une manière pratique de faire un opérateur "ou". Par exemple, si vous voulez dire "correspond à a ou à b". Cette expression se présente sous la forme d'une série de caractères compris entre des crochets ([]), d'où son nom. Ces caractères sont traités comme si il y avait un "ou" entre eux. Par exemple, l'expression "[abc]" correspond à un "a", un "b" ou un "c". Ainsi, le regexp "a[bd]c" correspond à "abc" et "adc" mais pas à "acc."

Une chose très commune à faire est rechercher quelque chose comme, une lettre ou un chiffre. Plutôt que de faire, par exemple, "[0123456789]", l'opérateur crochet supporte les intervalles. Ils fonctionnent en spécifiant le début et la fin avec un - entre eux. Donc, une façon plus simple de rechercher un chiffre est de d'utiliser "[0-9]". La même chose peut être utilisée pour des lettres, ou en fait, n'importe quel intervalle de valeurs ASCII. Si vous voulez rechercher une lettre, utilisez simplement "[a-z]" étant donné qu'Unreal n'est pas sensible à la case, il correspondra à toutes les lettres. Vous pouvez également inclure plusieurs intervalles dans la même expression. Pour rechercher une lettre ou un nombre, "[0-9a-z]". Une complication que cela génère est le fait que le - est un caractère spécial dans une expression avec crochets. Pour pouvoir rechercher un - comme caractère littéral, la manière la plus simple est de le placer comme le premier ou le dernier caractère dans l'expression. Par exemple, "[0-9-]" correspond à un chiffre ou à un -.

Pour rendre les choses encore plus simples, il existe plusieurs "classes de caractères" pouvant être utilisées dans une expression avec crochets. Ces classes de caractères élimine le besoin de définir certains intervalles. Les classes de caractères sont écrites en mettant leur nom entre : . Par exemple, "[0-9]" peut également être écrit "[:digit:]". La liste ci-dessous montre toutes les classes de caractères disponibles et ce qu'elles font :

- `alnum` - caractères alphanumériques
- `alpha` - acaractères alphabétique
- `blank` - caractères blanc /li>
- `cntrl` - caractères de contrôle
- `digit` - chiffres décimaux (de 0 à 9)
- `graph` - tous les caractères imprimables excepté l'espace
- `lower` - lettres minuscules
- `print` - tous les caractères imprimables, espace inclus
- `punct` - tous les caractères imprimables n'etant ni un espace ni un alphanumérique
- `space` - espaces
- `upper` - lettres majuscules
- `xdigit` - nombres hexadécimaux

Une note important à propos des classes de caractères est qu'elles DOIVENT être le seul élément dans l'expression. Par exemple, [:digit:-] N'est PAS autorisé. A la place, vous pouvez réaliser le même but en imbriquant les expressions, par exemple, pour faire la même chose que "[0-9-]" en utilisant une classe de caractères, vous pouvez mettre "[[:digit:]-]".

La dernière caractéristique des expressions avec crochets est la négation. Parfois, c'est utile pour dire "n'importe quoi excepté ces caractères". Par exemple, si vous voulez vérifier si le caractère "n'est pas une lettre", il est plus facile de lister a-z et de dire "pas ceux-ci", que de lister tous les caractères n'étant pas des lettres. Les expressions avec crochets vous permette de réaliser ceci avec une négation. Vous niez l'expression en spécifiant un "^" comme premier caractère. Par exemple, "[^a-z]" correspondra à tout caractère n'étant pas une lettre. Comme avec le -, si vous voulez inclure un ^ literal, ne le placez pas en première position : "[a-z^]". De plus, pour nier une classe de caractère, vous devez, une fois encore, utiliser l'imbrication, "[^[:isdigit:]]" correspondra à n'importe quel caractère n'étant pas un chiffre.

A.5 – Assertions

Les assertions vous permettent de tester certaines conditions n'étant pas représentables par des chaînes de caractères, aussi bien qu'en utilisant des raccourcis pour certaines expressions avec crochets communes.

Le caractère ^ est désigné sous le nom de "ancre gauche". Ce caractère correspond au début d'une chaîne. Si vous spécifiez simplement une regex tel que "test", il correspondra, par exemple à "ceci est un test" car cette chaîne contient "test". Mais, parfois, il est utile de s'assurer que la chaîne commence réellement avec le modèle. Ceci peut être réalisé avec ^. Par exemple "^test" signifique que le texte doit commencer par "test". De plus, le caractère $ est l'"ancre droite". Ce caractère correspond à la fin de la chaîne. Donc si vous mettiez "^test$", alors la chaîne devrait être exactement le mot "test".

Des tests similaires existent également pour les mots. Toutes les autres assertions sont spécifiées par l'usage d'un \ suivi par un caractère spécifique. Par exemple, pour tester le début et la fin d'un mot, vous pouvez utiliser respectivement \< et \>.

Les assertions restantes ont deux formes : une négative et une positive. Elles sont listés ici :

- `\b` - Limite d'un mot
- `\B` - Intérieur d'un mot
- `\d` - Chiffre (équivalent à `[[:digit:]]`)
- `\D` - Caractère n'étant pas un chiffre (équivalent à `[^[:digit:]]`)
- `\s` - Espace (équivalent à `[[:space:]]`)
- `\S` - Caractère n'étant pas un espace (équivalent à `[^[:space:]]`)
- `\w` - Mots (équivalent à `[[:alnum:]_]`)
- `\W` - Caractère n'étant pas un mots (équivalent à `[^[:alnum:]_]`)

A.6 – Alternation

L'alternation est une méthode pour dire "ou". L'opérateur alternation est une barre verticale (|). Par exemple, si vous vouliez dire dire "a ou b" vous pouvez mettre "a|b". Pour des lettres normales, ceci peut être remplacè par une expression avec crochets, mais l'alternation peut également être utilisée avec des sous-expressions (abordées dans la section suivante).

A.7 – Sous-expressions

Une sous-expression est une portion d'une regex qui sera traitée comme une entité à part entière. Il y a deux manière de créer une sous-expression. Les deux méthodes diffèrent par rapport aux références arrières, qui seront expliquées plus tard. Pour déclarer une sous-expression utilisant des références arrières, mettez la simplement entre parenthèses (). Pour créer une sous-expression n'utilisant pas de références arrières, replacez la parenthèse ouvrante par "(?:". Par exemple, "([a-z])" et "(?:[a-z])". La raison pour laquelle les sous-expressions sont utiles est que vous pouvez alors appliquer des opérateurs à l'expression. Tous les opérateurs de répétition, par exemple, ceux qui mentionnent "X ou plus de fois le caractère précédent", peut également être utilisé pour "X ou plus de fois la sous-expression précédente". Par exemple, si vous avez un regex tel que "[0-9][a-z][0-9]", pour rechercher un chiffre, suivi par une lettre, suivi par un chiffre, et que la vous décidez que vous voulez rechercher cette séquence deux fois. Normallement, vous devriez utiliser, "[0-9][a-z][0-9][0-9][a-z][0-9]". Avec les sous-expressions, par contre, vous pourrez simplement utiliser "([0-9][a-z][0-9]){2}".

A.8 – Références arrières

Les références arrières (back references) vous permettent de référencer une chaîne qui correspond à une des sous-expressions ou des regexp. Vous utilisez une référence en spécifiant un backslash (\) suivi par un nombre, 0-9, par exemple \1. \0 est une back reference spéciale qui se réferre au regexp entier, plutôt qu'à une sous-expression. Les back references sont utilises lorsque vous voulez rechercher quelque chose qui contient la même chaîne deux fois. Par exemple, disons que vous avez un nick!user@host. Vous savez qu'il y a un trojan qui utilise un nickname et un username correspondant à "[0-9][a-z]{5}", et les deux sont les mêmes. Utiliser "[0-9][a-z]{5}![0-9][a-z]{5}@.+" ne fonctionnera pas car il permettra au nickname et à l'username d'être différents. Par exemple, le nickname pourra être 1abcde et l'username 2fghij. Les références arrières vous permettent de contourner cette limitation. Utiliser, "([0-9][a-z]{5})!\1@.+" permettra de réaliser exactement ce qui était attendu. Ceci cherchera le nickname correspondra aux sous-expressions données, et utilisera ensuite une référence arrière pour dire que l'username doit être exactement le même texte.

C'est parce que vous ne pouvez avoir que 9 back references, que la notation (?:) est utile. Elle vous permet de créer une sous-expression sans gacher une référence. De plus, vu que les informations des références arrières n'ont pas besoin d'être sauvées, elles sont plus rapides. A cause de ceci, des sous-expressions non-références arrières peuvent être utilisées même si des références arrières ne sont pas obligatoire.

A.9 – Sensibilité à la case

Comme déjà mentionné, Unreal considère toutes les regexps comme insensibles à la case par défaut. La raison principale à cela est qu'il semble qu'il y a beaucoup plus de cas où vous voulez être insensible à la case que l'inverse, par exemple, si vous bloquez le texte "www.test.com", vous voulez certainement bloquer aussi "WWW.TEST.COM". Cependant, il y a des cas où vous pouvez vouloir être sensible à la case, par exemple, chercher certains trojans. C'est pourquoi, une méthode existe pour permettre de dynamiquement activer/désactiver l'insensibilité à la case.

Pour la désactiver, utilisez simplement "(?-i)" et pour l'activer, "(?i)". Par exemple, "(?-i)[a-z](?i)[a-z]" correspondra à une lettre minuscule (insensibilité à la case désactivée) suivie par une lettre minuscule ou majuscule (insensibilité à la case activée). De plus, plutôt que d'avoir à toujours se rappeller de changer de mode lorsque vous avez fini, vous pouvez également spécifier que le changement de mode doit uniquement s'appliquer à une sous-expression, par exemple, "(?-i:[a-z])[a-z]" est équivalent au précédent regexp car le -i s'applique uniquement à la sous-expression donnée.