callisto-debian/evolution
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Put config-encryption in usage-mail.sgml. config-encryption.sgml should be

Browse Source 
2001-06-25  Kevin Breit  <battery841@mediaone.net>

	* C/usage-mail.sgml: Put config-encryption in usage-mail.sgml.  config-encryption.sgml should be depreciated.

svn path=/trunk/; revision=10486
This commit is contained in:
Kevin Breit
2001-06-25 18:35:29 +00:00
committed by Kevin Breit
parent 308a2af1a1
commit 3ec4dfd27d
8 changed files with 308 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
doc/C/Makefile.am
View File

@ -5,7 +5,6 @@ GUIDE_SGML_FILES = \
apx-authors.sgml \
apx-bugs.sgml \
apx-gloss.sgml \
config-encryption.sgml \
config-prefs.sgml \
config-setupassist.sgml \
config-sync.sgml \

3
doc/C/usage-contact.sgml
View File

@ -155,7 +155,8 @@
Contact</guimenuitem></menuchoice>. This will open the
in-depth search window, which lets you use multiple search
criteria in the same way that email filters and <glossterm
linkend="vfolder">virtual folders</glossterm> do.. </para>
linkend="vfolder">virtual folders</glossterm> do.
</para>
<para>
Click <guibutton>Add Criterion</guibutton> to increase the
number of criteria you'd like to use in the search, and

150
doc/C/usage-mail.sgml
View File

@ -1583,6 +1583,7 @@ with quoted materials and the relevant replies interspersed-->
</figure>
</para>
</sect2>
<sect2 id="usage-mail-subscriptions">
<title>Subscription Management</title>
<para>
@ -1605,9 +1606,154 @@ with quoted materials and the relevant replies interspersed-->
will check for new messages whenever you press the
<guibutton>Get Mail</guibutton> button.
</para>
</sect2>
</sect1>
<sect1 id="encryption">
<title>Encryption</title>
<sect2 id="encryption-whatis">
<title>What is Encryption?</title>
<para>
Encryption is an ancient method of changing readable text to unreadable
text that dates back to Egyptian times. Encryption takes the statement
"Evolution" and turns it into something which cannot be read without help
through decryption.
<example>
<title>Encryption Example</title>
<para>
Kevin orders an <application>Evolution</application> t-shirt from
Ximian, Inc. over the internet. He puts in his credit card number
which is 1234-567-8901. For security, his computer encrypts the
credit card number so it can be safely transmitted over the internet.
The number now is @#$23ui7yr87#@!48970fsd, which holds no intentional
resemblance to the inital number. When the information gets to
Ximian, Inc. it'll be decrypted into the inital number.
</para>
</example>
Encryption can be used in email in two ways: to verify that the sender is
the real sender, and to hide the message while in transmission.
<application>Evolution</application> has the capability to do both.
</para>
</sect2>
<sect2 id="encryption-keygen">
<title>Generating your PGP key</title>
<para>
First, you need to create a PGP key. To do this, you'll need GPG
installed.
</para>
<tip>
<title>GPG Versions</title>
<para>
This manual covers version 1.0.6 of GPG. If your version is different,
this may not be entirely accurate. You may find out your version number
by typing in: <command>gpg --version</command>.
</para>
</tip>
<para>
You can start by typing in: <command>gpg --gen-key</command>. At the
first question, select 1. The next question asks you about key length.
The longer the key, more stronger it is. However, the longer the key, the
longer it takes to generate. This is your choice. However, 1024 bits
(default) should be adequate. The next question asks you if you want your
key to expire. Expiring keys make your key invalid after a certain amount
of time, so old keys don't float around active. This is the same concept
as a coupon at a supermarket. Next, you'll type in your Real name, your
email address, and a comment. You should not forge this information, as
it is used later to verify who you are. Assuming that all your
information is correct, press "O" to continue. GPG now asks you for a
passphrase. This is a password which you will need to decrypt and encrypt
messages. This can be any length, with any characters in it. It is case
sensitive, which means that it does know the difference between capital
letters and lower-case. Now your key is generated. It is recommend you
surf the internet, read your email, or write a letter in a word
processor. This help creates randomness in the key.
</para>
<para>
Once this is completed, you'll be dropped back to the command line.
Now you can view your key information by typing <command>gpg
--list-keys</command>. You should see something similar to this:
<example id="gpg-list-keys">
<title>GPG Listing Keys</title>
<para>
/home/bob/.gnupg/pubring.gpg
----------------------------
pub 1024D/32j38dk2 2001-06-20 bob &lt;bob@bob.com&gt;
sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]
</para>
</example>
You'll now need to upload your public key to a keyserver, so that your
friends can use your key. You'll need to know the ID of your key, which
is after the 1024D on the line beginning with pub. For this example, it
is 32j38dk2. You now type in <command>gpg --send-keys --keyserver
wwwkeys.pgp.net 32j38dk2</command>. Substitute your key ID for 32j38dk2.
You will be prompted to type in your password <!-- verify that you need to
enter your password here --> and your key will be uploaded for your
friends to download.
</para>
</sect2>
<sect2 id="encrypt-evo-integ">
<title>Setting up Evolution's Encryption</title>
<para>
You'll need to open
<menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Mail Settings</guimenuitem>
</menuchoice>
Once there, select the account you'd like to associate the key to and click
the <guibutton>Edit</guibutton> button. In the
<guilabel>Security</guilabel> tab is a section labeled <guilabel>Pretty
Goog Privacy</guilabel>. Enter your key ID and click
<guibutton>OK</guibutton>. Your key is now integrated into your identity
in <application>Evolution</application>.
</para>
</sect2>
<sect2 id="encrypt-sending">
<title>Sending Encrypted Messages</title>
<para>
You can either sign or encrypt a message. When you sign a message, verify
that you were the one who sent it, and that no one is forging your
identity. Encrypting a message makes it impossible for someone with
prying eyes to view it while it's in tranmission.
</para>
</sect2>
<sect2 id="sign-msg">
<title>Signing a Message</title>
<para>
To sign a message, you simply click
<menuchoice>
<guimenu>Security</guimenu>
<guimenuitem>PGP Sign</guimenuitem>
</menuchoice>
. You will be prompted for your PGP password. Once you enter it,
click <guibutton>OK</guibutton> and your message will be signed.
</para>
</sect2>
<sect2 id="encrypt-msg">
<title>Encrypting a Message</title>
<para>
Encrypting a message is very similar to signing a message. You simply
click the menu item
<menuchoice>
<guimenu>Security</guimenu>
<guimenuitem>PGP Encrypt</guimenuitem>
</menuchoice>
</para>
</sect2>
<sect2 id="unencrypting">
<title>Unencrypting a Recieved Message</title>
<para>
Sometimes, a friend will send you a message which is encrypted. In order
for you to read it, you need to unencrypt it.
</para>
<para>
When you view the encrypted message, <application>Evolution</application>
will prompt you for your PGP password. You type in your PGP password and
the message is then decrypted.
</para>
</sect2>
</sect1>
</chapter>

4
doc/ChangeLog
View File

@ -1,5 +1,9 @@
2001-06-25 Kevin Breit <battery841@mediaone.net>
* C/usage-mail.sgml: Put config-encryption in usage-mail.sgml. config-encryption.sgml should be depreciated.
* C/usage-contact.sgml: Fixed typo
* C/usage-mail.sgml: Added info about mailing lists
Elaborated on mailing lists

1
help/C/Makefile.am
View File

@ -5,7 +5,6 @@ GUIDE_SGML_FILES = \
apx-authors.sgml \
apx-bugs.sgml \
apx-gloss.sgml \
config-encryption.sgml \
config-prefs.sgml \
config-setupassist.sgml \
config-sync.sgml \

3
help/C/usage-contact.sgml
View File

@ -155,7 +155,8 @@
Contact</guimenuitem></menuchoice>. This will open the
in-depth search window, which lets you use multiple search
criteria in the same way that email filters and <glossterm
linkend="vfolder">virtual folders</glossterm> do.. </para>
linkend="vfolder">virtual folders</glossterm> do.
</para>
<para>
Click <guibutton>Add Criterion</guibutton> to increase the
number of criteria you'd like to use in the search, and

150
help/C/usage-mail.sgml
View File

@ -1583,6 +1583,7 @@ with quoted materials and the relevant replies interspersed-->
</figure>
</para>
</sect2>
<sect2 id="usage-mail-subscriptions">
<title>Subscription Management</title>
<para>
@ -1605,9 +1606,154 @@ with quoted materials and the relevant replies interspersed-->
will check for new messages whenever you press the
<guibutton>Get Mail</guibutton> button.
</para>
</sect2>
</sect1>
<sect1 id="encryption">
<title>Encryption</title>
<sect2 id="encryption-whatis">
<title>What is Encryption?</title>
<para>
Encryption is an ancient method of changing readable text to unreadable
text that dates back to Egyptian times. Encryption takes the statement
"Evolution" and turns it into something which cannot be read without help
through decryption.
<example>
<title>Encryption Example</title>
<para>
Kevin orders an <application>Evolution</application> t-shirt from
Ximian, Inc. over the internet. He puts in his credit card number
which is 1234-567-8901. For security, his computer encrypts the
credit card number so it can be safely transmitted over the internet.
The number now is @#$23ui7yr87#@!48970fsd, which holds no intentional
resemblance to the inital number. When the information gets to
Ximian, Inc. it'll be decrypted into the inital number.
</para>
</example>
Encryption can be used in email in two ways: to verify that the sender is
the real sender, and to hide the message while in transmission.
<application>Evolution</application> has the capability to do both.
</para>
</sect2>
<sect2 id="encryption-keygen">
<title>Generating your PGP key</title>
<para>
First, you need to create a PGP key. To do this, you'll need GPG
installed.
</para>
<tip>
<title>GPG Versions</title>
<para>
This manual covers version 1.0.6 of GPG. If your version is different,
this may not be entirely accurate. You may find out your version number
by typing in: <command>gpg --version</command>.
</para>
</tip>
<para>
You can start by typing in: <command>gpg --gen-key</command>. At the
first question, select 1. The next question asks you about key length.
The longer the key, more stronger it is. However, the longer the key, the
longer it takes to generate. This is your choice. However, 1024 bits
(default) should be adequate. The next question asks you if you want your
key to expire. Expiring keys make your key invalid after a certain amount
of time, so old keys don't float around active. This is the same concept
as a coupon at a supermarket. Next, you'll type in your Real name, your
email address, and a comment. You should not forge this information, as
it is used later to verify who you are. Assuming that all your
information is correct, press "O" to continue. GPG now asks you for a
passphrase. This is a password which you will need to decrypt and encrypt
messages. This can be any length, with any characters in it. It is case
sensitive, which means that it does know the difference between capital
letters and lower-case. Now your key is generated. It is recommend you
surf the internet, read your email, or write a letter in a word
processor. This help creates randomness in the key.
</para>
<para>
Once this is completed, you'll be dropped back to the command line.
Now you can view your key information by typing <command>gpg
--list-keys</command>. You should see something similar to this:
<example id="gpg-list-keys">
<title>GPG Listing Keys</title>
<para>
/home/bob/.gnupg/pubring.gpg
----------------------------
pub 1024D/32j38dk2 2001-06-20 bob &lt;bob@bob.com&gt;
sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]
</para>
</example>
You'll now need to upload your public key to a keyserver, so that your
friends can use your key. You'll need to know the ID of your key, which
is after the 1024D on the line beginning with pub. For this example, it
is 32j38dk2. You now type in <command>gpg --send-keys --keyserver
wwwkeys.pgp.net 32j38dk2</command>. Substitute your key ID for 32j38dk2.
You will be prompted to type in your password <!-- verify that you need to
enter your password here --> and your key will be uploaded for your
friends to download.
</para>
</sect2>
<sect2 id="encrypt-evo-integ">
<title>Setting up Evolution's Encryption</title>
<para>
You'll need to open
<menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Mail Settings</guimenuitem>
</menuchoice>
Once there, select the account you'd like to associate the key to and click
the <guibutton>Edit</guibutton> button. In the
<guilabel>Security</guilabel> tab is a section labeled <guilabel>Pretty
Goog Privacy</guilabel>. Enter your key ID and click
<guibutton>OK</guibutton>. Your key is now integrated into your identity
in <application>Evolution</application>.
</para>
</sect2>
<sect2 id="encrypt-sending">
<title>Sending Encrypted Messages</title>
<para>
You can either sign or encrypt a message. When you sign a message, verify
that you were the one who sent it, and that no one is forging your
identity. Encrypting a message makes it impossible for someone with
prying eyes to view it while it's in tranmission.
</para>
</sect2>
<sect2 id="sign-msg">
<title>Signing a Message</title>
<para>
To sign a message, you simply click
<menuchoice>
<guimenu>Security</guimenu>
<guimenuitem>PGP Sign</guimenuitem>
</menuchoice>
. You will be prompted for your PGP password. Once you enter it,
click <guibutton>OK</guibutton> and your message will be signed.
</para>
</sect2>
<sect2 id="encrypt-msg">
<title>Encrypting a Message</title>
<para>
Encrypting a message is very similar to signing a message. You simply
click the menu item
<menuchoice>
<guimenu>Security</guimenu>
<guimenuitem>PGP Encrypt</guimenuitem>
</menuchoice>
</para>
</sect2>
<sect2 id="unencrypting">
<title>Unencrypting a Recieved Message</title>
<para>
Sometimes, a friend will send you a message which is encrypted. In order
for you to read it, you need to unencrypt it.
</para>
<para>
When you view the encrypted message, <application>Evolution</application>
will prompt you for your PGP password. You type in your PGP password and
the message is then decrypted.
</para>
</sect2>
</sect1>
</chapter>

4
help/ChangeLog
View File

@ -1,5 +1,9 @@
2001-06-25 Kevin Breit <battery841@mediaone.net>
* C/usage-mail.sgml: Put config-encryption in usage-mail.sgml. config-encryption.sgml should be depreciated.
* C/usage-contact.sgml: Fixed typo
* C/usage-mail.sgml: Added info about mailing lists
Elaborated on mailing lists