Unverified Commit 2458ee17 authored by Minseong Choi's avatar Minseong Choi 💬
Browse files

docs(bootstrap): say auth_source tags are permanent and order is trust 

Both config templates the installer writes, the nano felis.toml and
the comment above [[auth_source]] in the generated felis tomls, now
state two things an operator editing the list needs to know.

A tag is hashed verbatim into every player UUID of its source, with no
case folding, so renaming it gives all of those players new UUIDs and
orphans their data, links and bans. The list is scanned in order and
the first source that validates wins, so order is trust, and a
compromised root has to be removed, not moved down. Comment text only.
parent 6794e66c

deploy/bootstrap.sh

+9 −0
Changes for deploy/bootstrap.sh: 9 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -2037,6 +2037,10 @@ ${smtp_block} 
# append as namespace-rewritten guests. A fresh install federates LittleSkin. Edit the

# list in ${STATE_DIR}/felis.host.toml and rerun the installer; re-runs keep it as it

# is, and with no [[auth_source]] at all the server is Mojang-only.

# Order is trust: the first source that answers 200 wins, so list the most trusted roots

# first, and remove a compromised root rather than just moving it down.

# A tag is permanent: it is hashed into every player UUID of its source, so changing it

# (even its case) gives all of them new UUIDs and orphans their data, links and bans.

${auth_source_blocks}

EOF

}
@@ -2368,6 +2372,11 @@ write_nano_config() { 
# Add each third-party Yggdrasil root below (priority = order). url is the FULL

# hasJoined endpoint. After editing:  sudo systemctl restart felis-nano

#

# Order is trust: the first source that answers 200 wins, so list the most trusted roots

# first, and remove a compromised root rather than just moving it down.

# tag is permanent: it is hashed into every player UUID of its source, so changing it

# (even its case) gives all of them new UUIDs and orphans their data, links and bans.

#

# prefix is required, 1-4 letters/digits, unique per source. A player of this source

# whose name belongs to a Mojang account joins as PREFIX_name (LS_steve) instead —

# otherwise the proxy, which keys its player list on the NAME, refuses to have both