Questa guida illustra le regole specifiche da seguire quando si utilizza una password contenente il carattere “dollaro” $ per inviare un’e-mail tramite SMTP Infomaniak in uno script (PowerShell, Python, ecc.).

Introduzione

• Se durante l'invio di un'e-mail tramite SMTP si verifica un errore di autenticazione (ad esempio auth failed, invalid login or password), anche se la password è corretta e funziona in un software come Outlook, il problema potrebbe essere dovuto alla gestione del carattere $ nel tuo script o file di configurazione.
• Per garantire un'esecuzione affidabile dei tuoi script SMTP, si consiglia vivamente di evitare l'uso di caratteri speciali che abbiano un significato sintattico, in particolare $, nelle password utilizzate negli script e nei file di configurazione.
• Il problema può verificarsi anche durante la connessione ai database.

Regole da seguire

Il carattere $ è un simbolo speciale in molti linguaggi e ambienti. Quando viene utilizzato in una password all'interno di uno script o di un file di configurazione, potrebbe essere interpretato erroneamente come una variabile o un carattere di controllo.

Ecco alcuni casi frequenti in cui non è consigliabile utilizzare il carattere $ in una password:

• PowerShell: il simbolo $ viene utilizzato per dichiarare le variabili. Una password contenente $ potrebbe causare errori di sintassi o essere troncata.
• Bash / Shell (Linux): $ è anche un prefisso di variabile. Potrebbe innescare sostituzioni inattese.
• File YAML (ad esempio Home Assistant, GitHub Actions, Docker Compose): $ può essere interpretato come una variabile d'ambiente.
• File .env, .ini o altri file di configurazione: gli strumenti che leggono questi file potrebbero tentare di interpretare le variabili.
• Comandi o URL con autenticazione: una password contenente il carattere $ potrebbe essere codificata in modo errato o causare errori durante l'analisi.

Per correggere o prevenire questo tipo di errore:

• Evitate di utilizzare il carattere $ nelle password destinate all'uso in script o sistemi automatizzati.
• Se è assolutamente necessario utilizzarlo, racchiudete sempre la stringa della password correttamente in base al linguaggio:
  • In PowerShell: utilizzate le virgolette singole 'password$Test', se possibile.
  • In Python: assicuratevi che la stringa sia racchiusa tra virgolette singole o doppie, senza interpretazioni.
  • In Bash: utilizzate il carattere di escape \$ per il carattere $.