Account, preset e limiti

Le schede Users e Presets

Gli amministratori vedono due schede in più. Nessun altro le vede. La scheda Loggers, per amministratori e utenti, ha una pagina a parte.

La scheda Presets

Un preset è un broker e quello che si osserva su di esso: i suoi gateway, i contatori attesi e le chiavi AES. Si sceglie per nome nella scheda Session. L'elenco si chiamava Brokers fino al 2026-09-23, quando aveva smesso di essere un elenco di broker.

Un preset si sceglie per nome. Il banco tiene l'indirizzo del broker, il suo account e la sua password, e alla pagina non viene detto niente di tutto questo — nemmeno alla pagina di un amministratore. Una password già registrata compare come kept.

Add a preset apre una finestra con i campi. Solo due vanno per forza riempiti.

Campo	Che cosa scrivere
Name	Quello che l'elenco mostra. Di solito l'edificio. Obbligatorio.
Address	Il nome host del broker. Obbligatorio.
Port	Facoltativo. Vuoto significa 8883 con TLS e 1883 senza, e il campo dice quale.
TLS	Attivo di default.
User, Password	L'account del broker. Facoltativi, per un broker che non li chiede.
Topic prefix	Facoltativo. Vuoto significa nrg/qgw6direct, il valore Qundis di default, e il campo lo mostra. L'elenco non ha una colonna per questo: un preset su un altro prefisso lo dice dopo l'indirizzo.
Gateway	Facoltativo. I gateway per cui si osserva questo broker. Se ne possono scrivere più d'uno, separati da virgole. Una sessione su questo broker osserva quelli e nessun altro; se qui non ce n'è nessuno, sceglie chi si connette.
Meters to expect	Facoltativo. Le matricole che quell'edificio ha, separate da spazi, virgole o righe. Una sessione su questo broker attende queste e non le può cambiare.
AES-128 keys	Facoltative. Le chiavi dei contatori che quel gateway sente, una per riga.

Il gateway e le chiavi fanno risparmiare digitazione, e funzionano in modo diverso. Il gateway non è un segreto: scegliendo questo broker viene scritto nel campo Gateway della scheda Session, dove si vede, si può cambiare, o si può svuotare per sentire tutti i gateway di quel broker. Le chiavi sono segrete — alla pagina non vengono mai dette — quindi è il banco ad aggiungerle alla sessione, e la scheda Session dice soltanto quante ne sono registrate. Le chiavi scritte lì si usano in più di queste, non al posto loro.

Change apre la stessa finestra, già riempita. Il campo della password è vuoto e dice kept unless you type one: lasciandolo così, la password registrata resta. Per le chiavi vale lo stesso — il riquadro è vuoto e l'etichetta dice quante ne sono registrate — e Remove the keys è il modo per non averne nessuna.

Clone apre la stessa finestra come nuovo broker, già riempita da quella riga, con il nome pronto da riscrivere. La password e le chiavi vengono con lui, anche se alla pagina non vengono mai dette: le copia il banco. Scrivendo una password se ne usa un'altra. È il modo rapido per elencare un server una volta per gateway: si clona la riga, si cambiano il nome e il campo Gateway, e si salva.

Delete toglie la riga. Una sessione già aperta su quel broker continua.

Un nome si usa una volta sola. Lo stesso broker può comparire due volte con due nomi, per due edifici con prefissi o account diversi, oppure per due gateway sullo stesso server. L'elenco della scheda Session dice quali gateway tiene ogni voce, dopo l'indirizzo, così due voci dello stesso server si distinguono.

La scheda Users

Invite somebody apre una finestra. Si danno un indirizzo email e un ruolo, e si preme Write an invitation.

La finestra resta aperta, con il link, ed è voluto: il banco ne tiene solo un hash, quindi il link esiste una volta sola e da nessun'altra parte. Copiarlo prima di premere Close — niente può mostrarlo di nuovo. Mandarlo alla persona da soli: il banco non manda per email un invito scritto qui. Un invito vale sette giorni e funziona una volta sola, e si può cancellare prima che venga usato.

La tabella People elenca gli account. Disable impedisce a un account di accedere e lascia dove sono la sua riga e i suoi incarichi; Enable lo riattiva. Un amministratore non può disabilitare il proprio account.

Richieste di un account

Chi non ha un account può chiederlo con Ask for an account, accanto a Sign in. Dà un nome, un'email e un motivo. Ogni amministratore riceve un'email, con un link a questa scheda. La richiesta aspetta in cima alla scheda, sotto Requests for an account.

• Approve chiede un ruolo, e Contractor è quello proposto. Scrive un invito normale per quell'email e quel ruolo, e manda alla persona il link per email. Dove il banco non può mandare email, la finestra mostra il link: copiarlo e darlo alla persona, come per un invito scritto a mano.
• Reject chiede conferma, con il nome. Alla persona non arriva niente. L'email di una richiesta l'ha scritta chi chiede, e può essere di un altro.

Una richiesta per un'email che ha già un account, o che ha già una richiesta in attesa, non viene tenuta. La persona riceve la stessa risposta in tutti e due i casi, così il modulo non dice chi ha un account qui. Da un indirizzo si mandano tre richieste in un'ora, e ne aspettano al massimo venti insieme. Una richiesta si cancella dopo 30 giorni, con risposta o senza.

Per dare dei gateway a un tecnico esterno prima che accetti, si usa l'invito scritto dall'approvazione, come per ogni altro invito.

Quando qualcuno non riesce ad accedere

Reset the password sulla sua riga gli scrive una nuova strada per entrare. Il banco non manda posta, quindi questa è l'unica: non esiste un password dimenticata che una persona possa premere da sola.

Copiare il link e darglielo. La persona lo apre, sceglie la propria password, e con lo stesso passaggio è dentro. La sua password non la sapete, ed è sua dal primo uso.

• Funziona una volta sola, e per sette giorni.
• Scriverlo non interrompe nessuno. La persona può essere ancora al lavoro, e il link da solo non cambia niente.
• Usarlo chiude tutte le sessioni di quell'account. Una password si cambia perché la vecchia strada non è più affidabile, quindi una pagina rimasta aperta da qualche parte è proprio il motivo del cambio.
• Un secondo link fa smettere di funzionare il primo, così uno scritto per sbaglio si può sostituire.
• Un account disabilitato non rientra con un link scritto prima che venisse disabilitato.

Un amministratore può farlo anche per il proprio account. Disabilitare sé stessi è rifiutato, perché potrebbe chiudere fuori tutti dal banco; scegliersi una password nuova no.

Che cosa è stato dato a un tecnico esterno

La riga di un tecnico esterno ha un pulsante Gateways. Apre una finestra con quello che ha adesso, una riga per ciascuno: il broker, i gateway e i contatori, con (key) dopo un contatore per cui il banco tiene una chiave. Remove in fondo alla riga toglie quello, e chiede conferma.

Sotto, Give another:

Campo	Che cosa scrivere
Broker	Uno dei preset elencati, per nome.
Gateways	Un gateway, o più d'uno separati da virgole. Il riquadro parte dai gateway che quel broker tiene, e si può cambiare.
Meters	Facoltativo. Uno per riga, come matricola o matricola=chiave, dove la chiave è la chiave AES-128 del contatore.

Se non si indica nessun contatore, l'incarico è ogni contatore che quei gateway sentono — compresi i contatori dei vicini, che un gateway sente. Se questo conta, indicare i contatori.

Un tecnico a cui sono stati dati più gateway può osservarli tutti in una sola sessione, oppure indicarne alcuni. Un gateway che non gli è stato dato viene rifiutato, esattamente come un broker che non gli è stato dato.

A un tecnico a cui non è stato dato niente non si apre nessuna sessione.

Una chiave non viene mai mostrata di nuovo. Un amministratore che ne ha scritta una vede solo che c'è.

Limiti

Sessioni aperte sul banco	24
Sessioni dallo stesso indirizzo	4
Attesa della risposta del broker	10 secondi
Una sessione che nessuno legge	finisce dopo 15 minuti
Qualunque sessione	finisce dopo 12 ore
Telegrammi disponibili dopo la fine	4 ore, oppure 7 giorni per una sessione aperta da un amministratore
Una finestra prenotata dalla pagina	da 5 a 60 minuti
Gateway indicati in una sessione	50
Contatori attesi in una sessione	2.000
Righe del registro del gateway	le ultime 200
Messaggi conservati per un gateway	i 5.000 più recenti
Telegrammi tenuti da una sessione	gli ultimi 10.000
Logger, in funzione o no	20
Persone che guardano una sessione con il link	10
Richieste di un account da un indirizzo	3 in un'ora
Richieste di un account in attesa insieme	20

Che cosa può mandare il banco a un gateway: l'avvio e l'arresto di una finestra, un elenco di contatori, un riavvio, una nuova misura del segnale, la pianificazione, e — solo per un amministratore — le quattro azioni sopra.

Perché l'accesso è facoltativo

Per chi porta la password di un broker, è il broker a controllare chi è: senza quella password non ci si connette a niente. Una password anche sul banco sarebbe un secondo segreto, e non direbbe niente su chi può usare quale broker. Quindi la pagina si apre per chiunque, ed è la strada più corta per guardare un gateway di cui si hanno già le credenziali.

Un account risponde a una domanda diversa — quale broker può usare questa persona, e quale gateway — e a questa il broker non sa rispondere. Il tecnico esterno è il caso per cui è stato aggiunto: una persona da fuori, in un edificio per un pomeriggio, a cui non va data la password MQTT dell'edificio.

Nel log finisce la connessione: che una sessione è stata aperta, da quale indirizzo, verso quale broker e, se chi l'ha aperta aveva fatto l'accesso, chi è. Ogni modifica fatta da un amministratore finisce nel log con l'indirizzo da cui è arrivata.

La password di un broker scritta nel modulo serve a tenere aperta la connessione e sparisce quando si chiude; le chiavi scritte nel modulo spariscono con la sessione. La password di un broker e le chiavi di un tecnico esterno registrate sono cifrate nella base dati, quindi una copia di un backup non porta né l'una né le altre.