Account

The Account row of the Account page, connecting the station to its Ganter account through the system browser, the connected and offline states, Sign out, and what the sign-in belongs to.

View as Markdown

The Account row is the first card of the Account page: the station's sign-in to its Ganter account. The sign-in belongs to the station, not to a person: one human signs in once, in the system browser, and every Windows user of the computer shares the session until someone signs the station out. It licenses the runtime (see Subscription) and lets the Feedback form send; it does nothing to the screens, which the local users govern.

The card is read by every identity. Connecting and disconnecting the account takes the Manage local users permission on this connection (the Admin role); without it the card shows why and offers only what does not change the station.

Signed out

Element What it shows or does
Title Sign in to Ganter Lab
Text "Connect this station to your Ganter account. Your web browser opens to sign in securely. The app never sees your password. The sign-in belongs to the station and is shared by every Windows user of this computer."
Note without the permission "An administrator must connect this station's account. Sign in as one from the user chip in the title bar."
Command What it does Greyed when (situation) Not drawn when (role)
Sign in Starts the browser sign-in. Never. The identity lacks Manage local users.
Create an account Opens the Ganter Lab site's sign-in page, which links to registration. On the station's window it opens in the default browser; in a plain browser it opens a new tab. The station's window hands the address to Windows itself, and opens a web address and nothing else, here and wherever else the app sends you outside itself: anything that is not one reports "That is not a web address this station opens. Nothing was opened." Never. Never.

Waiting for the browser

Pressing Sign in turns the card into Waiting for the browser… with the text "Complete the sign-in in the browser window that just opened. Control returns here automatically.", a progress bar and a Cancel button. The app listens on a loopback port for the browser to come back; the password is typed on the site, never in the app. Cancel, closing the browser without finishing, or an error returns the card to the signed-out state, and the error text lands under Connection details below the card.

Signed in

Element What it shows
Name The account's display name, or Ganter account when the profile carries none.
E-mail The account's e-mail address.
State dot and text Green with "Connected to the Ganter server." while the server answers; amber with "Offline, using the saved sign-in; reconnects automatically." while it does not.
Note without the permission "Only an administrator can disconnect this station's account."
Command What it does Greyed when (situation) Not drawn when (role)
Sign out Asks "Signing out disconnects this station's Ganter account for every Windows user of this computer. Sign out?", then releases the station's seat, asks the server to revoke the session, and clears the stored sign-in. Never. The identity lacks Manage local users.

The card's leading edge is tinted with the same state as the dot, so the connection health reads before anything else.

Online and offline

The station stores a refresh token, encrypted for this machine (under %ProgramData%\GanterLab, writable by every local Windows account so that any of them can renew it), together with the last profile and subscription snapshot. At every start the cached identity shows at once and a silent renewal runs in the background: a network failure leaves the station in the offline state with the cached identity, and only an authoritative rejection by the server (the session was revoked, expired, or the account can no longer sign in) clears the sign-in. A session that is used at least once every 90 days never asks for the browser again; a station fully offline for 90 days signs in again through the browser.

Sign-out on the station does not sign the browser out of the site; the site's own session is the browser's.

Connection details

When the last sign-in, renewal or refresh failed, a Connection details expander appears under the card with the error text. It stays visible while the station is otherwise online, so a failed refresh that kept the cached state is not hidden. One message deserves attention: "The server did not issue a refresh token; the sign-in will not survive a restart." means the session lives in memory only.

The temporary identity notice

The station identifies itself to the server by a random id created on first use and kept machine-wide; the seat is granted to that id. When the file holding it cannot be read or written, the station runs on a temporary identity, and the Subscription row leads with a loud critical banner, This station is using a temporary identity:

This computer could not read or write the file that holds its station identity, so it is not recognized as the station your license seat belongs to. A new identity is created every time the app starts, the runtime keeps stopping on the free mode timer, and the account fills up with stations that were never real. Check that the Windows account running Ganter Lab can read and write the folder %ProgramData%\GanterLab, then restart the app. The Events console carries the exact reason under the Licensing source.

The banner shows whether or not the station is signed in, because a station in that condition reads as unlicensed whatever the account says.

What is sent

Step What leaves the station
Browser sign-in The standard authorization-code flow with the Ganter server, requesting identity, e-mail, offline access and subscription reading.
After sign-in, at boot, every 24 hours and at every Account page open The station's registration: its random id, the Windows machine name and, when set, the integrator ID; then a request for the subscription document.
Sign out The seat release and the token revocation, both best-effort.

No hardware fingerprint, no serial number and no local user name is sent. A reformatted disk becomes a new station; the old registration ages out of the account after 90 days without a sign-in.

The demo profile

On the isolated demo profile the card shows a local stand-in: Demo profile, demo@ganterlab.invalid, "Connected to the Ganter server." with nothing behind it. Sign out and Sign in work without a browser and switch the profile between a licensed seat and free mode; nothing reaches the server.

What the row does not do

  • It does not sign a person in. Who is signed in on a screen is the user chip and the Users page; this sign-in is the station's.
  • It does not change what any screen shows or allows. Permissions come from local roles.
  • It does not block anything when it fails. A station that cannot reach the server keeps its cached state and keeps working; the only consequence of not being signed in is the free-mode window.
  • It does not offer sign-in or sign-out to a role without Manage local users, and it does not let a remote browser borrow the administrator at the bench: the permission is read on the connection that presses the button.