Skip to main content

Fast and flexible security protocol parser and generator

Project description

What is it and what is it not?

As the project name CryptoParser implies, it is a cryptographic protocol parser. The main purpose of creating this library is the fact, that cryptography protocol analysis differs in many aspect from establishing a connection using a cryptographic protocol. Analysis is mostly testing where we trigger special and corner cases of the protocol and we also trying to establish connection with hardly supported, experimental, obsoleted or even deprecated mechanisms or algorithms which are may or may not supported by the latest or any version of an implementation of the cryptographic protocol.

As follows, it is neither a comprehensive nor a secure implementation of any cryptographic protocol. On the one hand library implements only the absolutely necessary parts of the protocol. On the other it contains completely insecure algorithms and mechanisms. It is not designed and contraindicated to use this library establishing secure connections. If you are searching for cryptographic protocol implementation, there are several existing wrappers and native implementations for Python (eg: M2Crypto, pyOpenSSL, Paramiko, …).

Quick start

CryptoParser can be installed directly via pip:

pip install cryptoparser

Development environment

If you want to setup a development environment, you are in need of pipenv.

$ cd cryptoparser
$ pipenv install --dev
$ pipenv shell



Python implementation

  • CPython (2.7, >=3.3)
  • PyPy (2.7, 3.5)

Operating systems

  • Linux
  • macOS
  • Windows

Protocol Specific Features

Transport Layer Security (TLS)

Only features that cannot be or difficultly implemented by some of the most popular SSL/TLS implementations (eg: GnuTls, LibreSSL, OpenSSL, wolfSSL, …) are listed.


  1. supports Generate Random Extensions And Sustain Extensibility (GREASE) values for
    • protocol version
    • extension type
    • ciphers suite
    • signature algorithms
    • named group
  2. supports easy JA3 fingerprint generation

Cipher Suites

  1. supports each cipher suites discussed on
  2. supports GOST (national standards of the Russian Federation and CIS countries) cipher suites


The code is available under the terms of Mozilla Public License Version 2.0 (MPL 2.0).

A non-comprehensive, but straightforward description of MPL 2.0 can be found at Choose an open source license website.

Download files

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

Files for cryptoparser, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size cryptoparser-0.3.1.tar.gz (39.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page