A portal session names a person, not whoever enrolled

Remote access used to collapse every portal session onto the account that
performed the enrolment. That was the only thing it could do while nothing
here knew who was at the other end, and it is why letting a second person
in meant handing them the first one's account.

`user.portal_sub` is where a portal identity meets a local one: set for the
enrolling superuser at enrolment, and for each person a superuser admits
afterwards through Settings -> Remote access -> Add remote user. The code
they type comes from the newcomer's own portal account, and it is redeemed
against the hub with this installation's tunnel credential rather than with
a portal session, so being let in is not itself the power to let others in.
The account created is never a superuser, which closes the same door from
this side.

A proxy token now resolves through that mapping and nowhere else. An
identity nobody mapped resolves to no user rather than falling back on the
enroller, so deleting the local row under Admin -> Users is the whole of
the revocation: it bites on a credential already in flight, and it does not
wait on the portal being reachable to be told. Telling the portal is best
effort for exactly that reason.

The cost is stated where it lands, in DEPLOY.md: an installation enrolled
before this has no mapping, so its owner reconnects once with a fresh code.
Panels and the health summary still act as the enrolling account - neither
of them is a person, and neither gained a way to name one.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This commit is contained in:

stroblme

2026-08-21 11:34:01 +02:00

co-authored by

Claude Opus 5

parent 3e084c06cf

commit c27ed98cb8

14 changed files with 553 additions and 64 deletions

									
										backend/tests/conftest.py
									
		+8
		
												View File
												
				@@ -107,6 +107,14 @@ def enrolled(

				            portal_account=settings.FIRST_SUPERUSER,

				        )

				    )

				    # Enrolment also maps the enrolling account to the portal identity that

				    # owns the installation; without it a portal session resolves to nobody.

				    local_user.portal_sub = "portal-user-1"

				    db.add(local_user)

				    db.commit()

				    yield local_user

				    local_user.portal_sub = None

				    db.add(local_user)

				    db.commit()

				    cloud_config.delete()

				    settings.CLOUD_CONFIG_FILE = original