jcoffey-dev
2e2724c55c
The dashboard's link to Stalwart's own administration needed
STALWART_ADMIN_URL, which an operator had to know to set. Everything it
holds can be read from the server:
- the origin is the host Stalwart advertises in its own session URLs, the
one people reach it at even when ihasmail talks to it on a private
address;
- the prefix is where its web interface application is installed. The
production server's x:Application reads "Stalwart Web Interface",
enabled, urlPrefix {"/admin", "/account"}, and /admin is also what
Stalwart writes at first boot.
So, for an account that administers, the account info fetch now asks the
account's own server for its applications and links to origin + /admin/.
An installation whose web interface is disabled or moved gets no link; an
administrator who may not read applications gets Stalwart's default
/admin. It is cached with the rest of the account info.
STALWART_ADMIN_URL and a servers file entry's adminUrl still win, for an
administration that lives somewhere else. A routed domain without one now
takes what its own server said, never the default server's.
32 lines
1.5 KiB
JSON
32 lines
1.5 KiB
JSON
{
|
|
"_comment": [
|
|
"Optional: which Stalwart a domain signs in to.",
|
|
"",
|
|
"STALWART_URL stays required and stays the default. This file only adds",
|
|
"domains that go somewhere else -- delete it and nothing changes.",
|
|
"",
|
|
"Point at it with STALWART_SERVERS_FILE=/etc/ihasmail/servers.json and mount",
|
|
"it read-only. Read once at startup, so editing it means restarting.",
|
|
"",
|
|
"A domain that is not listed here, and a bare username with no domain at",
|
|
"all, go to STALWART_URL. A domain that IS listed never falls back: if its",
|
|
"server is unreachable that sign-in fails, because falling back would",
|
|
"authenticate somebody against a server their domain was routed away from.",
|
|
"",
|
|
"Keys are lower-cased and stripped of a trailing dot when read. Malformed",
|
|
"JSON, a duplicate domain, or a value that is not an http(s) URL stops the",
|
|
"server at startup rather than failing quietly at somebody's sign-in.",
|
|
"",
|
|
"ihasmail's Administration dashboard links to each server's own",
|
|
"administration, found from the server. A value may instead be an object",
|
|
"that overrides where it is: {\"url\": ..., \"adminUrl\": ...}.",
|
|
"STALWART_ADMIN_URL is the same for the default server. A listed domain is",
|
|
"never pointed at the default server's administration.",
|
|
"",
|
|
"Docs: https://docs.ihasmail.org/configure/#several-stalwart-servers"
|
|
],
|
|
|
|
"example.com": "https://mail.example.com",
|
|
"customer-b.test": { "url": "https://jmap.customer-b.test", "adminUrl": "https://admin.customer-b.test" }
|
|
}
|