package security import ( "crypto/rand" "crypto/subtle" "encoding/base64" "errors" "fmt" "strings" "unicode/utf8" "golang.org/x/crypto/argon2" ) const ( argonMemory uint32 = 19 * 1024 argonIterations uint32 = 2 argonParallelism uint8 = 1 argonSaltLength = 16 argonKeyLength uint32 = 32 minPasswordLength = 12 maxPasswordLength = 128 ) var ErrInvalidPasswordHash = errors.New("invalid password hash") func ValidatePassword(password string) error { if !utf8.ValidString(password) { return errors.New("password must be valid UTF-8") } length := utf8.RuneCountInString(password) if length < minPasswordLength || length > maxPasswordLength { return fmt.Errorf( "password length must be between %d and %d code points", minPasswordLength, maxPasswordLength, ) } return nil } func HashPassword(password string) (string, error) { if err := ValidatePassword(password); err != nil { return "", err } salt := make([]byte, argonSaltLength) if _, err := rand.Read(salt); err != nil { return "", fmt.Errorf("generate password salt: %w", err) } hash := argon2.IDKey( []byte(password), salt, argonIterations, argonMemory, argonParallelism, argonKeyLength, ) encodedSalt := base64.RawStdEncoding.EncodeToString(salt) encodedHash := base64.RawStdEncoding.EncodeToString(hash) encoded := fmt.Sprintf( "$argon2id$v=%d$m=%d,t=%d,p=%d$%s$%s", argon2.Version, argonMemory, argonIterations, argonParallelism, encodedSalt, encodedHash, ) return encoded, nil } func VerifyPassword( password string, encodedHash string, ) (bool, error) { parameters, salt, expectedHash, err := decodePasswordHash(encodedHash) if err != nil { return false, err } actualHash := argon2.IDKey( []byte(password), salt, parameters.iterations, parameters.memory, parameters.parallelism, uint32(len(expectedHash)), ) matches := subtle.ConstantTimeCompare( actualHash, expectedHash, ) == 1 return matches, nil } type argonParameters struct { memory uint32 iterations uint32 parallelism uint8 } func decodePasswordHash( encodedHash string, ) (argonParameters, []byte, []byte, error) { parts := strings.Split(encodedHash, "$") if len(parts) != 6 || parts[0] != "" || parts[1] != "argon2id" { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } var version int if _, err := fmt.Sscanf(parts[2], "v=%d", &version); err != nil { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } if version != argon2.Version { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } var parameters argonParameters if _, err := fmt.Sscanf( parts[3], "m=%d,t=%d,p=%d", ¶meters.memory, ¶meters.iterations, ¶meters.parallelism, ); err != nil { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } // Ограничения не позволяют повреждённой строке из БД запросить // гигантский объём памяти или процессорного времени. if parameters.memory < 8*1024 || parameters.memory > 256*1024 || parameters.iterations < 1 || parameters.iterations > 10 || parameters.parallelism < 1 || parameters.parallelism > 8 { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } salt, err := base64.RawStdEncoding.DecodeString(parts[4]) if err != nil || len(salt) < 16 || len(salt) > 64 { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } hash, err := base64.RawStdEncoding.DecodeString(parts[5]) if err != nil || len(hash) < 16 || len(hash) > 64 { return argonParameters{}, nil, nil, ErrInvalidPasswordHash } return parameters, salt, hash, nil }