OwnYourData wird vom gemeinnützigen Verein zur Förderung der selbstständigen Nutzung von Daten entwickelt. Alle Elemente davon sind unter der MIT-Lizenz veröffentlicht und auf Github verfügbar. Wenn du ebenfalls an OwnYourData mitarbeiten möchtest, findest du auf dieser Seite die notwendigen Informationen.
Inhalt
Die Architektur von OwnYourData trennt zwischen der verschlüsselten Datenspeicherung im Datentresor und der Verarbeitung von Daten durch Plugins wie im folgenden Bild dargestellt:
Das zentrale Element zur Speicherung und Verwaltung von Daten in OwnYourData ist der Datentresor. Er besteht im wesentlichen aus einer Datenbank und einer Zugriffsverwaltung darauf mittels OAuth2. Plugins und Services müssen mit einem Manifest registriert werden wodurch eine ID und ein Secret erstellt wird. Eine Client-Anwendung (Plugin) erhält nach Bereitstellung von ID und Secret einen Token mit dem ein Zugriff auf die im Manifest definierten Daten möglich ist.
Source Code des Datentresors: https://github.com/ownyourdata/oyd-pia2
Docker Image für Datentresor: https://hub.docker.com/r/oydeu/oyd-pia2
Swagger API Dokumentation: https://api-docs.ownyourdata.eu/datavault
Anmerkung: der interne Name PIA für den Datentresor ist die Abkürzung für “Personal Information Archive”
Daten werden im Datentresor Ende-zu-Ende verschlüsselt. D.h. jede Datenquelle soll beim Speichern von Daten diese mittels Public Key verschlüsseln und Plugins die Daten verarbeiten benötigen den Private Key. Eine ausführliche Dokumentation für den Zugriff auf den Datentresor ist in der Spezifikation der OwnYourData Smartphone App (nur in Englisch verfügbar) enthalten.
Ein Manifest beschreibt ein Plugin und definiert auf welche Daten in welcher Form zugegriffen werden darf. Es ist in JSON und enthält folgende Felder:
name: angezeigter Nameidentifier: eindeutiger, interner Namelanguage: Sprache (de|en)version: Version als ZeichenketteversionNumber: Version als Ganzzahldescription: kurze Beschreibung der App / des Servicesinfo_url: Link zu online Beschreibungpicture: base64 enkodiertes Bild das im Datentresor angezeigt wirdpermissions: Array der Listen (Repos) auf die zugegriffen werden darf; mögliche Zugriffe sind:
read: lesenwrite: schreibenupdate: änderndelete: löschen*: lesen, schreiben, ändern und löschender Syntax für jeden Eintrag ist {Liste}:{Zugriff}; bei der Angabe der Liste ist am Ende das Wildcard * möglich
sources: Array der angebotenen Datenquellen mit folgenden Attributen:
name: angezeigter Nameidentifier: eindeutiger, interner Namedescription: kurze Beschreibung der Datenquelletype: Typ der Datenquelle (pull|push)inactive_duration: Anzahl der Tage ohne Daten bevor eine Warnung ausgegeben werden sollconfig: Konfigurationsmöglichkeiten der Datenquelle:
form: HTML Code zur Darstellung der Konfigurationsoptionenfields: Array mit Namen der Felder in formdefaults: Standardwerte der Konfigurationsparameterrepos: Beschreibung der relevanten Listenanswers: Array der Fragen die mit diesem Plugin beantwortet werden können – Struktur so wie weiter unten beschriebenreports: Array der Einträge in der periodischen Datenzusammenfassung die mit diesem Plugin bereitgestellt werden – Struktur so wie weiter unten beschriebenviews: Array der im Datentresor angezeigten Applikationen mit folgenden Attributen:
name: angezeigter Nameidentifier: eindeutiger, interner Namedescription: kurze Beschreibung der Applikationurl: Webadresse der Applikationdocker: eindeutiger Name des Docker Imagespicture: base64 enkodiertes Bild das im Datentresor angezeigt wirdmobiles: Array der im Datentresor angezeigten Applikationen die nur in der Smartphone App angezeigt werden sollen mit den gleichen Attributen wie viewstasks: Array der periodischen Aufgaben mit folgenden Attributen:
name: angezeigter Nameidentifier: eindeutiger, interner Namecommand: base64 enkodiertes Bash Skript das ausgeführt werden sollschedule: Webadresse der Applikationanswers: Array der Fragen die mit diesem Plugin beantwortet werden können mit folgenden Attributen:
name: angezeigter Nameshort: angezeigter Kurznameidentifier: eindeutiger, interner Namecategory: Text mit frei wählbarer Kategorieinfo_url: Webadresse mit weiterführenden Informationenrepos: Array mit relevanten Listen zur Beantwortung der Fragenanswer_order: numerischer Wert zur aufsteigenden Sortierung aller Antwortenanswer_view: base64 enkodierter Client-seitiger UI code einer Shiny Anwendunganswer_logic: base64 enkodierter Server-seitiger Code einer Shiny Anwendungreports: Array der Einträge in der periodischen Datenzusammenfassung mit folgenden Attributen:
name: angezeigter Name in der Datenzusammenfassungidentifier: eindeutiger, interner Namerepos: Array mit relevanten Listen zur Beantwortung der Frageninfo_url: Webadresse mit weiterführenden Informationendata_prep: base64 enkodiertes Bash Skript das ausgeführt wird um Daten in data_snippet bereitzustellendata_snippet: base64 enkodierter R-code mit Platzhaltern die durch das Skript in data_prep befüllt werdenreport_view: base64 enkodierter R-Markdown code der auf die Variablen in data_snippet zugreifen kannreport_order: numerischer Wert zur aufsteigenden Sortierung der Einträge in der DatenzusammenfassungIn folgendem Github Repository befinden sich Beispiele für die Erstellung eines Manifests: https://github.com/OwnYourData/oyd-manifest
Plugins (Erweiterungen) in OwnYourData stellen die Funktionen zum Sammeln, Auswerten und Anzeigen von Daten zur Verfügung. Dazu müssen sie sich via OAuth2 beim Datentresor anmelden und können dann auf die im angegebenen Manifest definierten Daten zugreifen. Der Zugriff auf den Datentresor ist in Tutorials für folgende Sprachen demonstriert:
Außerdem gibt es ein R-Package um Shiny-Apps für OwnYourData zu erstellen. Verwende die folgenden Applikationen als Referenz für eigene Entwicklungen:
Zur einfachen Installation von Plugins können Manifeste bei einem Plugin-Anbieter gespeichert werden. Diese dort gespeicherten Plugins werden – abhängig von der Sprachversion – auf der Pluginseite des Datentresors angezeigt. Das Manifest eines eigenen Plugins kann ebenfalls hochgeladen werden.
Source Code für Plugin-Anbieter: https://github.com/ownyourdata/oyd-sam
Anmerkung: der interne Name SAM für Plugin-Anbieter ist die Abkürzung für “Store for AlgorithMs”
Die unterschiedlichen Komponenten von OwnYourData können abhängig von eigenen Vorlieben auf unterschiedlichen Geräten betrieben werden. Dieser Abschnitt beschreibt die gängisten Möglichkeiten.
Der Online Datentresor unter https://data-vault.eu ist die einfachste und komfortabelste Art der Nutzung von OwnYourData. Auf dieser Seite kann ein neues Konto angefordert werden und nach Bestätigung der Emailadresse stehen der Datentresor mit allen Erweiterungen zur Verfügung.
Um OwnYourData zu installieren und auszuführen ist Docker notwendig. Die Installation des Datentresors erfolgt auf der Commandline und erfordert folgende 5 Docker Images:
Für die Konfiguration und den Start der Docker Container steht ein Skript auf Github zur Verfügung. Führe den folgenden Befehl in einem leeren Verzeichnis aus, um das Skript herunterzuladen und zu starten:
bash <(wget -qO- https://raw.githubusercontent.com/OwnYourData/oyd-pia2/master/local/oyd_local_setup.sh)
Folgende vier Information musst du dafür bereitstellen:
Der Datentresor ist dann unter der jeweiligen IP-Adresse verfügbar und es können Benutzerkontos eingerichtet werden. Die folgenden Blogbeiträge beschreiben die Verwendung von OwnYourData am eigenen NAS (z.B. Synology) und auf einem Asus VivoMini.
Für den Zugriff auf den Datentresor und als Sensorplattform steht auch eine eigene App für Android und iOS zur Verfügung.
Ebenfalls gibt es für Android-basierte Systeme die Möglichkeit die APK-Datei hier herunterzuladen.
Der Source Code für den mobilen Datentresor (entwickelt mit react-native) steht hier zur Verfügung: https://github.com/OwnYourData/oyd-phoneapp
