github.com/gnolang/gno@v0.0.0-20240520182011-228e9d0192ce/tm2/pkg/crypto/bcrypt/bcrypt.go (about)

     1  // MODIFIED BY TENDERMINT TO EXPOSE `salt` in `GenerateFromPassword`.
     2  // Copyright 2011 The Go Authors. All rights reserved.
     3  // Use of this source code is governed by a BSD-style
     4  // license that can be found in the LICENSE file.
     5  
     6  // Package bcrypt implements Provos and Mazières's bcrypt adaptive hashing
     7  // algorithm. See http://www.usenix.org/event/usenix99/provos/provos.pdf
     8  package bcrypt // import "golang.org/x/crypto/bcrypt"
     9  
    10  // The code is a port of Provos and Mazières's C implementation.
    11  import (
    12  	"crypto/subtle"
    13  	"errors"
    14  	"fmt"
    15  	"strconv"
    16  
    17  	"golang.org/x/crypto/blowfish"
    18  )
    19  
    20  const (
    21  	MinCost     int = 4  // the minimum allowable cost as passed in to GenerateFromPassword
    22  	MaxCost     int = 31 // the maximum allowable cost as passed in to GenerateFromPassword
    23  	DefaultCost int = 10 // the cost that will actually be set if a cost below MinCost is passed into GenerateFromPassword
    24  )
    25  
    26  // The error returned from CompareHashAndPassword when a password and hash do
    27  // not match.
    28  var ErrMismatchedHashAndPassword = errors.New("crypto/bcrypt: hashedPassword is not the hash of the given password")
    29  
    30  // The error returned from CompareHashAndPassword when a hash is too short to
    31  // be a bcrypt hash.
    32  var ErrHashTooShort = errors.New("crypto/bcrypt: hashedSecret too short to be a bcrypted password")
    33  
    34  // The error returned from CompareHashAndPassword when a hash was created with
    35  // a bcrypt algorithm newer than this implementation.
    36  type HashVersionTooNewError byte
    37  
    38  func (hv HashVersionTooNewError) Error() string {
    39  	return fmt.Sprintf("crypto/bcrypt: bcrypt algorithm version '%c' requested is newer than current version '%c'", byte(hv), majorVersion)
    40  }
    41  
    42  // The error returned from CompareHashAndPassword when a hash starts with something other than '$'
    43  type InvalidHashPrefixError byte
    44  
    45  func (ih InvalidHashPrefixError) Error() string {
    46  	return fmt.Sprintf("crypto/bcrypt: bcrypt hashes must start with '$', but hashedSecret started with '%c'", byte(ih))
    47  }
    48  
    49  type InvalidCostError int
    50  
    51  func (ic InvalidCostError) Error() string {
    52  	return fmt.Sprintf("crypto/bcrypt: cost %d is outside allowed range (%d,%d)", int(ic), MinCost, MaxCost)
    53  }
    54  
    55  const (
    56  	majorVersion       = '2'
    57  	minorVersion       = 'a'
    58  	maxSaltSize        = 16
    59  	maxCryptedHashSize = 23
    60  	encodedSaltSize    = 22
    61  	encodedHashSize    = 31
    62  	minHashSize        = 59
    63  )
    64  
    65  // magicCipherData is an IV for the 64 Blowfish encryption calls in
    66  // bcrypt(). It's the string "OrpheanBeholderScryDoubt" in big-endian bytes.
    67  var magicCipherData = []byte{
    68  	0x4f, 0x72, 0x70, 0x68,
    69  	0x65, 0x61, 0x6e, 0x42,
    70  	0x65, 0x68, 0x6f, 0x6c,
    71  	0x64, 0x65, 0x72, 0x53,
    72  	0x63, 0x72, 0x79, 0x44,
    73  	0x6f, 0x75, 0x62, 0x74,
    74  }
    75  
    76  type hashed struct {
    77  	hash  []byte
    78  	salt  []byte
    79  	cost  int // allowed range is MinCost to MaxCost
    80  	major byte
    81  	minor byte
    82  }
    83  
    84  // GenerateFromPassword returns the bcrypt hash of the password at the given
    85  // cost. If the cost given is less than MinCost, the cost will be set to
    86  // DefaultCost, instead. Use CompareHashAndPassword, as defined in this package,
    87  // to compare the returned hashed password with its cleartext version.
    88  func GenerateFromPassword(salt []byte, password []byte, cost int) ([]byte, error) {
    89  	if len(salt) != maxSaltSize {
    90  		return nil, fmt.Errorf("salt len must be %v", maxSaltSize)
    91  	}
    92  	p, err := newFromPassword(salt, password, cost)
    93  	if err != nil {
    94  		return nil, err
    95  	}
    96  	return p.Hash(), nil
    97  }
    98  
    99  // CompareHashAndPassword compares a bcrypt hashed password with its possible
   100  // plaintext equivalent. Returns nil on success, or an error on failure.
   101  func CompareHashAndPassword(hashedPassword, password []byte) error {
   102  	p, err := newFromHash(hashedPassword)
   103  	if err != nil {
   104  		return err
   105  	}
   106  
   107  	otherHash, err := bcrypt(password, p.cost, p.salt)
   108  	if err != nil {
   109  		return err
   110  	}
   111  
   112  	otherP := &hashed{otherHash, p.salt, p.cost, p.major, p.minor}
   113  	if subtle.ConstantTimeCompare(p.Hash(), otherP.Hash()) == 1 {
   114  		return nil
   115  	}
   116  
   117  	return ErrMismatchedHashAndPassword
   118  }
   119  
   120  // Cost returns the hashing cost used to create the given hashed
   121  // password. When, in the future, the hashing cost of a password system needs
   122  // to be increased in order to adjust for greater computational power, this
   123  // function allows one to establish which passwords need to be updated.
   124  func Cost(hashedPassword []byte) (int, error) {
   125  	p, err := newFromHash(hashedPassword)
   126  	if err != nil {
   127  		return 0, err
   128  	}
   129  	return p.cost, nil
   130  }
   131  
   132  func newFromPassword(salt []byte, password []byte, cost int) (*hashed, error) {
   133  	if cost < MinCost {
   134  		cost = DefaultCost
   135  	}
   136  	p := new(hashed)
   137  	p.major = majorVersion
   138  	p.minor = minorVersion
   139  
   140  	err := checkCost(cost)
   141  	if err != nil {
   142  		return nil, err
   143  	}
   144  	p.cost = cost
   145  
   146  	p.salt = base64Encode(salt)
   147  	hash, err := bcrypt(password, p.cost, p.salt)
   148  	if err != nil {
   149  		return nil, err
   150  	}
   151  	p.hash = hash
   152  	return p, err
   153  }
   154  
   155  func newFromHash(hashedSecret []byte) (*hashed, error) {
   156  	if len(hashedSecret) < minHashSize {
   157  		return nil, ErrHashTooShort
   158  	}
   159  	p := new(hashed)
   160  	n, err := p.decodeVersion(hashedSecret)
   161  	if err != nil {
   162  		return nil, err
   163  	}
   164  	hashedSecret = hashedSecret[n:]
   165  	n, err = p.decodeCost(hashedSecret)
   166  	if err != nil {
   167  		return nil, err
   168  	}
   169  	hashedSecret = hashedSecret[n:]
   170  
   171  	// The "+2" is here because we'll have to append at most 2 '=' to the salt
   172  	// when base64 decoding it in expensiveBlowfishSetup().
   173  	p.salt = make([]byte, encodedSaltSize, encodedSaltSize+2)
   174  	copy(p.salt, hashedSecret[:encodedSaltSize])
   175  
   176  	hashedSecret = hashedSecret[encodedSaltSize:]
   177  	p.hash = make([]byte, len(hashedSecret))
   178  	copy(p.hash, hashedSecret)
   179  
   180  	return p, nil
   181  }
   182  
   183  func bcrypt(password []byte, cost int, salt []byte) ([]byte, error) {
   184  	cipherData := make([]byte, len(magicCipherData))
   185  	copy(cipherData, magicCipherData)
   186  
   187  	c, err := expensiveBlowfishSetup(password, uint32(cost), salt)
   188  	if err != nil {
   189  		return nil, err
   190  	}
   191  
   192  	for i := 0; i < 24; i += 8 {
   193  		for j := 0; j < 64; j++ {
   194  			c.Encrypt(cipherData[i:i+8], cipherData[i:i+8])
   195  		}
   196  	}
   197  
   198  	// Bug compatibility with C bcrypt implementations. We only encode 23 of
   199  	// the 24 bytes encrypted.
   200  	hsh := base64Encode(cipherData[:maxCryptedHashSize])
   201  	return hsh, nil
   202  }
   203  
   204  func expensiveBlowfishSetup(key []byte, cost uint32, salt []byte) (*blowfish.Cipher, error) {
   205  	csalt, err := base64Decode(salt)
   206  	if err != nil {
   207  		return nil, err
   208  	}
   209  
   210  	// Bug compatibility with C bcrypt implementations. They use the trailing
   211  	// NULL in the key string during expansion.
   212  	// We copy the key to prevent changing the underlying array.
   213  	ckey := append(key[:len(key):len(key)], 0)
   214  
   215  	c, err := blowfish.NewSaltedCipher(ckey, csalt)
   216  	if err != nil {
   217  		return nil, err
   218  	}
   219  
   220  	var i, rounds uint64
   221  	rounds = 1 << cost
   222  	for i = 0; i < rounds; i++ {
   223  		blowfish.ExpandKey(ckey, c)
   224  		blowfish.ExpandKey(csalt, c)
   225  	}
   226  
   227  	return c, nil
   228  }
   229  
   230  func (p *hashed) Hash() []byte {
   231  	arr := make([]byte, 60)
   232  	arr[0] = '$'
   233  	arr[1] = p.major
   234  	n := 2
   235  	if p.minor != 0 {
   236  		arr[2] = p.minor
   237  		n = 3
   238  	}
   239  	arr[n] = '$'
   240  	n++
   241  	copy(arr[n:], []byte(fmt.Sprintf("%02d", p.cost)))
   242  	n += 2
   243  	arr[n] = '$'
   244  	n++
   245  	copy(arr[n:], p.salt)
   246  	n += encodedSaltSize
   247  	copy(arr[n:], p.hash)
   248  	n += encodedHashSize
   249  	return arr[:n]
   250  }
   251  
   252  func (p *hashed) decodeVersion(sbytes []byte) (int, error) {
   253  	if sbytes[0] != '$' {
   254  		return -1, InvalidHashPrefixError(sbytes[0])
   255  	}
   256  	if sbytes[1] > majorVersion {
   257  		return -1, HashVersionTooNewError(sbytes[1])
   258  	}
   259  	p.major = sbytes[1]
   260  	n := 3
   261  	if sbytes[2] != '$' {
   262  		p.minor = sbytes[2]
   263  		n++
   264  	}
   265  	return n, nil
   266  }
   267  
   268  // sbytes should begin where decodeVersion left off.
   269  func (p *hashed) decodeCost(sbytes []byte) (int, error) {
   270  	cost, err := strconv.Atoi(string(sbytes[0:2]))
   271  	if err != nil {
   272  		return -1, err
   273  	}
   274  	err = checkCost(cost)
   275  	if err != nil {
   276  		return -1, err
   277  	}
   278  	p.cost = cost
   279  	return 3, nil
   280  }
   281  
   282  func (p *hashed) String() string {
   283  	return fmt.Sprintf("&{hash: %#v, salt: %#v, cost: %d, major: %c, minor: %c}", string(p.hash), p.salt, p.cost, p.major, p.minor)
   284  }
   285  
   286  func checkCost(cost int) error {
   287  	if cost < MinCost || cost > MaxCost {
   288  		return InvalidCostError(cost)
   289  	}
   290  	return nil
   291  }