[seahorse/wip/userdocs: 120/363] docs: added page about certs. initial draft of ssh-key description.



commit 6e98f99949b397f71ad7bd91a82d2b2fc5871f14
Author: Jim Campbell <jwcampbell gmail com>
Date:   Sun Mar 4 12:39:30 2012 -0600

    docs: added page about certs. initial draft of ssh-key description.

 help/C/import-existing-keys.page    |    6 -----
 help/C/what-is-certificate-key.page |   21 ++++++++++++++++++++
 help/C/what-is-ssh-key.page         |   36 +++++++++++++++++++++++++++-------
 3 files changed, 49 insertions(+), 14 deletions(-)
---
diff --git a/help/C/import-existing-keys.page b/help/C/import-existing-keys.page
index d45054c..b1354cc 100644
--- a/help/C/import-existing-keys.page
+++ b/help/C/import-existing-keys.page
@@ -15,12 +15,6 @@
 
   <title>Import an existing PGP or SSH key</title>
 
-  <comment>
-    <cite date="2011-06-17" href="mailto:jwcampbell gmail com">Jim Campbell</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
-
   <p>Short introductory text...</p>
 
   <steps>
diff --git a/help/C/what-is-certificate-key.page b/help/C/what-is-certificate-key.page
new file mode 100644
index 0000000..9df0b17
--- /dev/null
+++ b/help/C/what-is-certificate-key.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="what-is-certificate-key">
+
+<info>
+  <link type="guide" xref="index#learn-about-keys"/>
+  <revision pkgversion="3.4" version="0.1" date="2012-03-04" status="stub"/>
+  <credit type="author">
+    <name>Jim Campbell</name>
+    <email>jwcampbell gmail com</email>
+  </credit>
+</info>
+
+<title>What is a certificate?</title>
+
+  <p>If you select <guiseq><gui>View</gui><gui></gui>Show Any</guiseq>, you 
+  will see many <em>Certificates</em> listed alongside your PGP and SSH keys.
+  . . . </p>
+  
+
+</page>
diff --git a/help/C/what-is-ssh-key.page b/help/C/what-is-ssh-key.page
index 5f39510..1296b35 100644
--- a/help/C/what-is-ssh-key.page
+++ b/help/C/what-is-ssh-key.page
@@ -12,14 +12,34 @@
 
   </info>
 
-  <title>What is an SSH key?</title>
+  <title>What is a Secure Shell key?</title>
 
-  <p>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+  <p>A <em>Secure Shell key</em>, often just called an <em>SSH key</em>, 
+  helps you create a secure connection over an unsecured network.</p>
+  
+  <p>Before <em>SSH keys</em>, computers would create connections via insecure 
+  protocols, such as <em>Telnet</em>. These protocols just used plaintext 
+  passwords to create connections between computers. These passwords could be 
+  easily intercepted.</p>
+  
+  <list>
+    <title>An SSH key actually consists of two parts:</title>
+    <item><p>A public key, which is widely available.</p></item>
+    <item><p>A private key, which is kept secret. The private key is used 
+    to unlock messages encrypted with a corresponding public key.</p></item>
+  </list>
+  
+  <p>The advantage of using an <em>SSH key</em> to create a connection between 
+  computers is that only the <em>Public key</em> needs to be sent over 
+  the network. Transmissions encrypted with a <em>Public key</em> can only be 
+  decoded by unlocking them with the corresponding <em>Private key</em> and a 
+  password. Because only the public key is sent over the network, the key's 
+  password is kept secret.</p>  
 
+  <p><em>SSH keys</em> are most often used in situations where data security is 
+  very important. For example, a system administrator would use an <em>SSH key
+  </em> when connecting to a remote server to perform system updates. A 
+  software developer would use an <em>SSH key</em> to submit updated software 
+  code to a remote software repository.</p>
+  
 </page>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]