userdocexport improved

manual pages updated
This commit is contained in:
lars 2005-08-08 10:52:30 +00:00
parent 5543ff8041
commit f49d0d7cf5
3 changed files with 240 additions and 102 deletions

View file

@ -1,22 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<meta name="robots" content="index,nofollow">
<title>CryptoBox - howto</title>
<link rel=stylesheet type=text/css charset=utf-8 media=all href=../cryptobox.css>
</head>
<body>
<div id="page" lang="en" dir="ltr"><!-- start page -->
<h1 id="title"><a title="Click to do a full-text search for this title" href="/wikis/howto/CryptoBox?action=fullsearch&amp;value=%22CryptoBox%22&amp;context=180">CryptoBox</a></h1>
<div lang="en" id="content" dir="ltr">
<a id="top"></a>
<ol>
<p><a href="/wikis/howto/CryptoBoxEn">-&gt; english overview &lt;-</a> <ol>
<li>
<a href="#head-97e3ed911f9a14c537e247a2719dc86b73056dde">Überblick</a>
@ -30,6 +14,10 @@
<a href="#head-81e691d388494e38d5f72c5a2f7abf5632625b6d">Was brauchst du?</a>
</li>
<li>
<a href="#head-ff0e3b1584bc46aef5854f09f75b372c707fbf29">Spezifikationen</a>
</li>
</ol>
<li>
@ -48,6 +36,10 @@
<a href="#head-2dbc1550a8c92d00f6cbb94131b3e90651792212">Optimierung</a>
</li>
<li>
<a href="#head-fabf23fd82a6a21311b13862d2d955056114a608">Vor- &amp; Nachteile</a>
</li>
</ol>
<li>
@ -66,6 +58,10 @@
<a href="#head-64a0a5e5f036e433b2a7101016e6e6af96f5a29d">Versionsverwaltung</a>
</li>
<li>
<a href="#head-fabf23fd82a6a21311b13862d2d955056114a608-2">Vor- &amp; Nachteile</a>
</li>
</ol>
<li>
@ -73,28 +69,28 @@
</li>
</ol>
<p> </p>
</p>
<hr>
<p> </p>
<h2 id="head-97e3ed911f9a14c537e247a2719dc86b73056dde">Überblick</h2>
<p>Die CryptoBox ist eine Live-CD mit der sich jeder alte Rechner in Sekundenschnelle in einen verschlüsselnden Server umwandeln lässt. Damit kannst du sensible Daten speichern, ohne dass du Ahnung von Kryptografie haben musst. Das <a href="/wikis/howto/CryptoBoxKonzept">CryptoBoxKonzept</a> beschreibt die technischen Feinheiten näher. </p>
<p>Die CryptoBox ist eine <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Live-cd"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">Live-CD</a> mit der sich jeder alte Rechner in Sekundenschnelle in einen verschlüsselnden Server umwandeln lässt. Damit kannst du sensible Daten speichern, ohne dass du etwas über <a class="badinterwiki" title="WikiePediaDe" href="/wikis/howto/InterWiki"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiePediaDe]" height="16" width="16">Kryptografie</a> wissen musst. </p>
<h3 id="head-b44206765ef44c91cbfd0ba23b33b43a192eeb8d">Was kann die CryptoBox?</h3>
<ul>
<li><p> Ein vollständiger <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Samba_%28Software%29"><img src="/moin-base/modern/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">Samba</a>-Dateiserver (für alle freien Betriebssysteme, sowie Windows und Mac OS) bietet Zugriff auf deine Daten. </p>
<li><p> Ein vollständiger <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Samba_%28Software%29"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">Samba</a>-Dateiserver (für alle freien Betriebssysteme, sowie Windows und Mac OS) bietet Zugriff auf deine Daten. </p>
</li>
<li><p> Deine Daten werden mit <a class="external" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> AES</a> verschlüsselt (256 Bit Schlüssellänge). </p>
<li><p> Deine Daten werden mit <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">AES</a> verschlüsselt (256 Bit Schlüssellänge). </p>
</li>
<li><p> Das Web-Interface bietet dir kinderleichten Zugriff auf alle Funktionen der CryptoBox. </p>
<li><p> Die Web-Oberfläche bietet dir kinderleichten Zugriff auf alle Funktionen der CryptoBox. </p>
<ul>
<li><p> Verwaltung des verschlüsselten Dateisystems </p>
</li>
<li><p> Konfiguration der Netzwerk- und Sicherheitseinstellungen </p>
</li>
<li><p> abgesehen von deinem <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Webbrowser"><img src="/moin-base/modern/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">Browser</a> brauchst du keine weiteren Programme </p>
<li><p> Abgesehen von deinem <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Webbrowser"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">Browser</a> brauchst du keine weiteren Programme </p>
</li>
</ul>
</li>
@ -121,19 +117,75 @@
</li>
</ul>
<h3 id="head-ff0e3b1584bc46aef5854f09f75b372c707fbf29">Spezifikationen</h3>
<div>
<table>
<tr>
<td>
<p>System</p>
</td>
<td>
<p>Debian/Linux basierte Live-CD</p>
</td>
</tr>
<tr>
<td>
<p>benötigter Computer</p>
</td>
<td>
<p> "ausrangierter" PC (i386 ab p1 mind. 32MB RAM)</p>
</td>
</tr>
<tr>
<td>
<p>unterstützte Clients</p>
</td>
<td>
<p><a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Liste_der_Betriebssysteme"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">*nix; *bsd; Windows; Mac OS</a></p>
</td>
</tr>
<tr>
<td>
<p>interner Fileserver</p>
</td>
<td>
<p><a class="external" href="http://samba.org"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> samba</a> (Netzwerkfreigaben)</p>
</td>
</tr>
<tr>
<td>
<p>Benutzerschnittstelle</p>
</td>
<td>
<p>per Browser bedienbar (<a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Perl"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">Perl</a>-Webinterface via https)</p>
</td>
</tr>
<tr>
<td>
<p>Verschlüsselung</p>
</td>
<td>
<p><a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/Advanced_Encryption_Standard"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">AES</a> via device-mapper</p>
</td>
</tr>
</table>
</div>
<p>Das <a href="/wikis/howto/CryptoBoxKonzept">CryptoBoxKonzept</a> beschreibt die technischen Feinheiten etwas näher. </p>
<h2 id="head-4a62d30abaeb5cd5d2e4545aabd13e81a819504f">Nutzung</h2>
<h3 id="head-52db644c60a52bcaed2c809cb51e1255bec6eb6e">Einrichtung</h3>
<ol type="1">
<li><p>Lade dir ein <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/ISO-Image"><img src="/moin-base/modern/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">iso-Image</a> aus dem <a class="external" href="https://systemausfall.org/toolforge/cryptobox/download"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> Download-Bereich</a> herunter. <em>[in wenigen Tagen verfügbar]</em> </p>
<li><p>Lade dir ein <a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/ISO-Image"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">iso-Image</a> aus dem <a class="external" href="https://systemausfall.org/toolforge/cryptobox/download"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Download-Bereich</a> herunter. <em>[Die Entwicklung der CryptoBox befindet sich noch in einer frühen Phase. Momentan testen wir die ersten lauffähigen, funktionstüchtigen Versionen. In wenigen Tagen wird das erste Release verfügbar sein.]</em> </p>
</li>
<li><p>Kopiere dieses Image auf eine CD (RW). </p>
</li>
<li><p>Starte den zukünftigen Datei-Server mit der CryptoBox-LiveCD. </p>
<li><p>Starte den zukünftigen Datei-Server mit der CryptoBox-LiveCD im Laufwerk. </p>
</li>
<li><p>Benutze das Web-Interface der CryptoBox für: </p>
<li><p>Benutze die Web-Oberfläche der CryptoBox für: </p>
<ol type="1">
<li><p>die Netzwerk- und Sicherheitseinstellungen </p>
</li>
@ -158,20 +210,53 @@
<h3 id="head-2dbc1550a8c92d00f6cbb94131b3e90651792212">Optimierung</h3>
<ol type="1">
<li><p>Du hast einen Verbesserungsvorschlag oder findest gar einen Fehler. </p>
<p>Du hast einen Verbesserungsvorschlag oder findest gar einen Fehler: </p>
<ul>
<li><p> Schreib's in unsere <a class="external" href="https://systemausfall.org/trac/cryptobox"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Gedankensammelstelle</a> - wir beheben das Problem oder nehmen, bei Unklarheiten, Kontakt mit dir auf. </p>
</li>
<li><p>Schreib's in unsere <a class="external" href="https://systemausfall.org/trac/cryptobox"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> Gedankensammelstelle</a> </p>
</ul>
<h3 id="head-fabf23fd82a6a21311b13862d2d955056114a608">Vor- &amp; Nachteile</h3>
<p>Hier werden markantesten Vor- und Nachteile der CryptoBox Live-CD aus Sicht der NutzerInnen vorgestellt. </p>
<ul>
<li><p> Vorteile: </p>
<ul>
<li><p> einfache Handhabung - kein spezielles Fachwissen notwendig </p>
</li>
<li><p>Wir beheben das Problem oder nehmen, bei Unklarheiten, Kontakt mit dir auf. </p>
<li><p> erfordert keinerlei Softwareinstallation </p>
</li>
</ol>
<li><p> mehrere Rechner im Netz können zentral sensible Daten speichern und teilen </p>
</li>
<li><p> im ausgeschaltenen Zustand sind die Daten für Unbefugte unbrauchbar (starke Verschlüsselung) </p>
</li>
<li><p> das System ist resistent gegenüber Schadsoftware (Viren, Würmer), da die CD nicht beschreibbar ist </p>
</li>
<li><p> die Übertragung des Passworts zur Aktivierung der Crypto-Daten erfolgt verschlüsselt (<a class="interwiki" title="WikiPediaDe" href="http://de.wikipedia.org/wiki/HTTPS"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[WikiPediaDe]" height="16" width="16">HTTPS</a>) </p>
</li>
<li><p> basiert auf einer der stabilsten und sichersten Linux Distributionen (<a class="external" href="http://ww.debian.org"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian</a>) </p>
</li>
<li><p> minimale Hardware-Anforderungen </p>
</li>
</ul>
</li>
<li><p> Nachteile: </p>
<ul>
<li><p> ein extra Rechner ist notwendig (Stromverbrauch, Platzbedarf) </p>
</li>
<li><p> das lokale Netz muss vertrauenswürdig sein </p>
</li>
<li><p> die CryptoBox-CD muss gegen einen böswilligen Austausch gesichert werden (z.B. ein physisches Siegel) </p>
</li>
</ul>
</li>
</ul>
<h2 id="head-40e05c4967bb03e29499d0696362590be5c646d8">Entwicklung</h2>
<p>Eine CryptoBox-LiveCD wird in folgenden Schritten erstellt: </p>
<ol type="1">
<li><p>ein minimales <a class="external" href="http://www.debian.org"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> debian</a>-System erzeugen (mit <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild"><img src="/moin-base/modern/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">dfsbuild</a>) </p>
<li><p>ein minimales <a class="external" href="http://www.debian.org"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian</a>-System erzeugen (mit <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">dfsbuild</a>) </p>
</li>
<li><p>spezifische Anpassungen des Systems vornehmen </p>
</li>
@ -186,36 +271,55 @@
<h3 id="head-ecfc074956b9f39a0fbfab314758db9cf39df4ce">Anforderungen</h3>
<ul>
<li><p> ein <a class="external" href="http://www.debian.org"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> debian</a>-System (eine <em>chroot</em>-Umgebung genügt auch) </p>
<li><p> ein <a class="external" href="http://www.debian.org"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian</a>-System (eine <em>chroot</em>-Umgebung genügt auch) </p>
</li>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=qemu"><img src="/moin-base/modern/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">qemu</a> zum Testen des erzeugten Systems in einer virtuellen Umgebung </p>
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=qemu"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">qemu</a> zum Testen des erzeugten Systems in einer virtuellen Umgebung </p>
</li>
</ul>
<h3 id="head-c90560cd155843d48d791e731b9b6c0ee852dc9d">Mitmachen</h3>
<p>Beteilige dich an der Entwicklung der CryptoBox und werde reich und schön! <img src="/moin-base/modern/img/smile4.png" alt=";)" height="15" width="15"> <br>
Nee im Ernst, wir freuen uns über jeden partizipierenden Menschen. Du wirst in einem entspannten Team reichlich Erfahrungen sammeln, eine nützliche Sache voranbringen und - wer weiß - vielleicht macht dich das auch schön, hehe. Schreib eine Mail an <em>svn-cryptobox[at]lists.systemausfall.org</em> und hab Spaß. </p>
<p>Beteilige dich an der Entwicklung der CryptoBox und werde reich und schön! <img src="/moin-base/greenthumb/img/smile4.png" alt=";)" height="15" width="15"> <br>
Nee im Ernst, wir freuen uns über jeden partizipierenden Menschen. Du wirst in einem entspannten Team reichlich Erfahrungen sammeln, eine nützliche Sache voranbringen und - wer weiß - vielleicht macht dich das auch schön. Schreib eine Mail an <em>svn-cryptobox[at]lists.systemausfall.org</em> und hab Spaß. </p>
<h3 id="head-64a0a5e5f036e433b2a7101016e6e6af96f5a29d">Versionsverwaltung</h3>
<p>Wir verwenden <a class="external" href="http://subversion.tigris.org"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> subversion</a> zur Koordination der Arbeit an der CryptoBox. Der Lese-Zugang zum Repository ist öffentlich. </p>
<p>Wir verwenden <a class="external" href="http://subversion.tigris.org"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> subversion</a> zur Koordination der Arbeit an der CryptoBox. Der Lese-Zugang zum Repository ist öffentlich. </p>
<p>Das Repository ist über folgende Adressen erreichbar: </p>
<dl>
<dt>Kommandozeile</dt>
<dd><p><a href="https://svn.systemausfall.org/svn/cryptobox"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> https://svn.systemausfall.org/svn/cryptobox</a> </p>
<dd><p><a href="https://svn.systemausfall.org/svn/cryptobox"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> https://svn.systemausfall.org/svn/cryptobox</a> </p>
</dd>
<dt>Web-Interface</dt>
<dd><p><a href="https://systemausfall.org/websvn/cryptobox"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> https://systemausfall.org/websvn/cryptobox</a> </p>
<dd><p><a href="https://systemausfall.org/websvn/cryptobox"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> https://systemausfall.org/websvn/cryptobox</a> </p>
</dd>
</dl>
<h3 id="head-fabf23fd82a6a21311b13862d2d955056114a608-2">Vor- &amp; Nachteile</h3>
<ul>
<li><p> Vorteile: </p>
<ul>
<li><p> schnelle Aktualisierung, durch das einfache build-System </p>
</li>
<li><p> Verwendung von Debian/stable Paketen (no dirty Hacks) </p>
</li>
</ul>
</li>
<li><p> Nachteile: </p>
<ul>
<li><p> ? </p>
</li>
</ul>
</li>
</ul>
<h2 id="head-a3671f2dd22b53b402496f62c4f62c847220f2a1">Rechtliches</h2>
<ol type="1">
<li><p>Alle Skripte unterliegen der <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> GPL</a> - sie sind also quasi vollständig frei. </p>
<li><p>Alle Skripte unterliegen der <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> GPL</a> - sie sind also quasi vollständig frei. </p>
</li>
<li><p>Die Dokumentation unterliegt einer <em><a class="external" href="http://creativecommons.org/licenses/by-sa/2.5/"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> Creative Commons</a></em>-Lizenz, damit wird die Möglichkeit der freien Verbreitung des gesammelten Wissens gewährleistet. </p>
<li><p>Die Dokumentation unterliegt einer <em><a class="external" href="http://creativecommons.org/licenses/by-sa/2.5/"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Creative Commons</a></em>-Lizenz, damit wird die Möglichkeit der freien Verbreitung des gesammelten Wissens gewährleistet. </p>
</li>
<li><p>Wir übernehmen keinerlei Haftung für eventuelle Folgen, die durch die Nutzung einer CryptoBox entstehen könnten. </p>
</li>
@ -223,9 +327,9 @@
<a id="bottom"></a>
</div>
<p id="pageinfo" class="info" lang="en" dir="ltr">last edited 2005-07-07 14:35:55 by <span title=""></span></p>
<p id="pageinfo" class="info" lang="en" dir="ltr">last edited 2005-07-19 10:48:31 by <span title=""></span></p>
</div> <!-- end page -->
</body>
</html>

View file

@ -1,20 +1,4 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<meta name="robots" content="index,nofollow">
<title>CryptoBoxDev - howto</title>
<link rel=stylesheet type=text/css charset=utf-8 media=all href=../cryptobox.css>
</head>
<body>
<div id="page" lang="en" dir="ltr"><!-- start page -->
<h1 id="title"><a title="Click to do a full-text search for this title" href="/wikis/howto/CryptoBoxDev?action=fullsearch&amp;value=%22CryptoBoxDev%22&amp;context=180">CryptoBoxDev</a></h1>
<div lang="en" id="content" dir="ltr">
<a id="top"></a>
<ol>
@ -27,7 +11,7 @@
</li>
<li>
<a href="#head-254d88cf784c8561fa87b86fb6114b5024808a3f">cb-build</a>
<a href="#head-693b97f1f140e361364dcc277c0afa779430f527">cbox-build</a>
<ol>
<li>
@ -91,31 +75,31 @@
<h2 id="head-6eb518f032b739c4ddc4336b19cefd3fa16e20aa">Komponenten</h2>
<p>Eine <a href="/wikis/howto/CryptoBox">CryptoBox</a> CD wird in wenigen Schritten erstellt. Die Basisarbeit erledigt 'dfsbuild' und die genaue Konfiguration macht 'cb-build'. </p>
<p>Eine <a href="/wikis/howto/CryptoBox">CryptoBox</a> CD wird in wenigen Schritten erstellt. Die Basisarbeit erledigt 'dfsbuild' und die genaue Konfiguration macht 'cbox-build'. </p>
<h3 id="head-734d8f8dd2dc75137657154aab53d33f64f891bd">dfsbuild</h3>
<p>Das Linux Grundsystem für die <a href="/wikis/howto/CryptoBox">CryptoBox</a> CD wird mit <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild"><img src="/moin-base/modern/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">dfsbuild</a> gebaut. Das ist ein Programm, welches eine <a class="external" href="http://www.debian.org"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian</a> Live-CD erzeugt.<br>
<p>Das Linux Grundsystem für die <a href="/wikis/howto/CryptoBox">CryptoBox</a> CD wird mit <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=dfsbuild"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">dfsbuild</a> gebaut. Das ist ein Programm, welches eine <a class="external" href="http://www.debian.org"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian</a> Live-CD erzeugt.<br>
<em>(Wir entwickeln die <a href="/wikis/howto/CryptoBox">CryptoBox</a> bisher auf Debian/Linux-Systemen. Prinzipiell dürfte es auch mit deiner Lieblingsdistro funktionieren, nur der anfängliche Einrichtungsaufwand wird dadurch größer.)</em> </p>
<p>Für "dfsbuild" bietet sich <a class="badinterwiki" title="DebianPackages" href="/wikis/howto/InterWiki"><img src="/moin-base/modern/img/moin-inter.png" alt="[DebianPackages]" height="16" width="16">apt-cacher</a> an. Damit brauchst du nicht für jeden Bau des Grundsystems alle Debian-Pakete erneut herunter laden. </p>
<p>Für "dfsbuild" bietet sich <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">apt-cacher</a> an. Damit brauchst du nicht für jeden Bau des Grundsystems alle Debian-Pakete erneut herunter laden. </p>
<p>Installation: </p>
<ul>
<li><p> <tt>apt-get&nbsp;install&nbsp;dfsbuild&nbsp;apt-cacher</tt> </p>
</li>
</ul>
<p>Die <em>dfsbuild</em>-Dokumentation ist noch recht spärlich. Du kommst aber kaum in direkten Kontakt mit <em>dfsbuild</em>, da es durch 'cb-build' aufgerufen wird. Die folgenden Links helfen dir vielleicht trotzdem weiter: </p>
<p>Die <em>dfsbuild</em>-Dokumentation ist noch recht spärlich. Du kommst aber kaum in direkten Kontakt mit <em>dfsbuild</em>, da es durch 'cbox-build' aufgerufen wird. Die folgenden Links helfen dir vielleicht trotzdem weiter: </p>
<ul>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> dfsbuild1</a> </p>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a> </p>
</li>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/149"><img src="/moin-base/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> dfsbuild2</a> </p>
<li><p> <a class="external" href="http://www.debian-administration.org/articles/149"><img src="/moin-base/greenthumb/img/moin-www.png" alt="[WWW]" height="11" width="11"> Debian Administration: Getting in deep with dfsbuild</a> </p>
</li>
</ul>
<h3 id="head-254d88cf784c8561fa87b86fb6114b5024808a3f">cb-build</h3>
<h3 id="head-693b97f1f140e361364dcc277c0afa779430f527">cbox-build</h3>
<p>Die wichtige Kleinarbeit, damit aus dem dfsbuild-System eine <a href="/wikis/howto/CryptoBox">CryptoBox</a> wird, erledigt <em>cb-build.sh</em>.<br>
Das Script und die bestehenden Konfigurationsdateien liegen im <a class="interwiki" title="SubVersion" href="/websvn/cryptobox"><img src="/moin-base/modern/img/moin-inter.png" alt="[SubVersion]" height="16" width="16">cryptobox-Repository</a>. </p>
<p>Mit diesem Script baust du deine eigene <a href="/wikis/howto/CryptoBox">CryptoBox</a>-CD. Hier ein kurzer Überblick: </p>
<p>Die wichtige Kleinarbeit, damit aus dem dfsbuild-System eine <a href="/wikis/howto/CryptoBox">CryptoBox</a> wird, erledigt <em>cbox-build.sh</em>.<br>
Das Script und die bestehenden Konfigurationsdateien liegen im <a class="interwiki" title="SubVersion" href="/websvn/cryptobox"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[SubVersion]" height="16" width="16">cryptobox-Repository</a>. </p>
<p>Mit diesem Script baust du deine eigene <a href="/wikis/howto/CryptoBox">CryptoBox</a>-CD. Hier ein verkürzter Überblick: </p>
<div>
<table>
<tr>
@ -139,7 +123,15 @@
<p> config </p>
</td>
<td>
<p> kopiert die Konfiguration (cryptobox.conf.d) in die Arbeitskopie </p>
<p> konfiguriert das Basissystem </p>
</td>
</tr>
<tr>
<td>
<p> harden </p>
</td>
<td>
<p> entfernt das <em>devel-feature.sh</em> Skript und einige unnötige Pakete </p>
</td>
</tr>
<tr>
@ -147,7 +139,7 @@
<p> iso </p>
</td>
<td>
<p> erstellt das iso-image </p>
<p> erstellt ein iso-image </p>
</td>
</tr>
<tr>
@ -163,7 +155,7 @@
<p> qemu </p>
</td>
<td>
<p> startet das image mit <em>qemu</em> (zum sicheren Testen) </p>
<p> startet das iso-image mit <em>qemu</em> (zum sicheren Testen) </p>
</td>
</tr>
<tr>
@ -174,20 +166,34 @@
<p> Wiederherstellung des dfsbuild-Endprodukts - falls mensch mit <em>config</em> die Arbeitskopie übertrieben verschmutzt hat </p>
</td>
</tr>
<tr>
<td>
<p> release </p>
</td>
<td>
<p> Abkürzung für <em>dfsbuild config harden iso</em> - es wird also eine Release-CD erstellt </p>
</td>
</tr>
</table>
</div>
<p>Das kannst mehrere Aktionen als Parameter angeben. </p>
<p>Das kannst mehrere Aktionen nacheinander als Parameter angeben. </p>
<p>Weitere Aktionen, die die Entwicklung erleichtern, werden unter <a href="/wikis/howto/CryptoBoxDevFeatures">CryptoBoxDevFeatures</a> beschrieben. </p>
<p>Das fertige iso-Image findest du unter <em>_builddir/cd1/cryptobox.iso</em>. </p>
<h4 id="head-5850d37242fe07221892c0126989304825831e5c">Beispiele</h4>
<dl>
<dt>Die erste Erstellung des Grundsystems</dt>
<dd><p><tt>./cb-build.sh&nbsp;dfsbuild</tt> </p>
<dd><p><tt>./cbox-build.sh&nbsp;dfsbuild</tt> </p>
</dd>
<dt>Anpassungen vornehmen, ISO-Image erstellen und per ''qemu'' testen</dt>
<dd><p><tt>./cb-build.sh&nbsp;config&nbsp;iso&nbsp;qemu</tt> </p>
<dd><p><tt>./cbox-build.sh&nbsp;config&nbsp;iso&nbsp;qemu</tt> </p>
</dd>
</dl>
<ul>
<li style="list-style-type:none"><p>Release-CD erstellen: <tt>./cbox-build.sh&nbsp;release</tt> </p>
</li>
</ul>
<h3 id="head-b4a0271d176c624fda4d38f5c138aefe0a329bca">der CryptoBox-Kernel</h3>
@ -206,7 +212,7 @@
<h3 id="head-d81befa59fe38bcf5ffae7c0c4c42141d74395eb">Verwendung des Subversion-Repositories</h3>
<p>Erstellung einer lokalen Arbeitskopie des Entwickler-Repositories: <tt>svn&nbsp;checkout&nbsp;https://svn.systemausfall.org/svn/cryptobox&nbsp;deincryptoboxverzeichnis</tt> </p>
<p>Deine Änderungen an der <a href="/wikis/howto/CryptoBox">CryptoBox</a> klannst du per <tt>svn&nbsp;commit</tt> in unser Repository übertragen. Dazu musst du, aber vorher Schreibrechte erhalten (die wir gerne vergeben). <img src="/moin-base/modern/img/smile.png" alt=":)" height="15" width="15"> </p>
<p>Deine Änderungen an der <a href="/wikis/howto/CryptoBox">CryptoBox</a> klannst du per <tt>svn&nbsp;commit</tt> in unser Repository übertragen. Dazu musst du, aber vorher Schreibrechte erhalten (die wir gerne vergeben). <img src="/moin-base/greenthumb/img/smile.png" alt=":)" height="15" width="15"> </p>
<h2 id="head-488d495ca9bbbac0c903c2de823c13efa299cc43">Ablauf</h2>
@ -298,15 +304,18 @@
<ul>
<li><p> Du brauchst etwa 1GB Plattenplatz für den Bau einer Cryptobox. Das eigentliche CD-Image wird aber nur knapp 250MB groß. </p>
</li>
<li><p> Für <em>dfsbuild</em> bietet sich <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher"><img src="/moin-base/modern/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">apt-cacher</a> an. Damit müssen die Debian-Pakete nicht bei jedem neuen <em>dfsbuild</em>-Vorgang erneut heruntergeladen werden. </p>
<li><p> Für <em>dfsbuild</em> bietet sich <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&amp;subword=1&amp;version=all&amp;release=all&amp;keywords=apt-cacher"><img src="/moin-base/greenthumb/img/moin-inter.png" alt="[DebianPackage]" height="16" width="16">apt-cacher</a> an. Damit müssen die Debian-Pakete nicht bei jedem neuen <em>dfsbuild</em>-Vorgang erneut heruntergeladen werden. </p>
</li>
<li><p> cb-build muss für folgende Vorgänge mit root Rechten laufen: <tt>dfsbuild,&nbsp;config,&nbsp;chroot,&nbsp;revert</tt> </p>
<li><p> cbox-build muss für folgende Vorgänge mit root Rechten laufen: <tt>dfsbuild,&nbsp;config,&nbsp;chroot,&nbsp;revert</tt> </p>
</li>
<li><p> <em>cb-build.sh</em> verwendet relative Pfad-Angaben - du solltest es also aus dem Verzeichnis heraus starten, in dem sich beispielsweise auch <em>cb-build.sh</em> befindet. </p>
<li><p> <em>cbox-build.sh</em> verwendet relative Pfad-Angaben - du solltest es also aus dem Verzeichnis heraus starten, in dem sich beispielsweise auch <em>cbox-build.sh</em> befindet. </p>
</li>
<li><p> Netzwerk für <em>qemu</em>: </p>
<ul>
<li><p> dein Systemkernel muss das <em>tun/tap</em>-Netzwerkgerät unterstützen <strong>(TODO: entsprechende Zeile der Kernel-Config einfuegen)</strong> </p>
<li><p> dein Systemkernel muss das <em>tun/tap</em>-Netzwerkgerät unterstützen
</p>
<pre>
CONFIG_TUN=m</pre>
</li>
<li><p> eventuell musst du "misc/qemu-ifup.sh" an dein System anpassen </p>
</li>
@ -336,9 +345,9 @@
<a id="bottom"></a>
</div>
<p id="pageinfo" class="info" lang="en" dir="ltr">last edited 2005-07-07 19:01:07 by <span title=""></span></p>
<p id="pageinfo" class="info" lang="en" dir="ltr">last edited 2005-08-08 08:33:33 by <span title=""></span></p>
</div> <!-- end page -->
</body>
</html>

View file

@ -1,22 +1,47 @@
#!/bin/sh
set -u
## diese Seiten aus dem Wiki ziehen und entschlacken
SITES="CryptoBox CryptoBoxDev"
DEST_PATH="cryptobox.conf.d/var/www/userdoc/"
[ ! -e $DEST_PATH ] && echo "$DEST_PATH does not exist" && exit
# TODO:
# import of images
for SITE in $SITES; do
SITE_SRC="https://systemausfall.org/wikis/howto/$SITE"
SITE_TMP="/tmp/$SITE"
SITE_DEST="${DEST_PATH}${SITE}.html"
# root directory of the cryptobox development environment
ROOT_DIR="$(dirname $(dirname $0))"
[ -e $SITE_TMP ] && echo "$SITE_TMP exists" && exit
wget -O $SITE_TMP $SITE_SRC || exit
sed -n "1,/\<title\>/p" $SITE_TMP > $SITE_DEST
echo "<link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="../cryptobox.css">" >> $SITE_DEST
echo -e "</head>\n<body>\n" >> $SITE_DEST
sed -n /\<\!--\ start\ page\ --\>/,/\<\!--\ end\ page\ --\>/p $SITE_TMP >> $SITE_DEST
echo -e "</body>\n</html>\n" >> $SITE_DEST
rm $SITE_TMP
done
# retrieve these pages from the wiki
PAGES="CryptoBox CryptoBoxDev"
# the trailing slash is important
WIKI_HOST="https://systemausfall.org"
WIKI_URL="/wikis/howto/"
# the trailing slash is important
DEST_PATH="cbox-tree.d/usr/share/doc/cryptobox/html/"
TMP_FILE="/tmp/$(basename $0)-$$.out"
# the URL of the CGI of the cryptobox
CBOX_CGI='/cryptobox?action=show_doc&page='
[ ! -e "$DEST_PATH" ] && echo "$DEST_PATH does not exist" && exit 1
for PAGE in $PAGES; do
PAGE_SRC="$WIKI_HOST$WIKI_URL$PAGE"
echo "Importing $PAGE ..."
[ -e "$TMP_FILE" ] && rm "$TMP_FILE"
# download the page
echo " downloading the page ..."
wget -q -O "$TMP_FILE" "$PAGE_SRC" || { echo "Downloading ($PAGE_SRC) failed!"; exit 1; }
echo " removing header and footer ..."
# break lines before start of content
sed -i 's#<div [^>]* id="content" [^>]*>#_END_OF_HEADER_\n#' "$TMP_FILE"
sed -i 's#<div id="footer">#\n_START_OF_FOOTER_#' "$TMP_FILE"
# remove all lines before and after "body"
sed -i '1,/_END_OF_HEADER_/d; /_START_OF_FOOTER_/,$d' "$TMP_FILE"
# TODO: replace wiki-links by references to the cbox-cgi
# check if wiki-links are absolute!
echo " replacing wiki links ..."
sed -i "s#"$WIKI_URL#"$CBOX_CGI#g" "$TMP_FILE"
mv "$TMP_FILE" "${DEST_PATH}${PAGE}.html"
echo " finished!"
done