Mercurial > trustbridge
changeset 1223:fd47a79125c6
(help-client) Added and explained certificate state icons.
| author | Emanuel Schuetze <emanuel@intevation.de> |
|---|---|
| date | Wed, 24 Sep 2014 14:54:09 +0200 |
| parents | 5f59344dbd13 |
| children | 7e720a820e1f |
| files | doc/help/client/_static/aktualisieren.png doc/help/client/_static/certificate-install.png doc/help/client/_static/certificate-installed.png doc/help/client/_static/certificate-not-install.png doc/help/client/_static/certificate-not-installed.png doc/help/client/_static/certificate-not-remove.png doc/help/client/_static/certificate-remove-red.png doc/help/client/_static/certificate-remove.png doc/help/client/_static/certificate-removed.png doc/help/client/_static/erneut-schreiben.png doc/help/client/_static/extra-style.css doc/help/client/_static/trustbridge-gui_win.png doc/help/client/bedienung.rst doc/help/client/index.rst doc/help/client/installation.rst |
| diffstat | 15 files changed, 126 insertions(+), 59 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/help/client/_static/extra-style.css Wed Sep 24 11:17:14 2014 +0200 +++ b/doc/help/client/_static/extra-style.css Wed Sep 24 14:54:09 2014 +0200 @@ -3,6 +3,9 @@ margin-bottom: 10px; padding: 4px; } +img { + vertical-align: top; +} .figure .caption { margin-top: 0px; margin-bottom: 20px;
--- a/doc/help/client/bedienung.rst Wed Sep 24 11:17:14 2014 +0200 +++ b/doc/help/client/bedienung.rst Wed Sep 24 14:54:09 2014 +0200 @@ -5,7 +5,7 @@ Die **TrustBridge-Oberfläche** gliedert sich in 3 Seiten, die über die großen Schaltflächen an der linken Seite aufgerufen werden können: -- **Neue Empfehlungen:** Alle verfügbaren Aktualisierungen und Änderungen werden hier bestätigt und installiert. +- **Ausstehende Änderungen:** Alle verfügbaren Aktualisierungen und Änderungen werden hier bestätigt und installiert. - **Empfohlene Wurzelzertifikate:** Alle Wurzelzertifikate, die TrustBridge zur Installation vorgeschlagen hat. - **Abgeratene Wurzelzertifikate:** Alle Wurzelzertifikate, die TrustBridge zur Deinstallation empfohlen hat. @@ -14,62 +14,105 @@ :width: 100% -Seite "Neue Empfehlungen" -------------------------- +Seite "Ausstehende Änderungen" +------------------------------ -Neue Zertifikatsänderungen schreiben: -..................................... -Sind neue Zertifikatsaktualisierungen vom BSI verfügbar, werden Sie +Neue, empfohlene Änderungen: +............................ +Ist eine neue Zertifikatsliste verfügbar, werden Sie über die empfohlenen Änderungen auf dieser Seite informiert. Im Titel finden Sie die Gesamtanzahl der vorgeschlagenen Zertifikatsänderungen. -Über den Button *[Änderungen schreiben]* können Sie diese Änderungen -vollständig übernehmen. -Details zu den empfohlenen Zertifikaten (wie z.B. Zertifikatsinhaber, -Gültigkeit, Fingerabdruck) lassen sich im unteren Teil der Seite über -die beiden Gruppierungen mittels der *[Details]* Button einblenden: +Informationen zu den empfohlenen Zertifikaten (wie z.B. Zertifikatsinhaber, +Gültigkeit, Fingerabdruck) lassen sich über die beiden eingeklappten Listen +mittels des *[Details]*-Button einblenden: -* Neue, empfohlene Wurzelzertifikate installieren (n/n) -* Abgeratene Wurzelzertifikate entfernen (n/n) +* Neue, empfohlene Wurzelzertifikate installieren +* Abgeratene Wurzelzertifikate entfernen -An dieser Stelle haben Sie die Möglichkeit (*vor* dem Schreiben der +An dieser Stelle haben Sie die Möglichkeit (vor dem Schreiben der Änderungen) ausgewählte Zertifikate "abzuwählen". Dadurch werden diese Zertifikate *nicht* installiert bzw. entfernt. Solche Abwahlentscheidungen können Sie später jederzeit wieder auf den Seiten "Empfohlene Wurzelzertifikate" und "Abgeratene Wurzelzertifikate" korrigieren. -Suche nach Aktualisierungen: -............................ -Beim Start der Anwendung wird automatisch nach neuen Aktualisierungen -(Software und Zertifikaten) gesucht. Über den Button *[Aktualisieren]* -kann diese Suche auch manuell angestoßen werden. Der letzte -Suchzeitpunkt wird daneben angezeigt. +Über den Button *[Änderungen schreiben]* werden alle Zertifikatsänderungen (die +Anzahl steht im Titel und im roten Kreis der Schaltfläche) in die Zertifikatsspeicher geschrieben. -Wurzelzertifikate erneut schreiben: -................................... -Sind alle Zertifikatsänderungen eingespielt und liegen keine -Änderungen vor, können alle von TrustBridge verwalteten Zertifikate -noch einmal installiert werden. Dafür muss auf den Button -*[Wurzelzertifikate erneut schreiben]* geklickt werden. Hilfreich -könnte diese Funktion sein, wenn seit der letzten Aktualisierung durch +Anschließend ist die List der Ausstehenden Änderungen leer - bis zur +nächsten verfügbaren Zertifikatslisten-Aktualisierung. + +Zertifikatszustände auswählen: +.............................. + +Jedes Zertifikat kann verschiedene Zustände einnehmen und manuell von +Ihnen geändert werden. Diese Abwahlentscheidungen merkt sich +TrustBridge. Nachfolgend eine Erklärung der verwendeten Icons: + +Auswahl bei neuen Zertifiaktslisten (vor der +Installation/Deinstallation der Zertifikate): + +|install| Ein zur Installation empfohlenes Zertifikate wird installiert. (Voreinstellung) + +|not-install| Ein zur Installation empfohlenes Zertifikate wird **nicht** installiert. + +|remove| Ein zur Deinstallation empfohlenes Zertifikate wird entfernt. (Voreinstellung) + +|not-remove| Ein zur Deinstallation empfohlenes Zertifikate wird **nicht** entfernt. + + + +Weitere Aktionen: +................. + +|aktualisieren| sucht nach neuer Software- und Zertifikatslisten-Version. +(TrustBridge sucht bereits täglich oder nach Anmeldung am System automatisch nach neuen Aktualisierungen.) + +.. |aktualisieren| image:: _static/aktualisieren.png + +|erneut-schreiben| installierten bzw. deinstallierten alle verwalteten +Zertifikate noch einmal. +Hilfreich, wenn z.B. seit der letzten Zertifikatsaktualisierung durch TrustBridge im Zertifikatsspeicher *manuell* Zertifikate geändert -wurden. Um den durch TrustBridge empfohlenen Stand wiederherzustellen, -klickt man einmal auf o.g. Schaltfläche. +wurden. + + +.. |erneut-schreiben| image:: _static/erneut-schreiben.png + Seite "Empfohlene Wurzelzertifikate" ------------------------------------ Alle Wurzelzertifikate, die TrustBridge aktuell zur Installation -vorgeschlagen hat, sind auf dieser Seite einsehbar. Jedes Zertifikat +vorgeschlagen hat, werden auf dieser Seite aufgelistet. Jedes Zertifikat kann einzeln "abgewählt" werden, d.h. es wird mit der nächsten -*[Änderungen schreiben]*-Aktion entfernt. Bereits "abgewählte" -Zertifikate können analog so zur Installation markiert werden. +*[Änderungen schreiben]*-Aktion entfernt. Bereits abgewählte +Zertifikate können genauso wieder zur Installation markiert werden. Jede manuelle Änderung, die Sie hier vornehmen, wird auf der Seite -"Neue Empfehlungen" aufgelistet. Die Anzahl der "abweichend zu -behandelnden Wurzelzertifikate" wird auch auf der Schaltfläche "Neue -Empfehlungen" im roten Kreis angezeigt. +"Ausstehende Änderungen" aufgelistet. Die Anzahl der manuellen +Änderungen wird auf der Schaltfläche "Ausstehende Änderungen" +im roten Kreis angezeigt. + + +**Zustände eines installierten Zertifikats:** + +|installed| |remove-red| + +Ein zur Installation empfohlenes Zertifikate ist **installiert** (links) +bzw. **wird deinstalliert** (rechts). + + +**Zustände eines abgewählten, nicht installierten Zertifikats:** + +|not-install| |install| + +Ein zur Installation empfohlenes Zertifikat ist **nicht installiert** (links) bzw. **wird +installiert** (rechts). + + + **Achtung:** TrustBridge zeigt *nicht* den tatsächlichen Installationszustand eines Zertifikats im Zertifikatsspeicher an. @@ -88,16 +131,42 @@ Sollten Sie Zertifikate bei der Aktualisierung "zurückgehalten" haben, d.h. noch nicht zur Deinstallation freigegeben haben, können Sie das -Zertifikat über das Auswahlfeld zur Deinstallation markieren. Damit -das Zertifikat endgültig aus allen Zertifikatsspeichern gelöscht wird +Zertifikat hier zur Deinstallation markieren. + +Damit das Zertifikat endgültig aus allen Zertifikatsspeichern gelöscht wird, müssen Sie anschließend den *[Änderungen schreiben]*-Button auf der -Seite "Neue Empfehlungen" bestätigen. +Seite "Ausstehende Änderungen" bestätigen. + +**Zustände eines deinstallierten Zertifikats:** + +|removed| + +Ein zur Deinstallation empfohlenes Zertifikate **wurde enfernt**. + + +**Zustände eines abgewählten, nicht deinstallierten Zertifikats:** + +|not-remove| |remove| + +Ein zur Deinstallation empfohlenes Zertifikat ist **nicht deinstalliert** (links) bzw. **wird deinstalliert** (rechts). Seite "Information und Hilfe" ----------------------------- -Neben der Erwähnung von Herstellers und Lizenz von TrustBridge finden +Neben der Erwähnung von Hersteller und Lizenz von TrustBridge finden Sie hier die Möglichkeit: * diese TrustBridge-Hilfe zu starten und * die Proxy-Server-Einstellungen vorzunehmen. + + + + +.. |install| image:: _static/certificate-install.png +.. |not-install| image:: _static/certificate-not-install.png +.. |remove| image:: _static/certificate-remove.png +.. |not-remove| image:: _static/certificate-not-remove.png +.. |removed| image:: _static/certificate-removed.png +.. |not-removed| image:: _static/certificate-not-remove.png +.. |installed| image:: _static/certificate-installed.png +.. |remove-red| image:: _static/certificate-remove-red.png
--- a/doc/help/client/index.rst Wed Sep 24 11:17:14 2014 +0200 +++ b/doc/help/client/index.rst Wed Sep 24 14:54:09 2014 +0200 @@ -13,7 +13,7 @@ Was ist TrustBridge? ==================== TrustBridge erleichtert Ihnen das Einpflegen von Wurzelzertifikaten -zur Absicherung von Kommunikation durch Verschlüsselung und Signaturen. +zur Absicherung Ihrer Kommunikation durch Verschlüsselung und Signaturen. Dazu holt sich TrustBridge regelmäßig die Wurzelzertifikate, welche von einer zentralen Stelle vorgeschlagen werden und bietet Sie Ihnen zum Einfügen in den Zertifikatspeicher Ihres Rechners an. @@ -29,20 +29,15 @@ erst Ihre Erlaubnis. Wurzelzertifikate verwalten den Zugang zu Ihren Daten. -Verwenden Sie TrustBridge deshalb nur, wenn Sie der Organisation -vertrauen von der Sie die Software erhalten -und welche die Wurzelzertifikatsvorschläge pflegt. +Verwenden Sie TrustBridge deshalb nur, wenn Sie der Organisation, +(von der Sie die Software erhalten haben +und welche die Wurzelzertifikatsvorschläge pflegt) vertrauen. TrustBridge arbeitet im Hintergrund und meldet sich bei Ihnen, wenn es etwas Neues gibt. TrustBridge ist eine Anwendung vom `Bundesamt für Sicherheit in der -Informationstechnik (BSI) <https://bsi.bund.de>`_ für die Verbreitung -von empfohlenen Wurzelzertifikaten. - -TrustBridge macht es Nutzern einfacher, Wurzelzertifikate für eine -X.509-basierende, öffentliche Zertifikatsinfrastruktur (PKI) -einzuspielen und aktuell zu halten. +Informationstechnik (BSI) <https://bsi.bund.de>`_.
--- a/doc/help/client/installation.rst Wed Sep 24 11:17:14 2014 +0200 +++ b/doc/help/client/installation.rst Wed Sep 24 14:54:09 2014 +0200 @@ -7,7 +7,7 @@ Offiziell unterstützt und geprüft sind Windows 7 und 8 sowie Ubuntu 14.04 (jeweils 32 und 64 Bit). -TrustBridge greift auf zwei gängige `Zertifikatsspeicher <konzept.html#zertifikatsspeicher>`_ zu, den Windows-System-Zertifikatsspeicher und den Mozilla-NSS-Zertifikatsspeicher. +TrustBridge greift auf zwei gängige `Zertifikatsspeicher <techn-referenz.html#welche-zertifikatsspeicher-werden-verwendet>`_ zu, den Windows-System-Zertifikatsspeicher und den Mozilla-NSS-Zertifikatsspeicher. Folgende Anwendungen nutzen diese Zertifikatsspeicher und werden von TrustBridge unterstützt: * Mozilla Firefox @@ -16,10 +16,11 @@ * MS Internet Explorer * MS Outlook -Weitere Anforderungen: +Weitere Anforderungen zum Betrieb der Anwendung: + * Internetverbindung (mit offenen TLS-Port 443 zum Update-Server; oder Verbindung zu einem Proxy-Server) -* Plattenplatz: ca. 20 MB -* nur Ubuntu: Python2 (Teil der Standard-Installation) oder uudecode erforderlich +* erforderlicher Festplattenplatz: ca. 20 MB +* Das Installationsskript unter Ubuntu erfordert Python2 (Teil der Standard-Installation) oder uudecode. Windows @@ -42,7 +43,7 @@ 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 +TrustBridge selbständig zu installieren. Die Zertifikate werden dann nur im Zertifikatsspeicher des Nutzers abgelegt. Für die **Deinstallation** von TrustBridge gehen Sie über den üblichen Weg @@ -52,13 +53,12 @@ Ubuntu ------ -Für die Installation von TrustBridge unter Ubuntu wird ein interaktives Installationsskript -für die Kommandozeile angeboten - jeweils für 32- und 64-Bit-Systeme +Für die Installation von TrustBridge unter Ubuntu ist ein Installationsskript +für die Kommandozeile verfügbar - jeweils für 32- und 64-Bit-Systeme (TrustBridge-|version|-amd64.sh bzw. TrustBridge-|version|-i386.sh). -Eine Anleitung zur Installation unter Ubuntu finden Sie in der -Kopfzeile des Installationsskripts - Doppelklicken, -um es im Texteditor zu öffnen. +Eine Schritt-für-Schritt-Anleitung zur Installation unter Ubuntu finden Sie in der +Kopfzeile des Installationsskripts (Doppelklicken, um es im Texteditor zu öffnen). Sie haben zwei Installationsmöglichkeiten: **systemweit** (erfordert sudo-Rechte) oder **lokal** (in Ihrem Heimatverzeichnis).