Admin: Created page with "{{#seo: |title=Bcrypt – Encryption, Decryption algorithm – zaoniao Wiki |keywords=Bcrypt, generator, password, encryption, decrypt, security, hash |description=Bcrypt is a..."

2019-04-11T03:49:57Z

Created page with "{{#seo: |title=Bcrypt – Encryption, Decryption algorithm – zaoniao Wiki |keywords=Bcrypt, generator, password, encryption, decrypt, security, hash |description=Bcrypt is a..."

New page

{{#seo:
|title=Bcrypt – Encryption, Decryption algorithm – zaoniao Wiki
|keywords=Bcrypt, generator, password, encryption, decrypt, security, hash
|description=Bcrypt is a password hashing function designed by Niels Provos and David Mazière. There are implementations of bcrypt for C, C#, Java, PHP, Python, Scala and other languages. The bcrypt algorithm is the result of encrypting the phrase using Blowfish.
}}

<amp/>
[[File:bcrypt.png|530px|right|Bcrypt online password generator]]
'''Bcrypt''' is a [[Cryptographic hash function#Password verification|password hashing function]] designed by [[Niels Provos]] and David Mazières, based on the Blowfish cipher, and presented at USENIX in 1999. Besides incorporating a salt to protect against rainbow table attacks, bcrypt is an adaptive function: over time, the iteration count can be increased to make it slower, so it remains resistant to brute-force search attacks even with increasing computation power.

The bcrypt function is the default password hash algorithm for OpenBSD and other systems including some Linux distributions such as SUSE Linux.
The prefix "$2a$" or "$2b$" (or "$2y$") in a hash string in a shadow password file indicates that hash string is a bcrypt hash in modular crypt format.
The rest of the hash string includes the cost parameter, a 128-bit salt (Radix-64 encoded as 22 characters), and 184 bits of the resulting hash value (Radix-64 encoded as 31 characters). The Radix-64 encoding uses the unix/crypt alphabet, and is not 'standard' Base-64. The cost parameter specifies a key expansion iteration count as a power of two, which is an input to the crypt algorithm.

For example, the shadow password record <code>$2a$10$N9qo8uLOickgx2ZMRZoMyeIjZAgcfl7p92ldGxad68LJZdL17lhWy</code> specifies a cost parameter of 10, indicating 210 key expansion rounds. The salt is <code>N9qo8uLOickgx2ZMRZoMye</code> and the resulting hash is <code>IjZAgcfl7p92ldGxad68LJZdL17lhWy</code>. Per standard practice, the user's password itself is not stored.

There are implementations of bcrypt for C, C#, Go, Java, JavaScript, Perl, PHP, Python, Ruby and other languages.

==Bcrypt password generator==
Blowfish is notable among block ciphers for its expensive key setup phase. It starts off with subkeys in a standard state, then uses this state to perform a block encryption using part of the key, and uses the result of that encryption (which is more accurately a hashing) to replace some of the subkeys. Then it uses this modified state to encrypt another part of the key, and uses the result to replace more of the subkeys. It proceeds in this fashion, using a progressively modified state to hash the key and replace bits of state, until all subkeys have been set.

Provos and Mazières took advantage of this, and took it further. They developed a new key setup algorithm for Blowfish, dubbing the resulting cipher "Eksblowfish" ("expensive key schedule Blowfish"). The key setup begins with a modified form of the standard Blowfish key setup, in which both the salt and password are used to set all subkeys. There are then a number of rounds in which the standard Blowfish keying algorithm is applied, using alternatively the salt and the password as the key, each round starting with the subkey state from the previous round. In theory, this is no stronger than the standard Blowfish key schedule, but the number of rekeying rounds is configurable; this process can therefore be made arbitrarily slow, which helps deter brute-force attacks upon the hash or salt.

== Versioning History ==

''' $2$ (1999) '''

The original Bcrypt specification defined a prefix of <code>$2$</code>. This follows the '''Modular Crypt Format''' format used when storing passwords in the OpenBSD password file:

* <code>$1$</code>: MD5
* <code>$2$</code>: Bcrypt
* <code>$sha1$</code>: SHA-1
* <code>$5$</code>: SHA-256
* <code>$6$</code>: SHA-512

''' $2a$ '''

The original specification did not define how to handle non-ASCII character, nor how to handle a null terminator. The specification was revised to specify that when hashing strings:

* the string must be UTF-8 encoded
* the null terminator must be included

With this change, the version was changed to <code>$2a$</code>

''' $2x$, $2y$ (June 2011) '''

In June 2011, a bug was discovered in '''crypt_blowfish''', a PHP implementation of BCrypt. It was mis-handling characters with the 8th bit set. They suggested that system administrators update their existing password database, replacing <code>$2a$</code> with <code>$2x$</code>, to indicate that those hashes are bad (and need to use the old broken algorithm). They also suggested the idea of having '''crypt_blowfish''' emit <code>$2y$</code> for hashes generated by the fixed algorithm.

Nobody else, including canonical OpenBSD, adopted the idea of 2x/2y. This version marker change was limited to '''crypt_blowfish'''.

''' $2b$ (February 2014) '''

A bug was discovered in the OpenBSD implementation of bcrypt. They were storing the length of their strings in an '''unsigned char''' (''i.e.'' 8-bit <code>Byte</code>).

BCrypt was created for OpenBSD. When they had a bug in their library, they decided to bump the version number.

==Bcrypt Algorithm==

The bcrypt algorithm is the result of encrypting the text ''"OrpheanBeholderScryDoubt"'' 64 times using Blowfish. In bcrypt the usual Blowfish key setup function is replaced with an ''expensive'' key setup (EksBlowfishSetup) function:

'''Function''' bcrypt
'''Input:'''
cost: Number (4..31) log2(Iterations). e.g. 12 ==> 212 = 4,096 iterations
salt: array of Bytes (16 bytes) random salt
password: array of Bytes (1..72 bytes) UTF-8 encoded password
'''Output:'''
hash: array of Bytes (24 bytes)

//Initialize Blowfish state with expensive key setup algorithm
''state'' <math>\gets</math> EksBlowfishSetup(''cost'', ''salt'', ''password'')

//Repeatedly encrypt the text "OrpheanBeholderScryDoubt" 64 times
''ctext'' <math>\gets</math> ''"OrpheanBeholderScryDoubt"'' //24 bytes ==> three 64-bit blocks
'''repeat''' (64)
''ctext'' <math>\gets</math> EncryptECB(''state'', ''ctext'') //encrypt using standard Blowfish in ECB mode

//24-byte ''ctext'' is resulting password hash
'''return''' Concatenate(''cost'', ''salt'', ''ctext'')

=== Bcrypt code – Expensive key setup ===

The bcrypt algorithm depends heavily on its "Eksblowfish" key setup algorithm, which runs as follows:

'''Function''' EksBlowfishSetup
'''Input:'''
cost: Number (4..31) log2(Iterations). e.g. 12 ==> 212 = 4,096 iterations
salt: array of Bytes (16 bytes) random salt
password: array of Bytes (1..72 bytes) UTF-8 encoded password
'''Output:'''
state: opaque BlowFish state structure

''state'' <math>\gets</math> InitialState()
''state'' <math>\gets</math> ExpandKey(''state'', ''salt'', ''password'')
'''repeat''' (2''cost'')
''state'' <math>\gets</math> ExpandKey(state, 0, password)
''state'' <math>\gets</math> ExpandKey(state, 0, salt)

'''return''' ''state''

InitialState works as in the original Blowfish algorithm, populating the P-array and S-box entries with the fractional part of <math>\pi</math> in hexadecimal.

=== Expand key ===
The ExpandKey function does the following:

'''Function''' ExpandKey(''state'', ''salt'', ''password'')
'''Input:'''
state: Opaque BlowFish state structure Internally contains P-array and S-box entries
salt: array of Bytes (16 bytes) random salt
password: array of Bytes (1..72 bytes) UTF-8 encoded password
'''Output:'''
state: opaque BlowFish state structure

//Mix password into the internal P-array of ''state''
'''for''' ''n'' <math>\gets</math> 1 '''to''' 18 '''do'''
Pn <math>\gets</math> Pn xor ''password''[32(n-1)..32n-1] //treat the password as cyclic

//Encrypt state using the lower 8 bytes of salt, and store the 8 byte result in P1|P2
''block'' <math>\gets</math> Encrypt(''state'', ''salt''[0..63])
P1 <math>\gets</math> ''block''[0..31] //lower 32-bits
P2 <math>\gets</math> ''block''[32..63] //upper 32-bits

//Continue encrypting state with salt, and storing results in remaining P-array
'''for''' ''n'' <math>\gets</math> 2 '''to''' 9 '''do'''
''block'' <math>\gets</math> Encrypt(''state'', ''block'' '''xor''' ''salt''[64(n-1)..64n-1]) //encrypt using the current key schedule and treat the salt as cyclic
P2n-1 <math>\gets</math> ''block''[0..31] //lower 32-bits
P2n <math>\gets</math> ''block''[32..63] //upper 32-bits

//Mix encrypted state into the internal S-boxes of ''state''
'''for''' ''i'' <math>\gets</math> 1 '''to''' 4 '''do'''
'''for''' ''n'' <math>\gets</math> 0 '''to''' 127 '''do'''
''block'' <math>\gets</math> Encrypt(''state'', ''block'' '''xor''' ''salt''[64(n-1)..64n-1]) //as above
Si[2n] <math>\gets</math> ''block''[0..31] //lower 32-bits
Si[2n+1] <math>\gets</math> ''block''[32..63] //upper 32-bits
'''return''' ''state''

Hence, <code>ExpandKey(''state'', 0, ''key'')</code> is the same as regular Blowfish key schedule since all XORs with the all-zero salt value are ineffectual. <code>ExpandKey(''state'', 0, ''salt'')</code> is similar, but uses the salt as a 128-bit key.

==User input==
Many implementations of bcrypt truncate the password to the first 72 bytes.

The mathematical algorithm itself requires initialization with 18 32-bit subkeys (equivalent to 72 octets/bytes). The original specification "The 448 [bit] limit on the key size ensures that the every bit of every subkey depends on every bit of the key."

Implementations have varied in their approach of converting passwords into initial numeric values, including sometimes reducing the strength of passwords containing non-ASCII characters.

==See also==
* [[Crypt (C)#Blowfish-based scheme]] crypt password storage and verification scheme Blowfish
* [[PBKDF2]] (Password-Based Key Derivation Function 2)
* [[Scrypt]]
* [[SHA-256]]
* [[SHA-1]]

==Source==
[http://wikipedia.org/ http://wikipedia.org/]

Bcrypt - Revision history

Admin: Created page with "{{#seo: |title=Bcrypt – Encryption, Decryption algorithm – zaoniao Wiki |keywords=Bcrypt, generator, password, encryption, decrypt, security, hash |description=Bcrypt is a..."