sspyjose

Release 0.2.6

An (interim) JOSE library, featuring support for Ed25519, X25519, ChaCha20/Poly1305 and AES256-GCM as required for PyKauriID

Homepage Repository PyPI

Keywords
singlesource, blockchain, data, kauri, kauriid, identity, self-sovereign, jose, jwt, jws, jwe, jwk
License
Apache-2.0
Install
pip install sspyjose==0.2.6

Documentation

SingleSource PyJOSE Library

An (interim) JOSE library, featuring support for Ed25519, X25519, ChaCha20/Poly1305 and AES256-GCM as required for PyKauriID.

Installation

To install use pip:

$ pip install sspyjose

Or clone the repo:

$ git clone https://gitlab.com/kauriid/sspyjose.git
$ python setup.py install

Set up and activate for Python 3:

virtualenv ${HOME}/.virtualenvs/sspyjose \
           --system-site-packages --python=/usr/bin/python3
source ${HOME}/.virtualenvs/sspyjose/bin/activate

Install required packages:

pip install -e .

For installing the additional development, testing or documentation dependencies, add a qualifier with one or more of these commands:

pip install -e .[dev]       # Development dependencies
pip install -e .[test]      # Testing dependencies
pip install -e .[dev,test]  # All dependencies together

Usage

Signing to a JWS

from sspyjose.jwk import Ed25519Jwk
from sspyjose.jws import Ed25519Jws

# Make a signing key object from a JWK as a JSON string.
# The JWK must contain the private key seed.
jwk = Ed25519Jwk(from_json=jwk_string)
# If the JWK is already parsed to a Python dictionary, use this:
# jwk = Ed25519Jwk(from_dict=jwk_dict)

# Make a JWS signing object.
signer = Ed25519Jws(jwk=jwk)

# Assign the content to authenticate.
signer.payload = {'answer': 42}

# Sign it, and get the content in a compact serialisation format
# (`jws` is a string).
signer.sign()
jws = jws.serialise()

Verifying a JWS

from sspyjose.jwk import Ed25519Jwk
from sspyjose.jws import Ed25519Jws

# Make a signing key object from a JWK as a JSON string.
# The JWK only needs to contain the public key.
jwk = Ed25519Jwk(from_json=jwk_string)
# If the JWK is already parsed to a Python dictionary, use this:
# jwk = Ed25519Jwk(from_dict=jwk_dict)

# Make a JWS verifier object.
verifier = Ed25519Jws(jwk=jwk)

# Load the signed JWS as a compact form string.
verifier.load_compact(jws)

# Verify it, and get the payload.
verifier.verify()
print(verifier.payload)

Contributing

TBD

Example

TBD

Licence

Copyright 2018 by SingleSource Limited, Auckland, New Zealand

This work is licensed under the Apache 2.0 open source licence. Terms and conditions apply.

Stats

Dependencies
11
Dependent packages
1
Dependent repositories
0
Total releases
5
Latest release
First release
Stars
0
Forks
0
Contributors
0
SourceRank
7

Development practices

Source repo 2FA enabled
TEXT!
Package manager 2FA enabled
TEXT!
Is security responsive
TEXT!
Dependencies are managed
TEXT!
Issue-free release available
TEXT!
Succession plan available
TEXT!
Package manager 2FA enabled
TEXT!

The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.

Learn more →

Releases

0.2.6
0.2.5
0.2.4
0.2.3
0.2.2

Something wrong with this page? Make a suggestion

Export .ABOUT file for this package

Last synced: 2021-02-22 05:35:19 UTC

Login to resync this project