Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/formigarafa/robotito
Terminal shell accessible through a jabber connection
https://github.com/formigarafa/robotito
jabber remote-control remote-shell ruby shell
Last synced: 9 days ago
JSON representation
Terminal shell accessible through a jabber connection
- Host: GitHub
- URL: https://github.com/formigarafa/robotito
- Owner: formigarafa
- License: mit
- Created: 2010-02-26T04:01:21.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2018-10-03T20:06:37.000Z (about 6 years ago)
- Last Synced: 2023-03-10T23:52:35.957Z (over 1 year ago)
- Topics: jabber, remote-control, remote-shell, ruby, shell
- Language: Ruby
- Homepage:
- Size: 43.9 KB
- Stars: 69
- Watchers: 7
- Forks: 18
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
* host is behind NAT
* firewall protection
* remote host with dynamic ip
* port redirections
* annoying administrators
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](https://github.com/formigarafa/robotito/issues/4)
## 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
* Ruby >= 2.0.0
### 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](https://github.com/google/google-authenticator), available for [Android](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2) and [iPhone](https://itunes.apple.com/en/app/google-authenticator/id388497605),
You just need to add a time based account entry with the credentials you specified
in the credentials.rb file.
## Thanks
[Philippe Creux](http://github.com/pcreux) and its [suggestion on gist](https://gist.github.com/258561)
https://gist.github.com/258561