82022-04-01 14:10:16160.97.54.39servizio dismesso72018-08-01 08:54:17host222-246-static.59-217-b.business.telecomitalia.itvariabili d'ambiente necessarie per systemd62017-05-17 14:53:56StefanaussModifiche su telegram non propagate52017-05-17 09:10:58StefanaussAvvio automatico istanze systemd --user42017-05-15 19:31:54StefanaussAggiunta policy32017-05-15 19:24:16Stefanauss22017-05-15 19:21:01StefanaussCompletamento prima stesura12017-05-15 13:03:32StefanaussPrima stesura della documentazione per l'istanza Ninux di TeleIRC

SERVIZIO DISMESSO IL 01/04/2022 URL: Maintainer: Stefanauss TeleIRC è il software che fa da bridge (ponte) tra il canale IRC ufficiale Ninux (#ninux.org @ freenode) e il gruppo ufficiale telegram (), consentendo a chi entra in uno dei due sistemi di chat di comunicare con chi è membro dell'altro. In questo modo ognuno può usare il proprio sistema di chat preferito raggiungendo comunque tutta la community ninux che chatta.

Il bridge è essenzialmente trasparente: chatti su IRC, reinoltra su Telegram; chatti su Telegram, reinoltra su IRC; tutti vedono tutto. La principale limitazione (tipica di molti bridge) è che non è possibile ottenere una lista completa degli utenti: l'utente virtuale del bridge "nasconde" quelli presenti dall'altro lato. Su Telegram: è possibile (per ora), visualizzare la lista degli utenti su IRC inviando nel gruppo telegram il comando /names, ma probabilmente verrà presto rimossa perché il comando non è limitabile a precisi momenti o utenti. Su IRC: non è possibile ottenere la lista degli utenti del gruppo Telegram. Si può "apprendere" il nick di un utente solo quando questo si unisce al gruppo o manda qualche messaggio. Altre info utili: Al momento, l'utente del bot non è registrato presso FreeNode, quindi non ha il nick prenotato. Fate i bravi e non usate ninux-telegram. Al momento, il bot non ha particolari privilegi IRC nell'ambito del canale. Non dovrebbero essere necessari. La connessione bot-freenode è su TLS/SSL, quindi sicura. Più per stile che per altro, visto che quella bot-telegram è in HTTP (sigh) Su Telegram: rispondendo ad un messaggio del bot, su IRC viene propagato sostituendo l'utente corretto: nice! Per menzionare un utente è consigliato utilizzare "@nick"; questo perché si adegua all'unico funzionante in Telegram e perché è comunque funzionante anche intra-IRC su quasi tutti i client Il bot fa caching dei media (immagini, file, messaggi vocali, stickers, tutt'e'cose) postati su Telegram, e li reinoltra come link su IRC.

Il servizio di bridging è mantenuto secondo una logica as-is, best-effort. Al momento non ho piani precisi per lo storage a lungo termine della cache dei media. Lo spazio a disposizione è 45 GiB circa. Il bridging ha potenziale per trasformarsi in un log onnicomprensivo delle chat Ninux, quindi se sarà possibile tenere tutti i file lo farò. Servirebbe implementare un management più raffinato di un cache-everything, però.

nei file inviati via telegram, la didascalia non viene propagata ad IRC le modifiche dei messaggi su telegram non vengono propagate ad IRC

Verificare se FreeNode usa un certificato self-signed per il login TLS; se no, possiamo evitare di accettarli

L'interazione programmatica con il servizio di messaggistica istantanea Telegram avviene attraverso dei "bot", dei software che creano un profilo telegram con cui è poi possibile chattare, sia singolarmente che in chat di gruppo, impartendo loro comandi, mettendoli in attesa di particolari eventi o messaggi che scateneranno le azioni desiderate. In due parole: sono "utenti" telegram programmabili. Per creare un bot, si chatta con un super-bot chiamato @botfather. Per aprire una chat con botfather basta cercarlo nel campo ricerca globale del proprio client telegram. Ecco come si svolge la chat di creazione di un bot TeleIRC: se qualcosa non tornasse, basta semplicemente seguire le istruzioni passo-passo che il bot ci sputerà contro dopo ogni nostra parola. Tra parentesi quadre commenti a margine da leggere, ma non digitare. Noi:: /newbot botfather: Alright, a new bot. How are we going to call it? Please choose a name for your bot. Noi:: Ninux.org TeleIRC Bridge [il "nome e cognome" del nostro bot, sarebbe il nome per esteso che comparirà nelle bolle-messaggio] botfather: Good. Now let's choose a username for your bot. It must end in bot. Like this, for example: ~TetrisBot or tetris_bot. Noi:: ninuxorg_teleircbot [questo sarà un "nickname" per il bot, che si potrà menzionare con la @nomecheabbiamoappenascritto. Deve terminare in "bot"] botfather: Done! Congratulations on your new bot. You will find it at t.me/ninuxorg_teleircbot. ... Use this token to access the HTTP API: numeriacaso:altrarobaacaso ... Noi:: /setprivacy [dobbiamo permettere al bot di accedere a tutti i messaggi postati dal nostro gruppo] botfather: Choose a bot to change group messages settings. Noi:: @ninuxorg_teleircbot [digitiamo o selezioniamo il nick del nostro bot, specificato al passo precedente] botfather: ... Current status is: ENABLED Noi:: Disable [occhio a digitarlo esattamente così] botfather: Success! The new status is: DISABLED. /help Noi:: /setabouttext botfather: Choose a bot to change the about section. Noi:: @ninuxorg_teleircbot [digitiamo o selezioniamo il nick del nostro bot, specificato al passo precedente] botfather: OK. Send me the new 'About' text. People will see this text on the bot's profile page and it will be sent together with a link to your bot when they share it with someone. Noi:: [massimo 120 caratteri per descrivere il nostro bot, che compariranno nel suo profilo] botfather: Success! About section updated. /help Noi:: /setdescription botfather: Choose a bot to change description. Noi:: @ninuxorg_teleircbot [digitiamo o selezioniamo il nick del nostro bot, specificato al passo precedente] botfather: OK. Send me the new description for the bot. People will see this description when they open a chat with your bot, in a block titled 'What can this bot do?'. Noi:: [una descrizione più lunga di cosa farà il nostro bot, che comparirà a chiunque cominci una chat col nostro bot] botfather: Success! Description updated. /help Noi: /setuserpic botfather: Choose a bot to change profile photo. Noi:: @ninuxorg_teleircbot [digitiamo o selezioniamo il nick del nostro bot, specificato al passo precedente] botfather: OK. Send me the new profile photo for the bot. Noi: [carichiamo la foto profilo che vogliamo per il nostro bot] Quello che abbiamo fatto in sintesi è: creare un nuovo bot, con nome esteso e nickname di nostra scelta abbiamo ottenuto un token (numeriacaso:altrarobaacaso) con cui accedere ai server telegram. Appuntiamoceli! gli abbiamo permesso di leggere tutti i messaggi del gruppo Telegram in cui si troverà, che è essenziale affinché possa ritrasmetterli lo abbiamo dotato di una descrizione breve, una estesa e di una sua foto profilo A questo punto non ci resta che aggiungere il nostro bot nei gruppi telegram per il quali dovrà fare da bridge.

Base: Ubuntu Server 16.04.x LTS N.B.: Questo howto non copre la parte di installazione, configurazione e messa in sicurezza del sistema operativo server, macchina virtuale o container che ospiterà il servizio, ma solo le istruzioni specifiche per TeleIRC. TeleIRC è basato sul runtime javascript Node.js. Per installare una versione aggiornata di Node.js utilizzeremo i repository NodeSource (disponibili per molteplici distribuzioni Linux). Prima di proseguire con l'installazione di TeleIRC, installiamo librerie e toolchain necessarie: Installiamo TeleIRC attraverso il gestore pacchetti di Node.js

Eseguiremo il bot col suo proprio utente, applicando il principio del minimo privilegio:

Una volta completata l'installazione, generiamo la configurazione di partenza di teleirc, che risiederà in ~/.teleirc/config.js e che poi personalizzeremo: Apriamo il file appena generato col nostro editor di testo per terminale preferito e cominciamo ad editarlo nei punti chiave. Segue la versione appuntata in italiano del file, che rappresenta anche la configurazione in essere per l'istanza in uso da Ninux:

Verifichiamo che tutto funzioni avviando TeleIRC in modalità ultra-verbosa, con teleirc -vvv. Dovremmo vedere comparire nella lista utenti di IRC il nostro bot scrivendo messaggi da ambedue i lati, verderli reinoltrati sull'altro

Systemd utilizza, oltre all'init di sistema con PID 1, anche un processo (user mode, --user) per ogni utente che nasce e muore al login/logout di quell'utente e permette a ciscuno di essi di gestire i propri service/socket/unit/mount systemd in maniera autonoma. Affinché l'istanza di systemd per ogni utente possa avviarsi, è necessaria la libreria PAM per Systemd: Il file service per il bot risiederà nella directory dove $EDITOR è il nostro editor di testo CLI preferito. Il contenuto del file sarà Aggiugiamo in ~/.profile le seguenti variabili d'ambiente, in fondo al file. Dopo averle aggiunte sarà necessario riloggarsi con l'utente teleirc affinché abbiano effetto: Testiamo il nostro file service con Se tutto andrà bene, vedremo uno stato del genere: A questo punto potremo abilitare definitivamente il servizio per l'autostart Non basta però: di default le istanze per-utente systemd si avviano solo al primo login e terminano dopo il logout. Per avviarle e lasciarle in esecuzione è necessario abilitarle con

Appuntandoci il Main PID nell'output di systemctl --user status teleirc, possiamo poi consultare il log di teleirc usando il comando: Affinché teleirc sia sufficientemente informativo nei log di sistema, è necessario avviarlo con i flag -v o -vv (vedi file .service da noi creato).