Deze handleiding beschrijft de specifieke regels die u moet volgen bij het gebruik van een wachtwoord dat het teken “dollar” $ bevat om een e-mail te verzenden via de SMTP-server van Infomaniak in een script (PowerShell, Python, enz.).

Inleiding

• Als u bij het verzenden van een e-mail via SMTP een authenticatiefoutmelding krijgt (bijvoorbeeld authenticatie mislukt, ongeldige gebruikersnaam of wachtwoord), terwijl het wachtwoord correct is en wel werkt in een programma zoals Outlook, kan het probleem liggen in de manier waarop het teken $ in uw script of configuratiebestand wordt verwerkt.
• Om een betrouwbare werking van uw SMTP-scripts te garanderen, wordt het sterk aangeraden om het gebruik van speciale tekens met een syntactische betekenis, met name $, in de wachtwoorden die in scripts en configuratiebestanden worden gebruikt, te vermijden.
• Het probleem kan ook optreden bij het verbinden met databases.

Regels om te volgen

Het teken $ is een speciaal symbool in veel programmeertalen en omgevingen. Wanneer het in een wachtwoord in een script of configuratiebestand wordt gebruikt, kan het onterecht worden geïnterpreteerd als een variabele of een besturingsteken.

Hieronder volgen enkele veelvoorkomende gevallen waarin het teken $ niet in een wachtwoord mag worden gebruikt:

• PowerShell: $ wordt gebruikt om variabelen te definiëren. Een wachtwoord dat $ bevat, kan syntaxisfouten veroorzaken of worden afgekapt.
• Bash / Shell (Linux): $ is ook een voorvoegsel voor variabelen. Dit kan onverwachte vervangingen veroorzaken.
• YAML-bestanden (bijvoorbeeld Home Assistant, GitHub Actions, Docker Compose): $ kan worden geïnterpreteerd als een omgevingsvariabele.
• Bestanden .env, .ini of andere configuratiebestanden: de tools die deze bestanden lezen, kunnen proberen de variabelen te interpreteren.
• Opdrachten of URL's met authenticatie: een wachtwoord dat het teken $ bevat, kan verkeerd worden gecodeerd of de analyse kan mislukken.

Om dit type fout te corrigeren of te voorkomen:

• Vermijd het gebruik van het teken $ in wachtwoorden die bedoeld zijn voor gebruik in scripts of geautomatiseerde systemen.
• Als u het absoluut moet gebruiken, zorg er dan altijd voor dat de wachtwoordstring correct wordt omsloten, afhankelijk van de programmeertaal:
  • In PowerShell: gebruik indien mogelijk enkele aanhalingstekens 'password$Test'.
  • In Python: zorg ervoor dat de string correct tussen enkele of dubbele aanhalingstekens staat, zonder interpretatie.
  • In Bash: gebruik een backslash \$ om het $-teken te escapen.