Vai al contenuto principale

Impostazioni per gli amministratori

Dove BeeBEEP tiene i suoi file, il file della policy dell'amministratore e le chiavi di beebeep.ini che un amministratore può impostare, con valori e valori predefiniti.

Per: amministratori · Da BeeBEEP 6.0.0 · Aggiornata il

BeeBEEP tiene le impostazioni di ogni installazione in un solo file di testo semplice, beebeep.ini, e legge una policy valida per tutta la macchina da un secondo file, beebeep.rc, che solo un amministratore può scrivere. Questa pagina dice dove si trovano entrambi, quale cartella contiene i dati di un utente, e cosa fa ogni chiave che un amministratore può impostare, con i suoi valori e il suo valore predefinito.

La cartella dei dati

I dati di un utente stanno in una sola cartella: le impostazioni (beebeep.ini), il database cifrato (beebeep.db), i log giornalieri e, quando ne usi uno, beehosts.ini. BeeBEEP sceglie la cartella con la prima di queste regole che si applica:

  1. Il file della policy. DataFolder/Path in beebeep.rc (vedi la policy). Vince su tutto ciò che segue, --data-folder compreso.
  2. La riga di comando. --data-folder=<path>, per quell'esecuzione.
  3. La modalità portatile. Se la cartella che contiene l'eseguibile di BeeBEEP è scrivibile, BeeBEEP usa al suo interno una cartella chiamata beebeep-data, così una copia su una chiavetta USB porta con sé i suoi dati. Non si applica mai su macOS, Android o iOS, e su Windows mai sotto Program Files.
  4. La cartella predefinita del sistema per la configurazione delle applicazioni, sotto MarcoMastroddiSW/BeeBEEP.

Nel file della policy e sulla riga di comando il percorso può contenere la parola {account}, sostituita dal nome dell'account del sistema operativo. Puntalo a una posizione condivisa e ogni account ci ottiene una cartella tutta sua:

[DataFolder]
Path=D:/BeeBEEP/{account}

Del nome dell'account si tengono solo lettere, cifre, -, _, . e spazi. Un percorso più lungo di 240 caratteri, o un {account} su un sistema che non dà alcun nome di account, ferma BeeBEEP all'avvio con un errore; non ripiega mai su un'altra cartella.

Ogni log giornaliero è beebeep-<year>-<month>-<day>.log nella cartella dei dati, e BeeBEEP elimina quelli più vecchi di 7 giorni.

Windows

La cartella dei dati predefinita è %LOCALAPPDATA%\MarcoMastroddiSW\BeeBEEP, una per account, quindi le impostazioni sono in %LOCALAPPDATA%\MarcoMastroddiSW\BeeBEEP\beebeep.ini. Disinstallare BeeBEEP la lascia dov'è (installare su Windows).

Linux

La cartella dei dati predefinita è ~/.config/MarcoMastroddiSW/BeeBEEP, quindi le impostazioni sono in ~/.config/MarcoMastroddiSW/BeeBEEP/beebeep.ini. Il nodo senza interfaccia beebeep-relay usa BeeBEEP-Relay al posto di BeeBEEP, così non condivide mai una cartella, né un database, con il programma desktop dello stesso account.

La policy

beebeep.rc è il file dell'amministratore. BeeBEEP lo legge da un solo posto fisso, mai dalla cartella dell'eseguibile né dalla cartella dell'utente, così che solo un account che può scrivere lì possa impostare una policy.

SistemaPosizione
Windows%ProgramData%\BeeBEEP\beebeep.rc
macOS/Library/Application Support/BeeBEEP/beebeep.rc
Linux/etc/beebeep/beebeep.rc

Il file è un file INI. Quando non esiste, non si applica nessuna policy. Contiene la cartella dei dati vista sopra, gli interruttori dei plugin, le chiavi degli host, le cerchie e le finestre di tempo per modificare un messaggio, qui sotto. Un beehosts.ini nella stessa cartella viene letto anche quando beebeep.rc non esiste (vedi il file beehosts.ini). Su un computer, File > Apri la cartella delle risorse apre questa cartella una volta che esiste; finché non esiste, apre la cartella in cui è installato BeeBEEP.

Gli interruttori dei plugin

Queste cinque chiavi si leggono solo da beebeep.rc, mai da beebeep.ini e mai dalla riga di comando, così un utente non può ribaltare la scelta di un amministratore. Un booleano si scrive true o false, yes o no, on o off, 1 o 0, in maiuscole o minuscole; un'altra parola lascia il valore predefinito e scrive un avviso nel log.

[Plugins]
Enabled=true
DisabledCategories=game
AllowScreenCapture=true
AllowUnsigned=false
AllowExternal=false
DataFolderFirst=false
ChiaveValoriPredefinitoCosa fa
Enabledbooleanotruefalse non carica nessun plugin: non viene esaminata nessuna cartella dei plugin e a ogni invito a un plugin che arriva si risponde che non è disponibile, senza mostrare nulla all'utente
DisabledCategoriesgame, utility, communication, separati da virgolenessunaun plugin di una categoria elencata non viene mai caricato, e un invito a uno di essi riceve come risposta che non è disponibile, senza mostrare nulla; una parola sconosciuta viene ignorata, con un avviso nel log
AllowScreenCapturebooleanotruefalse toglie ogni modo di usare un plugin che cattura lo schermo, come condividerlo: non viene mai offerto, e a un invito a usarlo si risponde che non è disponibile; gli altri usi del plugin restano, e un plugin senza altri usi non viene caricato
AllowUnsignedbooleanofalsetrue carica una libreria di plugin senza una firma valida; solo per lo sviluppo
AllowExternalbooleanofalsetrue registra i plugin esterni, programmi che BeeBEEP avvia e con cui parla; se è disattivato, BeeBEEP non avvia nessun programma
DataFolderFirstbooleanofalsetrue preferisce un plugin nella cartella dei dati dell'utente alla copia installata con BeeBEEP, per provare una nuova build di un plugin; un plugin ha comunque bisogno di una firma valida; solo per lo sviluppo

Disattivare le chiamate vocali

Le chiamate vocali arrivano con BeeBEEP come plugin Call, della categoria communication. Per disattivarle su un computer, elenca quella categoria nel suo beebeep.rc:

[Plugins]
DisabledCategories=communication

Il plugin Call allora non viene caricato: il pulsante del telefono non compare in nessuna chat, e a una chiamata verso questo computer si risponde che non è disponibile, senza mostrare nulla al suo utente; chi chiama legge che questa persona non ha Call. Per disattivare insieme chiamate e giochi, elenca entrambe: DisabledCategories=communication, game. Enabled=false disattiva tutti i plugin, chiamate comprese.

Limitare BeeBEEP a un elenco di computer

Altre tre chiavi di beebeep.rc, lette solo da lì, decidono come BeeBEEP usa beehosts.ini (vedi il file beehosts.ini). Il loro elenco è la copia di beehosts.ini dell'amministratore, quella nella stessa cartella di beebeep.rc, mai quella dell'utente. I booleani si scrivono come per gli interruttori dei plugin.

[HostsFile]
IgnoreUserFile=true
AcceptOnlyFromListed=true
AnnounceOnlyToListed=true
ChiaveValoriPredefinitoCosa fa
IgnoreUserFilebooleanofalsetrue legge solo il beehosts.ini dell'amministratore; quello nella cartella dei dati dell'utente viene ignorato
AcceptOnlyFromListedbooleanofalsetrue si collega solo con i computer elencati dal file dell'amministratore, in entrambe le direzioni; un annuncio da un altro indirizzo viene ignorato, e a un utente che aggiunge a mano un altro indirizzo viene detto che l'amministratore non lo permette
AnnounceOnlyToListedbooleanofalsetrue non invia nulla in broadcast o in multicast (e non pubblica BeeBEEP con Bonjour); BeeBEEP si annuncia solo ai computer e alle reti elencati dal file dell'amministratore

Un computer è elencato dal suo indirizzo (qualsiasi porta), da una riga di rete che contiene il suo indirizzo, o da un nome host, all'indirizzo che il nome ha quando BeeBEEP lo cerca: all'avvio, e ogni volta che la sua rete cambia. Finché la prima ricerca di un nome non ha risposto, quel nome non elenca nulla.

Le chiavi valgono solo per le connessioni di rete dirette. Un utente raggiunto tramite un altro BeeBEEP che fa da relay per entrambi, o via Bluetooth, non è una connessione che questo computer stabilisce, e resta raggiungibile.

Tenere una ricerca dentro la propria rete

Quando l'utente cerca più lontano degli indirizzi più vicini (le distanze Medio e Lontano), BeeBEEP si annuncia anche alle reti accanto alla sua -- i blocchi di 256 indirizzi che la circondano, dentro l'intervallo privato che contiene il suo indirizzo, mai uno pubblico -- così che un ufficio diviso su due reti si ritrovi. Una chiave di beebeep.rc tiene ogni ricerca dentro la rete del computer:

[Network]
SearchBeyondOwnNetwork=false
ChiaveValoriPredefinitoCosa fa
SearchBeyondOwnNetworkbooleanotruefalse tiene le ricerche Medio e Lontano dentro la rete del computer: ne coprono di più quando è più grande di 256 indirizzi, mai le reti accanto

AnnounceOnlyToListed qui sopra vale comunque per ogni ricerca.

Cerchie

Una cerchia è un nome, e le persone che ne condividono una si vedono tra loro (cerchie dice cosa vede un utente). Il modo più semplice per organizzare un ufficio è dare a ogni computer le sue cerchie in beebeep.rc, così che l'utente non debba fare nulla. La chiave si legge da beebeep.rc quando BeeBEEP si avvia.

[Circles]
Names=Doctors, Doctor A
ChiaveValoriPredefinitoCosa fa
Namesnomi di cerchie, separati da virgolenon impostataimposta le cerchie di questa installazione e le blocca: l'elenco compare in Impostazioni > Privacy con Impostate dal tuo amministratore., e l'utente non può aggiungerne né toglierne; Names= senza nulla dopo significa nessuna cerchia, bloccata; senza Names nel file l'elenco è quello dell'utente

Un elenco impostato qui viene applicato sopra quello dell'utente, che resta intatto in beebeep.ini e torna il giorno in cui il file smette di impostarlo. Un nome che le regole rifiutano viene escluso e un avviso viene scritto nel log: BeeBEEP non si rifiuta mai di avviarsi per questo. Le regole sono quelle che incontra un utente: al massimo 32 caratteri, almeno una lettera o una cifra, nessuna emoji, un nome una sola volta per cerchia comunque sia scritto con le maiuscole o con spazi in più, e l'intero elenco entro 320 byte, due per ogni nome contati oltre al suo testo (una virgola separa i nomi, quindi un nome non ne contiene mai una). Un nome più lungo di 32 caratteri viene accorciato ai suoi primi 28, poi # e tre lettere o cifre prese dall'intero nome, così lo stesso nome lungo dà lo stesso nome corto su ogni computer, e file che elencano nomi lunghi diversi si accordano su ciascuno; l'avviso nel log riporta la forma corta.

Anche due chiavi di beebeep.ini riguardano le cerchie, entrambe scritte da BeeBEEP:

ChiaveValoriPredefinitoCosa fa
Circles/Namesnomi di cerchie, separati da virgolenessunale cerchie dell'utente, scelte in Impostazioni > Privacy; non usata mentre beebeep.rc imposta Names
Circles/GroupUsersByCirclebooleanofalseraggruppa l'elenco degli utenti per cerchia, come fa Raggruppa le persone per cerchia nel menu di ordinamento di Utenti; resta anche quando se ne va l'ultima cerchia

Il nodo relay senza interfaccia beebeep-relay non ha cerchie: ignora [Circles] in entrambi i file, fa passare i messaggi di tutti ed è visibile a tutti.

Modificare ed eliminare un messaggio inviato

Un utente può correggere un messaggio che ha inviato, o eliminarlo per tutti: ogni copia mostra allora "Questo messaggio è stato eliminato" al suo posto. Può farlo per un po' di tempo dopo averlo scritto; queste chiavi stabiliscono quanto. Un ufficio che tiene le sue chat come archivio documentale le disattiva entrambe. Una chiave impostata qui prevale su qualsiasi cosa dica il file dell'utente, e non si può cambiare mentre BeeBEEP è in esecuzione.

[Messages]
messageEditWindowSecs=0
messageDeleteWindowSecs=0
ChiaveValoriPredefinitoCosa fa
messageEditWindowSecssecondi, 0 o più900per quanto tempo dopo aver scritto un messaggio chi l'ha inviato può ancora modificarlo (15 minuti); 0 disattiva la modifica
messageDeleteWindowSecssecondi, 0 o più86400per quanto tempo dopo aver scritto un messaggio chi l'ha inviato può ancora eliminarlo per tutti (un giorno); 0 disattiva l'eliminazione per tutti

Finché nessuno ha ancora ricevuto un messaggio, chi l'ha inviato può sempre eliminarlo, e correggerlo, senza limiti di tempo. Eliminare un messaggio solo per sé non è mai limitato. Il tempo si conta da quando il messaggio è stato scritto, sul computer di chi l'ha inviato; un computer con un altro valore non rifiuta una modifica inviata da uno con un tempo più lungo.

Modificare beebeep.ini

beebeep.ini è un semplice file INI: ogni chiave appartiene a un [Group], e questa pagina chiama una chiave Group/Key. Un booleano è true o false.

[Network]
PreferIPv6=true

[FileTransfer]
AutoAcceptMaxSizeMiB=50

Un giorno di uso è un giorno in cui BeeBEEP è stato in esecuzione su quel computer; i giorni in cui era spento non contano.

Dove sono conservati i segreti

BeeBEEP custodisce tre segreti: la password che cifra il database, la chiave privata della tua identità end-to-end e la password di rete. Dove sono conservati dipende dalla macchina.

Con un archivio dei segreti nel sistema, i tre vanno lì, con il nome di servizio BeeBEEP, e mai in beebeep.ini: il Keychain su macOS e iOS e, tramite la libreria qtkeychain, il Credential Manager su Windows, il Secret Service o KWallet su Linux e il Keystore su Android.

Una macchina che non ha alcun archivio dei segreti, come un server senza sessione desktop, viene riconosciuta all'avvio di BeeBEEP: chiede una volta all'archivio, e conta solo una risposta che dice che non esiste alcun archivio. Un archivio bloccato, o una richiesta rifiutata, non conta: BeeBEEP continua a usare l'archivio e non ripiega su altro. Quando non esiste alcun archivio, BeeBEEP tiene i tre segreti in chiaro nello stesso beebeep.ini, accanto alle impostazioni.

--secret-file=<path> serve a quella macchina. Il file contiene un segreto principale, con il contenuto che preferisci; un a capo finale viene ignorato, e un segreto più corto di 16 byte è accettato con un avviso. BeeBEEP tiene allora i tre segreti in un file cifrato, beebeep.secrets, nella cartella dei dati, sbloccato dal segreto principale, e non tocca mai l'archivio dei segreti del sistema, anche dove ce n'è uno. BeeBEEP si limita a leggere il file del segreto principale, senza mai scriverlo: tienilo fuori dalla cartella dei dati, leggibile solo dall'account che esegue BeeBEEP, oppure consegnalo tramite il tuo gestore dei servizi. Se beebeep.secrets non si decifra con quel segreto, o non si può leggere, BeeBEEP si ferma all'avvio con un errore e non tocca il database.

Rete

ChiaveValoriPredefinitoCosa fa
Network/UseNetworkPasswordbooleanofalseapplica la password di rete salvata alle nuove connessioni; disattivarla conserva la password salvata
Network/UseBonjourbooleanotrue su macOS, iOS e Android, false altrovepubblica questa installazione e cerca le altre con Bonjour; si applica subito, senza riavvio
Network/PreferIPv6booleanofalseraggiunge via IPv6 un utente offerto sia su IPv4 sia su IPv6; un utente offerto su una sola famiglia viene raggiunto su quella
Network/ListenPortuna porta, da 1 a 655356475la porta TCP che BeeBEEP chiede quando si avvia; BeeBEEP memorizza la porta su cui è finito in ascolto e chiede quella la volta dopo; --listen-port la sostituisce per un'esecuzione
Network/EffortLevelNormal, High, Max (o 0, 1, 2)Normalquanto traffico questa installazione spende per tenere vive le sue connessioni: al massimo 25 pacchetti al secondo per Normal, 60 per High, 240 per Max
Network/LegacyBridgeEnabledbooleanotrueparla con gli utenti che usano BeeBEEP 5.x; vedi la nota sotto la tabella

Con Network/LegacyBridgeEnabled attivo, BeeBEEP parla con gli utenti di BeeBEEP 5.x, e dice a ogni utente a cui si collega il nome e il dominio dell'account del sistema operativo, ma solo quando l'identità di questa installazione è stata ricavata da quell'account. Con la chiave disattivata, BeeBEEP non parla con gli utenti di BeeBEEP 5.x e non dice a nessuno il nome dell'account.

Le stesse scelte sono in Impostazioni > Rete: Usa password di rete, Trova i colleghi con Bonjour, Preferisci IPv6 a IPv4, Impegno sulla rete e Parla con gli utenti di BeeBEEP 5.x.

Privacy e sicurezza

ChiaveValoriPredefinitoCosa fa
Privacy/ShareProfileWithEveryone, ContactsOnlyContactsOnlychi può ottenere la tua email, il tuo numero di telefono, la tua posizione, la tua data di nascita e le tue informazioni: qualsiasi utente, o solo i tuoi contatti; qualsiasi altro valore viene letto come ContactsOnly
Privacy/ShareGalleryWithEveryone, ContactsOnlyContactsOnlylo stesso per la tua galleria
Privacy/DropGroupInvitationsFromNonContactsbooleanofalsescarta un invito a un gruppo da parte di chi non è un contatto, invece di mostrarlo con un avviso
Privacy/AcceptGroupInvitationsFromContactsbooleanofalseaccetta subito, senza chiedere, un invito a un gruppo da parte di un contatto; un invito di chiunque altro, o a un gioco, aspetta comunque l'utente
Security/AutoAcceptKeyChangesbooleanotrueaccetta da solo la nuova chiave di sicurezza di un utente che non hai verificato di persona; false fa aspettare ogni cambio finché non lo confermi nella chat di quell'utente

File

ChiaveValoriPredefinitoCosa fa
FileTransfer/AutoAcceptMaxSizeMiBnumero intero, da 0 a 10485760 su un computer, 20 su Android e iOSla dimensione massima, in MiB, di un file offerto da un contatto che si scarica senza chiedere; 0 non pone alcun limite; un file offerto da chi non è un contatto aspetta sempre, e una nota vocale si scarica sempre
FileTransfer/OfferTtlDaysnumero intero7per quanti giorni di uso di questa installazione un file che hai inviato, e che il destinatario non ha preso, resta offerto prima che l'offerta fallisca; 0 o meno non ne fa scadere mai nessuna

Il limite è anche in Impostazioni > Preferenze > Scarica automaticamente.

Notifiche e aspetto

ChiaveValoriPredefinitoCosa fa
Notifications/Enabledbooleanotruemostra le notifiche del sistema operativo
Notifications/Soundbooleanotrueriproduce il beep di BeeBEEP a ogni notifica, tranne quando è attivo il Non disturbare del sistema
Notifications/FlashWindowbooleanotruesu un computer, a ogni notifica fa lampeggiare il pulsante della finestra nella barra delle applicazioni mentre BeeBEEP non è in primo piano, finché non viene aperto
Appearance/ThemeSystem, Light, DarkSystemSystem segue l'impostazione chiaro o scuro del sistema operativo, gli altri ne fissano uno
Language/Localeun nome di locale come it o zh_CNvuotola lingua del programma; se vuoto segue le lingue del sistema; si applica al prossimo avvio
Language/TranslationsFolderun percorsovuotouna cartella i cui file di traduzione vengono letti prima di quelli incorporati in BeeBEEP; un percorso relativo parte dalla cartella dei dati; se vuoto è la cartella translations della cartella dei dati
Shortcuts/Enabledbooleanofalseattiva le scorciatoie da tastiera di BeeBEEP; i tasti abituali del sistema funzionano sempre
Shortcuts/HideToTrayun tasto come Ctrl+MCtrl+Mil tasto che nasconde BeeBEEP; la schermata delle impostazioni accetta solo un tasto con Ctrl, Alt o Meta
Shortcuts/PresetMessagesun tasto come Ctrl+Shift+PCtrl+Shift+Pil tasto dei messaggi predefiniti: in una chat apre o chiude il loro elenco sopra il campo del messaggio, altrove li apre in Impostazioni; la stessa regola di sopra
VoiceMessage/MaxDurationSecondsnumero intero120una registrazione vocale si ferma da sola a questa lunghezza; nessuna schermata la imposta
Screenshot/KeepInPicturesbooleanotruesu un computer, conserva uno screenshot fatto in una chat nella cartella BeeBEEP delle Immagini dell'utente; false lo scrive in una cartella temporanea svuotata il giorno dopo. Lo imposta anche Impostazioni > Preferenze > Keep my screenshots

Manutenzione e diagnostica

ChiaveValoriPredefinitoCosa fa
Cleanup/GroupMemberDaysnumero intero, da 0 a 365090i giorni di uso con cui parte ogni nuovo gruppo per rimuovere i membri non visti; 0 crea i gruppi senza quella regola. Lo imposta anche Impostazioni > Privacy
Cleanup/InactiveUserDaysnumero intero, da 0 a 365030toglie dagli elenchi un utente che è offline, si è collegato almeno una volta e non è stato visto per questo numero di giorni di uso di questa installazione: chi ha messaggi, un gruppo, un contatto o un blocco viene solo nascosto, e mostrato di nuovo quando torna; chiunque altro viene eliminato. 0 non rimuove mai nessuno. Lo imposta anche Impostazioni > Privacy
Log/PanicModebooleanofalsescrive nel log ogni messaggio di ogni categoria, compresi quelli di Qt; ha effetto dal prossimo avvio; lo impostano anche Impostazioni > Registro > Abilita registro di emergenza (panic log) e --panic-mode

Il file beehosts.ini

Un file chiamato beehosts.ini nella cartella dei dati viene letto a ogni avvio di BeeBEEP. Nomina gli host da contattare direttamente e gli host da bloccare, uno per riga. Una riga che comincia con #, * o / è un commento.

Un beehosts.ini nella stessa cartella di beebeep.rc è quello dell'amministratore: viene letto anch'esso, per primo, e un utente non può cambiarlo. Un blocco in uno dei due file vince su un host da contattare in uno dei due, e le righe dell'amministratore sono l'elenco che usano le chiavi degli host della policy.

Host da contattare

Una riga host[:port] [udp|tcp] nomina un computer che BeeBEEP non riesce a trovare da solo, su un'altra sottorete o attraverso una VPN: un indirizzo o un nome host, con il modo in cui BeeBEEP stabilisce il primo contatto. Lo stesso file si può copiare su ogni computer che elenca, dato che ogni BeeBEEP salta la propria voce. La sintassi, i due modi e le porte da aprire sono in raggiungere i computer su altre reti.

office-pc.tailnet-name.ts.net
192.168.3.32
server.example.com tcp

Host da bloccare

Una riga che comincia con ! blocca un host: BeeBEEP non vi si collega né ne accetta connessioni, fin dal primo annuncio.

!10.184.9.132
!2001:db8:1f70::999:de8:7648:6e8

Un blocco nomina un indirizzo, mai un nome host, e copre l'intero host: una porta scritta dopo l'indirizzo viene ignorata e un avviso viene scritto nel log. L'opzione --block-address=<host[:port]> aggiunge un blocco per un'esecuzione, e si può ripetere.

Opzioni della riga di comando

OpzioneCosa fa
--data-folder=<path>usa <path> per le impostazioni, il database e i log; vedi la cartella dei dati
--language=<locale>la lingua per questa esecuzione, con precedenza su Language/Locale e sul sistema
--secret-file=<path>tiene la password del database, la chiave dell'identità e la password di rete in un beebeep.secrets cifrato nella cartella dei dati, sbloccato dal segreto principale in questo file; vedi dove sono conservati i segreti
--network-password-file=<path>usa il contenuto del file come password di rete per questa esecuzione, e non la memorizza mai
--panic-modelog dettagliato, e lo mantiene per le esecuzioni successive
--block-address=<host[:port]>blocca un host per questa esecuzione; ripetibile
--listen-port=<port>la porta TCP su cui ascoltare per questa esecuzione, con precedenza su Network/ListenPort
--versionstampa la versione ed esce
--helpelenca ogni opzione ed esce

Un'opzione che accetta un solo valore viene rifiutata, con un errore all'avvio, quando è data due volte.

Tutte le pagine della guida