Tutti i documenti
Per iniziare
In azienda
Console centrale
Il modello
Sicurezza e licenze
Documentazione › In azienda
Distribuire Omissis su più PC
Per chi gestisce i computer di un'azienda o di più clienti (un MSP): quattro script PowerShell per installare Omissis in silenzio, già configurato, bloccarne le impostazioni, controllarne lo stato e toglierlo. Funzionano con qualsiasi strumento che sappia lanciare uno script: un RMM, Intune, uno script di accesso.
Da dove cominciare: GUIDA-AZIENDE.it.md dice che cosa è gratuito e che cosa no, quale
schema scegliere (ogni PC con il suo modello, oppure un PC che lo presta agli altri) e come accendere il server di
inferenza, passo per passo. Questa pagina è il riferimento degli script.
| File | A cosa serve |
|---|---|
Install-Omissis.ps1 |
Installa in silenzio, applica le scelte del cliente, porta il modello, avvia la protezione |
Set-OmissisPolicy.ps1 |
Blocca le impostazioni scelte per tutti gli utenti del PC. È l'unico che va lanciato come amministratore |
Get-OmissisStatus.ps1 |
Dice in una riga come sta Omissis su quel PC; con -MinVersion fa da regola di rilevamento |
Uninstall-Omissis.ps1 |
Toglie il programma; con -RemoveData anche i dati |
settings.example.json |
Modello delle scelte del cliente (l'utente le può cambiare) |
policy.example.json |
Modello delle impostazioni bloccate (l'utente non le può cambiare) |
GUIDA-AZIENDE.it.md, GUIDE-ORGANISATIONS.md |
La guida pratica: gratuito e a pagamento, schemi, server di inferenza |
La regola che conta: si lancia come utente
Omissis si installa per il singolo utente, senza diritti di amministratore, e i suoi dati (l'archivio dei
valori sostituiti, cifrato e legato a quell'utente) stanno nel suo profilo. Gli script vanno quindi eseguiti
con l'utente che usa il PC, non come SYSTEM e non come amministratore: lanciati come SYSTEM
installerebbero il programma nel profilo sbagliato. Su un PC usato da più persone si lancia una volta per
ciascuna. L'unica eccezione è Set-OmissisPolicy.ps1, che scrive in una zona del registro riservata agli
amministratori: quello va lanciato come amministratore o come SYSTEM, una volta per PC.
Che cosa serve
- L'installer
Omissis-<versione>-setup.exee la sua impronta SHA-256. L'impronta sta inupdate.json, pubblicato firmato accanto all'installer: lo script rifiuta un file con un'impronta diversa. - Facoltativo, ma consigliato: una cartella con il modello, così ogni PC non scarica 537 MB per conto suo.
Dentro ci va una sottocartella con il nome del modello (
omissis-small) e i cinque file che il programma scaricherebbe (config.json,tokenizer.json,tokenizer_config.json,omissis.json,model.onnx). Ogni file viene accettato solo se dimensione e impronta sono quelle dell'elenco che viaggia con il programma; se uno non torna, la copia viene scartata e il programma scarica il modello da sé. - Facoltativo: le scelte del cliente, un file come
settings.example.json.
powershell -ExecutionPolicy Bypass -File Install-Omissis.ps1 `
-Installer "\\server\software\Omissis-0.1.0-setup.exe" -Sha256 "<impronta>" `
-Settings "\\server\software\cliente.json" -ModelSource "\\server\software\modelli"
-Installer accetta anche un indirizzo https://. Con -NoAutostart Omissis non parte insieme a Windows,
con -NoStart non viene avviato alla fine. Lo script scrive una riga in JSON con l'esito ed esce con
0 (fatto), 2 (installer non ottenuto o impronta sbagliata), 3 (installazione fallita), 4
(installato, ma la protezione non è partita entro tre minuti: di solito sta ancora scaricando il modello).
Le scelte del cliente
Solo le chiavi scritte nel file vengono imposte; ogni altra impostazione resta come l'ha l'utente. Le più utili:
| Chiave | Valori | Che cosa decide |
|---|---|---|
model |
omissis-small (di serie), omissis-base |
Il modello. Su PC da ufficio il piccolo; il grande vuole 16 GB |
updates |
automatic, notify, never |
never se le versioni le distribuisci tu, con questo stesso script |
policies |
per servizio: protect, record, block, ignore |
Per esempio "deepseek": "block". I nomi dei servizi sono quelli della sezione Servizi AI del pannello |
groups_off |
payments, organizations, it, records |
Gruppi di dati da non sostituire. Di serie nessuno: spegnerne uno riduce la protezione |
always_on |
true |
La protezione non si ferma dal pannello né dall'icona, e il programma non si chiude dall'icona. Non ferma chi lo chiude da Gestione attività |
view |
simple, advanced |
Che cosa vede l'utente quando apre il pannello |
language |
it, en, auto |
La lingua del pannello |
engine_url, engine_key, engine_pin |
la configurazione data dal PC che presta il modello | Il PC non carica il modello: lo chiede a quel server della rete (vedi app/README.it.md, «Server di inferenza in rete») |
L'utente può cambiare queste impostazioni dal pannello: rilanciare lo script le rimette. Per impedirglielo ci sono le impostazioni bloccate, qui sotto.
Bloccare le impostazioni
Set-OmissisPolicy.ps1 scrive le impostazioni di un file JSON nella chiave di registro
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Omissis, che un utente normale non può modificare. Omissis la legge:
ciò che trova lì vince sulle scelte dell'utente, e nel pannello quei comandi compaiono fermi, con la scritta
«decisa da chi amministra questo PC». Non c'è nessuna password: comanda chi ha i diritti di amministratore sul PC.
powershell -ExecutionPolicy Bypass -File Set-OmissisPolicy.ps1 -Settings "\\server\software\cliente-blocco.json"
- Va lanciato come amministratore o come SYSTEM (è il modo in cui RMM e Intune lanciano gli script di serie).
- I nomi sono gli stessi delle scelte del cliente (
policy.example.jsonè un modello).policiesblocca solo i servizi scritti: gli altri restano all'utente. Ogni altra impostazione è bloccata per intero. Sui servizi scritti lì, l'estensione del browser non si lascia sospendere dalla sua finestrella. - La chiave rispecchia il file: un'impostazione tolta dal file torna libera. Con
-Removetorna tutto libero, e ogni utente ritrova le scelte che aveva prima. - Esce con
0(fatto),3(file mancante o non valido),5(non ha i diritti per scrivere). - Chi preferisce i criteri di gruppo o Intune può scrivere gli stessi valori da lì: testo (
REG_SZ) per le scelte, numero (REG_DWORD, 0 o 1) per quelle sì/no, e JSON dentro un testo per elenchi e tabelle.
Che cosa non è. Omissis è installato nel profilo dell'utente, che quindi può modificarne i file: il blocco ferma i cambi fatti dal pannello e dal file delle impostazioni, non chi manomette il programma. Chi deve impedire anche questo usa gli strumenti di Windows (AppLocker, controllo delle applicazioni). Allo stesso modo, niente impedisce all'utente di spegnere o togliere l'estensione dal browser: per quello servono i criteri del browser (installazione forzata), possibili quando l'estensione sarà pubblicata su uno store.
La console centrale
Di serie Omissis non manda nulla a nessuno. Un'organizzazione che vuole vedere tutti i suoi PC in un posto solo
può collegarli a una console centrale: bastano due impostazioni, console_url (un indirizzo https://) e
console_key (la chiave di collegamento del cliente, che dà la console), messe nel file delle impostazioni
bloccate o in quello delle scelte del cliente.
Da quel momento ogni PC manda alla console, una volta all'ora, un riepilogo fatto di conteggi: versione e stato del programma, quante richieste avevano dati da sostituire, quanti valori per tipo di dato, verso quali servizi, quante richieste sono state fermate, e i nomi e le versioni degli strumenti AI trovati sul PC. Mai i testi, mai i valori sostituiti. Chi usa il PC lo vede: nel pannello, in Impostazioni, c'è scritto a chi è collegato e il pulsante «Vedi che cosa parte» mostra il riepilogo esatto.
- Il riepilogo porta il nome del computer e dell'utente, perché chi gestisce i PC deve sapere quale va
controllato. Con
"console_names": falsenon li porta. Attenzione: conteggi per singola persona possono essere un controllo a distanza dei lavoratori; prima di attivarli si sente chi si occupa di privacy e, dove serve, si informano i dipendenti. - Il protocollo è aperto (
app/central.py): una richiestaPOSTa<console_url>/api/v1/reportcon la chiave nell'intestazioneAuthorization. La console è un programma a parte, non aperto: si scarica compilata dalla pagina delle versioni ed è gratuita fino a 5 PC (vedi../console/README.it.md). - Un rinvio verso un altro indirizzo non viene seguito, e un indirizzo non
httpsviene rifiutato. - Regole dalla console. Con
"console_rules": trueil PC applica le regole che la console gli manda in risposta al riepilogo (per servizio, file, allegati, aggiornamenti, analisi, protezione ridotta, divieto di spegnere la protezione: nient'altro). Di serie è spento. Ciò che è scritto in questa chiave di registro vince sempre sulle regole della console. - Console in rete locale. Una console interna non ha un nome pubblico né un certificato firmato da
un'autorità: si fa il certificato da sé e ne dà l'impronta. Con
"console_pin": "<impronta SHA-256>"il PC si collega solo al server che presenta proprio quel certificato, e lo controlla prima di mandare la chiave. Così basta un indirizzo comehttps://192.168.1.10:8800: niente nome, niente porte 80 e 443. Senzaconsole_pinil certificato deve essere valido come per un browser.
Con un RMM (NinjaOne e simili)
- Caricare i tre script e, se lo strumento lo permette, l'installer; altrimenti metterlo su una condivisione
o a un indirizzo
https://. - Creare un'automazione che lancia
Install-Omissis.ps1con i parametri del cliente, eseguita come utente connesso (in NinjaOne: «Esegui come: utente attualmente connesso»). - Per il controllo periodico:
Get-OmissisStatus.ps1senza parametri, sempre come utente. Esce con0se la protezione è accesa,1se Omissis è installato ma spento,2se non è installato; la riga in JSON si può salvare in un campo personalizzato.
Con Intune
- Impacchettare installer e script in un'app Win32 (
.intunewin). - Comando di installazione:
powershell -ExecutionPolicy Bypass -File Install-Omissis.ps1 -Installer Omissis-0.1.0-setup.exe -Sha256 <impronta> -Settings cliente.json - Comando di disinstallazione:
powershell -ExecutionPolicy Bypass -File Uninstall-Omissis.ps1 - Comportamento di installazione: Utente (non Sistema).
- Regola di rilevamento: script personalizzato,
Get-OmissisStatus.ps1 -MinVersion 0.1.0(esce con0e scrive una riga solo se quella versione, o una successiva, è installata). - Il modello conviene lasciarlo scaricare al programma, oppure metterlo su una condivisione raggiungibile dai PC: dentro il pacchetto peserebbe troppo.
Che cosa dice lo stato
{"installed":true,"version":"0.1.0","computer":"PC-07","user":"m.rossi","protectionOn":true,"panelUp":true,
"startsWithWindows":true,"model":"omissis-small","modelPresent":true,"updates":"notify","groupsOff":[],
"days":7,"requestsWithReplacements":41,"valuesReplaced":187,"stopped":2}
Gli ultimi tre numeri vengono dal registro di Omissis degli ultimi -Days giorni: quante richieste avevano
dati da sostituire, quanti valori sono stati sostituiti, quante richieste sono state fermate. Sono conteggi:
il registro non contiene mai i testi. Su un PC con impostazioni bloccate la riga porta anche locked (quali) e
console (se il PC è collegato a una console).
L'estensione del browser
Gli script installano il programma, non l'estensione. Due cose restano da fare:
- Installarla. Finché non è pubblicata sugli store dei browser si carica a mano dalla cartella indicata nel
pannello. Quando sarà pubblicata si potrà imporre con il criterio
ExtensionInstallForcelistdi Chrome e di Edge (un criterio di macchina: qui servono i diritti di amministratore). - Collegarla. Appena installata, l'estensione apre una pagina con il pulsante «Collega questo browser»: il pannello si apre e il collegamento si fa da solo. Va fatto una volta per utente e per browser: il codice di collegamento è diverso su ogni PC e non esce da lì.
Aggiornare e togliere
- Aggiornare: di serie Omissis si aggiorna da solo con aggiornamenti firmati. Con
updates: neversi rilanciaInstall-Omissis.ps1con l'installer nuovo: i dati dell'utente restano. - Togliere:
Uninstall-Omissis.ps1. Senza-RemoveDatai dati restano, e una nuova installazione li ritrova. Con-RemoveDatavengono eliminati: senza l'archivio i segnaposto delle vecchie conversazioni non si possono più riportare ai valori veri.
Che cosa è provato
Il 14 novembre 2026, su un solo PC con Windows 11 e Windows PowerShell 5.1: installer con impronta sbagliata rifiutato senza installare nulla; installazione in silenzio in 21 secondi con le scelte del cliente applicate, il modello copiato da una cartella e la protezione accesa; un testo inventato mascherato dalla copia installata; stato letto a programma acceso; disinstallazione con i dati senza lasciare programma, dati, voce di avvio o collegamento nel menu Start.
Sempre il 14 novembre 2026: Set-OmissisPolicy.ps1 provato su una chiave di prova dell'utente (scrive, il
programma rilegge i valori nella forma giusta, un file ridotto libera le impostazioni tolte, -Remove toglie
tutto) e, senza diritti di amministratore, sulla chiave vera, dove si rifiuta senza scrivere nulla. Blocco e
invio del riepilogo sono coperti dalle prove automatiche del programma (app/e2e_central.py). In più, con
l'installer che contiene queste novità: installazione in silenzio in 9 secondi; la copia installata, accesa con
impostazioni imposte da un file di prova, le mostra bloccate, rifiuta di cambiarle e manda il riepilogo a una
console di prova sullo stesso PC; disinstallazione senza resti.
Non ancora provato: Set-OmissisPolicy.ps1 lanciato davvero come amministratore su un PC con Omissis
installato, e la riga locked di Get-OmissisStatus.ps1; il lancio da un RMM o da Intune veri, un PC con più utenti, un PC con restrizioni
sull'esecuzione dei programmi (AppLocker e simili) o con un antivirus diverso da quello di Windows, i
conteggi dell'attività su un registro con dati veri.
Lo stesso documento nel repository: deploy/README.it.md