desext

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 1, 2024 License: BSD-3-Clause Imports: 7 Imported by: 0

Documentation

Overview

Package desext implements the DES Extended hashing algorithm for crypt(3).

Index

Examples

Constants

View Source
const (
	MinRounds     = 1
	MaxRounds     = 1<<24 - 1
	DefaultRounds = 5001
)
View Source
const Prefix = "_"
View Source
const SaltLength = 4

Variables

This section is empty.

Functions

func Check

func Check(hash, password string) error

Check compares the given crypt(3) DES Extended hash with a new hash derived from the password. Returns nil on success, or an error on failure.

Example
package main

import (
	"fmt"

	"github.com/sergeymakinen/go-crypt/desext"
)

func main() {
	hash := "_6C/.yaiu.qYIjNR7X.s"
	fmt.Println(desext.Check(hash, "password"))
	fmt.Println(desext.Check(hash, "test"))
}
Output:

<nil>
hash and password mismatch

func Key

func Key(password, salt []byte, rounds uint32) ([]byte, error)

Key returns a DES Extended key derived from the password, salt and rounds.

Example
package main

import (
	"fmt"

	"github.com/sergeymakinen/go-crypt/desext"
	"github.com/sergeymakinen/go-crypt/hash"
)

func main() {
	salt, rounds, _ := desext.Params("_6C/.yaiu.qYIjNR7X.s")
	fmt.Println(string(salt))
	fmt.Println(rounds)

	key, _ := desext.Key([]byte("password"), salt, rounds)
	fmt.Println(hash.BigEndianEncoding.EncodeToString(key))
}
Output:

yaiu
5000
.qYIjNR7X.s

func NewHash

func NewHash(password string, rounds uint32) (string, error)

NewHash returns the crypt(3) DES Extended hash of the password with the given rounds.

func Params

func Params(hash string) (salt []byte, rounds uint32, err error)

Params returns the hashing salt and rounds used to create the given crypt(3) DES Extended hash.

Example
package main

import (
	"fmt"

	"github.com/sergeymakinen/go-crypt/desext"
)

func main() {
	salt, rounds, _ := desext.Params("_6C/.yaiu.qYIjNR7X.s")
	fmt.Println(string(salt))
	fmt.Println(rounds)
}
Output:

yaiu
5000

Types

type InvalidRoundsError

type InvalidRoundsError uint32

InvalidRoundsError values describe errors resulting from an invalid round count.

func (InvalidRoundsError) Error

func (e InvalidRoundsError) Error() string

type InvalidSaltError

type InvalidSaltError byte

InvalidSaltError values describe errors resulting from an invalid character in a hash string.

func (InvalidSaltError) Error

func (e InvalidSaltError) Error() string

type InvalidSaltLengthError

type InvalidSaltLengthError int

InvalidSaltLengthError values describe errors resulting from an invalid length of a salt.

func (InvalidSaltLengthError) Error

func (e InvalidSaltLengthError) Error() string

type UnsupportedPrefixError

type UnsupportedPrefixError string

UnsupportedPrefixError values describe errors resulting from an unsupported prefix string.

func (UnsupportedPrefixError) Error

func (e UnsupportedPrefixError) Error() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL