| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 1 | .. Python-RSA documentation master file, created by |
| 2 | sphinx-quickstart on Sat Jul 30 23:11:07 2011. |
| 3 | You can adapt this file completely to your liking, but it should at least |
| 4 | contain the root `toctree` directive. |
| 5 | |
| 6 | Welcome to Python-RSA's documentation! |
| 7 | ====================================== |
| 8 | |
| Sybren A. Stüvel | aa28c04 | 2011-07-30 23:48:00 +0200 | [diff] [blame] | 9 | Python-RSA is a pure-Python RSA implementation. It supports |
| 10 | encryption and decryption, signing and verifying signatures, and key |
| 11 | generation according to PKCS#1 version 1.5. |
| 12 | |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 13 | |
| 14 | Security notice |
| 15 | -------------------------------------------------- |
| 16 | |
| 17 | This RSA implementation has seen the eyes of a security expert, and it |
| 18 | uses an industry standard random padding method. However, there are |
| 19 | still possible vectors of attack. Just to name one example, it doesn't |
| 20 | compress the input stream to remove repetitions, and if you display |
| Sybren A. Stüvel | c1c455d | 2011-08-01 23:04:30 +0200 | [diff] [blame] | 21 | the stack trace of a :py:class:`rsa.pkcs1.CryptoError` exception |
| 22 | you'll leak information about the reason why decryption or |
| 23 | verification failed. |
| 24 | |
| 25 | I'm sure that those aren't the only insecurities. Use your own |
| 26 | judgement to decide whether this module is secure enough for your |
| 27 | application. |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 28 | |
| 29 | If you have the time and skill to improve the implementation, by all |
| 30 | means be my guest. The best way is to clone the Mercurial repository |
| 31 | and send me a merge request when you've got something worth merging. |
| 32 | |
| 33 | |
| 34 | Contents |
| 35 | -------------------------------------------------- |
| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 36 | |
| 37 | .. toctree:: |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 38 | :maxdepth: 2 |
| Sybren A. Stüvel | dbea213 | 2011-08-03 13:31:57 +0200 | [diff] [blame^] | 39 | :numbered: |
| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 40 | |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 41 | intro |
| 42 | installation |
| Sybren A. Stüvel | dbea213 | 2011-08-03 13:31:57 +0200 | [diff] [blame^] | 43 | upgrading |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 44 | licence |
| 45 | usage |
| Sybren A. Stüvel | 8d8cc31 | 2011-07-31 23:03:23 +0200 | [diff] [blame] | 46 | cli |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 47 | compatibility |
| Sybren A. Stüvel | d92b667 | 2011-07-31 17:44:44 +0200 | [diff] [blame] | 48 | reference |
| Sybren A. Stüvel | aa28c04 | 2011-07-30 23:48:00 +0200 | [diff] [blame] | 49 | |
| 50 | |
| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 51 | * :ref:`genindex` |