secure

Documentation

Index

• Constants
• Variables
• func IsIdSupported(id string) bool
• func LoadConfig(path string) error
• func RandomBytes(len uint32) ([]byte, error)
• func SetDefaultPHC(id string)
• type PHC
  • func DefaultPHC() *PHC
  • func ParsePHC(s string) (*PHC, error)
  • func (p *PHC) Hash(password string) (string, error)
  • func (p *PHC) String() string
  • func (p *PHC) Verify(password string) error
• type SConfiguration

Constants

const (
	IdArgon2id = "argon2id"
	IdBcrypt   = "bcrypt"
	IdPBKDF2   = "pbkdf2"
)

Variables

var Argon2idPHC = &PHC{
	Id: IdArgon2id,
	Params: map[string]interface{}{
		"m": 65536,
		"t": 3,
		"p": 2,
	},
}

var BcryptPHC = &PHC{
	Id: IdBcrypt,
	Params: map[string]interface{}{
		"r": 10,
	},
}

var PBKDF2PHC = &PHC{
	Id: IdPBKDF2,
	Params: map[string]interface{}{
		"t": 310_000,
		"h": "sha256",
	},
}

Functions

func IsIdSupported

func IsIdSupported(id string) bool

func LoadConfig

func LoadConfig(path string) error

Load secure configuration from file

func RandomBytes

func RandomBytes(len uint32) ([]byte, error)

RandomBytes generate secure random bytes

func SetDefaultPHC

func SetDefaultPHC(id string)

Types

type PHC

type PHC struct {
	Id      string
	Version int
	Params  map[string]interface{}
	Salt    string
	Value   string
}

Password Hashing Competition

func DefaultPHC

func DefaultPHC() *PHC

func ParsePHC

func ParsePHC(s string) (*PHC, error)

parse PHC string https://github.com/P-H-C/phc-string-format/blob/master/phc-sf-spec.md

func (*PHC) Hash

func (p *PHC) Hash(password string) (string, error)

Hash password

func (*PHC) String

func (p *PHC) String() string

func (*PHC) Verify

func (p *PHC) Verify(password string) error

Verify password

type SConfiguration

type SConfiguration struct {
	PCHID string `yaml:"pchid"` // Password hash algorithm
}