optigatrust

A ctypes based Python wrapper to work with the OPTIGA(TM) Trust security solutions.

Features
Current Release
Dependencies
Required Hardware
Installation
License
Documentation
Testing
Development

Features

Function	Module
Elliptic Curves Cryptograpy	`optigatrust.pk.ecc`
ECDSA	`optigatrust.pk.ecdsa`
Certificate Signing Request	`optigatrust.x509.csr`
Certificate handling	`optigatrust.x509.cert`
Random Number Generation	`optigatrust.rand`
Write/Read General Purpose Data	`optigatrust.util.io`

Current Release

0.3.4

Dependencies

Python 3.x
asn1crypto
oscrypto

Required Hardware

OPTIGA(TM) Trust Personalisation Board, or
any FTDI USB-HID/I2C Converter board
(planned) Embedded Linux with open I2C lines; e.g. RPi3

Installation

$ pip install optigatrust

License

optigatrust is licensed under the terms of the MIT license. See the LICENSE file for the exact license text.

Documentation

The documentation for optigatrust is composed of tutorials on basic usage and links to the source for the various pre-defined type classes.

Examples

from optigatrust.rand import *
from optigatrust.pk import *
from optigatrust.x509 import *
import base64

print("Rand size 8 bytes: {0}\n".format(list(get_random_bytes(8))))
print("Rand size 16 bytes: {0}\n".format(list(get_random_bytes(16))))
print("Rand size 255 bytes: {0}\n".format(list(get_random_bytes(255))))

ecc_key = ecc.generate_keypair()
print("Generate NIST-P256 Keypair: {0}\n".format(list(ecc_key.pkey)))

ecdsa_signature = ecdsa.sign(ecc_key, b'Hello World')
print("Generate ECDSA Signature using the keypair: {0}\n".format(list(ecdsa_signature.signature)))

csr_key = ecc.generate_keypair(curve='secp256r1', keyid=KeyId.USER_PRIVKEY_3)
print("Generate NIST-P256 Keypair for a new certificate: {0}\n".format(list(csr_key.pkey)))

builder = csr.Builder(
	{
		'country_name': 'DE',
		'state_or_province_name': 'Bayern',
		'organization_name': 'Infineon Technologies AG',
		'common_name': 'OPTIGA(TM) Trust IoT',
	},
	key_1
)

request = builder.build(csr_key)
csr = base64.b64encode(request.dump())
print("A new CSR {0}\n".format(csr))

Testing

Tests are written using pytest and require this package to be installed:

$ git clone --recurse-submodules https://github.com/Infineon/python-optiga-trust
...
$ cd python-optiga-trust
$ cd tests
$ pytest

To run only some tests, pass a regular expression as a parameter to tests.

$ pytest test_rand.py

Development

Existing releases can be found at https://pypi.org/project/optigatrust/.

Metadata

Release files for optigatrust 0.3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for optigatrust 0.3.5
File	Size	Uploaded
optigatrust-0.3.5.tar.gz	15.7 kB	May 31, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for optigatrust 0.3.5
File	Interpreter	ABI	Platform	Reset
optigatrust-0.3.5-py3-none-any.whl 244.2 kB May 31, 2019	Python 3	none	any	Details

Total release size: 259.9 kB

Release files / optigatrust-0.3.5.tar.gz

Download URL	optigatrust-0.3.5.tar.gz
Size	15.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`56076e109643286617ca1b04acba40e28af6cc224420704b3b54b810cb039ae6`
BLAKE2b-256 checksum How to use checksums	`8aa26728e9a572d14f9c4c88f0a744d5ba578612226903d0434e38d04fe8139c`
Upload date	May 31, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3`

Release files / optigatrust-0.3.5-py3-none-any.whl

Download URL	optigatrust-0.3.5-py3-none-any.whl
Size	244.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d4afffe5c3771f895039ec7c3df479bb140178f38ae89dd72508bf7a964c8e1d`
BLAKE2b-256 checksum How to use checksums	`0ff5e52b291a8d1328c3b74c7d1e1023ac4a9470f7e6207042a8e756c5966601`
Upload date	May 31, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3`