Account di posta IMAP e SMTP

Metnos può usare caselle di fornitori diversi da Google. La posta standard passa da IMAP per la lettura e SMTP per l'invio; Google Workspace resta un'integrazione distinta per le funzioni specifiche di Gmail.

Identità dell'account

Ogni account ha un nome stabile, per esempio work. Nell'archivio cifrato delle credenziali l'associazione è smtp_work; negli executor di posta il valore di account è work. account="all" legge tutti gli account configurati e aggrega i risultati; può essere usata anche una lista esplicita di nomi.

Configurazione preferita

Chiedi a Metnos con una richiesta come quella di questo esempio: «Spiegami come configurare un account di posta non Google chiamato work, con IMAP e SMTP, senza inserire la password nel messaggio.»

La voce cifrata smtp_<nome> contiene questi campi:

CampoSignificato
user, passwordCredenziali della casella.
imap_host, imap_portServer di lettura; porta tipica 993.
smtp_host, smtp_portServer di invio; porta tipica SMTPS 465. Può essere omesso per un account di sola lettura.
verify_tlsVerifica TLS, attiva per impostazione predefinita; disattivarla richiede una decisione amministrativa esplicita.

Esempio di contratto, con valori segreti sostituiti da segnaposto:

set_credentials(
  binding="smtp_work",
  fields={
    "user": "persona@example.test",
    "password": "<password>",
    "imap_host": "imap.example.test",
    "imap_port": 993,
    "smtp_host": "smtp.example.test",
    "smtp_port": 465,
    "verify_tls": true
  }
)

Durante l'installazione interattiva, la fase Dati sensibili può creare uno o più account. Dopo l'installazione, la stessa struttura può essere salvata con set_credentials; i valori entrano nell'archivio locale cifrato, mentre risposta e telemetria espongono soltanto metadati.

Compatibilità con configurazioni precedenti

È ancora accettato un file ~/.config/metnos/mail/<nome>.env con permessi 0600 e campi HOST_IMAP, PORT_IMAP, HOST_SMTP, PORT_SMTP, USER, PASS e VERIFY_TLS. L'archivio cifrato ha precedenza; il file resta un percorso di compatibilità e migrazione.

Confini

read_messages legge IMAP; send_messages invia SMTP; move_messages gestisce cartelle IMAP. Etichette Gmail, conversazioni Gmail e altre funzioni specifiche rimangono nell'integrazione Google Workspace.

Lo spostamento di un messaggio nel Cestino non elimina mai in blocco il contenuto di una cartella. Metnos usa l'operazione atomica MOVE quando il server la offre; altrimenti procede soltanto se può copiare, marcare ed eliminare esattamente gli UID selezionati. Se il server non garantisce queste operazioni, lo spostamento fallisce senza modificare la casella. Gli UID restano legati all'account e alla cartella di origine: i risultati provenienti da account diversi non vengono mai inoltrati a un unico spostamento ambiguo. Quando gli UID IMAP sono forniti direttamente, invece di provenire da un passo di lettura precedente, account e cartella di origine devono essere entrambi espliciti. Metnos rifiuta un UID privo di questo legame prima di contattare il backend: non presume mai la casella predefinita. Il vincolo non riguarda gli ID dei messaggi Gmail, il cui ambito di identità è fornito dal provider.

Le password non devono essere inserite in documentazione, manifest o file di log. Se vengono fornite tramite un flusso credenziali della chat, sono estratte prima del pianificatore, cifrate e sostituite da un segnaposto privo del segreto.