Mercurial > trustbridge
changeset 919:e15637472a99
(manual) Updated help pages.
author | Emanuel Schuetze <emanuel@intevation.de> |
---|---|
date | Thu, 21 Aug 2014 13:58:33 +0200 |
parents | a55c6cf54365 |
children | e48ad80c3aca |
files | manuals/help-manual/.conf.py.swp manuals/help-manual/_static/extra-style.css manuals/help-manual/_static/nsis-installer.png manuals/help-manual/_static/trustbridge-gui_win.png manuals/help-manual/bedienung.rst manuals/help-manual/index.rst manuals/help-manual/installation.rst |
diffstat | 7 files changed, 77 insertions(+), 13 deletions(-) [+] |
line wrap: on
line diff
--- a/manuals/help-manual/_static/extra-style.css Mon Aug 18 18:52:39 2014 +0200 +++ b/manuals/help-manual/_static/extra-style.css Thu Aug 21 13:58:33 2014 +0200 @@ -7,3 +7,8 @@ margin-top: 0px; margin-bottom: 20px; } +tt { + font-size: 1.1em; + background-color: transparent; +} +
--- a/manuals/help-manual/bedienung.rst Mon Aug 18 18:52:39 2014 +0200 +++ b/manuals/help-manual/bedienung.rst Thu Aug 21 13:58:33 2014 +0200 @@ -9,4 +9,7 @@ - **Empfohlene Wurzelzertifikate:** Alle Wurzelzertifikate, die TrustBridge zur Installation vorgeschlagen hat. - **Abgeratene Wurzelzertifikate:** Alle Wurzelzertifikate, die TrustBridge zur Deinstallation empfohlen hat. -TODO: Screenshot +.. figure:: _static/trustbridge-gui_win.png + :alt: Die TrustBridge-Oberfläche unter Windows bei verfügbaren Zertifikatsänderungen + :width: 100% +
--- a/manuals/help-manual/index.rst Mon Aug 18 18:52:39 2014 +0200 +++ b/manuals/help-manual/index.rst Thu Aug 21 13:58:33 2014 +0200 @@ -11,12 +11,12 @@ Dabei ist unerheblich, ob die Zertifikate auf der Anwenderebene vorher bereits installiert waren. -**Wurzelzertifikate** sind die Basis einer PKI zur Feststellung der +**Wurzelzertifikate** (auch Rootzertifikate genannt) sind die Basis einer PKI zur Feststellung der Authentizität des Kommunikationspartners und der Integrität seiner Nachrichten für verschiedene Anwendungen -- insbesondere bei der Übertragung über unsichere Kommunikationskanäle, wie dem Internet. -Ein Wurzel- oder auch "Root"-Zertifikat dient als Vertrauensanker +Ein Wurzelzertifikat dient als Vertrauensanker ("Trust Anchor") für alle darunter hängenden Zertifikate. Unterhalb der Wurzel folgt eine Sicherheitskette ("Trust Chain") von ein oder mehreren Zwischenzertifikaten der Zertifizierungsstellen, gefolgt von @@ -29,7 +29,7 @@ Über diese Hilfe ================ -Diese Hilfe unterstützt Sie bei der Bedienung von TrustBridge sowie +Diese Hilfe unterstützt Sie bei der Bedienung von TrustBridge |version| sowie vermittelt Ihnen ein beseres Verständnis was die Anwendung macht und wofür das gut ist. Die Hilfeseiten im Überblick:
--- a/manuals/help-manual/installation.rst Mon Aug 18 18:52:39 2014 +0200 +++ b/manuals/help-manual/installation.rst Thu Aug 21 13:58:33 2014 +0200 @@ -5,19 +5,75 @@ Offiziell unterstützt und geprüft sind Windows 7 und 8 sowie Ubuntu 14.04 (jeweils 32 und 64 Bit). -Weiterhin werden alle Anwendungen unterstützt, die auf die -Zertifikatsspeicher zugreifen -- Mozilla Firefox -- Mozilla Thunderbird -- Google Chrome / Chromium -- MS Internet Explorer -- MS Outlook +TrustBridge greift auf zwei gängige `Zertifikatsspeicher <konzept.html#zertifikatsspeicher>`_ zu, den Windows-System-Zertifikatsspeicher und den Mozilla-NSS-Zertifikatsspeicher. +Folgende Anwendungen nutzen diese Zertifikatsspeicher und werden von TrustBridge unterstützt: + +* Mozilla Firefox +* Mozilla Thunderbird +* Google Chrome / Chromium +* MS Internet Explorer +* MS Outlook Windows ------- -TODO: NSIS-Installer (signiert), systemweit vs. Einzelnutzer +Nach dem Start des Installationsassistenten TrustBridge-|version|.exe folgt ein +Begrüßungsdialog: + +.. figure:: _static/nsis-installer.png + :alt: Installationsassistent unter Windows + +Der Installationsdatei ist mit einem Code-Signing-Zertifikat signiert. + +Sie können TrustBridge **systemweit** (benötigt Administrator-Rechte) oder +**lokal** (nur für den aktuellen Nutzer) installieren. + +Sobald Sie den TrustBridge-Installer mit Administrator-Rechten ausführen (z.B. +als eingeloggter Admin) wird die Anwendung immer systemweit installiert. Das +bedeutet, dass jeder Nutzer auf dem System später die von TrustBridge +installierten Zertifikate nutzen kann. Der Administrator ist zuständig für die +regelmäßige Prüfung nach Aktualisierung von Software und Zertifikaten. + +Eine lokale Installation ermöglicht es Nutzern ohne Administrator-Rechte +TrustBridge selbständig zu installieren. Die Zertifikate werden dann später nur im +Zertifikatsspeicher des Nutzers abgelegt. + +Für die **Deinstallation** von TrustBridge gehen Sie über den üblichen Weg +der Windows-Systemsteuerung ("Programme deinstallieren") und folgen Sie den +Anweisungen des Deinstallationsassistenten. + Ubuntu ------ -TODO: Installatonsskript (signiert), systemweit vs. Einzelnutzer +Für die Installation von TrustBridge unter Ubuntu wird ein interaktives Installationsskript +für die Kommandozeile angeboten - jeweils ein Script für 32 und 64 Bit-Systeme. + +Führen Sie das Skript ohne Option aus, um Trustbridge **lokal** in Ihrem Home-Verzeichnis zu installieren +(standardmäßg unter ``/home/TrustBridge/``). + +Für 64-Bit-Systeme: + +.. parsed-literal:: + ./TrustBridge-|version|-amd64.sh + +Für 32-Bit-Syteme: + +.. parsed-literal:: + ./TrustBridge-|version|-i386.sh + + +Sollten Sie eine **systemweite Installation** wünschen, nutzen Sie die Option ``-s``: + +.. parsed-literal:: + ./TrustBridge-|version|-amd64.sh -s # für 64-Bit + ./TrustBridge-|version|-i386.sh -s # für 32-Bit + + +Zur **Deinstallation** der Anwendung (mit allen Zertifikaten) steht Ihnen die Option ``-d`` zur Verfügung: + +.. parsed-literal:: + ./TrustBridge-|version|-amd64.sh -d # für 64-Bit + ./TrustBridge-|version|-i386.sh -d # für 32-Bit + + +Eine Hilfe zu den verfügbaren Kommandozeilenoptionen bietet Ihnen ``--help``.