Skip to main content

Modern password hashing for your software and your servers

Project description

bcrypt

Latest Version https://travis-ci.org/pyca/bcrypt.svg?branch=master

Modern password hashing for your software and your servers

Installation

To install bcrypt, simply:

$ pip install bcrypt

Usage

Basic

Hashing and then later checking that a password matches the previous hashed password is very simple:

>>> import bcrypt
>>> password = b"super secret password"
>>> # Hash a password for the first time, with a randomly-generated salt
>>> hashed = bcrypt.hashpw(password, bcrypt.gensalt())
>>> # Check that a unhashed password matches one that has previously been
>>> #   hashed
>>> if bcrypt.hashpw(password, hashed) == hashed:
...     print("It Matches!")
... else:
...     print("It Does not Match :(")

Adjustable Work Factor

One of bcrypt’s features is an adjustable logarithmic work factor. To adjust the work factor merely pass the desired number of rounds to bcrypt.gensalt(rounds=12) which defaults to 12):

>>> import bcrypt
>>> password = b"super secret password"
>>> # Hash a password for the first time, with a certain number of rounds
>>> hashed = bcrypt.hashpw(password, bcrypt.gensalt(14))
>>> # Check that a unhashed password matches one that has previously been
>>> #   hashed
>>> if bcrypt.hashpw(password, hashed) == hashed:
...     print("It Matches!")
... else:
...     print("It Does not Match :(")

Adjustable Prefix

Another one of bcrypt’s features is an adjustable prefix to let you define what libraries you’ll remain compatible with. To adjust this, pass either 2a or 2b (the default) to bcrypt.gensalt(prefix=b"2b") as a bytes object.

Compatibility

This library should be compatible with py-bcrypt and it will run on Python 2.6+, 3.2+, and PyPy.

Security

bcrypt follows the same security policy as cryptography, if you identify a vulnerability, we ask you to contact us privately.

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
bcrypt-2.0.0-cp26-none-win32.whl (18.6 kB) Copy SHA256 hash SHA256 Wheel cp26 Jun 12, 2015
bcrypt-2.0.0-cp26-none-win_amd64.whl (19.0 kB) Copy SHA256 hash SHA256 Wheel cp26 Jun 12, 2015
bcrypt-2.0.0-cp27-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp27 Jun 12, 2015
bcrypt-2.0.0-cp27-none-win_amd64.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel cp27 Jun 12, 2015
bcrypt-2.0.0-cp32-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp32 Jun 12, 2015
bcrypt-2.0.0-cp32-none-win_amd64.whl (18.6 kB) Copy SHA256 hash SHA256 Wheel cp32 Jun 12, 2015
bcrypt-2.0.0-cp33-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp33 Jun 12, 2015
bcrypt-2.0.0-cp33-none-win_amd64.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel cp33 Jun 12, 2015
bcrypt-2.0.0-cp34-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp34 Jun 12, 2015
bcrypt-2.0.0-cp34-none-win_amd64.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel cp34 Jun 12, 2015
bcrypt-2.0.0-cp35-none-win32.whl (19.1 kB) Copy SHA256 hash SHA256 Wheel cp35 Dec 20, 2015
bcrypt-2.0.0-cp35-none-win_amd64.whl (21.0 kB) Copy SHA256 hash SHA256 Wheel cp35 Dec 20, 2015
bcrypt-2.0.0.tar.gz (38.7 kB) Copy SHA256 hash SHA256 Source None Jun 12, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page