bcrypt

Modern password hashing for your software and your servers

These details have not been verified by PyPI

Project links

Homepage

Project description

bcrypt

Modern password hashing for your software and your servers

Installation

To install bcrypt, simply:

$ pip install bcrypt

Note that bcrypt should build very easily on Linux provided you have a C compiler, headers for Python (if you’re not using pypy), and headers for the libffi libraries available on your system.

For Debian and Ubuntu, the following command will ensure that the required dependencies are installed:

$ sudo apt-get install build-essential libffi-dev python-dev

For Fedora and RHEL-derivatives, the following command will ensure that the required dependencies are installed:

$ sudo yum install gcc libffi-devel python-devel

Changelog

3.1.0

Added support for checkpw, a convenience method for verifying a password.
Ensure that you get a $2y$ hash when you input a $2y$ salt.
Fixed a regression where $2a hashes were vulnerable to a wraparound bug.
Fixed compilation under Alpine Linux.

3.0.0

Switched the C backend to code obtained from the OpenBSD project rather than openwall.
Added support for bcrypt_pbkdf via the kdf function.

2.0.0

Added support for an adjustible prefix when calling gensalt.
Switched to CFFI 1.0+

Usage

Password Hashing

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 an unhashed password matches one that has previously been
>>> # hashed
>>> if bcrypt.checkpw(password, hashed):
...     print("It Matches!")
... else:
...     print("It Does not Match :(")

KDF

As of 3.0.0 bcrypt now offers a kdf function which does bcrypt_pbkdf. This KDF is used in OpenSSH’s newer encrypted private key format.

>>> import bcrypt
>>> key = bcrypt.kdf(
...     password=b'password',
...     salt=b'salt',
...     desired_key_bytes=32,
...     rounds=100)

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.checkpw(password, 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.

As of 3.0.0 the $2y$ prefix is still supported in hashpw but deprecated.

Maximum Password Length

The bcrypt algorithm only handles passwords up to 72 characters, any characters beyond that are ignored. To work around this, a common approach is to hash a password with a cryptographic hash (such as sha256) and then base64 encode it to prevent NULL byte problems before hashing the result with bcrypt:

>>> password = b"an incredibly long password" * 10
>>> hashed = bcrypt.hashpw(
...     base64.b64encode(hashlib.sha256(password).digest()),
...     bcrypt.gensalt()
... )

Compatibility

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

C Code

This library uses code from OpenBSD.

Security

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

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

4.2.0

Jul 22, 2024

4.1.3

May 4, 2024

4.1.2

Dec 15, 2023

4.1.1

Nov 28, 2023

4.1.0 yanked

Nov 27, 2023

Reason this release was yanked:

Incompatibility with assumptions made by passlib.

4.0.1

Oct 9, 2022

4.0.0

Aug 24, 2022

3.2.2

May 1, 2022

3.2.1

May 1, 2022

3.2.0

Aug 16, 2020

3.1.7

Jun 20, 2019

3.1.6

Jan 16, 2019

3.1.5

Dec 12, 2018

3.1.4

Oct 11, 2017

3.1.3

Feb 23, 2017

3.1.2

Dec 17, 2016

3.1.1

Sep 18, 2016

This version

3.1.0

Jun 30, 2016

3.0.0

Jun 28, 2016

2.0.0

Jun 12, 2015

1.1.1

Mar 14, 2015

1.1.0

Dec 6, 2014

1.0.2

May 19, 2013

1.0.1

May 11, 2013

1.0.0

May 11, 2013

Download files

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

Source Distribution

bcrypt-3.1.0.tar.gz (40.0 kB view details)

Uploaded Jun 30, 2016 Source

Built Distributions

bcrypt-3.1.0-cp35-cp35m-win_amd64.whl (25.7 kB view details)

Uploaded Jun 30, 2016 CPython 3.5m Windows x86-64

bcrypt-3.1.0-cp35-cp35m-win32.whl (24.2 kB view details)

Uploaded Jun 30, 2016 CPython 3.5m Windows x86

bcrypt-3.1.0-cp35-cp35m-manylinux1_x86_64.whl (57.6 kB view details)

Uploaded Jun 30, 2016 CPython 3.5m

bcrypt-3.1.0-cp35-cp35m-manylinux1_i686.whl (58.7 kB view details)

Uploaded Jun 30, 2016 CPython 3.5m

bcrypt-3.1.0-cp35-cp35m-macosx_10_6_intel.whl (50.9 kB view details)

Uploaded Jun 30, 2016 CPython 3.5m macOS 10.6+ intel

bcrypt-3.1.0-cp34-cp34m-win_amd64.whl (24.3 kB view details)

Uploaded Jun 30, 2016 CPython 3.4m Windows x86-64

bcrypt-3.1.0-cp34-cp34m-win32.whl (23.8 kB view details)

Uploaded Jun 30, 2016 CPython 3.4m Windows x86

bcrypt-3.1.0-cp34-cp34m-manylinux1_x86_64.whl (57.5 kB view details)

Uploaded Jun 30, 2016 CPython 3.4m

bcrypt-3.1.0-cp34-cp34m-manylinux1_i686.whl (58.5 kB view details)

Uploaded Jun 30, 2016 CPython 3.4m

bcrypt-3.1.0-cp34-cp34m-macosx_10_6_intel.whl (50.8 kB view details)

Uploaded Jun 30, 2016 CPython 3.4m macOS 10.6+ intel

bcrypt-3.1.0-cp33-cp33m-win_amd64.whl (24.3 kB view details)

Uploaded Jun 30, 2016 CPython 3.3m Windows x86-64

bcrypt-3.1.0-cp33-cp33m-win32.whl (23.8 kB view details)

Uploaded Jun 30, 2016 CPython 3.3m Windows x86

bcrypt-3.1.0-cp33-cp33m-manylinux1_x86_64.whl (57.3 kB view details)

Uploaded Jun 30, 2016 CPython 3.3m

bcrypt-3.1.0-cp33-cp33m-manylinux1_i686.whl (58.3 kB view details)

Uploaded Jun 30, 2016 CPython 3.3m

bcrypt-3.1.0-cp33-cp33m-macosx_10_6_intel.whl (50.8 kB view details)

Uploaded Jun 30, 2016 CPython 3.3m macOS 10.6+ intel

bcrypt-3.1.0-cp27-cp27mu-manylinux1_x86_64.whl (57.4 kB view details)

Uploaded Jun 30, 2016 CPython 2.7mu

bcrypt-3.1.0-cp27-cp27mu-manylinux1_i686.whl (58.5 kB view details)

Uploaded Jun 30, 2016 CPython 2.7mu

bcrypt-3.1.0-cp27-cp27mu-macosx_10_10_x86_64.whl (28.8 kB view details)

Uploaded Jun 30, 2016 CPython 2.7mu macOS 10.10+ x86-64

bcrypt-3.1.0-cp27-cp27m-win_amd64.whl (24.2 kB view details)

Uploaded Jun 30, 2016 CPython 2.7m Windows x86-64

bcrypt-3.1.0-cp27-cp27m-win32.whl (23.7 kB view details)

Uploaded Jun 30, 2016 CPython 2.7m Windows x86

bcrypt-3.1.0-cp27-cp27m-manylinux1_x86_64.whl (57.4 kB view details)

Uploaded Jun 30, 2016 CPython 2.7m

bcrypt-3.1.0-cp27-cp27m-manylinux1_i686.whl (58.5 kB view details)

Uploaded Jun 30, 2016 CPython 2.7m

bcrypt-3.1.0-cp27-cp27m-macosx_10_6_intel.whl (50.8 kB view details)

Uploaded Jun 30, 2016 CPython 2.7m macOS 10.6+ intel

bcrypt-3.1.0-cp26-cp26mu-manylinux1_x86_64.whl (57.4 kB view details)

Uploaded Jun 30, 2016 CPython 2.6mu

bcrypt-3.1.0-cp26-cp26mu-manylinux1_i686.whl (58.4 kB view details)

Uploaded Jun 30, 2016 CPython 2.6mu

bcrypt-3.1.0-cp26-cp26m-win_amd64.whl (24.5 kB view details)

Uploaded Jun 30, 2016 CPython 2.6m Windows x86-64

bcrypt-3.1.0-cp26-cp26m-win32.whl (24.0 kB view details)

Uploaded Jun 30, 2016 CPython 2.6m Windows x86

bcrypt-3.1.0-cp26-cp26m-manylinux1_x86_64.whl (57.4 kB view details)

Uploaded Jun 30, 2016 CPython 2.6m

bcrypt-3.1.0-cp26-cp26m-manylinux1_i686.whl (58.4 kB view details)

Uploaded Jun 30, 2016 CPython 2.6m

bcrypt-3.1.0-cp26-cp26m-macosx_10_7_intel.whl (49.3 kB view details)

Uploaded Jun 30, 2016 CPython 2.6m macOS 10.7+ intel

File details

Details for the file bcrypt-3.1.0.tar.gz.

File metadata

Download URL: bcrypt-3.1.0.tar.gz
Upload date: Jun 30, 2016
Size: 40.0 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for bcrypt-3.1.0.tar.gz
Algorithm	Hash digest
SHA256	`e54820d8b9eff357d1003f5b8d4b949a632b76b89610d8a933783fd476033ebe`
MD5	`49d79e646dbf27a05b81e4f0c4f717c7`
BLAKE2b-256	`9b321ece045aa19069ca687d5ccd1241e03a70cae157ae908b6aa5b97789e6da`

Algorithm	Hash digest
SHA256	`26bad7f8010ccb029990f1103fb3686cdde098408de4855a2a286b07b96aef83`
MD5	`8354152bd9df733b0bc887c7c3cda195`
BLAKE2b-256	`ec166514ff192e99050af4c995ea91a1c42a0dccbbf31a53b9c7fd2f055bff6d`

Algorithm	Hash digest
SHA256	`d43dda44ae1c3d50eddd54029ae1e3e2a2a2734d7e71eb94c66a72f640b1ac4b`
MD5	`c3f18872b113723e0b2a0c800b4a0f13`
BLAKE2b-256	`891f6254947d3c743d2a805033d338720f5fb618e1cacd73ef4af40afa71c74f`

Algorithm	Hash digest
SHA256	`e6b3c90908a740ce9cc0a0d7d55ae38602e64b226a0658581ea481c822c82fcf`
MD5	`4469d04de1a2fcd7b666e68719648dc6`
BLAKE2b-256	`2c6b128262e33f0ca2ba47e3f22757962aef49d761ec3c21b9d36167b46be589`

Algorithm	Hash digest
SHA256	`d33967627e5f7d777b0e1bccf7aab2587058517d18ddc5b388b2652902511203`
MD5	`0c9c96148ba321604bb9ff72b09d778b`
BLAKE2b-256	`d93c0669899685c0dec50a48f53755c20ba68026a2c1d6c925d9830861d73281`

Algorithm	Hash digest
SHA256	`7d403d74183eb957f34ca331a5d05d4475d7993042419dfd3bfd3f8eb40b98d1`
MD5	`084a976ac096e44e947a5a62cc600ec5`
BLAKE2b-256	`0acedd13ce1f7c623da5dfde7ce1c9bbfb774877aac147f4d53ded30cae2d1c1`

Algorithm	Hash digest
SHA256	`78003c6793e07afbd8a7cce89c8c5b923eb511a8e2bdc837e59cca11cd31a7ea`
MD5	`1e33b579f8ab823fd3f91d26d1650a9b`
BLAKE2b-256	`6d8965e4bb2c2ef9e0b41d8ae010fcca2d20a4d89a5473726ba8f9180243560d`

Algorithm	Hash digest
SHA256	`7044e2c0a4e0378d4b945490124bed740cf864402f5686dbbefb78e8093ffbb6`
MD5	`53b1cecda16890b351a11202e9df8441`
BLAKE2b-256	`3fc1a2192449c7b8923da53ec1e4d6e2a095d471f30eae3dfdef06e7bae752c4`

Algorithm	Hash digest
SHA256	`63b67f6be04035c351f4db9ba0c1317c4a8acac6c647cc02755f342171bdc234`
MD5	`078114b0e81aebf2bde76bffdaa36798`
BLAKE2b-256	`56ebe93dd999ad9628335f34d2b0dc09eb346267d2e87602b70c9a9e89bb9766`

Algorithm	Hash digest
SHA256	`3322a5be544d07ef8ee138a675653f3d7722f8beeb391fa04a228dfb4b35fd29`
MD5	`d865301158e1912e1a9ed6a7255ecb40`
BLAKE2b-256	`6f6ccbdbebf104ab89c187921b50e55b0c2a4ef3d0cbc748d7f20603cff0e41b`

Algorithm	Hash digest
SHA256	`3f96bd5dfb5a0062c5bcac93b37c84edcd1d594bc7c5e2d8680aa60fb6f4f546`
MD5	`4febce7e3bdc1311b217a1219b3dfec7`
BLAKE2b-256	`0f8c2ebff12ad28e116187375472a37ee1152343e7a6a3d82592b7c34b1913ef`

Algorithm	Hash digest
SHA256	`518bf3c6bc0f3fc9f273f66fc4f2fcbbfc40b0080ceb00fb4016a62531e15e30`
MD5	`0fb5dd54f2f2f1bf8e042af57440629b`
BLAKE2b-256	`902819db38f46cb96eb27b2fda9459e44759ec5f8b060a339d0d1f5a31ebf436`

Algorithm	Hash digest
SHA256	`67ab148cc67310e6eb4455ed1751b8a8fd0e63be8227123a5d199c5233355ded`
MD5	`d1d6091f42dbfc5425fdc674fdf3a4cf`
BLAKE2b-256	`691410f4c744f56e1ca24a35e94a596fed23fa092416e95de036e3cc5c96a6e4`

Algorithm	Hash digest
SHA256	`e2b779a29b51d2c80f408f36c77de55d040301a11c7ab96ef9af7797552572bf`
MD5	`4a02295b5967b3d1cbb15b9f9e7bec82`
BLAKE2b-256	`e5e32781e3f179cfcbdfa16d301d72f303816322921f869d1ecaa9be13eee3fc`

Algorithm	Hash digest
SHA256	`540c9aecfaab41a68e012f8b1ffc280c29a60689a6181e06c4bc473f7382e953`
MD5	`6723ae81a259df7a4e877092f80112ed`
BLAKE2b-256	`a29aaf02274ea9c8afad3109246c5ee29c93c49423566560cd9a18779b361c91`

Algorithm	Hash digest
SHA256	`4c471a572d40e7809e31048e8e15437e8799240f6eba9164d1e60ea61604bf93`
MD5	`3b73d900846ae3472b4be9ad152b9349`
BLAKE2b-256	`41e7d05cc0dd09fa29166b3a830c00798f0adb3a516c0e18dc74ce3c140c6068`

Algorithm	Hash digest
SHA256	`c9a3d44c3b13c6a1fb209663f6f06c04e41f2e8c4ac040ce51ddd019dc06ef09`
MD5	`ece5d8a89fe17e8ca5edebd0d5a1d9d9`
BLAKE2b-256	`39268cf90f00278397a91701d247010dd1424281eff13c8f44176d967fcf20ff`

Algorithm	Hash digest
SHA256	`467a0ab2a23ca384d2a068a040409c8c4ba173335cd73158cb0a61b3c67fcb41`
MD5	`0d2f9ba2eeca75456eff8a63dae9445a`
BLAKE2b-256	`b46cf0a2e376179da31ce2000db1c5feac48cc544193314361eb6f01ac6ba4f5`

Algorithm	Hash digest
SHA256	`457bae2b268940792c58da6dfdbbb763a6b32d9729f273dbcbf7c41364727014`
MD5	`86cedb667804f72695ea8e17583e8763`
BLAKE2b-256	`89a109add97516de7b3318531fc73f6e502e39084228b70f69b44c562a803e9c`

Algorithm	Hash digest
SHA256	`f9fc357289d198da42c347c93310d649c3a69cba5d068dee21321e95c560a94e`
MD5	`b2048e40df4166b79734b296fb446dda`
BLAKE2b-256	`c2e9bb2a92965632a1fec2c39b9838abd7beedfee8209e290d7c05b32d68d6c2`

Algorithm	Hash digest
SHA256	`bdfed3d16907dccec91547cdc8aa473908e9562da342ad16026c0bf97ba867f0`
MD5	`243087fd1ef4bca4a2522d460b2fc08f`
BLAKE2b-256	`02ec96a093adadee03f0c3d4529014696d416a0e42b3838d550671cc0fe554e2`

bcrypt 3.1.0

Navigation

Verified details

Owner

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

bcrypt

Installation

Changelog

3.1.0

3.0.0

2.0.0

Usage

Password Hashing

KDF

Adjustable Work Factor

Adjustable Prefix

Maximum Password Length

Compatibility

C Code

Security

Project details

Verified details

Owner

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`d0fab32ab20677c2c8b06a8d8745bcfd45df73680c0f8ee6c5c80e007d830d8d`
MD5	`a092d97d5991d18da350e3f845035d91`
BLAKE2b-256	`a14c951b092817fcaab62ccecb20a0e977a3b43af2f5d669660cac8afed32007`

Algorithm	Hash digest
SHA256	`12ec763e3d0bed4e2c21708a5002d7d1e478e84773d8d70555509a3208bb2099`
MD5	`ecb306b11ea1c9a7132951e91e1f61f3`
BLAKE2b-256	`4b1bef5a489e7d335ca9624bedf19be758e1a582f2118136d7af879e8699767f`

Algorithm	Hash digest
SHA256	`b63349c7dca58de68841ababc92d67586bd74a02d3bdeded40ff3c624dee1d1b`
MD5	`6f7ba8083c469459f1cb583184b5f7de`
BLAKE2b-256	`9659f381e2d67c435ae57f3c75f26f153c319e302d889eaed154f4a190828bd7`

Algorithm	Hash digest
SHA256	`6a5ed44eab27e7db0c04525430b84dbffa4ddaf4df113d54a18c8f1c53b95fa8`
MD5	`ea2689fbb1467bc5a755aa75cb111e9c`
BLAKE2b-256	`db7f815a9af3ef9050ac226eac556ec805eed8b67f503fd70183538d531f88c6`

Algorithm	Hash digest
SHA256	`ca31f7c36a646fe41fd38263bc1e45b46955bd638aba717183a23279b7e10b2c`
MD5	`49bbf0c694e166acd2a8fe1123f8e460`
BLAKE2b-256	`01748a074778223d571fd92065093a8226395b85e5f3e7765318f152e222c9b4`

Algorithm	Hash digest
SHA256	`8da0578982a6c1039a02f7f9ccfff2a92ea378b1c304e1b21c6219509fc4e8f1`
MD5	`04c757ecb97f400972bff8e32bcee1e2`
BLAKE2b-256	`019d163711ecd295c889caac8746c0fe6941e1b8b37bcbaf8116c78d49458b76`

Algorithm	Hash digest
SHA256	`7db3949fbf42f544aae49b5559f333aa1473d84a712f085a27927bc18bdf53ba`
MD5	`3f9bab1550a81176192827d81a007d95`
BLAKE2b-256	`9f358f2ccabd88bcdd13f7f8824c71c081467cc13ddcb6354fea8aee560082ee`

Algorithm	Hash digest
SHA256	`21ae97098f187a40b7f64a359a794ecb5e6bfe7f6b358d0e3033081b43d406ed`
MD5	`2d94c5ef7a87c24565997be257e67bfb`
BLAKE2b-256	`ffef071846b2a323643cffe059c20ef7121f57e7f54d882ff8dfb42773b22606`

Algorithm	Hash digest
SHA256	`0a1fa5e8bad38ead75819fe82d1c9dbb682a972848639df3d70329fa24e1eed4`
MD5	`0da48e110bdcb2da8729ef4041aeab27`
BLAKE2b-256	`2eeee08ec9ef70092c7d5d153279f622b052335c1c6759bdd7ac2526c4c75404`

Algorithm	Hash digest
SHA256	`ef8b9d5883611ffe2428d40dcf65ab86b8d92afdd6d01e79594b10a710d724af`
MD5	`909309be70147d85f840a315068cdb5b`
BLAKE2b-256	`c066696789ccf9bfd4ed370877e6921569caa3dbb048abc4b59e344189e46784`