vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gateway): document custom 401 page in HTTP Basic auth section

Browse source
This commit is contained in:
iris 2026-06-05 16:24:23 +02:00 • committed by mara
commit c1d1328426
1 changed files with 11 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

11
docs/gateway.md
View file

@ -466,3 +466,14 @@ follow-up.
display in the credential dialog. Defaults to `"hyperhive"`. Must not display in the credential dialog. Defaults to `"hyperhive"`. Must not
contain `"` or `$`. contain `"` or `$`.
**Custom 401 page:** when credentials are absent or wrong, nginx serves
a Catppuccin-styled `unauthorized.html` page (built into the same Nix
derivation as the agent error pages) that tells the operator which
`hivectl` command to run to create a user. The response status is still
`401` (`error_page 401 =401 /__hive_auth_unauthorized`) so browsers
present the login dialog on the first visit — users who dismiss the
dialog see the human-readable hint. The internal exact-match location
(`= /__hive_auth_unauthorized`) beats `location /` in nginx's prefix
ordering, preventing the subrequest from looping back through
`auth_basic`.