bit-cmdr / salty64

Hashing package for Go

Salty64

This is a Go package that is used to generate a hash of a string with a minimum level of security. The ideal scenario is if you need to generate an ID for a record that is based on one or more fields combined together and will be the same every time it is generated. This is not meant to be a secure string or used for passwords in any way, simply as a hash to identify a record in a way that does not leak anything like an email address or name in plain text. There are reversible and non-reversible methods.

Installation

go get -u github.com/bit-cmdr/salty64

Testing

go test .

Benchmarking

go test -bench=. -benchmem

Example

package main

import (
	"github.com/bit-cmdr/salty64"
    "fmt"
    "os"
)

func main() {
    email := "[e-mail]"

    s, err := salty64.NewShaker("secret", 2)
    if err != nil {
        fmt.Printf("error: %s\n", err)
        os.Exit(1)
    }

    // reversible usage
    hash, err := s.Encode(email)
    if err != nil {
        fmt.Printf("error: %s\n", err)
        os.Exit(1)
    }

    fmt.Printf("hash: %s\n", hash)

    // non-reversible usage
    hash, err = s.MethodEncode(salty64.SHA256, "[e-mail]")
    if err != nil {
        fmt.Printf("error: %s\n", err)
        os.Exit(1)
    }
}