README.md

   1 ctypescrypto
   2 ============
   3
   4 Python interface to some openssl function based on ctypes module
   5
   6 This module is based on works from
   7
   8 http://code.google.com/p/ctypescrypto/
   9
  10 It is aimed to provide Python interface to OpenSSL libcrypto function
  11
  12 Now supported:
  13
  14 bio.py - interfase to OpenSSL stream abstraction BIO. Now supports
  15         memory BIOs this module intended to use for parsing/serializing
  16         various ASN.1 based formats like private keys or certificates
  17         Status: bare minimum functionality is implemented and covered by
  18         rests
  19
  20 oid.py - interface to OpenSSL ASN.1 Object Identifier databsase.
  21         Allows to convert numeric identifier (NIDs) returned by various
  22         OpenSSL function to readable names or dotted-decimal OIDs and back
  23         Status: Fully implemented and covered by tests.
  24
  25 engine.py - interface to loadable modules with alternate implementations
  26     of cryptoalgorithms.
  27         Status: Bare minumum, neccessary to use GOST algorithms is
  28         implemented.
  29
  30 rand.py - interface to pseudo-random number generator.
  31         Status: Implemented. Tests now only ensure that no segfault occurs
  32         if arugments are passed correctly
  33
  34 digests.py  - Interface  to EVP\_Digest\* family of functions.
  35         Really does almost same as hashlib, which even is able to take
  36         advantage of loaded engines if compiled against dynamic libcrypto
  37         Status: fully implemented and covered by tests
  38
  39 ciphers.py - Interface to EVP\_Cipher family of function.
  40         Status: Needs complete rewriting and test coverage. Idea to keep
  41         cleartext in python variable until entire text would be passed to
  42         update is EVIL.
  43
  44 pkey.py - Low-level private key operations (like pkey, genpkey and p
  45     keyutl command line ops), all via algorithm-agnostic EVP interface.
  46         Status: Designed and mostly implemented but not yet covered by tests
  47
  48 exception.py OpenSSL error stack to python exception conversion
  49         Implemented.
  50
  51 x509 X509 certificates. Support parsing of X509 certificates,
  52         verification and extracting of field values. Possible extnesion -
  53         support creattion of PKCS10 certificate requests.
  54         Status: Interface designed and partially implemented
  55