Dieser Leitfaden beschreibt die spezifischen Regeln, die bei der Verwendung eines Passworts mit dem Zeichen „Dollar“ $ für den E-Mail-Versand über das SMTP von Infomaniak in einem Skript (PowerShell, Python usw.) zu beachten sind.

Einleitung

• Wenn beim Senden einer E-Mail über SMTP eine Authentifizierungsfehlermeldung angezeigt wird (z. B. auth failed, ungültiger Benutzername oder falsches Passwort), obwohl das Passwort korrekt ist und in einem Programm wie Outlook funktioniert, kann das Problem darin liegen, wie das Zeichen $ in Ihrem Skript oder Ihrer Konfigurationsdatei verarbeitet wird.
• Um eine zuverlässige Ausführung Ihrer SMTP-Skripte zu gewährleisten, wird dringend empfohlen, die Verwendung von Sonderzeichen, die eine syntaktische Bedeutung haben, insbesondere $, in den Passwörtern zu vermeiden, die in Skripten und Konfigurationsdateien verwendet werden.
• Das Problem kann auch beim Verbinden mit Datenbanken auftreten.

Zu beachtende Regeln

Das Zeichen $ ist ein Sonderzeichen in vielen Programmiersprachen und Umgebungen. Wenn es in einem Skript oder einer Konfigurationsdatei in einem Passwort verwendet wird, kann es fälschlicherweise als Variable oder Steuerzeichen interpretiert werden.

Hier sind einige häufige Fälle, in denen das Zeichen $ nicht in einem Passwort verwendet werden sollte:

• PowerShell: $ wird zur Deklaration von Variablen verwendet. Ein Passwort, das $ enthält, kann Syntaxfehler verursachen oder abgeschnitten werden.
• Bash / Shell (Linux): $ ist auch ein Variablenpräfix. Es kann zu unerwarteten Ersetzungen führen.
• YAML-Dateien (z. B. Home Assistant, GitHub Actions, Docker Compose): $ kann als Umgebungsvariable interpretiert werden.
• .env-, .ini- oder andere Konfigurationsdateien: Die Tools, die diese Dateien lesen, können versuchen, Variablen zu interpretieren.
• Befehle oder URLs mit Authentifizierung: Ein Passwort, das das Zeichen $ enthält, kann falsch codiert oder bei der Verarbeitung fehlschlagen.

Um diesen Fehler zu beheben oder zu vermeiden:

• Vermeiden Sie die Verwendung des Zeichens $ in Passwörtern, die in Skripten oder automatisierten Systemen verwendet werden sollen.
• Wenn Sie es unbedingt verwenden müssen, umschließen Sie die Passwortzeichenfolge immer korrekt, je nach verwendeter Sprache:
  • In PowerShell: Verwenden Sie nach Möglichkeit einfache Anführungszeichen 'password$Test'.
  • In Python: Stellen Sie sicher, dass die Zeichenfolge korrekt in einfache oder doppelte Anführungszeichen eingeschlossen ist, ohne dass sie interpretiert wird.
  • In Bash: Escapen Sie das $ mit einem Backslash \$.