Accedere e connettersi

Accesso

Il banco funziona senza account. Si indica un broker, si preme Connect e si guarda. Per questo non serve niente di quello che segue.

Un account dà tre cose: broker che si scelgono per nome invece di scrivere un indirizzo, un modo per tornare a una sessione aperta prima, e — per un tecnico esterno — il gateway che gli è stato dato.

Premere Sign in, in alto a destra, e dare email e password. Sign out è nello stesso posto.

Gli account si creano su invito. Un amministratore scrive un link. Chi lo apre sceglie un nome e una password di almeno dieci caratteri, e l'account esiste. Il link vale sette giorni e funziona una volta sola.

Si può anche chiedere un account. Premere Ask for an account, accanto a Sign in in alto a destra. Dare il proprio nome, la propria email e il motivo, e premere Send the request. Ogni amministratore riceve un'email. Se uno di loro approva la richiesta, si riceve per email il link qui sopra. Se nessuno la approva, non si riceve niente.

Per cambiare la propria password, premere Change my password, accanto al proprio nome in alto. Chiede quella attuale: è questo che impedisce a una pagina lasciata aperta su una scrivania di bastare per portarvi via l'account. Tutti gli altri browser che hanno fatto l'accesso come voi vengono disconnessi; quello che state usando no.

Su un telefono il vostro nome in alto è un pulsante. Premetelo per Change my password, Help e Sign out.

Chi non riesce proprio ad accedere ha bisogno di un amministratore: vedere Quando qualcuno non riesce ad accedere.

I ruoli sono tre.

Ruolo	Che cosa può fare
Amministratore	Tutto quello che può un utente, più le schede Users e Presets qui sotto. Vede anche tutte le sessioni aperte sul banco.
Utente	Sceglie un broker dall'elenco, oppure lo scrive, come chi non ha account. Vede le sessioni che ha aperto.
Tecnico esterno (contractor)	Sceglie uno dei gateway che un amministratore gli ha dato, e nient'altro.

Quello che vede un tecnico esterno è più stretto, e di proposito. Di solito è una persona esterna, in un edificio per un pomeriggio.

• L'elenco contiene solo i broker che gli sono stati dati, indicati per edificio e gateway. Niente indirizzo, niente porta, niente password.
• Il campo Gateway non c'è. Il banco usa i gateway dell'incarico, qualunque cosa chieda la pagina.
• Il campo AES-128 keys non c'è. Il banco tiene le chiavi dei contatori dell'incarico, e decodifica con quelle.
• Un contatore che non è nell'incarico non viene registrato: né nella tabella, né in Explore, né in Export. Un gateway sente anche i contatori dei vicini, e quelli sono di qualcun altro.
• Il registro Gateway raw data non si vede, e non ne viene tenuto niente.
• Non c'è Share: una sessione che non può restringere non è sua da passare ad altri.

A un tecnico esterno a cui non è stato dato ancora niente la pagina dice Nothing has been assigned to you yet.

Connettersi

Compilare il modulo e premere Connect.

Campo	Che cosa scrivere
Choose	Facoltativo, ed è una scorciatoia per tutto il resto: un solo elenco con i Presets che può usare chi ha fatto l'accesso e i broker a cui questo browser si è già connesso, sotto Recent. Vedere sotto.
Broker	Il nome host del broker, per esempio broker.example.net.
Port	8883 come predefinito.
TLS	Spuntato come predefinito. Togliere la spunta per un broker senza TLS, di solito sulla porta 1883.
Username, Password	L'account del broker.
Gateways	L'id del gateway, per esempio 700123. Per un edificio con più gateway, scriverli tutti, separati da virgole: 700123, 700456. Lasciarlo vuoto per sentire tutti i gateway del broker. Al massimo 50.
Topic prefix	Dove pubblicano i gateway. Vuoto vuol dire nrg/qgw6direct, il valore predefinito di Qundis.
AES-128 keys	Facoltativo. Una chiave per riga, 32 caratteri esadecimali ciascuna, per i contatori che cifrano.
Meters to expect	Facoltativo. Le matricole dei contatori che dovrebbero esserci, separate da spazi, virgole o righe: va bene anche un elenco copiato da un foglio di calcolo. Una matricola di meno di otto cifre riceve gli zeri davanti. Vedere Contatori attesi.

La connessione la apre il server, non il browser. Il banco si iscrive poi ai topic in salita di ogni gateway indicato, o di tutti i gateway se il campo è vuoto.

L'elenco Choose contiene tutte e due le scorciatoie, in due gruppi con il loro nome: Presets, i broker elencati da un amministratore, e Recent, i broker a cui questo browser si è connesso. Un preset si legge nome · indirizzo:porta · gateway, e una voce di Recent allo stesso modo senza il nome. Fino al 2026-09-23 erano due elenchi affiancati, e bisognava sapere di quale dei due tipi era un broker prima di poterlo cercare.

Scegliendo un broker dall'elenco (con l'accesso fatto), i campi attenuati mostrano l'indirizzo, la porta, il TLS, il nome utente e il prefisso di quel broker, così si vede a che cosa ci si connette. Il campo della password resta vuoto e dice Kept by the bench: la pagina non riceve mai una password. Scegliendo di nuovo Type a broker below, i campi mostrano quello che si era scritto.

Un broker che indica i suoi gateway li decide. Il campo Gateways li mostra e non si può cambiare: quel broker è elencato per quei gateway, e il banco usa quelli qualunque cosa chieda la pagina. Per osservare un altro gateway sullo stesso server, si sceglie o si elenca un broker per quello — Clone, nella scheda Presets, è il modo rapido. Un broker senza gateway lascia il campo libero: si può scrivere un gateway o lasciarlo vuoto per sentirli tutti.

Lo stesso vale per i contatori. Un broker elencato con Meters to expect riempie quel riquadro, una matricola per riga, e lo chiude: la sessione attende quei contatori. Un broker elencato senza lascia il riquadro libero.

Per osservare un broker sulla macchina del banco, scrivere localhost e la porta 1883, e togliere la spunta a TLS. Usare un account MQTT di quel broker; lo ha chi gestisce il banco. Un account che non è un account MQTT viene rifiutato dal broker.

Che cosa ricorda il browser. La volta successiva broker, porta, TLS, nome utente, gateway e prefisso sono già compilati con l'ultima connessione. Il browser ricorda le ultime cinque: sceglierne una dal gruppo Recent dell'elenco Choose, sopra il modulo, per compilare i campi. La pagina non ricorda mai la password né le chiavi. Il gestore di password del browser può salvare la password: accettare la sua proposta dopo la connessione, e la volta successiva la compila. Se si sceglie da Recent un broker o un nome utente diverso, la password viene cancellata; fare clic sul campo per scegliere quella salvata. Le chiavi vanno scritte ogni volta. Un preset non viene aggiunto a Recent, perché è già nell'elenco, e scegliere una voce di Recent riporta l'elenco su Type a broker below, perché è un'azione e non una scelta in cui il modulo resta.

Le tre schede, e la sessione

Un amministratore vede tre schede in alto: Session, Users e Presets. Tutti gli altri non vedono nessuna scheda, perché Session è l'unica che hanno.

• Session è dove ci si connette, e dove sono elencate le sessioni che si possono riprendere.
• Users sono gli account e gli inviti.
• Presets è l'elenco dei broker, con quello che si osserva su ciascuno, che chiunque può scegliere per nome.

Una sessione è una pagina a sé. Una volta connessi, le schede non ci sono più e la pagina è la sessione. ← Back in alto riporta le schede e lascia la sessione aperta — così si può aggiungere un broker, o invitare qualcuno, senza rinunciare a quello che si sta osservando. Disconnect è un'altra cosa: chiude la sessione, e quello che ha sentito resta sulla pagina.