Der Befehl authenticated() überprüft den Identifikationsstatus des Absenders.
Der Identifikationsstatus des Absenders beinhaltet die Identität und die Authentifizierung.
Für das Authentifizieren wird zunächst geprüft, ob der Sender-Header vorhanden ist und dessen Inhalt gegebenenfalls zwischengespeichert. Ist kein Sender-Header vorhanden, wird der Inhalt des Envelope-From (Envelop MAIL) stattdessen zwischengespeichert. Gehört die zwischengespeicherte Adresse einer Managed Domain an, so wird diese für das Authentifizieren genutzt, sofern der From-Header keine Adresse einer Managed Domain enthält.
Für das erfolgreiche Authentifizieren eines Absenders muss die - wie oben beschrieben ermittelte - SMTP-Adresse als «Named User» (siehe Users) bereits auf der Appliance vorhanden sein.
Aufbau des Befehls
authenticated(['from-header']);
Rückgabewert
positiv |
sofern der Absender erfolgreich authentifiziert werden konnte |
negativ |
bei Fehlschlagen der Authentifizierung des Absenders |
Parameter
from-header (optional)
Erzwingt das Authentifizieren anhand der SMTP-Adresse des From-Headers.
Mögliche Werte
•true, yes oder 1
•false, no oder 0
Standardeinstellung ist 0
|
Der für eine E-Mail Signatur benötigte Schlüssel wird immer anhand der E-Mail Adresse des authentifizierten Benutzers herangezogen. Das heisst, sofern der Parameter from-header den Wert «1» erhält, wird das Signieren mit dem Schlüssel des Absenders aus dem From-Header erzwungen. |
Beispiel 1
Zeile |
Code |
|---|---|
01 |
if (!authenticated()) { |
02 |
createaccount(); |
03 |
log(1,'user account generated'); |
04 |
} |
Erklärung
Das Beispiel wertet den negierten Rückgabewert des Befehls authenticated() aus (Zeile 01). Konnte der interne Absender der E-Mail erfolgreich authentifiziert werden, so ist der Rückgabewert aufgrund der Negierung false. Schlug das Authentifizieren fehl, so ist der Rückgabewert aufgrund der Negierung true und der angeführte Anweisungsblock kommt zum Tragen. Im Beispiel würde somit ein Benutzerkonto für den - wie eingehend beschrieben ermittelten Absender angelegt (Zeile 02) und ein entsprechender Log-Eintrag erzeugt (Zeile 03).
Beispiel 2
Zeile |
Code |
|---|---|
01 |
if (!authenticated('1')) { |
02 |
createaccount(); |
03 |
log(1,'user account generated'); |
04 |
} |
Erklärung
Im Gegensatz zu Beispiel 1 wird aufgrund des gesetzten Parameters 'from-header' das Verwenden des Absenders aus dem FROM-Header erzwungen.
