https://github.com/bwesterb/py-seccure
SECCURE compatible Elliptic Curve cryptography in Python
https://github.com/bwesterb/py-seccure
cryptography ecc python seccure
Last synced: 5 months ago
JSON representation
SECCURE compatible Elliptic Curve cryptography in Python
- Host: GitHub
- URL: https://github.com/bwesterb/py-seccure
- Owner: bwesterb
- License: lgpl-3.0
- Created: 2013-04-10T19:55:17.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2020-02-04T19:17:41.000Z (over 5 years ago)
- Last Synced: 2024-09-14T21:24:35.910Z (8 months ago)
- Topics: cryptography, ecc, python, seccure
- Language: Python
- Size: 131 KB
- Stars: 93
- Watchers: 10
- Forks: 25
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
- License: LICENSE
Awesome Lists containing this project
README
py-seccure
==========
Simple Elliptic Curve Cryptography for Python compatible with the
excellent `SECCURE`_ command
line utility (version 0.5). It's licensed under LGPLv3. See LICENSE.
**Do not use ``py-seccure`` when its operation can be timed by an
attacker.** See `timing attack`_.
Usage
-----
Public key from private
~~~~~~~~~~~~~~~~~~~~~~~
To get the public key from the private, you can use the original
commandline utility:
::
$ seccure-key
Assuming curve p160.
Enter private key: my private key
The public key is: 8W;>i^H0qi|J&$coR5MFpR*Vn
In Python:
.. code:: python
>>> import seccure
>>> str(seccure.passphrase_to_pubkey(b'my private key'))
'8W;>i^H0qi|J&$coR5MFpR*Vn'
Encrypting a string
~~~~~~~~~~~~~~~~~~~
To encrypt for a public key, one would use the original commandline
utility as follows.
::
$ seccure-encrypt -o private.msg '8W;>i^H0qi|J&$coR5MFpR*Vn'
Assuming MAC length of 80 bits.
Go ahead and type your message ...
This is a very very secret message!
^D
In Python:
.. code:: python
>>> ciphertext = seccure.encrypt(b'This is a very secret message\n', b'8W;>i^H0qi|J&$coR5MFpR*Vn')
>>> ciphertext
'\x00\x146\x17\xe9\xc1\x1a\x7fkX\xec\xa0n,h\xb4\xd0\x98\xeaO[\xf8\xfa\x85\xaa\xb37!\xf0j\x0e\xd4\xd0\x8b\xfe}\x8a\xd2+\xf2\xceu\x07\x90K2E\x12\x1d\xf1\xd8\x8f\xc6\x91\t>> seccure.encrypt_file('/path/to/file', '/path/to/file.enc', '8W;>i^H0qi|J&$coR5MFpR*Vn')
Decrypting
~~~~~~~~~~
To decrypt the message with the original utility:
::
$ seccure-decrypt -i private.msg
Assuming MAC length of 80 bits.
Assuming curve p160.
Enter private key: my private key
This is a very very secret message!
Integrity check successful, message unforged!
In Python:
.. code:: python
>>> seccure.decrypt(ciphertext, b'my private key')
'This is a very secret message\n'
And to decrypt a file:
.. code:: python
>>> seccure.decrypt_file('/path/to/file.enc', '/path/to/file', b'my private key')
Creating a signature
~~~~~~~~~~~~~~~~~~~~
To create a signature:
::
$ seccure-sign
Assuming curve p160.
Enter private key: my private key
Go ahead and type your message ...
This message will be signed
^D
Signature: $HPI?t(I*1vAYsl$|%21WXND=6Br*[>k(OR9B!GOwHqL0s+3Uq
In Python:
.. code:: python
>>> seccure.sign(b'This message will be signed\n', b'my private key')
'$HPI?t(I*1vAYsl$|%21WXND=6Br*[>k(OR9B!GOwHqL0s+3Uq'
Verifying a signature
~~~~~~~~~~~~~~~~~~~~~
To verify a signature:
::
$ seccure-verify '8W;>i^H0qi|J&$coR5MFpR*Vn' '$HPI?t(I*1vAYsl$|%21WXND=6Br*[>k(OR9B!GOwHqL0s+3Uq'
Go ahead and type your message ...
This message will be signed
^D
Signature successfully verified!
In Python:
.. code:: python
>>> seccure.verify(b'This message will be signed\n', b'$HPI?t(I*1vAYsl$|%21WXND=6Br*[>k(OR9B!GOwHqL0s+3Uq', b'8W;>i^H0qi|J&$coR5MFpR*Vn')
True
Installation
------------
On Debian Wheezy
~~~~~~~~~~~~~~~~
::
$ apt-get install libgmp3-dev build-essential python-dev python-pip libmpfr-dev libmpc-dev
$ pip install seccure
On Ubuntu
~~~~~~~~~
::
$ apt-get install libgmp-dev build-essential python-dev python-pip libmpfr-dev libmpc-dev
$ pip install seccure
On Mac with MacPorts
~~~~~~~~~~~~~~~~~~~~
::
$ port install py27-gmpy2
$ pip install seccure
Please contribute!
------------------
To help out, you could:
1. Test and report any bugs or other difficulties.
2. Implement missing features, such as ``seccure-dh``,
``seccure-veridec`` and ``seccure-signcrypt``.
3. Package py-seccure (or the original SECCURE itself) for your
platform.
4. Write more unit tests.
.. image:: https://travis-ci.org/bwesterb/py-seccure.png
:target: https://travis-ci.org/py-seccure/py-seccure
.. _SECCURE: http://point-at-infinity.org/seccure/
.. _timing attack: http://en.wikipedia.org/wiki/Timing_attack