https://github.com/dolph/keyless-fernet
A Python library to parse Fernet tokens as much as possible without using a key.
https://github.com/dolph/keyless-fernet
Last synced: 10 months ago
JSON representation
A Python library to parse Fernet tokens as much as possible without using a key.
- Host: GitHub
- URL: https://github.com/dolph/keyless-fernet
- Owner: dolph
- License: apache-2.0
- Created: 2015-02-24T23:01:23.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2016-03-03T17:16:54.000Z (over 10 years ago)
- Last Synced: 2025-07-28T18:39:08.482Z (11 months ago)
- Language: Python
- Size: 11.7 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
==============
keyless-fernet
==============
.. image:: https://img.shields.io/pypi/v/keyless-fernet.svg
:target: https://pypi.python.org/pypi/keyless-fernet
A Python library to parse `Fernet tokens `_ as much
as possible without using a key. This is useful for doing limited,
non-cryptographic validation or introspection of Fernet tokens.
If you have the Fernet key and need to validate or decrypt a Fernet token
further, I recommend using `pypi/cryptography
`_.
Usage
-----
.. code:: python
>>> token = 'gAAAAAAdwJ6wAAECAwQFBgcICQoLDA0ODy021cpGVWKZ_eEwCGM4BLLF_5CV9dOPmrhuVUPgJobwOz7JcbmrR64jVmpU4IwqDA=='
>>> import keyless_fernet
>>> t = keyless_fernet.Token(token) # tokens are validated on init
>>> t.validate(ttl=60) # but you can also validate a token against any TTL
Traceback (most recent call last):
[...]
keyless_fernet.core.ExpiredToken: Token expired [...] seconds ago.
>>> t.version # retrieve the token's version, as an integer
128
>>> t.timestamp # retrieve the token's timestamp, as a datetime
datetime.datetime(1985, 10, 26, 8, 20)
>>> t.iv # and see the hex representations of the other attributes
'000102030405060708090a0b0c0d0e0f'
>>> t.ciphertext
'2d36d5ca46556299fde13008633804b2'
>>> t.hmac
'c5ff9095f5d38f9ab86e5543e02686f03b3ec971b9ab47ae23566a54e08c2a0c'
Testing
-------
.. image:: https://travis-ci.org/dolph/keyless-fernet.svg?branch=master
:target: https://travis-ci.org/dolph/keyless-fernet
No external testing dependencies are required:
.. code:: bash
$ python -m unittest discover