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
bcrypt-2.0.0-cp26-none-win_amd64.whl (19.0 kB) Copy SHA256 hash SHA256 Wheel cp26
bcrypt-2.0.0-cp27-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp27
bcrypt-2.0.0-cp27-none-win_amd64.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel cp27
bcrypt-2.0.0-cp32-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp32
bcrypt-2.0.0-cp32-none-win_amd64.whl (18.6 kB) Copy SHA256 hash SHA256 Wheel cp32
bcrypt-2.0.0-cp33-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp33
bcrypt-2.0.0-cp33-none-win_amd64.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel cp33
bcrypt-2.0.0-cp34-none-win32.whl (18.3 kB) Copy SHA256 hash SHA256 Wheel cp34
bcrypt-2.0.0-cp34-none-win_amd64.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel cp34
bcrypt-2.0.0-cp35-none-win32.whl (19.1 kB) Copy SHA256 hash SHA256 Wheel cp35
bcrypt-2.0.0-cp35-none-win_amd64.whl (21.0 kB) Copy SHA256 hash SHA256 Wheel cp35
bcrypt-2.0.0.tar.gz (38.7 kB) Copy SHA256 hash SHA256 Source None

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page