Skip to content

Releases

goraz v0.2.0

goraz v0.2.0 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Nov 19:12
e667577

A refactor release: clearer errors, safer writes, far fewer allocations on hot paths, and much broader tests. It changes a few Go API names and the command-line exit code for wrong usage. The file format is unchanged.

goraz has not had an independent security audit. Don't make it the only protection for highly sensitive credentials. Read what it does not defend against. The Go API and command-line flags may change before version 1.

Breaking changes and how to migrate

Breach check moved to password/hibp. Programs that don't use it no longer link net/http.

// v0.1.x
h := password.NewHIBP()
// v0.2.0
import "github.com/mtnaskari/goraz/password/hibp"
h := hibp.New() // *hibp.Client; Count works as before.

KDF profiles have a public type, vault.Profile. CreateOptions.Profile, RekeyOptions.Profile and Vault.ChangePassphrase took a type from an internal package, so callers outside the module could only pass the zero value. Leave it empty for the default, or name a profile:

vault.CreateOptions{Passphrase: pass, Profile: vault.ProfileStrong}
v.ChangePassphrase(pass, nil, vault.ProfileStandard, false)

vault.Options.State is replaced by vault.Options.Memory. The old field took an internal type. To keep rollback state in memory instead of on disk, share one *vault.MemoryState across opens:

mem := vault.NewMemoryState()
v, err := vault.Open(path, cred, vault.Options{Memory: mem})

vault.VaultIDFromFile is renamed vault.IDFromFile, and returns [vault.IDSize]byte. Rename the call; the value is the same.

Command line: wrong usage now exits with code 2 instead of 1, and a command refuses arguments it doesn't take. Scripts that only check for a non-zero exit code are unaffected.

Other changes

  • Errors: new exported errors to check with errors.Is, such as vault.ErrNotVault, vault.ErrNotDurable and service.ErrUnsafeKeyFile.
  • Durability: waiting for a lock gives up after 10 seconds, new directories are synced, and the audit log refuses writes after a failed sync.
  • Performance: vault.Get makes about 97% fewer allocations, the JSON audit sink makes none, and parsing a token makes 2 allocations instead of 11.
  • Tests: Wycheproof and Argon2id reference vectors, a corpus of damaged vault files, new fuzz targets and allocation budgets.
  • Documentation: the Docker guide now mounts the service file's directory, because a single-file bind mount never sees an update. goraz-example is a complete service that runs the documented setup.

Vaults, service files and tokens from v0.1.x work unchanged. The full list is in the changelog.

Install

go install github.com/mtnaskari/goraz/cmd/goraz@v0.2.0

Or download a binary below, then check it:

sha256sum --check --ignore-missing SHA256SUMS
gh attestation verify goraz_v0.2.0_linux_amd64 --repo mtnaskari/goraz

macOS and Linux only. Start here.

goraz v0.1.1

goraz v0.1.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Nov 02:57
2b4b6e0

A security update that builds goraz with a Go release containing the fix for GO-2026-6859.

goraz has not had an independent security audit. Don't make it the only protection for highly sensitive credentials. Read what it does not defend against. The Go API and command-line flags may change before version 1. The v1 file format is unchanged.

Changes

  • Security: release binaries are built with Go 1.27.4. GO-2026-6859 (CVE-2026-97054) is a header race in the net/http standard library package, which can crash an HTTP/1 server. goraz runs no HTTP server: its only use of net/http is the opt-in breach check, goraz report --hibp.
  • Go version: the module now requires Go 1.26.11 or later, so programs that import goraz also build with a fixed standard library.
  • Documentation: the site at mtnaskari.github.io/goraz has a new layout, and the README names the author.

Vaults, service files and tokens from v0.1.0 work unchanged.

Install

go install github.com/mtnaskari/goraz/cmd/goraz@v0.1.1

Or download a binary below, then check it:

sha256sum --check --ignore-missing SHA256SUMS
gh attestation verify goraz_v0.1.1_linux_amd64 --repo mtnaskari/goraz

macOS and Linux only. Start here.

goraz v0.1.0

goraz v0.1.0 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 06 Nov 20:38
aa71956

The first public release of goraz: an encrypted vault, API token manager and password manager for Go services and the command line. It needs no server.

This is an early release, and goraz has not had an independent security audit. Don't make it the only protection for highly sensitive credentials. Read what it does not defend against. The Go API and command-line flags may change before version 1. The v1 file format is frozen by golden tests.

Included

  • An encrypted vault with hidden metadata, version history and tamper and rollback detection
  • Per-service encrypted files, with reload, staleness limits and rotation without an outage
  • API token issuing, verifying, revoking and rotating, with only a keyed hash stored
  • Passwords, passphrases, TOTP and HOTP, automatic clipboard clearing and opt-in breach checks
  • A hash-chained audit log with no names or values

Install

go install github.com/mtnaskari/goraz/cmd/goraz@v0.1.0

Or download a binary below, then check it:

sha256sum --check --ignore-missing SHA256SUMS
gh attestation verify goraz_v0.1.0_linux_amd64 --repo mtnaskari/goraz

macOS and Linux only. Start here.