Der Befehl createaccount() erstellt neue Benutzerkonten.
Als Benutzerkonto wird ein lokales SEPPmail Secure E-Mail Gateway Benutzerkonto bezeichnet. Dieses Benutzerkonto kann im Menü Users eingesehen werden.
|
Wird createaccount() in Custom macros and commands for all e-mails BEFORE processing aufgerufen, so muss durch incoming() zunächst die Richtung einer E-Mail (eingehend / ausgehend) bestimmt werden, da an dieser Stelle noch keine Entscheidung über die Gültigkeit und Richtung der Mail getätigt wurde. Empfohlen wird Macros lediglich für ein Flagging (zum Beispiel über ldap_compare()) zu verwenden um dann in Custom commands for outgoing e-mails BEFORE encryption eine entsprechende Aktion auszuführen. |
Aufbau des Befehls
createaccount([0],['userID'],['name']);
Rückgabewert
positiv |
immer |
Parameter
keys
Dieser Parameter wurde außer Kraft gesetzt. Für das Generieren von Schlüsselmaterial ist ausschließlich der Befehl createkeys() zu verwenden.
Sollen weitere Parameter verwendet werden, so muss keys zwingend mit null (0) angegeben werden, sofern weitere Parameter verwendet werden sollen.
userID (optional)
Dieser Parameter gibt die eindeutige ID des Benutzers an.
Wird dieser Parameter nicht angegeben, so wird für das Generieren des Benutzers seine E-Mail Adresse als userID verwendet. Sonderzeichen werden automatisch ersetzt.
Variablen verfügbar!
name (optional)
Dieser Parameter gibt des Namen des Benutzers an.
Wird dieser Parameter nicht angegeben, so wird für das Generieren des Benutzers der Anzeigename, beziehungsweise wenn dieser nicht vorhanden ist seine E-Mail Adresse als name verwendet. Sonderzeichen werden automatisch ersetzt.
Variablen verfügbar!
Beispiel 1
Zeile |
Code |
|---|---|
01 |
if (!authenticated()) { |
03 |
createaccount(); |
04 |
log(1,'user account generated'); |
05 |
} |
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 Absender angelegt (Zeile 02) und ein entsprechender Log-Eintrag erzeugt (Zeile 03).
