====== IRC : Les commandes IRC sur le réseau OFTC ======
* Objet : Lister les commandes IRC utilisables sur le réseau OFTC
* Niveau requis : {{tag>intermédiaire}}
* Commentaires : //Chaque serveur (et donc chaque réseau) a son lot propre de commandes. Ici nous décrivons celles valables sur le réseau OFTC.//
* Suivi : {{tag>en-chantier}}
* Création par [[user>arpinux]] 30/05/2021
* Testé par <...> le <...> FIXME
* Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=30102| Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))
Page en grande partie créée à partir de la page [[doc:reseau:freenode|freenode]]. Merci aux contributeurs de cette page ! :D
===== Introduction =====
Lorsque vous vous connectez la première fois sur OFTC, vous utilisez un pseudonyme parmi ceux disponibles, vous pouvez configurer votre client IRC pour en choisir un par défaut, mais vous pouvez aussi changer en direct de pseudo.
Vous pouvez alors rejoindre un salon de discussion comme #debian-facile, #df-flood ou #df-asso (ainsi que plein d'autres salons de projets divers.)
Cependant, si vous venez régulièrement, ou si vous voulez aller dans des salons auxquels l'accès est restreint à certaines personnes, il faut que vous soyez enregistré, afin de réserver votre pseudonyme et de vous authentifier auprès de OFTC.
Ces opérations se font à l'aide de commandes envoyées au serveur IRC. Les commandes se tapent dans la zone de discussion, mais commencent par un ''/''.
===== S'enregistrer sur OFTC =====
D'abord, connectez-vous à OFTC avec votre client IRC préféré (si vous n'en avez pas, regardez par exemple [[doc:reseau:xchat]].
Une fois connecté, vérifiez bien que votre pseudo est celui que vous avez choisi. Si ce n'est pas le cas, peut-être que ce dernier était déjà réservé. Vous pouvez essayer de changer de pseudo avec :
/nick nouveaupseudo
Ouvrez ensuite une session de discussion avec NickServ :
/query nickserv
Cela vous ouvre une nouvelle discussion, pour vérifier que vous causez bien à NickServ, vous pouvez lui demander d'afficher l'aide :
help register
Il vous explique alors que pour enregistrer votre pseudo, il faut utiliser le mot-clé register et fournir un mot de passe et une adresse email valide. Tapez-donc, dans cette discussion avec nickserv :
register votre-mot-de-passe votre@dresse.email
Une fois votre pseudo déclaré, il faut le vérifier. Sur OFTC, il faut visiter la page [[https://services.oftc.net/]], se connecter en cliquant sur "Login" : utilisez votre pseudo sur IRC et le mot de passe indiqué lors de l'étape précédente.\\
Sur la page de votre compte, cliquez sur "Verify" puis suivez les instructions du captcha.
À partir de là, vous êtes enregistrés, et vous pouvez indiquer à votre client irc vos noms d'utilisateur et mot de passe pour qu'il se connecte automatiquement.
Vous pouvez aussi vous connecter manuellement via la commande (sans avoir à ouvrir un ''/query'' avec nickserv):
/msg nickserv identify votre-mot-de-passe
Il est possible d'automatiser cette procédure d'identification de votre pseudo sur IRC . Exemple avec le client IRC Hexchat : [[doc:reseau:hexchat#identification-automatique|Hexchat - identification-automatique client IRC]]
===== S'authentifier sur OFTC avec un certificat SSL =====
Pour être identifié automatiquement sur le serveur OFTC, vous pouvez utiliser un certificat SSL.\\
==== Création du certificat SSL ====
On commence par créer ce certificat grâce à openssl. Vous n'êtes pas obligé de remplir tous les champs ;) :
openssl req -nodes -newkey rsa:2048 -keyout nick.key -x509 -days 3650 -out nick.cer
Generating a 2048 bit RSA private key
writing new private key to 'nick.key'
-----
Country Name (2 letter code) [FR]:VotreCodePays
State or Province Name (Aude) [Texas]:VotreRégion
Locality Name (eg, city) [Montréal]:VotreVille
Organization Name (eg, company) [debian-facile]:VotreOrganisation
Organizational Unit Name (eg, section) [IRC]:IRC
Common Name (eg, YOUR name) []:Votre nom
Email Address []:VotreEmail@ADDRESS
Cette commande va générer deux fichiers :
* une clé "nick.key"
* un certificat "nick.cer"
N'oubliez pas de changer les permissions de votre fichier 'nick.key' car il contient votre clé
chmod 400 nick.key
Nous allons réunir ces deux fichiers dans un autre afin de l'utiliser avec oftc grâce à 'cat'
cat nick.cer nick.key > nick.pem
N'oubliez pas de changer les permissions de votre certificat/clé
chmod 400 nick.pem
Vous disposez donc désormais de 3 fichiers : votre certificat (.cer), votre clé SSL (.key) et votre certificat valide associant votre clé et votre certificat SSL (.pem)\\
Nous n'allons utiliser que le fichier final, 'nick.pem' : vous pouvez supprimer les deux autres fichiers.
rm nick.{key,cer}
=== Création du certificat SSl (méthode alternative) ===
Vous pouvez utiliser une autre méthode qui vous permet de créer votre certificat en une seule commande :
openssl req -x509 -new -newkey rsa:2048 -sha256 -days 1096 -nodes -out nick.pem -keyout nick.pem
==== Utiliser le certificat pour s'authentifier sur OFTC ====
Le principe est de déplacer votre fichier .pem dans le dossier dédié de votre client IRC puis de le déclarer.\\
Ici un exemple avec le [[doc:reseau:weechat|client IRC weechat]]
Créer si nécessaire le dossier qui va contenir les certificats
mkdir -p ~/.weechat/certs
Déplacer le fichier dans le dossier dédié
mv nick.pem ~/.weechat/certs
Dans votre client weechat, déconnectez et effacez le serveur OFTC, ajoutez le certificat, puis recréez le serveur OFTC en version SSL :
/disconnect OFTC
/server del OFTC
/server add OFTC irc.oftc.net/6697 -ssl -ssl_verify -autoconnect
/set irc.server.OFTC.ssl_cert %h/certs/nick.pem
/save
Relancez alors weechat, identifiez-vous puis lancez la commande d'ajout du certificat déclaré dans l'étape précédente :
/connect OFTC
/msg NickServ identify votremotdepasse
/msg NickServ cert add
/reconnect OFTC
Pour les autres client IRC, consultez la [[https://oftc.net/NickServ/CertFP/|doc OFTC en anglais]]
===== Les commandes du client IRC =====
Ces commandes s'écrivent en tout début de la ligne pour communiquer. \\
Elles commencent obligatoirement :
- par un échappement /
- suit une commande accolée à cet échappement
- puis, éventuellement, une indication nominative d'un salon, d'un pseudo... ... <#salon>
| Action | Commande |
| Rejoindre le salon //#NomSalon// | ''/join #NomSalon'' |
| Changer son nom pour //nouveaupseudo// | ''/nick nouveaupseudo'' |
| Quitter et rejoindre un salon quasi-instantannément | ''/cycle'' |
| Obtenir des informations sur //pseudo// | ''/whois pseudo'' |
| Masquer toute intervention de //pseudo// | ''/ignore add pseudo'' |
| Fermer la fenêtre active | ''/close'' |
| Quitter le salon | ''/part'' |
| Quitter le client IRC | ''/quit'' |
| Discuter en privé avec //pseudo// | ''/query pseudo'' |
| Faire une action | ''/me votre_action'' |
| Envoyer un contenu binaire (images, sons...) | ''/dcc'' |
===== Les commandes Nickserv =====
Pour les opérations concernant un pseudo, il faut se connecter sous ce pseudo
| Action | Commande |
| Enregistrement de votre pseudo | ''/msg nickserv register votremotdepasse votre_email'' |
| S'identifier à la connexion sur le serveur | ''/msg nickserv identify votremotdepasse'' |
| Ajouter un pseudo sur le même mot de passe | ''/msg nickserv group lepseudo votremotdepasse'' |
| Le retirer | ''/msg nickserv ungroup votremotdepasse'' |
| Voir les pseudos de votre groupe | ''/msg nickserv info'' |
| Supprimer votre groupe | ''/msg nickserv drop votrepseudo votremotdepasse'' |
| Obtenir de l'aide sur les commandes nickserv | ''/msg nickserv help'' |
| Récupérer votre pseudo | ''/msg nickserv reclaim votrepseudo votremotdepasse'' |
| Changer de mot de passe | ''/msg nickserv SET PASSWORD nouveau-mot-de-passe'' |
| Activer le "Cloak" (ne pas afficher l'IP de connexion) | ''/msg nickserv SET CLOAK ON'' |
===== Les commandes Opérateurs =====
| Action | Commande |
| Passer opérateur((seuls les opérateurs sont capables de le faire)) | ''/msg chanserv op #NomSalon'' |
| Se retirer les droits d'opérateur | ''/msg chanserv deop #NomSalon'' |
| Mettre //pseudo// temporairement opérateur | ''/msg chanserv op #NomSalon pseudo'' |
| Méthode alternative si vous êtes op | ''/op pseudo'' |
| Retirer les droits d'opérateur à //pseudo// | ''/msg chanserv deop #NomSalon pseudo'' |
| Se donner les droits //voice// | ''/msg chanserv voice #NomSalon'' |
| S'enlever les droits //voice// | ''/msg chanserv devoice #NomSalon'' |
| Donner les droits //voice// | ''/msg chanserv voice #NomSalon pseudo'' |
| Méthode alternative si vous êtes op | ''/voice pseudo'' |
| Enlever les droits //voice// | ''/msg chanserv devoice #NomSalon pseudo'' |
| Pour expulser (//kicker//) | ''/kick pseudo le_motif_du_kick'' |
| Pour bannir (//ban//) | ''/ban masque_de_ban''((l'auto-complétion sur le pseudo permet d'obtenir un bon masque de ban)) |
| Pour dé-bannir (//unban//) | ''/unban masque_de_ban''((l'auto-complétion sur le pseudo permet d'obtenir un bon masque de ban)) |
| Aide sur les commandes chanserv | ''/msg chanserv help'' |
Si l'administrateur du salon vous a enregistré dans la liste d'accès comme étant opérateur, vous pourrez commander à chanserv de faire des opérations d'opérateurs pour vous, tout en restant utilisateur simple sur le salon.
===== Commande administration de chan =====
| Action | Commande |
| Enregistrer un salon | ''/msg chanserv register #NomSalon mon_password'' |
| Consulter les droits des utilisateurs | ''/msg chanserv access #NomSalon list'' |
| Rajouter l'op à //pseudo// | ''/msg chanserv op #NomSalon OP pseudo'' |
| Rajouter l'auto-voice à //pseudo// | ''/msg chanserv voice #NomSalon pseudo'' |
| Retirer l'auto-voice à //pseudo// | ''/msg chanserv devoice #NomSalon pseudo'' |
| Modifier le message de bienvenue | ''/msg chanserv set #NomSalon entrymsg blablablablablablabla'' |
| Aide sur les commandes chanserv | ''/msg chanserv help'' |
//Et maintenant, rendez-vous sur le serveur OFTC et notre salon #debian-facile !//