Skip to main content

Module for generating and verifying JSON Web Tokens

Project description

Build Status Coverage Status PyPI version

Module for generating and verifying JSON Web Tokens.

Example:

import python_jwt as jwt, Crypto.PublicKey.RSA as RSA, datetime
key = RSA.generate(2048)
payload = { 'foo': 'bar', 'wup': 90 };
token = jwt.generate_jwt(payload, key, 'PS256', datetime.timedelta(minutes=5))
header, claims = jwt.verify_jwt(token, key, ['PS256'])
for k in payload: assert claims[k] == payload[k]

The API is described here.

Installation

pip install python_jwt

Another Example

You can read and write keys from and to PEM-format strings:

import python_jwt as jwt, Crypto.PublicKey.RSA as RSA, datetime
key = RSA.generate(2048)
priv_pem = key.exportKey()
pub_pem = key.publickey().exportKey()
payload = { 'foo': 'bar', 'wup': 90 };
priv_key = RSA.importKey(priv_pem)
pub_key = RSA.importKey(pub_pem)
token = jwt.generate_jwt(payload, priv_key, 'RS256', datetime.timedelta(minutes=5))
header, claims = jwt.verify_jwt(token, pub_key, ['RS256'])
for k in payload: assert claims[k] == payload[k]

Licence

MIT

Tests

make test

Lint

make lint

Code Coverage

make coverage

coverage.py results are available here.

Coveralls page is here.

Benchmarks

make bench

Here are some results on a laptop with an Intel Core i5-3210M 2.5Ghz CPU and 6Gb RAM running Ubuntu 13.04.

Generate Key

user (ns)

sys (ns)

real (ns)

RSA

152,700,000

300,000

152,906,095

Generate Token

user (ns)

sys (ns)

real (ns)

HS256

140,000

10,000

157,202

HS384

160,000

10,000

156,403

HS512

139,999

20,000

153,212

PS256

3,159,999

49,999

3,218,649

PS384

3,170,000

10,000

3,176,899

PS512

3,120,000

9,999

3,141,219

RS256

3,070,000

20,000

3,094,644

RS384

3,090,000

0

3,092,471

RS512

3,079,999

20,000

3,095,314

Load Key

user (ns)

sys (ns)

real (ns)

RSA

811,000

0

810,139

Verify Token

user (ns)

sys (ns)

real (ns)

HS256

140,000

0

129,947

HS384

130,000

0

130,161

HS512

119,999

0

128,850

PS256

780,000

10,000

775,609

PS384

759,999

0

752,933

PS512

739,999

0

738,118

RS256

700,000

0

719,365

RS384

719,999

0

721,524

RS512

730,000

0

719,706

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_jwt-2.0.2.tar.gz (216.6 kB view hashes)

Uploaded Source

Built Distribution

python_jwt-2.0.2-py2.py3-none-any.whl (8.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page