Quelltext der Seite Spacecontrol

{{Infobox Projekt
|name            = Spacecontrol
|status          = stable
|autor           = [[Benutzer:bobapple|bobapple]], [[Benutzer:schinken|schinken|rel=author]]
|beschreibung    = Spacesteuerung über SSH
|image           = Spacecontrol cat img.jpg
|imagesize       = 280
}}
[[Category:Infrastruktur]]
[[Category:Software]]

== Beschreibung ==

Bei uns gibt es einige Anhänger der Commandline, daher wollten wir unsere gängigen Tools nicht nur per Website steuern, sondern auch im Terminal. Viele der Tools können mit einer REST-Api angesteuert werden, das macht es sehr einfach Clients zu erstellen.

== SSH ==

Die Steuerung soll für alle Mitglieder einfach erreichbar sein. Prinzipiell hat sich hier für uns also SSH angeboten. Wir sehen aber einen Nachteil darin jedem Mitglied einen SSH-User samt Passwort zu erstellen nur um ein paar CLI-Tools bedienen zu können. Die Möglichkeit einen einzigen User zu erstellen und das Passwort zu verbreiten, bietet uns aber auch nicht genügend Komfort. Bei dem Vorschlag einen SSH-User zu erstellen, der garkein Passwort besitzt zieht es wohl jedem Administrator die Zehennägel hoch. Wir haben uns dennoch dafür entschieden. Demensprechend musste das ganze abgesichert werden. Die erste Stufe ist, dass der Login nur vom Internen Netz möglich ist. Die nächste Stufe ist, dass der User direkt in einem chroot landet, in dem sich nur das nötigste befindet.

=== chroot ===

Das chroot wird mit Hilfe von jailkit erstellt. Mit den Tools die es mitbringt, kann man unter anderem auf einfache weise Binaries kopieren, da verwendete Libraries mitkopiert werden. Einen weiteren Vorteil bietet das Tool jk_chrootsh, das, wenn es als Login-Shell benutzt wird, den entsprechenden User direkt nach dem Login in ein chroot sperrt. Die CLI-Tools sind in Python geschrieben, daher befindet sich python2.7 zusammen mit allen Standard-Libs ebenfalls im chroot.

=== limits ===
Der User "spacecontrol" darf ausschließlich in sein Homeverzeichnis im chroot schreiben. Auf dem System hat er ein Volumen von maximal 100MB die er beschreiben darf (quota). Zusätzlich kann der User maximal 20 Prozesse gleichzeitig ausführen und maximal 200000kb Memory auf dem System nutzen.

=== busybox ===

Um die ganze Umgebung noch weiter einzuschränken wird als Shell busybox verwendet. Durch die vielen Konfigurationsmöglichkeiten lässt sich busybox auf eine sehr minimalistische Shell reduzieren. Leider gibt es keine Möglichkeit beim Login eine "Message of the day" auszuliefern. Um das aber dennoch zu ermöglichen ist ein kleiner patch für busybox entstanden. Sowohl die Config als auch der Patch befinden sich auf github: https://github.com/schinken/spacecontrol/tree/master/busybox

                                           _             _ 
  backspace                               | |           | |
  ___ _ __   __ _  ___ ___  ___ ___  _ __ | |_ _ __ ___ | |
 / __| '_ \ / _` |/ __/ _ \/ __/ _ \| '_ \| __| '__/ _ \| |
 \__ \ |_) | (_| | (_|  __/ (_| (_) | | | | |_| | | (_) | |
 |___/ .__/ \__,_|\___\___|\___\___/|_| |_|\__|_|  \___/|_|
     | |
     |_|   available tools: door          status
                            webrelais     ledboard

== Command Line Tools ==

Für das Spacecontrol stehen mehrere Commandline-Tools zur Verfügung welche meist in Python geschrieben sind. Hierzu wurde [http://docs.python.org/2/howto/argparse.html argparse] verwendet, um die Parameter komfortabel abzufragen. Die bisherigen Tools befinden sich im [https://github.com/schinken/spacecontrol Spacecontrol GitHub-Repository]. Für die REST-Anfragen wurde die Library [http://docs.python-requests.org/en/latest/ python-requests] genutzt, welche ein schönes Interface für HTTP-Requests zur Verfügung stellt.

=== Webrelais ===

Steuert die einzelnen Relais unserer Relaiskarte. Hier kann man ganz einfach das Notlicht oder auch die Rundumleuchte anschalten, sowie den aktuellen Status aller Relais erfragen. Relais die eine Authentifizierung besitzen können zur Zeit nicht geschalten werden - Feature: Pending.

=== Door ===

Ermöglicht das Öffnen und Schliessen der Tür mit dem eigenen Passwort. Das Passwort wird selbstverständlich nicht auf der Commandline ausgegeben und das Authentifizieren erfolgt über HTTPS.

=== Status ===

Zeigt den aktuellen Status der Open/Close API an. Dazu gehören die Anzahl der Member Devices, Member, unbekannte Geräte sowie die Nicknames der Mitglieder.

=== Ledboard ===

Dieses Tool stellt eine Schnittstelle zum LED Board dar. Hiermit lassen sich aktuell Textnachrichten an das Ledboard senden. Ein geplantes Feature ist die Anzeige von GIF-Animationen auf dem LED Board, welche einfach per Parameter angegeben werden.