passwd 0.2.0

crypt(3)-compatible (UNIX passwd style) password hashing algorithms


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

passwd

A D library for UNIX-style (crypt(3)) password hashing.

Features

  • Standards-compatible crypt(3) password hashing
  • Constant time password checking
  • @safe

Supported hashing algorithms:

  • MD5-based crypt (algorithm "1")
  • SHA256-based crypt (algorithm "5")
  • SHA512-based crypt (algorithm "6")

Usage example

import passwd;
import passwd.sha;

// Create salt for 6000-round SHA512 crypt
auto salt = SHA512Crypt.genSalt(6000);

// Create a hashed password
auto crypted = "hunter2".crypt(salt);

// Save hashed password to database or password file
// ...

// Test a password at login
auto password_guess = "hunter2";
assert (password_guess.canCryptTo(crypted));

Installation

It's currently not on the DUB registry because of issue #471. For now, you'll have to clone this repository and use dub add-local. Alternatively, don't use dub at all and just make sure source/ is in your (-I) import path.

passwd requires libbsd for portable entropy generation. It's available on many systems. For example, you can install it on Debian with sudo apt-get install libbsd0. If you're not using dub, you'll need to add -L-lbsd to your D compiler command line.

Documentation

The documentation isn't online yet for the same reason the package isn't on the DUB registry. You can build the docs yourself using dub build --build=docs.

Contributing

New algorithms are welcome as long as they're well standardised for use in crypt(3) implementations (and preferrably already in popular libcs). Please provide thorough test suites, and add links to algorithm specifications.

This library is licensed under the Mozilla Public License version 2.0. Parts of the library might be relicensed for inclusion in D's standard libraries in future. Don't contribute patches if you're not okay with them being relicensed that way.

Authors:
  • Simon Arneaud
Dependencies:
none
System dependencies:
libbsd (https://gitlab.freedesktop.org/libbsd/libbsd)
Versions:
0.3.1 2021-Apr-17
0.3.0 2020-Jul-20
0.2.0 2020-Jul-14
0.1.0 2020-Jul-11
~master 2021-Apr-17
Show all 5 versions
Download Stats:
  • 0 downloads today

  • 1 downloads this week

  • 1 downloads this month

  • 114 downloads total

Score:
0.0
Short URL:
passwd.dub.pm