Download | Tips

BkGnuPG Version 1.0.4
Copyright © 2000-2003 Yasuhiro ARAKAWA

GNU Privacy Guard Plug-in for Becky! 2
MANUAL

Japanese | English

About "GNU Privacy Guard Plug-in for Becky! 2"

GNU Privacy Guard Plug-in (BkGnuPG) is the plug-in software to be used with Becky! Internet Mail Ver. 2 (B2). By using GNU Privacy Guard (GnuPG) you can sign or encrypt your e-mail message. Also it can verify or decrypt incoming e-mail that was encrypted or signed by Pretty Good Privacy (PGP) or GnuPG.

There is a Becky PGP plug-in (BkPGP) that comes with B2, but almost everything you can do through PGP can be done by GnuPG, and GnuPG supports functions not yet supported by PGP.

BkGnuPG is free software. For further information about the copyright of BkGnuPG, please refer to BkGnuPG\readme_en.txt that comes in the BkGnuPG zip file. And please refer to "Tips - encryption mail" about tips of using BkGnuPG.

Environment

Besides I am using confirmation only in the following platform, because there is not developmental environment, although I think that it has no problem if B2 and Win32 version GnuPG are using.

In the case that I am not able to use it well in the platform other than the above Please report situation (OS of the kind/versions, errors of OS and application, etc.) as in detail as possible. Please refer to it "Support about" about the address of the author.

Installation and uninstallation method

Please confirm that the installation of B2 and GnuPG are completing first of all. I recommend that does the following setting about GnuPG, especially.

Please see the README.W32 file that comes in the GnuPG zip file about these setting method.

Next please download the latest version of BkGnuPG from the following URL.

BkGnuPG download page: http://hp.vector.co.jp/authors/VA023900/gpg-pin/index_en.html

When the file where I downloaded is extracted the following file is able to take out it.

You copy BkGnuPG.dll of these files to the "PlugIns" folder that is in a B2 installation folder or data folder, to install BkGnuPG. please do this operation in B2 condition without being acting.

The uninstallation is completion if you delete the DLL file where copied. Please delete even this, if there is BkGnuPG.ini. Please refer to "INI file specification" about the place of BkGnuPG.ini.

Facilities

"Settings" dialog

Please start B2 if installation completes. It may will confirm whether I register BkGnuPG in the case that I installed it for the first time. The "Setting dialog" can be opened from the "Tools" menu if installation is completing correctly.

Settings dialog
[Tools] menu >> [Plug-ins Setup] item >> [GNU Privacy Gard Plug-in] item

The explanation of items of the Settings dialog is as the following.

Default User ID
Default ID is set up if there are 2 or more secret keys.
PGP compatible
BkGnuPG encrypts or sign a mail message with a PGP compatible format. It may fail if I do not check this item, especially to the signature verification by PGP. Please refer to "Exchangeability of GnuPG and PGP" of Tips page about the exchangeability between GnuPG and PGP.
Try tobe more RFC1991 (PGP 2.6.x) compliant
BkGnuPG encrypts or sign a mail message with the standard of PGP 2.6.x (RFC1991). Please check and please combine even this item, in the case that it does not go well even if I check the "PGP compatible" item.
OpenPGP behavior
BkGnuPG does the processing of the signature and encryption that conformed to OpenPGP (RFC2440). This item is not able to set up it at the same time as "PGP compatible" item and "Try tobe more RFC1991 (PGP 2.6.x) compliant" item. A recipient may not be able to decrypt or verify a mail message with PGP, that you check this item.
Anonymous recipients
When you check this item you are able to conceal the recipients information that is included to encryption packet. (Yet, I am not able to conceal the number of recipients even if it checks this item.) This item is not able to set up it at the same time as "PGP compatible" item and "Try tobe more RFC1991 (PGP 2.6.x) compliant" item. A recipient can not be able to decrypt a mail message with PGP, that you check this item.
PGP/MIME (RFC2015) content type
BkGnuPG makes a signature or encryption message with PGP/MIME (RFC2015) format.
Use message digest algorithm MD5
When you check this item the message digest algorithm that BkGnuPG spends on a signature is set up to MD5. In the case that it does not check it (default) BkGnuPG uses SHA-1. This item is not able to set up it at the same time as "OpenPGP behavior" item. Usually, You SHOULD NOT check this item.
Encrypt with public keys of Cc recipients
Even the address of Cc adds it, to the recipient listing of the encryption other than the address of To.
Encrypt with public keys of Bcc recipients
Even the address of Bcc adds it, to the recipient listing of the encryption other than the address of To. Usually, You SHOULD NOT check this item.
Encrypt with public keys of From recipients
Even the address of From adds it, to the recipient listing of the encryption other than the address of To.
Encrypt with public keys of Default user
Even default user ID (Item that I explained before) adds it, to the recipient listing of the encryption other than the address of To.

When you push [OK] button the setting is reflected and write setting information in the INI file.

Encrypt mail

Please select [GnuPG: Encrypt...] item from the Tools menu of the composing window, to encrypt the message that you made. "Recipients dialog" triggers it.

Recipients dialog

The mail address that was set up in To field to "Recipients dialog" previously is listed. Even the mail address that is set up in the field where corresponds is listed to Recipients dialog, in the case that "Encrypt with public keys of Cc recipients" item etc. are checked with Settings dialog.

You edit the listing of recipients with this dialog and push [OK] button. Please push [Cancel] button in case that you want to stop operation.

When you push [Setup...] button "Settings dialog" triggers it. You can change setting temporarily here. (It is not reflected in the INI file.)

The contents of the composing window are encrypted if the result is displayed and the processing succeed when the encryption processing ends.

Sign mail

Please select [GnuPG: Sign...] from the Tools menu, to sign the message that you made with the composing window. "Passphrase dialog" triggers it.

Passphrase dialog

The mail address that was set up in From field to "Passphrase dialog" previously is listed. The signature user can change it.

You input Passphrase and please push [OK] button. Please push [Cancel] button in case that you want to stop operation.

When you push [Setup...] button "Settings dialog" triggers it. You can change setting temporarily here. (It is not reflected in the INI file.)

The explanation of items of the Passphrase dialog is as the following.

Show Passphrase
Showing Passphrase text.
Use Agent
Enabling --use-agent option. (use it with "gpg-agent.exe" that is included to WinPT Tray.)

The signature information is added to a message if the result is displayed and the processing succeed when the signature processing ends.

Sign and Encrypt

BkGnuPG can do the signature and encryption to a message at a time. Please select [GnuPG: Sign And Encrypt...] from the Tools menu. First "Recipients dialog" triggers and consecutively "Passphrase dialog" trigger. The contents of the composing window are signed and encrypted if the result is displayed and the processing succeed when the processing ends.

Attach public key

BkGnuPG can attach the public key of yourself to mail. Please select [GnuPG: Attach Public Key...] from the Tools menu.

Decrypt and verify

Please select [GnuPG: Decrypt And Verify...] from the Tools menu of main window. (It is able to select it even from the context menu of the ListView window. "Passphrase dialog" triggers it in the case of decryption.

Passphrase dialog (for decryption)

The contents are reflected to the message view window if the result, is displayed and succeed when the processing ends.

Support about

Please contact The author of the plug-in at the following e-mail address:

spiegel@alles.or.jp

Although I am not able to respond to all requests, I shall do my best, but as English is not might first language, there may be some delay. Please forgive me in advance.

Advanced usage

Between the option of GnuPG and the item of Settings dialog

The correspondence between the option of GnuPG and the item of "Settings dialog" are as the following.

--default-key:Default user ID
--force-v3-sigs:PGP compatible
--rfc1991:Try to be more RFC1991 (PGP 2.6.x) compliant
--openpgp:OpenPGP behavior
--throw-keyid:Anonymous recipients
--digest-algo MD5:Use message digest algorithm MD5

(Message digest algorithm of the default is SHA-1.)

The option of GnuPG that is not able to set up it with Settings dialog is able to set up it in an options file.

INI file specification

The setting of BkGnuPG is set in all the INI files "BkGnuPG.ini". The specification of the INI file were summarized to bkgnupg_ini_en.txt. (bkgnupg_ini_en.txt changes a name to BkGnuPG.ini and able to use as INI file as it is.)

There are Facilities that we are not able to set up with "Settings dialog" with a Facility without using much.

BkGnuPG searches INI file with the following turn at the time of the start.

  1. "PlugIns" the folder of data folder right under
  2. GnuPG home directory (In the case that it is set up with registry)
  3. Current directory of BkGnuPG

For in the case that there is not INI file in above which I make INI file for the current directory of BkGnuPG. Also, please see the README.W32 file where is in GnuPG zip file about the setting method of GnuPG home directory.

Please confirm that B2 is ending without fail, in the case that INI file is edited directly. BkGnuPG refers to INI file only at the time of the start. Even if INI file is edited during the B2 action it is not reflected to BkGnuPG in the action.

Trace log

BkGnuPG can take a tracing log. (It sets up it in INI file) The command line information of GnuPG and error information are written to a tracing log. Please use it to the report to the author, in the case that there was a trouble with BkGnuPG. Usually please turn off a tracing log.


Please contact to spiegel@alles.or.jp if you wish to comment on this page.