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

Inleiding

• Als er een authenticatiefout optreedt bij het verzenden van een e-mail via SMTP (bijvoorbeeld authenticatie mislukt, ongeldige gebruikersnaam of wachtwoord), ook al is het wachtwoord correct en werkt het in een programma zoals Outlook, kan het probleem worden veroorzaakt door het teken $ in uw script of configuratiebestand.
• Om een betrouwbare uitvoering van uw SMTP-scripts te garanderen, wordt het sterk aanbevolen om alle speciale tekens met een syntactische betekenis, met name $, te vermijden in de wachtwoorden die in scripts en configuratiebestanden worden gebruikt.
• Het probleem kan ook optreden bij het verbinden met databases.

Regels om te volgen

Het teken $ is in veel talen en omgevingen een speciaal symbool. Als 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 gebruikt mag worden $ in een wachtwoord:

• PowerShell: $ wordt gebruikt om variabelen te definiëren. Een wachtwoord dat $ bevat, kan leiden tot syntaxisfouten of kan worden afgekapt.
• Bash / Shell (Linux): $ is ook een variabeleprefix. Het kan onverwachte substituties 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 een $ bevat, kan verkeerd worden gecodeerd of bij het parsen mislukken.

Om dit probleem op te lossen 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, omsluit dan altijd de wachtwoordreeks correct volgens de taal:
  • In PowerShell: gebruik indien mogelijk enkele aanhalingstekens 'password$Test'.
  • In Python: zorg ervoor dat de reeks tussen enkele of dubbele aanhalingstekens staat, zonder interpretatie.
  • In Bash: ontsnap het $-teken met een backslash \$.