ric/MailHog
1
0
Fork 0
mirror of https://gitlab.com/ric_harvey/MailHog.git synced 2024-11-23 22:34:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
MailHog/docs/Auth.md
Ian Kent 5c4c753acd Add missing info
2015-05-27 18:11:31 +01:00

1.1 KiB
Raw Blame History

Authentication

HTTP basic authentication is supported using a password file.

See example-auth for an example (the password is test).

Authentication applies to all HTTP requests, including static content and API endpoints.

Password file format

The password file format is:

  • One user per line
  • username:password
  • Password is bcrypted

By default, a bcrypt difficulty of 4 is used to reduce page load times.

Generating a bcrypted password

You can use a MailHog shortcut to generate a bcrypted password:

MailHog bcrypt

Enabling HTTP authentication

To enable authentication, pass an -auth-file flag to MailHog:

MailHog -auth-file=docs/example-auth

This also works if you're running MailHog-UI and MailHog-Server separately:

MailHog-Server -auth-file=docs/example-auth MailHog-UI -auth-file=docs/example-auth

Future compatibility

Authentication has been a bit of an experiment.

The exact implementation may change over time, e.g. using sessions in the UI and tokens for the API to avoid frequently bcrypting passwords.