bcrypt-tool icon indicating copy to clipboard operation
bcrypt-tool copied to clipboard

A CLI tool for bcrypt - hash a password, determine if password matches a hash, compute cost of hash

bcrypt-tool

bcrypt-tool is a dandy CLI tool for generating and matching bcrypt hashes

Go Report Card Build Status GoDoc NetflixOSS Lifecycle GitHub

Get it from the Snap Store

Project Overview

Module gophers.dev/cmds/bcrypt-tool provides a simple command line tool.

Getting Started

Install from SnapCraft

The bcrypt-tool command can be installed as a snap

$ sudo snap install bcrypt-tool

Build from source

The bcrypt-tool command can be compiled by running

$ go get gophers.dev/cmds/bcrypt-tool

Examples

Generate Hash from a Password

$ bcrypt-tool hash p4ssw0rd

Generate Hash from a Password with Cost

$ bcrypt-tool hash p4ssw0rd 31

Determine if Password matches Hash

$ bcrypt-tool match p4ssw0rd $2a$10$nWFwjoFo4zhyVosdYMb6XOxZqlVB9Bk0TzOvmuo16oIwMZJXkpanW

note: depending on your shell, you may need to escape the $ characters

Determine Cost of Hash

$ bcrypt-tool cost $2a$10$nWFwjoFo4zhyVosdYMb6XOxZqlVB9Bk0TzOvmuo16oIwMZJXkpanW

note: depending on your shell, you may need to escape the $ characters

Usage

bcrypt-tool [action] parameter ...

Actions

  • hash [password] <cost> Use bcrypt to generate a hash given password and optional cost (4-31)

  • match [password] [hash] Use bcrypt to check if a password matches a hash

  • cost [hash] Use bcrypt to determine the cost of a hash (4-31)

Contributing

The gophers.dev/cmds/bcrypt-tool module is always improving with new features and error corrections. For contributing bug fixes and new features please file an issue.

License

The gophers.dev/cmds/bcrypt-tool module is open source under the MIT license.