wiki/src/doc/encryption_and_privacy/gpgapplet/public-key_cryptography.mdwn

   1 [[!meta title="Tails OpenPGP public-key cryptography"]]
   2
   3 With <span class="application">Tails OpenPGP Applet</span> you can
   4 **encrypt or sign text using the public key encryption of OpenPGP**.
   5
   6 [[!inline pages="doc/encryption_and_privacy/gpgapplet.warning" raw="yes"]]
   7
   8 <div class="note">
   9
  10 <strong>This technique requires you to use public-key
  11 cryptography.</strong> If you never used OpenPGP keys before, you might
  12 rather want to encrypt your text using a passphrase with OpenPGP
  13 passphrase encryption. [[See the corresponding
  14 documentation.|gpgapplet/passphrase_encryption]]
  15
  16 </div>
  17
  18 1. Write your text in a text editor. **Do not write it in the web browser!**
  19
  20    For example, open <span class="application">gedit</span> from the menu
  21    <span class="menuchoice">
  22      <span class="guimenu">Applications</span>&nbsp;▸
  23      <span class="guisubmenu">Accessories</span>&nbsp;▸
  24      <span class="guimenuitem">gedit Text Editor</span></span>.
  25
  26 2. Select with the mouse the text that you want to encrypt or sign. To
  27 copy it into the [[!wikipedia Clipboard_(computing) desc="clipboard"]],
  28 right-click on the selected text and choose <span
  29 class="guimenuitem">Copy</span> from the menu.
  30
  31    <span class="application">Tails OpenPGP Applet</span> now shows
  32    lines of text, meaning that the clipboard contains non-encrypted
  33    text.
  34
  35    [[!img gpgapplet_with_text.png link=no alt="Tails OpenPGP Applet with lines of text"]]
  36
  37 3. Click on <span class="application">Tails OpenPGP Applet</span> and
  38    select <span class="guimenuitem">Sign/Encrypt Clipboard with Public
  39    Keys</span> from the menu.
  40
  41    If you receive the error message “<span class="guilabel">The clipboard does
  42    not contain valid input data</span>”, try to copy your text again, starting
  43    from step 2.
  44
  45 4. If you want to encrypt the text, select one or more public keys for the
  46 recipients of the encrypted text in the <span class="guilabel">Choose
  47 keys</span> dialog box. To select a public key, double-click on the
  48 corresponding line in the <span class="guilabel">Select recipients</span> list
  49 box.
  50
  51 5. If you want to sign the text, select the secret key with which you want to
  52 sign the text in the <span class="guilabel">Sign message as</span> drop-down
  53 list.
  54
  55 6. If you want to hide the recipients of the encrypted text, select the <span
  56 class="guilabel">Hide recipients</span> check box. Otherwise anyone who sees the
  57 encrypted text can know who the recipients are.
  58
  59 7. Click on the <span class="guilabel">OK</span> button.
  60
  61    If you receive the warning message <span class="guilabel">Do you trust these
  62    keys</span>, answer it accordingly.
  63
  64 8. If you selected one or several public keys to encrypt the text,
  65 <span class="application">Tails OpenPGP Applet</span> now shows a
  66 padlock, meaning that the clipboard contains encrypted text.
  67
  68    [[!img gpgapplet_with_padlock.png link=no alt="Tails OpenPGP Applet with a padlock"]]
  69
  70    If you only selected a secret key to sign the text, <span
  71    class="application">Tails OpenPGP Applet</span> now shows a seal, meaning that the
  72    clipboard contains signed text.
  73
  74    [[!img gpgapplet_with_seal.png link=no alt="Tails OpenPGP Applet with a seal"]]
  75
  76 9. To paste the encrypted or signed text into another application,
  77    right-click in the application where you want to paste it and
  78    choose <span class="guimenuitem">Paste</span> from the menu.
  79
  80    For example, you can paste it into the web browser to send it by email.
  81
  82    [[!img browser_paste.png link=no alt="Encrypted text starting with
  83    -----BEGIN PGP MESSAGE-----"]]
  84
  85 <div class="tip">
  86
  87 To store your GnuPG keys and configuration across separate working sessions,
  88 you can activate the [[<span class="guilabel">GnuPG</span> persistence
  89 feature|doc/first_steps/persistence/configure/#gnupg]].
  90
  91 </div>
  92
  93 <div class="next">
  94
  95 You can also [[decrypt or verify a text that is encrypted or signed using
  96 public-key cryptography|decrypt_verify]] using <span class="application">Tails
  97 OpenPGP Applet</span>.
  98
  99 </div>