Programmi robusti
Permessi dei programmi
Che cosa un programma Leo può fare fuori dalla sua cartella: le sette categorie, la riga permessi:, l'approvazione, --permetti e leo permessi.
In breve#
Un programma Leo, come un'app del telefono, dichiara che cosa gli serve fuori dalla sua cartella: Internet, file altrove, impostazioni del computer, altri programmi, appunti, fotocamera. Chi lo esegue lo vede prima e decide; la scelta si ricorda. Se il programma prova a fare di più, Leo lo ferma con un messaggio chiaro.
Le funzioni che calcolano soltanto (matematica, testi, liste, date, la tartaruga, le finestre del programma stesso) non hanno bisogno di niente.
Le sette categorie#
| Categoria | Che cosa protegge | Esempi |
|---|---|---|
file | file e cartelle fuori dalla cartella del programma | leggi_file, scrivi_file, copia_file, elimina_cartella, estrai_zip, apri_database |
rete | Internet e altri computer | scarica_json, scarica_testo, richiesta_web, invia_email, il controllo RichiestaWeb |
sistema | impostazioni del computer: registro di Windows, avvio automatico, spegnimento, volume, finestre di altri programmi, variabili d'ambiente, nome utente | scrivi_registro, spegni_computer, aggiungi_all_avvio, cattura_schermo, nome_utente |
processi | avviare, elencare o chiudere altri programmi, eseguire comandi | esegui_comando, esegui_powershell, avvia_programma, termina_processo |
appunti | copia e incolla | leggi_appunti, scrivi_appunti, il controllo Appunti |
hardware | fotocamera, microfono, posizione, torcia, porte seriali, schede collegate | i controlli Fotocamera, LettoreQR, Dettatura, Posizione, PortaSeriale, SchedaPico |
codice | codice esterno fuori dai controlli di Leo (dalla 0.1.5) | importa python "…", importa c "…" |
La riga permessi:#
La riga permessi: va in cima al programma, prima del codice (prima ci possono essere solo commenti). Ogni voce è categoria valore, separate da virgole.
permessi: rete "api.meteo.it", file "dati/", sistema no, processi no, appunti no, hardware no, codice no
stampa("Il programma parte")| Valore | Significato |
|---|---|
sì | tutta la categoria (va approvata da chi esegue) |
no | mai, nemmeno chiedendo: Leo nega subito |
chiedi | Leo chiede ogni volta che serve (come senza dichiarazione) |
"..." | solo queste cose: siti per rete ("api.meteo.it" vale anche per i suoi sottodomini), cartelle per file, dispositivi per hardware ("fotocamera", "microfono", "posizione", "torcia", "seriale", "bluetooth"). Un elenco è un recinto: tutto il resto della categoria è negato. |
In un progetto si può dichiarare anche nel file progetto.toml, nella sezione [permessi]; se dichiarano tutti e due, per ogni categoria vince la riga del programma.
[permessi]
rete = ["api.meteo.it"]
file = ["dati/"]
sistema = "no"
hardware = ["fotocamera"]Senza dichiarazione#
- Libero, senza domande: la cartella del programma (o del progetto) e le sue sottocartelle, la cartella temporanea, la cartella da cui lanci il programma (se non è la tua cartella personale né la radice del disco), la rete verso questo stesso computer (
localhost). - Chiede la prima volta: file altrove, siti Internet, sistema, processi, appunti, hardware.
- I file che scegli tu in un dialogo (per esempio con
scegli_file_da_aprire) sono permessi da sé.
Chi esegue approva#
Se il programma dichiara più dei predefiniti, prima di partire Leo mostra che cosa chiede e chi esegue risponde una volta sola; la scelta si ricorda.
== Permessi ==
Il programma «meteo.leo» chiede questi permessi:
- Rete: collegarsi a api.meteo.it
Il programma stesso esclude: sistema; programmi e comandi; appunti; hardware.
Firma: il programma non è firmato.
Li concedi? La scelta vale anche le prossime volte. [s/N]Durante l'esecuzione, per ciò che non è dichiarato, Leo chiede al momento:
== Permesso richiesto ==
Il programma «rete.leo» vuole collegarsi a example.com (con `scarica_testo`).
Permesso «rete»: collegarsi a Internet o ad altri computer.
Consenti? [s = sì, questa volta / t = sì, sempre per questo programma / N = no]In Leo Studio la prima volta che premi Esegui compare la finestra «Permessi del programma»; sul telefono l'app mostra lo stesso elenco con Consenti / Non consentire, e per fotocamera, microfono e posizione chiede in più il permesso di Android. Un programma firmato con una chiave di cui ti fidi (leo firma) ha i permessi dichiarati già approvati.
Dalla riga di comando#
leo permessi programma.leo # che cosa dichiara, che cosa usa, le scelte ricordate
leo permessi programma.leo --json # lo stesso in JSON
leo permessi programma.leo --dimentica # dimentica le scelte: Leo chiederà di nuovo
leo programma.leo --permetti rete,file # queste categorie senza chiedere
leo programma.leo --permetti-tutto # tutto: solo per programmi di cui ti fidiAnche leo spiega programma.leo mostra i permessi prima di eseguire. Esempio di leo permessi dopo l'approvazione:
Permessi:
- Dichiarati (programma): file "dati/", rete "api.meteo.it", sistema no, processi no, appunti no, hardware no, codice no
- Approvati: sì (la scelta è ricordata).
- Usa: niente di protetto (solo la sua cartella e calcoli).Le scelte ricordate stanno nel file permessi.json nella cartella delle impostazioni di Leo (%APPDATA%\Leo su Windows).
Quando un permesso è negato#
Un permesso negato è un ErroreFile: si può catturare, e e.messaggio dice quale permesso manca. Se nessuno può rispondere (il programma è lanciato da uno script), ciò che andrebbe chiesto è negato, con un messaggio che spiega come fare.
permessi: rete no
prova
variabile t = scarica_testo("https://example.com")
cattura ErroreFile come e
stampa("Niente rete: {e.messaggio}")
fineNiente rete: `scarica_testo` vuole collegarsi a example.com, ma il programma stesso ha dichiarato `rete no` nei permessi.Le funzioni pericolose (spegni_computer, scrivi_registro, esegui_comando…) chiedono in più «Sì/No» prima di agire; senza_conferma = vero toglie quella domanda, ma non il permesso della categoria.
Codice Python e C#
I pacchetti Leo installati hanno un recinto in più: possono usare una categoria (e le librerie Python) solo se l'hanno dichiarata nel loro pacchetto.toml.