hashers

README

Go Django Hashers

Go implementation of password hashers used in Django

Implemented hashers:

• pbkdf2_sha256
• pbkdf2_sha1
• sha1
• md5
• unsalted_sha1
• unsalted_md5

Unsalted hashers are not allowed by hashers.MakePassword function. You can use them just with hashers.CheckPassword.

Hashers based on bcrypt are not implemented because golang.org/x/crypto/bcrypt is not yet compatible with Python's bcrypt.

By default hashers.MakePassword is using pbkdf2_sha256 hasher. If you really want to change it (i.e. when you want to have passwords compatible with Django 1.3 or older), you can set hashers.DefaultHasher variable to one of supported hashers:

hashers.DefaultHasher = "sha1"

Installation

go get -u github.com/meehow/go-django-hashers

Usage

Usage is quite straightforward and simple.

Check example files:

• check_password
• make_password

Documentation

Index

• Variables
• func CheckPassword(password, encoded string) (bool, error)
• func MakePassword(password string) (string, error)

Variables

var (
	// Iter is a number of iterations used to make pbkdf2 passwords.
	// 20000 is't a default value used in Django.
	Iter = 20000
	// SaltSize is a size of salt used to make passwords.
	// 12 is default size used in Django.
	SaltSize = 12
	// DefaultHasher is a default hashing algorithm.
	// pbkdf2_sha256 is used by default in Django
	DefaultHasher = "pbkdf2_sha256"
)

Functions

func CheckPassword

func CheckPassword(password, encoded string) (bool, error)

CheckPassword checks if given password is matching given hash

func MakePassword

func MakePassword(password string) (string, error)

MakePassword generates new password using algorithm set in DefaultHasher