1 #+TITLE: GnuPG - HOWTOs

2 #+STARTUP: showall

3 #+SETUPFILE: "../share/setup.inc"

4

5

6 * HOWTOs

7

8   There are several HOWTOs available.  Unfortunately some of them are

9   not up-to-date.

10

11

12 ** Web Key Directory Installation HOWTO

13

14    We are working on a HOTWO for the Web Key Directory.  For now

15    please consult the [[https://wiki.gnupg.org/WKD][Wiki]].

16

17 ** GPGME Python Bindings HOWTO

18

19    Written "in house" by the GnuPG Project core team, the GPGME Python

20    Bindings HOWTO provides detailed instructions and examples for

21    using the Python bindings of the GPGME API with Python 3 code.

22

23    This HOWTO is available:

24

25    -  in its original Emacs Org Mode source form in the GPGME repository ( [[https://dev.gnupg.org/source/gpgme/browse/master/lang/python/docs/GPGMEpythonHOWTOen.org][en]] )

26    -  as a single HTML file ( [[http://files.au.adversary.org/crypto/GPGMEpythonHOWTOen.html][en]] )

27    -  as a single HTML file with dark background and light text ( [[http://files.au.adversary.org/crypto/GPGMEpythonHOWTOen-dark.html][en]] )

28

29 ** GnuPG SmartcardHOWTO

30    :PROPERTIES:

31    :CUSTOM_ID: GnuPG-cardHOWTO

32    :END:

33

34    GnuPG supports the use of smartcards.  This HOWTO explains how to

35    install and work with these cards.

36

37    - as on-line browsable HTML files ( [[../howtos/card-howto/en/smartcard-howto.html][en]] )

38    - as one big HTML file ( [[../howtos/card-howto/en/smartcard-howto-single.html][en]] )

39    - as plain text ( [[../howtos/card-howto/en/smartcard-howto.txt][en]] )

40

41    This smartcard howto is also available in the [[../download/git.org][source repository]].

42

43 ** Legacy GnuPG MiniHOWTO

44

45    /These howtos mostly describe the legacy version 1.4 of GnuPG/

46

47    You may get the best overview about the GnuPG system by reading the

48    mini HOWTO available in several formats:

49

50 -  as on-line browsable HTML files (

51    [[../howtos/ca/GPGMiniHowto.html][ca]] ·

52    [[../howtos/de/index.html][de]] ·

53    [[http://www.dewinter.com/gnupg_howto/english/GPGMiniHowto.html][en]] ·

54    [[http://www.dewinter.com/gnupg_howto/spanish/index.html][es]] ·

55    [[../howtos/fr/index.html][fr]] ·

56    [[../howtos/it/GPGMiniHowto.html][it]] ·

57    [[../howtos/tr/GPGMinikNasil.html][tr]] ·

58    [[../howtos/vn/index.htm][vn]] ·

59    [[../howtos/zh/index.html][zh]] )

60 -  as one big HTML file (

61    [[../howtos/ca/GPGMiniHowto_big.html][ca]] ·

62    [[../howtos/it/GPGMiniHowto_big.html][it]] )

63 -  as PDF (

64    [[../howtos/ca/GPGMiniHowto.pdf][ca]] ·

65    [[../howtos/de/GPGMiniHowto.pdf][de]] ·

66    [[../howtos/it/GPGMiniHowto.pdf][it]] ·

67    [[../howtos/vn/GPGMiniHowto.pdf][vn]] )

68 -  in postscript format (

69    [[../howtos/ca/GPGMiniHowto.ps][ca]] ·

70    [[http://www.dewinter.com/gnupg_howto/english/GPGMiniHowto.ps][en]] ·

71    [[../howtos/de/GPGMiniHowto.ps][de]] )

72 -  as DVI file ( [[../howtos/ca/GPGMiniHowto.dvi][ca]] )

73 -  in RTF format ( [[../howtos/ca/GPGMiniHowto.rtf][ca]] )

74 -  as plain text (

75    [[../howtos/ca/GPGMiniHowto.txt][ca]] ·

76    [[http://www.dewinter.com/gnupg_howto/english/GPGMiniHowto.txt][en]] ·

77    [[../howtos/it/GPGMiniHowto.txt][it]] )

78 -  as SGML (

79    [[../howtos/ca/GPGMiniHowto.sgml][ca]] ·

80    [[../howtos/de/GPGMiniHowto.sgml][de]] ·

81    [[http://www.dewinter.com/gnupg_howto/english/GPGMiniHowto.sgml][en]] ·

82    [[../howtos/it/GPGMiniHowto.sgml][it]] ·

83    [[../howtos/tr/GPGMinikNasil.sgml.gz][tr]] )

84 -  as gzipped tarball of them all ( [[../howtos/ca/GPGMiniHowto.tar.gz][ca]] )

85

86 ** GnuPG Keysigning Party HOWTO

87

88    /Due to problem with the keyservers, this howto should be considered

89    historic./

90

91    Once you get familiar with GnuPG's mechanisms, you surely wouldn't

92    miss one of its funnest (and useful) aspects: to meet your Internet

93    buddies and get your key signed by as many of them as possible.

94

95    But having to check tens or even hundreds of keys at a meeting may

96    become quite frustrating. Here it is where this HOWTO by V. Alex

97    Brennen comes in handy. It is a guide to understanding and

98    organizing a PGP keysigning party. Keysigning parties help build

99    and strengthen the web of trust which serves to make the use of

100    GnuPG more secure.

101

102    This HOWTO is available:

103

104    -  as an on-line browsable set of HTML files (

105    [[http://www.cryptnet.net/fdp/crypto/gpg-party/gpg-party.de.html][de]] ·

106    [[http://www.cryptnet.net/fdp/crypto/keysigning_party/en/keysigning_party.html][en]] ·

107    [[../howtos/es/gpg-party.html][es]] ·

108    [[../howtos/it/keysigning_party.html][it]] ·

109    [[http://www.cypherpunks.ru/KSP.html][ru]] ·

110    [[http://www.cryptnet.net/fdp/crypto/gpg-party/gpg-party.si.html][si]] ·

111    [[http://www.cryptnet.net/fdp/crypto/gpg-party/gpg-party.zh-TW.html.big5][zh-TW.big5]] ·

112    [[http://www.cryptnet.net/fdp/crypto/gpg-party/gpg-party.zh-TW.html.euc-tw][zh-TW.euc-tw]] )

113

114 ** Mutt-GnuPG HOWTO

115

116    /This howto might not be up to the current GnuPG version./

117

118    Firstly, because everyone should be using encryption and signatures

119    in their email. Secondly, because there are absolutely no reason

120    for you not to be using PGP-compatible software. Thirdly, because

121    documentation is mostly geared toward someone who is already

122    familiar with PGP.  Fourtly, because we like to promote both GnuPG

123    and Mutt as free software project, for use in everyday

124    communications. Lastly, because Justin R.  Miller likes writing

125    tutorials.

126

127    For all these reasons, you can find below a link to Justin's HOWTO

128    on how to send and receive cryptographically signed and/or

129    encrypted email with GnuPG and the [[http://www.mutt.org/][Mutt mail reader]].

130

131    This HOWTO is available:

132

133    -  as plain text ( [[http://codesorcery.net/old/mutt/][en]] )

134

135 ** PHP-GnuPG HOWTO

136

137    /This howto might not be up to the current GnuPG version./

138

139    With the preponderance of javascript based OpenPGP solutions to

140    various functions on the web, the desire to perform certain types

141    of server side functions on a PHP driven website also has its

142    merits.

143

144    While PHP support for GPGME is either lacking, or too arcane for

145    most developers to decipher, or both; Piotr Masełkowski at

146    [[https://maslosoft.com/][Maslosoft]] has an alternative guide using the CLI programs.

147

148    This HOWTO is available:

149

150    -  as an online HTML article ( [[https://maslosoft.com/blog/2017/09/12/using-gpg-with-php-on-server/][en]] )