| 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 |
| 21 | the stack trace of a ``Decryptionerror`` exception you'll leak |
| 22 | information about the reason why decryption failed. And I'm sure that |
| 23 | those aren't the only insecurities. Use your own judgement to decide |
| 24 | whether this module is secure enough for your application. |
| 25 | |
| 26 | If you have the time and skill to improve the implementation, by all |
| 27 | means be my guest. The best way is to clone the Mercurial repository |
| 28 | and send me a merge request when you've got something worth merging. |
| 29 | |
| 30 | |
| 31 | Contents |
| 32 | -------------------------------------------------- |
| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 33 | |
| 34 | .. toctree:: |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 35 | :maxdepth: 2 |
| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 36 | |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 37 | intro |
| 38 | installation |
| 39 | licence |
| 40 | usage |
| Sybren A. Stüvel | 8d8cc31 | 2011-07-31 23:03:23 +0200 | [diff] [blame^] | 41 | cli |
| Sybren A. Stüvel | a3fd61a | 2011-07-31 00:22:31 +0200 | [diff] [blame] | 42 | compatibility |
| Sybren A. Stüvel | d92b667 | 2011-07-31 17:44:44 +0200 | [diff] [blame] | 43 | reference |
| Sybren A. Stüvel | aa28c04 | 2011-07-30 23:48:00 +0200 | [diff] [blame] | 44 | |
| 45 | |
| Sybren A. Stüvel | ae99db6 | 2011-07-30 23:13:04 +0200 | [diff] [blame] | 46 | Indices and tables |
| 47 | ================== |
| 48 | |
| 49 | * :ref:`genindex` |
| 50 | * :ref:`modindex` |
| 51 | * :ref:`search` |
| 52 | |