SkypePGP v2.1
Skype to PGP bridge
Freeware. Freely distributable.
Copyright (c) 2006, Adamos.
http://www.ahajduk.pl


This freeware program may be used and copied, without any fee or obligation, for private or commercial use.
See the file license.txt for license details.

The SkypePGP is a tool which is able to encrypt a Skype chat between two users using their own keys defined within
the PGP software. Why, if we all know, that Skype's messages are encrypted (and obfuscated) anyway? Well, there
are two answers to this question (or even maybe three). One is that keeping privacy is never enough. Another is that
the Author really wanted to try the skype4com wrapper. And least but not last is, why not?
The nsdpgp3.dll, skype4com.dll and vcredist_x86.exe are distributed here only for your convenience, 
please download original distributions (references listed below).


Distribution:
-------------

The skypepgp_pack.zip file contains following files:

skypepgp.zip		(SkypePGP package)
skypepgp.zip.sig	(PGP signature by KeyID: 0xB60C4B35)

The skypepgp.zip file contains following files:

SkypePGP_readme.txt	(this file)
license.txt		(license)
nsdpgp3.dll		(COM Wrapper DLL for PGP made by Gerard R.Thomas, check the
			 http://community.wow.net/grt/nsdpgp.html for the latest release )
skype4com.dll		(COM Wrapper DLL for Skype made by Skype Ltd, check the
			 https://developer.skype.com/Docs/Skype4COM for the latest release )
vcredist_x86.exe	(Visual C++ 2005 Runtime Libraries Package made by Microsoft Corp. check the
			 http://www.microsoft.com/downloads/ for the latest release )
SkypePGP.exe		(the Skype to PGP bridge, check the
			 http://www.ahajduk.pl for the latest release)


Installation:
-------------

1. Your Skype software has to be installed and configured. Check the http://www.skype.com/
2. Also you have to install and configure the PGP software. Check the http://www.pgp.com/
3. Run the vcredist_x86.exe to install Visual C++ 2005 Runtime Libraries.
4. Copy nsdpgp3.dll to the Windows/System32 directory and register it by typing into the Start | Run
   "regsvr32 nsdpgp3.dll"
5. Copy skype4com.dll to the Windows/System32 directory and register it by typing into the Start | Run
   "regsvr32 skype4com.dll"
6. Move the SkypePGP.exe to Program Files for your convenience


Configuration:
--------------

Check the following configuration guide step by step. Do not proceed to the next step, if something is not working
as described.

1. Let's assume that you have a Skype's account called "John.A" and want to talk to "Mary.B". First check, if you are
   able to chat with Mary using Skype without any add-ons.
2. Configure your PGP keys. Exchange with Mary your public keys (by server, by email, on disk, whatever). Then
   make a test - encrypt some message and send to Mary by email, Mary should be able to decrypt the message. Also
   do it in opposite way - decrypt message encrypted by Mary. Consider following example:
       John creates his primary key as "signer name: Johnny <Johnny@the.bravo.net> keyID: 0xB6A1C97C",
       Mary creates her primary key as "signer name: MaryLou <Mary@the.beauty.net> keyID: 0x73B4A8D0".
       Then John and Mary exchange their public keys and their keyrings look like:
       - John's computer:
         main key:   "Johnny <Johnny@the.bravo.net> keyID: 0xB6A1C97C"
         other key:  "MaryLou <Mary@the.beauty.net> keyID: 0x73B4A8D0"
       - Mary's computer:
         main key:   "MaryLou <Mary@the.beauty.net> keyID: 0x73B4A8D0"
         other key:  "Johnny <Johnny@the.bravo.net> keyID: 0xB6A1C97C"
3. Run the SkypePGP.exe tool. Skype will detect that a program is trying to attach and will show proper disclaimer.
   After you accept it, the SkypePGP.exe will minimize to the tray icon. Click it to configure, before you will
   start using it.
4. Press the "KeyRing" button in SkypePGP and go to the folder where PGP keeps your keyring. Usually this is
   "...My Documents\PGP". Open any file in this directory.
5. Setup your main key data. In above example John enters as MainPrivKeyID: 0xB6A1C97C and Mary enters 
   as MainPrivKeyID: 0x73B4A8D0. Also enter in MainPrivKeyPwd proper password used during creation of the key.
6. Find in AuthorizedUsers your chat partner and set proper key ID for her/him. In above example, John enters 
   "Mary.B; 0x73B4A8D0" and Mary enters "John.A; 0xB6A1C97C". SkypePGP loads initially all defined users from 
   Skype in the form "user; 0x0", so you just need to find proper person and modify the key ID value, but you can
   also add the user on your own.
7. You are all set.


How to use it:
--------------

1. The chat should be initiated from Skype. Let's assume, John opens chat with Mary and exchanges some greetings
   and initial smiles.
2. The SkypePGP has to run on both John and Mary's computer.
3. If one of them wants to start talking using pgp encryption, she/he has to write in Skype's chat window a "skype-pgp"
   magic command. The new dialog window will pop up, where you can write your secret phrase. After pressing "send" it
   will be delivered to the other person and decrypted by SkypePGP and displayed in new dialog window on her/his machine.
4. The main Skype's chat is not affected in any way.


Current limitations:
--------------------

1. Sometimes the SkypePGP cannot connect to the Skype and is showing "Connection Timeout" message box. It looks 
   like a problem inside the skype4com.dll and hopefully will be fixed in next release of this COM.
2. SkypePGP supports currently only one-to-one chats. That is, conference chats are not supported.
3. There is no way to get rid of the fancy encrypted ascii text in the Skype's chat dialog window.


Releases:
---------

v2.1 [10-Jun-2006] - first public release.


Note:
-----

The SkypePGP was built using Visual C++ 8.0 and tested with PGP 8.1 and PGP 9.0 (Freeware) on Windows XP.
The PGP signature may be used to verify the integrity of the package. The skypepgp.zip is signed with
my PGP RSA key [2048/2048 bit <adamos@ahajduk.pl> Key ID: 0xB60C4B35 
Key fingerprint: 4682 C57D 64B8 2670 8CD6  268A 761D 5310 B60C 4B35].

Also, many thanks to Artur i Arek for help with testing of this tool.


Cheers,
Adamos

EOF
