versione 1.0 Manuale Utente Area SX s.r.l. - Via Stefano Longanesi 25, ROMA - Tel: Fax:

Transcript

1 versione 1.0 Area SX s.r.l. - Via Stefano Longanesi 25, ROMA - Tel: Fax:

2 Indice generale Descrizione della BotMachine...2 Requisiti per l'installazione...2 Installazione della BotMachine...2 Accesso alla console di gestione Linux...2 Accesso tramite collegamento criptato in SSH...2 Credenziali di accesso:...3 Configurazione della BotMachine...4 Configurazione interfaccia di rete...4 Attivazione e configurazione BOT Telegram...5 Amministrazione del demone BotMachine...7 Ispezionare i log del demone BotMachine...7 Cambiare la password di sistema per l'utente botmachine e/o root...8 Fermare o riavviare il sistema Linux...8 Connessione al database MySQL integrato...8 Interfaccia web...9 Assistenza remota...10

3 Descrizione della BotMachine La BotMachine è un sistema per la ricezione e archiviazione su database di messaggi di tipo: testo, messaggio vocale, foto e posizione GPS dalla piattaforma Telegram. Il sistema BotMachine è composto da: il software BotMachine Linux box SXPI Alimentatore 220V - 12Vcc. Requisiti per l'installazione Per poter installare con successo la BotMachine è necessario disporre di: 1. Uno smatphone con istallato e attiva l'applicazione Telegram. 2. Una presa ethernet 10/100Mbit per collegare la BotMachine alla propria rete LAN. Oltre alla connessione fisica alla rete è necessario disporre di un indirizzo IP libero e univoco, l'indirizzo di subnet e quello del gateway per l'accesso ad internet. Se l'accesso ad internet è protetto da firewall, verificare che sia abilitato il traffico in uscita HTTPS (porta TCP 443) e NTP (porta 123 UDP). Nel caso non si disponga di questi dati è necessario contattare il proprio amministratore di rete. 3. Una presa di corrente di rete a 220 VAC o una tensione di 12VCC Installazione della BotMachine Collegate il cavo Ethernet (non in dotazione) tra la box BotMachine e la propria rete LAN. Collegate la BotMachine alla rete elettrica tramite l'alimentatore 220V / 12V fornito in dotazione. Accesso alla console di gestione Linux Si può accedere alla console di gestione in due modi, tramite la rete locale LAN collegandovi in SSH, oppure direttamente tramite la porta seriale. Accesso tramite collegamento criptato in SSH L'interfaccia di rete della BotMachine è preconfigurata con l'indizzo ip di default per poter accedervi è necessario configurare la Vs scheda di rete sulla stessa classe di indizzi IP ad esempio Pagina 1

4 Potete ora accedere tramite una connessione criptata SSH tramite il programma client putty.exe Nel caso utilizziate Linux o Mac potete connettervi in SSH aprendo una finestra "Terminale" digitando: ssh botmachine@ ssh -l botmachine inserite nel campo Host Name l'indirizzo IP della BotMachine ovvero alla voce Connection Type selezione SSH cliccate poi su OPEN. Schermata di login iniziale. A questo punto potete accedere utilizzando le seguenti credenziali: Credenziali di accesso: Utente: Utente: bootmachine root Password: Password botmachine botmachine Pagina 2

5 Nota: La password dell'utente root verrà richiesta ogni volta che eseguirete un comando di tipo sudo Configurazione della BotMachine Configurazione interfaccia di rete L'installazione Linux viene fornita con l'indirizzo IP di default: , se compatibile con la vostra reta LAN e non è assegnato ad altro apparato, potete saltare al passo successivo. Per modificare permanentemente l'indirizzo IP del sistema assistita eseguite da console il comando: è possibile effettuarlo lanciando procedura sudo setuplan Verranno richiesti indirizzo IP, subnet e gateway. Al termine della procedura, riavviare il sistema. Pagina 3

6 Attivazione e configurazione BOT Telegram Di seguito è descritta la procedura per l'attivazione di un canale BOT Telegram. Pre requisiti un account Telegram attivo su smatphone, tablet, pc o WEB ( Procedere come segue: 1. Aprire Telgram sul proprio smartphone e contattare e attendere il messaggio di benvenuto e cliccare su "RIAVVIA": 2. Inviare al il messaggio /newbot e attendere la risposta.successivamente inserire il nome da assegnare al proprio BOT, avendo cura che termini con il testo "bot" es. AreaSX_bot 3. Se il nome scelto risulta essere ritorna il token del nuovo BOT (HTTP API) Pagina 4

7 4. Ottenuto il token telegram, raggiungere l'interfaccia WEB della BotMachine all'url e autenticarsi con le credenziali di default username: admin password: admin 5. Nel menù a sinistra, box UTILITY cliccare sulla voce "Preferenze": Pagina 5

8 6. Nella pagina Preferenze Bot inserire il token precedentemente ottenuto nel campo "Token Bot Telegram" e cliccare sul tasto "Salve le modifiche" In questa sezione è anche possibile modificare il messaggio di benvenuto verso gli utenti che accedono al Bot appena attivato. 7. Per verificare il corretto funzionamento della BotMachine, è possibile inviare un messaggio Telegaram dal prorio smatphone al (@AreaSx_bot) Amministrazione del demone BotMachine Il demone BotMachine può essere controllato tramite i comandi console: sudo /etc/init.d/botmachine stop sudo /etc/init.d/botmachine start sudo /etc/init.d/botmachine restart Per ogni comando inviato è necessario digitare successivamente la passwordi di root (default: botmachine) Questa operazione può essere effettuata anche da remoto tramite una connessione SSH. Ispezionare i log del demone BotMachine Per analizzare la corretta esecuzione del demone è possibile ispezionare il file di log con il comando che segue: sudo tail f /home/botmachine/log/botmachine.log oppure sudo./log Questa operazione può essere effettuata anche dalla console remota. Pagina 6

9 Cambiare la password di sistema per l'utente botmachine e/o root Per modificare la password Linux dell'utente botmachine è sufficiente loggarsi come tale, sulla console da remoto in SSH, e digitare il comando: sudo passwd e digitare la nuova password. Fermare o riavviare il sistema Linux Le operazioni di riavvio e/o shutdown possono essere effettuate esclusivamente come superuser o root. Per riavviare il sistema digitare il comando: sudo reboot seguito dalla password di root (default: botmachine). Per fermare il sistema il comando digitare il comando: sudo halt seguito dalla password di rooto (default: botmachine). Per riavviare il sistema senza accesso alla console e potendo accedere fisicamente alla BotMachine, tenere premuto aiutandosi con una penna o una punta, il pulsante di reset per 5 Sec. Per effettuare lo shutdown, premere lo stesso pulsante per 15 secondi, fino all'accensione in rosso del led di status. Connessione al database MySQL integrato Per accedere da remoto al database MySQL integrato nella BotMachine, tramite un prioprio applicativo o un apposito tools è possibile utilizzare le credenziali di default che seguono: indirizzo ip: o (ip di default della BotMAchine) porta tcp/ip: 3306 nomeutente: botmachine password: botmachine I messaggi testo e multimediali Telegram ricevuti dalla BotMachine, vengono archiviati nel database botmachine tabella inpmsgqueue. Nella tabella autoresponder è possibile inserire i record per generare le risposte automatiche del bot. Di seguito un esempio di query: INSERT INTO 'autoresponder' ('search_key', 'text', 'msgtype') VALUES ('parola da cercare', 'Risposta da dare', 'text'); Il campo msgtype può avere il valore 'text', risposta in formato testo; o qrcode, la risposta verà fornita come immagine Qrcode. Nota: Onde evitare il malfunzionamento del sistema BotMachine si sconsiglia di modificare / rimuovere campi nel database. Pagina 7

10 Interfaccia web La BotMachine viene fornita con installata una completa interfaccia WEB la visualizzazione dei messaggi Telegram ricevuti: Inserire e/o modificale le regole dell autoresponder: Per accedere all'interfaccia WEB della BotMachine è sufficiente lanciare il browser internet su un qualsiasi PC e digitare l'indirizzo WEB: o o indirizzo ip configurato>/. Pagina 8

11 Le credenziali di accesso di default per l'interfaccia web sono: username admin password admin. Assistenza remota Per richiedere assistenza o aggiornamenti sul prodotto BotMachine da parte del personale di Area SX è necessario rendere accessibile la console SSH su IP pubblico. Con una normale ADSL è sufficiente effettuare il NAT o il port forwarding della porta TCP 22 (questa configurazione varia da router a router). Pagina 9

12 E un prodotto: Area SX S.r.l. INFORMATICA & MICROELETTRONICA Via Stefano Longanesi 25, ROMA Tel: Fax: info@areasx.com - Pagina 10