# &app; Manual

2005, 2006, 2007, 2008 Jacob Perkins and Adam Schreiber
Seahorse Project &legal;
Jacob Perkins
Seahorse Project
Adam Schreiber
Seahorse Project

    						sadam@clemson.edu

Seahorse Project
&app; Manual V0.10.0
August 2008

Adam Schreiber sadam@clemson.edu

&app; Manual V0.9.1
November 2006

Milo Casagrande milo_casagrande@yahoo.it

&app; Manual V0.9.0
July 2005

Adam Schreiber sadam@clemson.edu

Seahorse Project

&app; Manual V0.7.0
February 2003

Jacob Perkins

Seahorse Project

This manual describes version &appversion; of &app;

Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the Gnome Feedback Page.

&app; is the application for managing your primary encryption key and how the passphrase for your key is stored after performing an encryption operation.

## Introduction

You can use &app; to select your primary encryption key and how the passphrase for your key is stored after performing an encryption operation.

Additionally, this manual contains information pertaining to encryption plugins provided for:

- Gedit Text Editor

- Nautilus File Manager

- Epiphany Web Browser

## File Manager Integration

&app; integrates with Nautilus. You can encrypt, decrypt, sign and verify files as well as import public keys from the file manager window without launching &app;.

### Encrypting Files

To encrypt files from the file manager, perform the following steps:

- Select one or more files from the file manager,

- Right click on any selected file and choose Encrypt,

- Select the people you would like to encypt the file to, and then click OK.

### Signing Files

To sign files from the file manager, perform the following steps:

- Select one or more files from the file manager,

- Right click on any selected file and choose Sign,

- If asked, enter the passphrase of your private key.

### Decrypting Files

To decrypt an encrypted file from the file manager, perform the following steps:

- Double click on the file you want to decrypt,

- If asked, enter the passphrase of your private key.

### Verifing Signatures

To verify files, simply double click on the the detached signature file.

Detached signature file names often take the form <file name>.sig

## Text Editor Integration

To enable the Text Encryption plugin in Gedit, the GNOME text editor, perform the following steps:

- Run Gedit by choosing Applications Accessories Text Editor ,

- Choose Edit Preferences ,

- In the Plugin tab, select the Text Encryption plugin.

### Encrypting Text

To encrypt a selection of text from Gedit, perform the following steps:

- Select the text you want to encrypt, and choose Edit Encrypt ,

- Select the people you want to encrypt the text to, and click OK.

You can now copy or save the encrypted text.

### Signing Text

To sign a selection of text from Gedit, perform the following steps:

- Select the text you want to sign and choose Edit Sign ,

- Insert, if asked, the passphrase of your private key.

You can now copy or save the signed text.

### Decrypting/Verifing Text

To decrypt and/or verify a selection of text from Gedit, perform the following steps:

- Select the text you want to decrypt/verify and choose Edit Decrypt/Verify ,

- Insert, if asked, the passphrase of your private key.

You can now copy or save the decrypted text.

## Web Browser Integration

This extension allows encryption, decryption, signing and importing of the contents of text fields.

To enable the encryption extension in Epiphany Web Browser, the GNOME web browser, perform the following steps:

- Run Epiphany Web Browser by choosing Applications Internet Epiphany Web Browser ,

- Choose Tools Extensions ,

- Select the Seahorse plugin.

### Encrypting Text

To encrypt the contents of a text input field in Epiphany Web Browser, perform the following steps:

- Right click in the text input field you want to encrypt, and choose Encrypt ,

- Select the people you want to encrypt the text to, and click OK.

The encrypted text will now appear in the text input field.

### Signing Text

To sign the contents of a text input field in Epiphany Web Browser, perform the following steps:

- Right click in the text input field you want to sign and choose Sign ,

- Insert, if asked, the passphrase of your private key.

The signed text will now appear in the text input field.

### Decrypting/Verifing Text

To decrypt and/or verify the contents of a text input field in Epiphany Web Browser, perform the following steps:

- Right click in the text input field you want to decrypt/verify and choose Decrypt/Verify ,

- Insert, if asked, the passphrase of your private key.

The decrypted text will now appear in the text input field.

## Preferences

This section describes the preferences settable in &app;.

### Encryption Preferences

This section describes the preferences settable by choosing System Preferences Encryption and Keyrings from the panel.

#### Encryption Settings

Default Key

  This is the key that will be used by applications and plugins to sign files. It will also be the key that files will be encrypted to if encrypt to self is selected.

When encrypting, always include myself as a recipient

  Sets the encrypt to self option, whether or not you will be added to the recipients list for all files that are encrypted.

  If you do not select this and you do not select yourself as a recipient you will not be unable to decrypt any files you encrypt.

#### Passphrase Cache

Enabling the passphrase caching ability will allow you to perform many operations that require entering your passphrase without re-entering it every time. `seahorse-agent` takes the place of `gpg-agent`. Letting the cached passphrases expire is usually a good idea. This will then require re-entering your passphrase, but adds security.

Never remember passphrases

  Sets to not remember any passphrase.

Remember passphrases for ... minutes

  Sets the amount of time, in minutes, for storing passphrases. Use the spin box to set the desired time.

Always remember passphrases whenever logged in

  Sets to remember any passphrases whenever you are logged in the session.

Ask me before using a cached passphrase

  Sets to ask you before using a stored passphrase.

Automatically load Secure Shell keys

  Sets to automatically cache any Secure Shell key.

## About &app;

Passwords and Encryption Keys, its associated plugins, the preferences applet and the panel applet are known collectively as the &project;. The original author of the &project; is Jacob Perkins. The current maintainers are Stef Walter and Adam Schreiber. This manual is by Adam Schreiber. The project's web site was designed by Jim Pharis. To find more information about &project;, the project , please visit the &project; web page.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in the Feedback section of the GNOME User Guide.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license is included with this documentation; another can be found in the file COPYING included with the source code of this program.

Seahorse
seahorse
Encryption Keys