prepare new release 0.2.1
This commit is contained in:
parent
3b5a729834
commit
3cad3c5ae8
351 changed files with 19614 additions and 0 deletions
180
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBox.html
Normal file
180
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBox.html
Normal file
|
@ -0,0 +1,180 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-4f7ff469187373427683a6373538004a13ab7928">News</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-efcfa621d0607ea7c5466d3ecdb99edf3cb4ebc8">Overview</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-97b25333607e6847b07b9b3c4996ed39d3da3064">Specs</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-1a17731b6ddd57e960f191c2096fe48056aecb3b">Usage</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-dd472b75401e742bc60e6324313368309548e9f8">Development</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-82502f7b432827fa8eabd177567e4034eb595e6c">Legal stuff</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>see <a href="CryptoBoxIntro.html">CryptoBoxIntro/en</a> for a very short overview</em> </p>
|
||||
|
||||
<h2 id="head-4f7ff469187373427683a6373538004a13ab7928">News</h2>
|
||||
|
||||
<p>We are moving this project to <a href="https://codecoop.org/projects/cryptobox/">https://codecoop.org/projects/cryptobox/</a> </p>
|
||||
<p>The first release of the <a href="CryptoBox.html">CryptoBox</a>-LiveCD is planned for October 02005. </p>
|
||||
|
||||
<h2 id="head-efcfa621d0607ea7c5466d3ecdb99edf3cb4ebc8">Overview</h2>
|
||||
|
||||
<p>The <a href="CryptoBox.html">CryptoBox</a> is a Debian/Linux based live-cd. This CD boots up, starting a secure fileserver. Even non-technical users are able to store their data on its encrypted harddisk. There is no special knowledge about cryptography or servers required at all. </p>
|
||||
<p>We provide the documentation in different languages. Feel free to add more translations: </p>
|
||||
<ul>
|
||||
<li><p> <a href="CryptoBox.html">deutsch</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBox.html">english</a> </p>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h2 id="head-97b25333607e6847b07b9b3c4996ed39d3da3064">Specs</h2>
|
||||
|
||||
<div>
|
||||
<table>
|
||||
<tr>
|
||||
<td>
|
||||
<p>system</p>
|
||||
</td>
|
||||
<td>
|
||||
<p>Debian/Linux based Live-CD</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<p>needed hardware</p>
|
||||
</td>
|
||||
<td>
|
||||
<p> "outdated" PC (i386 p1-100 32MB RAM minimum)</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<p>supported clients</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><a class="interwiki" title="WikiPedia" href="http://en.wikipedia.org/wiki/Operating_System">*nix; *bsd; Windows; Mac OS</a></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<p>fileserver</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><a class="external" href="http://samba.org">samba</a> (network shares)</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<p>userinterface</p>
|
||||
</td>
|
||||
<td>
|
||||
<p>fully remote controlled via webbrowser</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<p>encryption</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><a class="interwiki" title="WikiPedia" href="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard">AES</a> via device-mapper</p>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<p>The web interface of the <a href="CryptoBox.html">CryptoBox</a> supports the following languages: </p>
|
||||
<ul>
|
||||
<li><p> english </p>
|
||||
</li>
|
||||
<li><p> german </p>
|
||||
</li>
|
||||
<li><p> slovenian </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>Feel free to contribute a <a class="interwiki" title="SubVersion" href="/websvn/cryptobox/trunk/cbox-tree.d/usr/share/cryptobox/lang/en.hdf">translation</a> for another language (preferably utf-encoded). </p>
|
||||
|
||||
<h2 id="head-1a17731b6ddd57e960f191c2096fe48056aecb3b">Usage</h2>
|
||||
|
||||
<p>The user documentation has its home at <a href="CryptoBoxUser.html">CryptoBoxUser/en</a>. </p>
|
||||
|
||||
<h2 id="head-dd472b75401e742bc60e6324313368309548e9f8">Development</h2>
|
||||
|
||||
<p>Take a look at the developer's documentation at <a href="CryptoBoxDev.html">CryptoBoxDev/en</a>. </p>
|
||||
<p>Report bugs at <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a>. </p>
|
||||
<p>Browse the source code in the <a class="interwiki" title="SubVersion" href="/websvn/cryptobox">CryptoBox-websvn interface</a>. </p>
|
||||
<p>Anything else? Write us an email: <em>cryptobox[at]systemausfall.org</em> </p>
|
||||
|
||||
<h2 id="head-82502f7b432827fa8eabd177567e4034eb595e6c">Legal stuff</h2>
|
||||
|
||||
<ol type="1">
|
||||
<li><p>All scripts are <a class="external" href="http://www.fsf.org/licensing/licenses/gpl.html">GPL licensed</a> </p>
|
||||
</li>
|
||||
<li><p>The documentation licensed under a <a class="external" href="http://creativecommons.org/licenses/by-sa-nc/2.0/">Creative Commons License</a><em> </em></p>
|
||||
</li>
|
||||
<li><p>We do not take any warranty for the functionality or usability of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
92
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDev.html
Normal file
92
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDev.html
Normal file
|
@ -0,0 +1,92 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-85f75330e62e5b1efc9f504fe9cb51a1b966dc3b">Development documentation</h2>
|
||||
|
||||
<p>The following pages are written for developers only. Users of the <a href="CryptoBox.html">CryptoBox</a> should read <a href="CryptoBoxUser.html">CryptoBoxUser</a> instead. </p>
|
||||
<ul>
|
||||
<li><p> <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDevCustomConfigure.html">CryptoBoxDevCustomConfigure</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDevValidation.html">CryptoBoxDevValidation</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDevBackground.html">CryptoBoxDevBackground</a> </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDevKnownProblems.html">CryptoBoxDevKnownProblems</a> </p>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h2 id="head-b8ce79abe983e1592235d0085dd6928b83811739">Contact</h2>
|
||||
|
||||
<p>We are waiting for your emails to <em>cryptobox[at]systemausfall.org</em>. </p>
|
||||
|
||||
<h2 id="head-964f56b054273ed39bab34484f83ac053ac0f12e">Bug reports</h2>
|
||||
|
||||
<p>Please use our issue tracker, if you discover problems: <a href="https://systemausfall.org/trac/cryptobox">https://systemausfall.org/trac/cryptobox</a> </p>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
109
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevBackground.html
Normal file
109
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevBackground.html
Normal file
|
@ -0,0 +1,109 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
|
||||
|
||||
<h2 id="head-2d71165918ee9e861cebf562e7f9be2c5c6328e4">dfsbuild</h2>
|
||||
|
||||
<p>The base system of the <a href="CryptoBox.html">CryptoBox</a> Live-CD is created by <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=dfsbuild">dfsbuild</a>. </p>
|
||||
<p>It is recommended to use some kind of caching tool for the retrieval of the debian packages (e.g.: <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-cacher">apt-cacher</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-proxy">apt-proxy</a>). This saves a lot of bandwidth and time. </p>
|
||||
<p>The documentation for <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=dfsbuild">dfsbuild</a> is sparse. But it is quite unlikely, that you will get in direct contact with it, as it is wrapped by <em>cbox-build</em>. However the following links may help you for specific problems: </p>
|
||||
<ul>
|
||||
<li><p> <a class="external" href="http://www.debian-administration.org/articles/125">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">Debian Administration: Getting in deep with dfsbuild</a> </p>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h2 id="head-6e3d13fcf3a0765d2188125e9b0b0bcb95e50622">the kernel</h2>
|
||||
|
||||
<p>The linux kernel for the <a href="CryptoBox.html">CryptoBox</a> is compiled statically. If you want to change it, you could follow this steps: </p>
|
||||
<ol type="1">
|
||||
<li><p>get the sources: <tt>apt-get install kernel-tree-2.6.11</tt> (or the version of your choice) </p>
|
||||
</li>
|
||||
<li><p>copy the exisiting config file <em>kernel/config-2.6.11</em> as <em>.config</em> into your kernel source directory </p>
|
||||
</li>
|
||||
<li><p>build the debian kernel package <tt>make-kpkg --revision=1.dfs --rootcmd=fakeroot kernel_image</tt> </p>
|
||||
</li>
|
||||
<li><p>change the kernel in the <em>unpackdebs</em> setting in <em>dfs-cbox.conf</em> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details) </p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h2 id="head-e01e8e66ae77c00f4e9fa9bd190c3ff738540727">qemu</h2>
|
||||
|
||||
<p><a class="external" href="http://fabrice.bellard.free.fr/qemu/">Qemu</a> is a portable system emulator. It is a convenient tool to ease the development workflow, as you do not need to burn LiveCDs for testing. </p>
|
||||
|
||||
<h2 id="head-00c94b926ece7f2a601d696a8880f5e54155ce7a">alternative LiveCDs</h2>
|
||||
|
||||
<p>We tried some other LiveCDs before we decided to use <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=dfsbuild">dfsbuild</a>. The following pages describe their advantages and disadvantages as the base system for the <a href="CryptoBox.html">CryptoBox</a>: </p>
|
||||
<ul>
|
||||
<li><p> <a href="CryptoBoxKnoppixVerworfen.html">CryptoBoxKnoppixVerworfen</a> - Knoppix </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxMorphixVerworfen.html">CryptoBoxMorphixVerworfen</a> - Morphix / IBuild </p>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
141
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevCustomBuild.html
Normal file
141
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevCustomBuild.html
Normal file
|
@ -0,0 +1,141 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
|
||||
|
||||
<h2 id="head-27ea5a3ee88c7c2dfcfd4124719aadd726f1e2da">Overview</h2>
|
||||
|
||||
<p>The following sections are useful, if you want to change the default settings of your personal <a href="CryptoBox.html">CryptoBox</a> development environment. </p>
|
||||
<p>You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>. </p>
|
||||
|
||||
<h2 id="head-737db576c5f42abc0c78574d0ce5077809f288cb">Settings</h2>
|
||||
|
||||
|
||||
<h3 id="head-9d97886ad41e38cb6afe343aa68ff652030ab06b">dfsbuild settings</h3>
|
||||
|
||||
<p>All settings for <em>dfsbuild</em> can be found in <em>etc-defaults.d/dfs-cbox.conf</em>. </p>
|
||||
<p>If you want to change any of them, you should do the following: </p>
|
||||
<ol type="1">
|
||||
<li><p>copy <em>etc-defaults.d/dfs-cbox.conf</em> file to <em>etc-local.d/</em> </p>
|
||||
</li>
|
||||
<li><p>change <em>etc-local.d/dfs-cbox.conf</em> according to your needs </p>
|
||||
</li>
|
||||
</ol>
|
||||
<p>This allows you to use your own (personal) settings, without interfering with files under version control. </p>
|
||||
|
||||
<h3 id="head-c2ae24a50a3706711c1a42e26176768438d4f160">CryptoBox development configuration</h3>
|
||||
|
||||
<p>Some settings regarding the building, configuring and validating of the <a href="CryptoBox.html">CryptoBox</a> can be found in <em>etc-defaults.d/cbox-dev.conf</em>. </p>
|
||||
<p>If you want to change any of them, you should do the following: </p>
|
||||
<ol type="1">
|
||||
<li><p>copy <em>etc-defaults.d/cbox-dev.conf</em> file to <em>etc-local.d/</em> </p>
|
||||
</li>
|
||||
<li><p>change <em>etc-local.d/cbox-dev.conf</em> according to your needs </p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h3 id="head-90ac95d2e5a50160cbf72b884b7b469a29c2fea1">SSH connection</h3>
|
||||
|
||||
<p>The file <em>etc-defaults.d/ssh_config</em> is used to establish a connection to a running <a href="CryptoBox.html">CryptoBox</a> system. </p>
|
||||
<p>It can be necessary to change these settings, if: </p>
|
||||
<ul>
|
||||
<li><p> you do not want to use the default IP for the <a href="CryptoBox.html">CryptoBox</a> </p>
|
||||
</li>
|
||||
<li><p> or the <a href="CryptoBox.html">CryptoBox</a> is not within your local network. </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>If you want to change some settings, you should do the following: </p>
|
||||
<ol type="1">
|
||||
<li><p>copy <em>etc-defaults.d/ssh_config</em> file to <em>etc-local.d/</em> </p>
|
||||
</li>
|
||||
<li><p>change <em>etc-local.d/ssh_config</em> according to your needs </p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h3 id="head-6798893e2e3fd89a72b5b6821a0d3d08125367b9">qemu network configuration</h3>
|
||||
|
||||
<p>The file <em>etc-defauolts.d/qemu-ifup</em> is used for the <a href="CryptoBox.html">CryptoBox</a> emulation with <em>qemu</em>. See <tt>man qemu</tt> for details. </p>
|
||||
<p>If you want to change some settings, you should do the following: </p>
|
||||
<ol type="1">
|
||||
<li><p>copy <em>etc-defaults.d/qemu-ifup</em> file to <em>etc-local.d/</em> </p>
|
||||
</li>
|
||||
<li><p>change <em>etc-local.d/qemu-ifup</em> according to your needs </p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,103 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
|
||||
|
||||
<h2 id="head-eaec6be4efea7b38c41712778bfd4fb8d2827d3c">Overview</h2>
|
||||
|
||||
<p>You may change nearly every aspect of the <a href="CryptoBox.html">CryptoBox</a> by using the custom configuration hook directory. </p>
|
||||
<p>Any script inside of this directory will be executed after the default configuration procedure (see <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a>). </p>
|
||||
<p>The order of execution is defined by the names of the scripts (alphabetically). </p>
|
||||
|
||||
<h2 id="head-51173f0423ca91d36cd0cfcdc75a06d90cc087ee">Locations</h2>
|
||||
|
||||
<p>Some example customization scripts can be found in <em>configure-examples.d/</em>. </p>
|
||||
<p>You may put your scripts into <em>configure-local.d/</em>. They will be sourced by <em>cbox-build.sh</em>. </p>
|
||||
|
||||
<h2 id="head-9b9b6463081c4d9d13e3aadebe9daaf61fa67b5c">Examples</h2>
|
||||
|
||||
<p>The examples in <em>configure-examples.d/</em> can be copied to <em>configure-local.d/</em> and adjusted to your needs. </p>
|
||||
<dl>
|
||||
<dt>set_default_ip</dt>
|
||||
<dd><p>change the default IP address of the <a href="CryptoBox.html">CryptoBox</a> </p>
|
||||
</dd>
|
||||
<dt>set_default_language</dt>
|
||||
<dd><p>set the default language </p>
|
||||
</dd>
|
||||
<dt>set_default_timeout</dt>
|
||||
<dd><p>set the default idle time for automatic unmounting </p>
|
||||
</dd>
|
||||
<dt>set_hostname</dt>
|
||||
<dd><p>change the default hostname </p>
|
||||
</dd>
|
||||
<dt>set_root_pw</dt>
|
||||
<dd><p>change the password of root (only useful for a development <a href="CryptoBox.html">CryptoBox</a>) </p>
|
||||
</dd>
|
||||
<dt>import_authorized_keys</dt>
|
||||
<dd><p>upload a <em>ssh</em> key for passwordless access to a development <a href="CryptoBox.html">CryptoBox</a> </p>
|
||||
</dd>
|
||||
<dt>set_scan_devices</dt>
|
||||
<dd><p>where to look for usable harddisks </p>
|
||||
</dd>
|
||||
</dl>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,79 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-3d279b986395c95455d4d831054f9664ac846790">qemu</a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-3d279b986395c95455d4d831054f9664ac846790">qemu</h2>
|
||||
|
||||
|
||||
<h3 id="head-9d223a1d9ee655c5a338f798fc08850a2b3694ba">interleaved files not (yet) supported</h3>
|
||||
|
||||
<p>You should update <em>qemu</em> to version 0.7 or higher. </p>
|
||||
|
||||
<h3 id="head-aa082f09cdb79c9a715826562efebd23cb8e9dfc">smbd: segfault</h3>
|
||||
|
||||
<p>This happens under certain circumstances. We do not know a solution for this problem. </p>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
129
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevPreparation.html
Normal file
129
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevPreparation.html
Normal file
|
@ -0,0 +1,129 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
|
||||
|
||||
<h2 id="head-5b50aeed8139c95e5a2670d4248978d942c5edd6">Software requirements</h2>
|
||||
|
||||
|
||||
<h3 id="head-143e3ec00a024bf2d9486f21dccab7ddc0ac3709">Packages</h3>
|
||||
|
||||
<p>We use <a class="external" href="http://debian.org">Debian</a> as our development environment. This was a natural choice, as the <a href="CryptoBox.html">CryptoBox</a>-LiveCD is also based on Debian. Other distributions should work too, of course - <a class="interwiki" title="Acronym" href="http://www.acronymfinder.com/af-query.asp?String=exact&Acronym=YMMV">YMMV</a>. </p>
|
||||
<p>required: </p>
|
||||
<ul>
|
||||
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=dfsbuild">dfsbuild</a> </p>
|
||||
</li>
|
||||
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=subversion">subversion</a> </p>
|
||||
</li>
|
||||
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=chroot">chroot</a> </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>recommended: </p>
|
||||
<ul>
|
||||
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-cacher">apt-cacher</a>, <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-proxy">apt-proxy</a> or <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=approx">approx</a> </p>
|
||||
</li>
|
||||
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=qemu">qemu</a> </p>
|
||||
</li>
|
||||
<li><p> <a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=curl">curl</a> </p>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3 id="head-8abff5fecd19a74f1f5602aa82c8783c80b6862e">Kernel</h3>
|
||||
|
||||
<p>If you want to use <a class="external" href="http://fabrice.bellard.free.fr/qemu/">qemu</a> to test your <a href="CryptoBox.html">CryptoBox</a> in a virtual environment, then you will need the <em>tun/tap</em> kernel feature.
|
||||
</p>
|
||||
<pre>
|
||||
CONFIG_TUN=m</pre>
|
||||
|
||||
<h2 id="head-e988a63aa4744649892e3c85e239927edb01f336">Get the source</h2>
|
||||
|
||||
<p>Download the latest release from our <a class="external" href="http://subversion.tigris.org">subversion</a>-Repository:
|
||||
</p>
|
||||
<pre>
|
||||
svn checkout https://svn.systemausfall.org/svn/cryptobox/trunk </pre>
|
||||
|
||||
<h2 id="head-3b183abdfebed7afdbbdbb7625f85081882beb70">First build</h2>
|
||||
|
||||
<p>run <tt>scripts/cbox-build.sh release</tt> as <em>root</em> - hopefully, there should be no errors <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p>
|
||||
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <em>mirror</em> in <em>dfs-cbox.conf</em>). </p>
|
||||
|
||||
<h2 id="head-08bd0ad2103b9f58bd026d64c0bcb333f3bbd90b">Finished</h2>
|
||||
|
||||
<p>Now you can start to pariticipate in the development of the <a href="CryptoBox.html">CryptoBox</a> or simply customize your own <a href="CryptoBox.html">CryptoBox</a>-LiveCD. </p>
|
||||
<p>See <a href="CryptoBoxDevWorkFlow.html">CryptoBoxDevWorkFlow</a> for details of how to use the developer's tools of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
<p><a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> shows some examples for local customizations of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
100
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevValidation.html
Normal file
100
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevValidation.html
Normal file
|
@ -0,0 +1,100 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
|
||||
|
||||
<h2 id="head-5e20146fd39363329427c6251209cccb8d374f3e">Overview</h2>
|
||||
|
||||
<p>The validation feature allows to check the programming logic of the <a href="CryptoBox.html">CryptoBox</a>. A lot of test cases are defined to test as many functions of the <a href="CryptoBox.html">CryptoBox</a> as possible. </p>
|
||||
<p>The requests are processed with <a class="external" href="http://curl.haxx.se/">curl</a>. </p>
|
||||
<p>The received web page is saved to allow a later design review or css debugging. </p>
|
||||
<p>The current state of the <a href="CryptoBox.html">CryptoBox</a> is represented by ten single values (e.g.: <em>box is configured</em>, <em>IP of the box</em>, <em>current language setting</em>, ...), which are invisibly a part of each html page (as comments). The returned status of every request is compared to the predicted value of the test case. </p>
|
||||
<p>Similar test cases are pooled into test groups (e.g.: <em>initialization</em>, <em>configuration</em> and <em>mounting</em>). </p>
|
||||
|
||||
<h2 id="head-6e1d416048c4d8ebfb5b3919b4d924c77e652a7b">Validate</h2>
|
||||
|
||||
<p>Run <tt>scripts/validate.sh check_all</tt> to conduct all tests of all groups. See <tt>scripts/validate.sh help</tt> for other actions. </p>
|
||||
<p>The results will be saved in <em>validation/report</em>. </p>
|
||||
<p>In addition to every single retrieved page, a html page called <em>summary.html</em> is created, which contains the state checks of all tests in a group. </p>
|
||||
|
||||
<h2 id="head-5634566bd24f83d397b43525fc62685f6e678fbf">How to create a test</h2>
|
||||
|
||||
<p>All test cases can be found in <em>validation/test-cases</em>. </p>
|
||||
<p>Every test consists of: </p>
|
||||
<dl>
|
||||
<dt>input.curl</dt>
|
||||
<dd><p>the configuration file for the <em>curl</em> request </p>
|
||||
</dd>
|
||||
<dt>output</dt>
|
||||
<dd><p>the predicted state of the <a href="CryptoBox.html">CryptoBox</a> after the call </p>
|
||||
</dd>
|
||||
<dt>description</dt>
|
||||
<dd><p>a short description of the test (will be used for the summary) </p>
|
||||
</dd>
|
||||
<dt>delay</dt>
|
||||
<dd><p>[optional] time to wait after this test </p>
|
||||
</dd>
|
||||
</dl>
|
||||
<p>Use the existing test cases as templates for new tests. </p>
|
||||
<p>Any logical path of the web interface CGI should be validated by a test case. </p>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
188
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevWorkFlow.html
Normal file
188
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxDevWorkFlow.html
Normal file
|
@ -0,0 +1,188 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick & dirty tests</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p><em>back to <a href="CryptoBoxDev.html">CryptoBoxDev</a></em> </p>
|
||||
|
||||
<h2 id="head-adacf7a8271d3f6fe8bdfb9773ac3b1f4b050f9a">Preparations</h2>
|
||||
|
||||
<p>You should have completed the steps described in <a href="CryptoBoxDevPreparation.html">CryptoBoxDevPreparation</a>. </p>
|
||||
|
||||
<h2 id="head-61cec4152bb64ed5799ae7422f7150a4e3bc4860">Create a CryptoBox-LiveCD - step by step</h2>
|
||||
|
||||
<p>The following steps can be executed in the order of their appearance. </p>
|
||||
<p>Usually there is no need to repeat the whole process, after you changed some parts of the <a href="CryptoBox.html">CryptoBox</a>. Especially the first step (building of the base system with <em>dfsbuild</em>) may usually be skipped. </p>
|
||||
<p>Every step of the building process must be executed as <em>root</em>. </p>
|
||||
|
||||
<h3 id="head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</h3>
|
||||
|
||||
<p>Run <tt>scripts/cbox-build.sh dfsbuild</tt> to create the base system for the LiveCD. </p>
|
||||
<p>The result can be found in <em>_builddir/cd1/image</em>. </p>
|
||||
<p>If you do not want to use the <em><a class="interwiki" title="DebianPackage" href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-cacher">apt-cacher</a></em> to save bandwidth and time, then you should modify the <em>mirror</em>-setting in <em>dfs-cbox.conf</em> (see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a> for details). </p>
|
||||
|
||||
<h3 id="head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</h3>
|
||||
|
||||
<p>Run <tt>scripts/cbox-build.sh config</tt> to copy the <a href="CryptoBox.html">CryptoBox</a>-specific files to the base image. </p>
|
||||
<p>TODO: link to cbox-build.sh-manpage </p>
|
||||
|
||||
<h3 id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3>
|
||||
|
||||
<p>The original base system, that was created by <em>dfsbuild</em> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they case severe security implications. </p>
|
||||
<p>To reduce the <a href="CryptoBox.html">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>scripts/cbox-build.sh harden</tt>. </p>
|
||||
|
||||
<h3 id="head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</h3>
|
||||
|
||||
<p>To burn a <a href="CryptoBox.html">CryptoBox</a>-LiveCD, you need an bootable <em>iso9660</em>-image. </p>
|
||||
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p>
|
||||
|
||||
<h3 id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3>
|
||||
|
||||
<p>Do it manually: <tt>cdrecord -v dev=0,0,0 _builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p>
|
||||
<p>Let the script do it for you: <tt>scripts/cbox-build.sh burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <a href="CryptoBoxDevCustomBuild.html">CryptoBoxDevCustomBuild</a>). </p>
|
||||
<p>Of course, it is not wise to use CD-R media. CD-RW consume less resources. </p>
|
||||
|
||||
<h2 id="head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</h2>
|
||||
|
||||
<p>This section is only useful for developers, who want to improve or change the <a href="CryptoBox.html">CryptoBox</a> system. </p>
|
||||
|
||||
<h3 id="head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick & dirty tests</h3>
|
||||
|
||||
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <a href="CryptoBox.html">CryptoBox</a>, then you can check for syntax errors by running them in a <em>chroot</em> environment. Be careful: you have access to all ressources of your computer, while you are working within a <em>chroot</em> environment - so you can easily repartition your real disk ... </p>
|
||||
<p>To start a <em>chroot</em> environment, you can execute <tt>scripts/cbox-dev.sh chroot</tt>. </p>
|
||||
<p>For more intensive tests, you may use <em>qemu</em> (see below) or burn real LiveCDs - of course this would take much more time. </p>
|
||||
|
||||
<h3 id="head-2278b94f0a24871a501d80c4e6e0c53d1f5621ca">Qemu: nearly complete emulation</h3>
|
||||
|
||||
<p>The processor emulator <a class="external" href="http://fabrice.bellard.free.fr/qemu">qemu</a> allows you test the <a href="CryptoBox.html">CryptoBox</a> in a virtual environment, that is completely separated from your real computer's resources. It is the tool of choice, if you do nat have a real computer around for testing. </p>
|
||||
<p>Beware - there are some problems, when using <em>qemu</em>: </p>
|
||||
<ul>
|
||||
<li><p> <em>smbd</em> does not start (segfault) </p>
|
||||
</li>
|
||||
<li><p> ??? </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>scripts/cbox-dev.sh qemu</tt>. </p>
|
||||
|
||||
<h2 id="head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</h2>
|
||||
|
||||
<p>This section is only useful for developers, who want to develop on a running <a href="CryptoBox.html">CryptoBox</a> system (emulated or real). </p>
|
||||
<p>You may access the <a href="CryptoBox.html">CryptoBox</a> directly or you can use <em>ssh</em> to open a remote session (<tt>./cbox-dev.sh ssh</tt>). </p>
|
||||
|
||||
<h3 id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3>
|
||||
|
||||
<p>When you run an emulation or test a real LiveCD, you may encounter problems and bugs. To test your fixes for these problems, it is convenient, to change the running test system. Afterwards you can merge these changes to your local development copy. </p>
|
||||
<p>Type <tt>scripts/cbox-dev.sh diff</tt> to see the changes, you made on the running <a href="CryptoBox.html">CryptoBox</a> system. </p>
|
||||
<p>Type <tt>scripts/cbox-dev.sh merge</tt> to merge these changes to your local working copy. </p>
|
||||
|
||||
<h3 id="head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</h3>
|
||||
|
||||
<p>Alternatively you may also upload a new version of your local working copy to the running <a href="CryptoBox.html">CryptoBox</a> system. </p>
|
||||
<p>Type <tt>scripts/cbox-dev.sh upload</tt> - beware: all recent changes you made to the running <a href="CryptoBox.html">CryptoBox</a> system, are lost. </p>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
62
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxIntro.html
Normal file
62
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxIntro.html
Normal file
|
@ -0,0 +1,62 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
|
||||
<h2 id="head-3ac73d0b8c70c774be737d43008ecbbe90b47c60">CryptoBox</h2>
|
||||
|
||||
<p>The <a href="CryptoBox.html">CryptoBox</a>-Project allows you to store your private data on an encrypting fileserver. You just need to put the bootable live-CD into an old computer and configure your personal <a href="CryptoBox.html">CryptoBox</a> within seconds. Your data is safe, as soon as you pull the plug. </p>
|
||||
<ul>
|
||||
<li><p> <a href="CryptoBoxUser.html">CryptoBoxUser/en</a> -- user guide </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBox.html">CryptoBox/en</a> -- details of the project </p>
|
||||
</li>
|
||||
<li><p> <a href="CryptoBoxDev.html">CryptoBoxDev/en</a> -- developer documentation </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>The <a href="CryptoBox.html">CryptoBox</a> is <a class="external" href="http://www.gnu.org/philosophy/free-sw.html">free software</a>: you are free to redistribute and modify it. See <a class="external" href="http://www.gnu.org/licenses/gpl.html">GPL</a> and <a class="external" href="http://creativecommons.org/licenses/by-nc-sa/2.0/">Creative Commons License</a> for details. </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
<p>The <a href="CryptoBox.html">CryptoBox</a>-Project was initiated by <a class="external" href="https://systemausfall.org/senselab">sense.lab</a>. </p>
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
79
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUser.html
Normal file
79
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUser.html
Normal file
|
@ -0,0 +1,79 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-2f352729b48ed53caaf36d4f8be5585dba2d80b9">User Documentation</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-2bdb4da4b459f842d64fcdbdc79ab3d6383f1407">Questions</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-2f352729b48ed53caaf36d4f8be5585dba2d80b9">User Documentation</h2>
|
||||
|
||||
<p>The following pages describe the easy use of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
<p>The online version of this manual is a wiki, which means you can edit the pages. So if you have a question or some description is unclear, please post it on the bottom of the relevant page. The developers will answer your questions and update the manual as fast as possible. This way you can contribute in making the <a href="CryptoBox.html">CryptoBox</a> a better experience for everyone! </p>
|
||||
<ol type="1">
|
||||
<li><p><a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted/en</a> -- first steps to get the Cryptobox up and running </p>
|
||||
</li>
|
||||
<li><p><a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/en</a> -- configure the details of your new encrypted fileserver </p>
|
||||
</li>
|
||||
<li><p><a href="CryptoBoxUserDailyUse.html">CryptoBoxUserDailyUse/en</a> -- daily use of your <a href="CryptoBox.html">CryptoBox</a> </p>
|
||||
</li>
|
||||
</ol>
|
||||
<p>The online version of this manual can be found at <a href="https://systemausfall.org/toolforge/CryptoBoxUser/en">https://systemausfall.org/toolforge/CryptoBoxUser/en</a>. </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-2bdb4da4b459f842d64fcdbdc79ab3d6383f1407">Questions</h2>
|
||||
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,165 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-b2e3c3d21cefdfa1346c517ec63c0c6652fba1d1">Overview</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-4244ebf306514fe0aba321b9bb92e70375af2d1f">Foreword</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-8853498a529036ba37e953d7ae99abb1c1da0113">Initialization</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-e1f6e8110136eced7bad4ae25232673890122d13">Configuration</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-dedf1b3f76a999c13b50d08148caa0f7a6ff959b">Hints / Caveats</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-e9e68aaf6182c3b5a9835f771916238c74d0cc33">Questions</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-b2e3c3d21cefdfa1346c517ec63c0c6652fba1d1">Overview</h2>
|
||||
|
||||
<p>All parts of administration of the <a href="CryptoBox.html">CryptoBox</a> are done through a comfortable web interface. If this is the first time you use the <a href="CryptoBox.html">CryptoBox</a>, just follow the steps below. </p>
|
||||
<p>You can safely ignore the <em>Foreword</em> if you're in a hurry. </p>
|
||||
<p><em>Initialization</em> describes the process of integrating a new harddisk. You usually have to perform this steps if you start with a new <a href="CryptoBox.html">CryptoBox</a> or after changing the harddisk. </p>
|
||||
<p>In the <em>Configuration</em> section, you can configure the <a href="CryptoBox.html">CryptoBox</a> according to your personal needs, e.g. change your desired language for the web interface or change the IP address of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
<p>Don't forget to read the <em>Hints / Caveats</em> section too. </p>
|
||||
|
||||
<h2 id="head-4244ebf306514fe0aba321b9bb92e70375af2d1f">Foreword</h2>
|
||||
|
||||
<p>Okay, you finished the <a href="CryptoBoxUserGettingStarted.html">CryptoBoxUserGettingStarted/en</a> and are now sitting in front of a computer that is connected via network with your <a href="CryptoBox.html">CryptoBox</a>. You point a browser to "<a href="https://192.168.0.23">https://192.168.0.23</a>" and the <a href="CryptoBox.html">CryptoBox</a> interface appears. </p>
|
||||
<p>Before you can save data on your <a href="CryptoBox.html">CryptoBox</a>, its harddisk has to be formatted with a cryptographic filesystem. Sounds complicated but don't be scared - it's really a "one click" thing. <img src="../../../var/www/cryptobox-img/smile.png" alt=":)" height="15" width="15"> </p>
|
||||
|
||||
<h2 id="head-8853498a529036ba37e953d7ae99abb1c1da0113">Initialization</h2>
|
||||
|
||||
<p>Click on <em>Initialize <a href="CryptoBox.html">CryptoBox</a></em> in the title bar. </p>
|
||||
<p>Now you are promted to enter two passwords twice (because we want to train your typing skills ;). </p>
|
||||
<ul>
|
||||
<li><p> The first password is the <em>administration password</em>. </p>
|
||||
<ul>
|
||||
<li><p> It is used to protect the configuration of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
</li>
|
||||
<li><p> This is necessary to make sure, that no one without your permission can destroy your data by re-initializing the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
</li>
|
||||
<li><p> Chances are good, that you will only need it once. </p>
|
||||
</li>
|
||||
<li><p> You may leave it empty, but this is not recommended. </p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p> The <em>crypto password</em> is the more important password, protecting the data on your harddisk. Choose it wisely! </p>
|
||||
<ul>
|
||||
<li><p> You will need it, whenever you want to access your encrypted data. </p>
|
||||
</li>
|
||||
<li><p> For a secure password consider a length of at least 15 characters including digits and special characters. The security of your encrypted data stands or falls with a good password. </p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p> To avoid mistakes and to remind you on what you're going to do, you have to type the displayed red phrase into the last field. </p>
|
||||
</li>
|
||||
<li><p> Now you can complete the initialization by clicking on the <em>Initialize CryptoBox</em> button at the bottom of the form. </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>That's all. Wasn't it a real "one click" thing? Cryptography has never been easier to use. <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
|
||||
<p>The initialization process takes place in the background and will be completed after a few minutes, depending on your harddisk's size. </p>
|
||||
|
||||
<h2 id="head-e1f6e8110136eced7bad4ae25232673890122d13">Configuration</h2>
|
||||
|
||||
<p>While the initialization is usually done only once, the configuration can be changed at any time you want. You can reach it by clicking at <em>Configuration</em> in the menu bar of the website. Now you see a form with four fields: </p>
|
||||
<ul>
|
||||
<li><p> If you defined a administration passwort during <em>Initialization</em>, you have to enter it first. Otherwise this field does not appear. </p>
|
||||
</li>
|
||||
<li><p> If the default network address (IP) doesn't fit into your network infrastructure, you can change it in the second field. </p>
|
||||
</li>
|
||||
<li><p> The timeout defines the amount of time (in minutes) after that the <a href="CryptoBox.html">CryptoBox</a> deactivates the access to the encrypted data. If you e.g. copy a file on the box, it starts counting at zero, so down-/uploads won't be interrupted. </p>
|
||||
<ul>
|
||||
<li><p> It's good choice to enter a small number (few minutes). </p>
|
||||
</li>
|
||||
<li><p> A timeout of <em>0</em> turns off the automatic deactivation - this is not recommended. </p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p> At <em>language preferences</em> you can select the default language for the <a href="CryptoBox.html">CryptoBox</a> interface. </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>Complete your changes by clicking on <em>Save configuration</em>. </p>
|
||||
<p>That's all - your <a href="CryptoBox.html">CryptoBox</a> is now ready for <a href="CryptoBoxUserDailyUse.html">daily use</a>! </p>
|
||||
|
||||
<h2 id="head-dedf1b3f76a999c13b50d08148caa0f7a6ff959b">Hints / Caveats</h2>
|
||||
|
||||
<ul>
|
||||
<li><p> All data on the <a href="CryptoBox.html">CryptoBox</a> harddisk will be erased during <em>Initialization</em>. </p>
|
||||
</li>
|
||||
<li><p> All passwords have to be typed twice to reduce the chance of a typo. </p>
|
||||
</li>
|
||||
<li><p> The optional adminstration password is necessary for configuration only. </p>
|
||||
</li>
|
||||
<li><p> The crypto password protects your beloved data. </p>
|
||||
</li>
|
||||
<li><p> If the cryptobox is not reachable by browsing to 192.168.0.23, you may have to adjust the network settings of your computer for initialization of the <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p><em>back to <a href="CryptoBoxUser.html">CryptoBoxUser/en</a></em> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-e9e68aaf6182c3b5a9835f771916238c74d0cc33">Questions</h2>
|
||||
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
105
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUserDailyUse.html
Normal file
105
v0.2.1/cbox-tree.d/_offline/doc/en/CryptoBoxUserDailyUse.html
Normal file
|
@ -0,0 +1,105 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-37a4d41cb3a9e26ce93c841fba0e8afd3367184b">Activate your encrypted filesystem</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-e0aa50e84f7fc78cc9e76ea1aabe9616a19d17ea">Deactivate your encrypted filesystem</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-3a58ba4feb37b325aecffed0f0b9cd3048b4ad48">Shut down your CryptoBox</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-dbb28a79cc5518696d0396b48ff4cde9cba8c5e3">In case of emergency</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-758bec29ea474875d5aafeee97fff1465a79cbe4">Questions</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-37a4d41cb3a9e26ce93c841fba0e8afd3367184b">Activate your encrypted filesystem</h2>
|
||||
|
||||
<p>You can activate your encrypted filesystem by doing following these steps: </p>
|
||||
<ul>
|
||||
<li><p> Point your web browser at the address of your <a href="CryptoBox.html">CryptoBox</a>. The default is <a href="https://192.168.0.23">https://192.168.0.23</a>. </p>
|
||||
</li>
|
||||
<li><p> Click on <em>Activation of encrypted data</em>. A new page asking for your crypto password appears. </p>
|
||||
</li>
|
||||
<li><p> Enter your crypto password and click on the button below labeled <em>activate encrypted filesystem</em>. </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>Now the filesystem is accessible. To use it, search for a computer in your network neighborhood. When asked for the name, enter the above IP address (default: 192.168.0.23). Now you can use it like any other network resource. </p>
|
||||
|
||||
<h2 id="head-e0aa50e84f7fc78cc9e76ea1aabe9616a19d17ea">Deactivate your encrypted filesystem</h2>
|
||||
|
||||
<p>You can deactivate the encrypted filesystem by clicking at <em>Deactivation of encrypted data</em> in the web interface of your <a href="CryptoBox.html">CryptoBox</a>. </p>
|
||||
<p>Your data is now protected again. </p>
|
||||
|
||||
<h2 id="head-3a58ba4feb37b325aecffed0f0b9cd3048b4ad48">Shut down your CryptoBox</h2>
|
||||
|
||||
<p>Click at the <em>Shutdown</em> link in the menu of the web interface. There you can choose <em>poweroff</em> or <em>reboot</em>. The shutdown takes some seconds. </p>
|
||||
<p>If the hardware of your <a href="CryptoBox.html">CryptoBox</a> is quite recent, it will power-off automatically. Otherwise you have to do it manually. </p>
|
||||
|
||||
<h2 id="head-dbb28a79cc5518696d0396b48ff4cde9cba8c5e3">In case of emergency</h2>
|
||||
|
||||
<p>If you have to protect the drive really fast, just power-off the <a href="CryptoBox.html">CryptoBox</a> machine instantly by pulling the plug or pushing the power button. This is not very clean and can (in very rare circumstances) corrupt open files, but it is the fasted method to secure your data. </p>
|
||||
<p><em>back to <a href="CryptoBoxUser.html">CryptoBoxUser/en</a></em> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-758bec29ea474875d5aafeee97fff1465a79cbe4">Questions</h2>
|
||||
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,116 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<title>CryptoBox</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<link rel="stylesheet" media="screen" href="../../../var/www/cryptobox.css" type="text/css" />
|
||||
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="lang">
|
||||
<a href="../en/CryptoBox.html">English</a><br/>
|
||||
<a href="../de/CryptoBox.html">Deutsch</a><br/>
|
||||
</div>
|
||||
|
||||
<div id="main">
|
||||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
||||
|
||||
<a id="top"></a>
|
||||
<ol>
|
||||
|
||||
<li>
|
||||
<a href="#head-059e26ee46182561a1c7e35e1a1ab2bf8a7a27ac">First Steps</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-f205f691abc70f7d2c60001ef96f32f544017295">Hints / Caveats</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="#head-237d3c26a42096a88e84db8c4f6d8923df1c2899">Questions</a>
|
||||
</li>
|
||||
|
||||
</ol>
|
||||
<p> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-059e26ee46182561a1c7e35e1a1ab2bf8a7a27ac">First Steps</h2>
|
||||
|
||||
<p>Getting the <a href="CryptoBox.html">CryptoBox</a> started doesn't take much: </p>
|
||||
<ol type="1">
|
||||
<li><p>You need an old Computer (at least 100MHz, 48MB RAM) (rule of thumb: bought at least after 1996). This PC needs a network card, a CD-ROM drive and a huge harddisk. </p>
|
||||
<ul>
|
||||
<li><p> Well the disk doesn't need to be huge, it should just suit your filestorage needs <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
|
||||
</li>
|
||||
<li><p> You don't need a monitor or a keyboard to use your <a href="CryptoBox.html">CryptoBox</a> (with one exception, see below). </p>
|
||||
</li>
|
||||
<li><p> Of course, you may use a faster computer, but they usually consume much more energy and do not provide signifcant advantages. </p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p>Then download the latest version of the <a href="CryptoBox.html">CryptoBox</a> as an iso-image and burn this image onto a CD. </p>
|
||||
<ul>
|
||||
<li><p> <a href="http://codecoop.org/projects/cryptobox/">http://codecoop.org/projects/cryptobox/</a> </p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p>Configure your PC, so it can boot from the CD. Therefore you have to enter the BIOS and configure the CD-ROM as boot device. </p>
|
||||
</li>
|
||||
<li><p>Insert the shiny new <a href="CryptoBox.html">CryptoBox</a> CD you've just burned and start the computer. </p>
|
||||
</li>
|
||||
</ol>
|
||||
<p>If it now boots from the CD, you accomplished all of the requirements. </p>
|
||||
<p>Now you can just go to your current desktop computer and point your browser to <a href="https://192.168.0.23">https://192.168.0.23</a> where the <a href="CryptoBox.html">CryptoBox</a> interface should be displayed. Easy - isn't it? </p>
|
||||
<p>For further steps go to <a href="CryptoBoxUserConfiguration.html">CryptoBoxUserConfiguration/en</a>. </p>
|
||||
|
||||
<h2 id="head-f205f691abc70f7d2c60001ef96f32f544017295">Hints / Caveats</h2>
|
||||
|
||||
<ul>
|
||||
<li><p> Maybe you need to change the network address (IP) of your PC to configure the <a href="CryptoBox.html">CryptoBox</a> for the first time. Ask someone for help, if you don't know how and why ... </p>
|
||||
</li>
|
||||
<li><p> If you're going to buy a new harddisk keep in mind that very old hardware can't handle actual disksizes! </p>
|
||||
</li>
|
||||
<li><p> Some old PCs are not able to boot from CD. </p>
|
||||
</li>
|
||||
<li><p> If you don't know what a BIOS is, better ask someone, before you try to change something. <img src="../../../var/www/cryptobox-img/smile4.png" alt=";)" height="15" width="15"> </p>
|
||||
</li>
|
||||
<li><p> Don't forget to connect your PC to your local area network! </p>
|
||||
</li>
|
||||
<li><p> To configure the BIOS, you need a keyboard and a monitor. But this has to be done only once. </p>
|
||||
</li>
|
||||
</ul>
|
||||
<p><em>back to <a href="CryptoBoxUser.html">CryptoBoxUser/en</a></em> </p>
|
||||
<hr>
|
||||
<p> </p>
|
||||
|
||||
<h2 id="head-237d3c26a42096a88e84db8c4f6d8923df1c2899">Questions</h2>
|
||||
|
||||
|
||||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
6
v0.2.1/cbox-tree.d/_offline/doc/en/doc_footer.inc
Normal file
6
v0.2.1/cbox-tree.d/_offline/doc/en/doc_footer.inc
Normal file
|
@ -0,0 +1,6 @@
|
|||
</div><!-- end of 'words' -->
|
||||
|
||||
<div id="footer">
|
||||
<a href="https://systemausfall.org/prj/cryptobox" title="Project page">CryptoBox-Home</a> The CryptoBox is a project of <a href="https://systemausfall.org/senselab" title="systemausfall.org">sense.lab</a>
|
||||
</div>
|
||||
|
13
v0.2.1/cbox-tree.d/_offline/doc/en/doc_header.inc
Normal file
13
v0.2.1/cbox-tree.d/_offline/doc/en/doc_header.inc
Normal file
|
@ -0,0 +1,13 @@
|
|||
<div id="head">
|
||||
<h1>The CryptoBox</h1>
|
||||
<h2>Privacy for the rest of us.</h2>
|
||||
</div>
|
||||
|
||||
<div id="content">
|
||||
<div id="menu">
|
||||
<a href="CryptoBox.html">Overview</a>
|
||||
<a href="CryptoBoxUser.html">User documentation</a>
|
||||
<a href="CryptoBoxDev.html">Development</a>
|
||||
</div>
|
||||
|
||||
<div id="doc">
|
Loading…
Add table
Add a link
Reference in a new issue