formigarafa / robotito

Terminal shell accessible through a jabber connection
MIT License
72 stars 18 forks source link
jabber remote-control remote-shell ruby shell

Robo-TiTO

Robo-TiTO gives you an alternative access to a remote machine terminal.

Main Objective

Sometimes you cannot reach an ssh ip:port of an host by a lot of reasons:

Robo-TiTO allows you circumvent these problems and execute commands remotely on your server.

Get involved

Drop a :+1: or a comment on Robo-TiTO's Research

Description

This is a light-weight bot connecting through XMPP (eg.: GTalk) that allows you run shell command remotely. Robo-TiTO will not open a port to be accessed, instead of that, it will connect to a jabber service. You send your commands in a chat session and receive terminal output back. You will be "talking" to your server like you always did, but now you will get some answers from it.

Requirements

Installation

bundle install

# adjust the bot credentials and server settings using the example file provided
cp config/credentials.rb.example config/credentials.rb
vim config/credentials.rb

start with

./robotitod start

check additional available options with

./robotitod -h

Authentication

Robo-TiTO uses OTP (One Time Password) for authentication. You can use Google Authenticator, available for Android and iPhone, You just need to add a time based account entry with the credentials you specified in the credentials.rb file.

Thanks

Philippe Creux and its suggestion on gist

https://gist.github.com/258561