Wiki source code of E-Mail-Server


Hide last authors
awa 1.1 1 {{content/}}
2
MKO 23.2 3 {{figure image="system_email_settings_en.png" width="600"}}
4 The user interface for editing the mail server settings. Other than some general connection settings you can also change how supoprt request emails are sent.
awa 1.1 5 {{/figure}}
6
7 {{info}}
MKO 23.2 8 When a global mail server was configured and a client did not specify their [[own mail server>>doc:Formcycle.UserInterface.Client.Settings]], the global mail server is used for that client. Otherwise, the mail server of the client is used. When no global mail server was configured, sending emails is disabled for the entire system.
9
10 Since version {{version major="7" minor="3"/}} it is possible that the system administrator deactivates the usage of the system wide email server for a client and also the configurability of the client specific server (see [[here>>doc:Formcycle.UserInterface.Client.Settings]]). If this is the case or, if applicable, no client-specific e-mail server is configured, corresponding functionalities with mail delivery are not available.
awa 1.1 11 {{/info}}
12
MKO 23.2 13 This menu lets you setup a global mail server. A mail server is required to sent emails. Sending emails may be necessary for certain functionality such as sending a user their login details. The mail server settings consists of three sections.
awa 1.1 14
MKO 23.2 15 == Base settings ==
awa 1.1 16
MKO 23.2 17 Here you can find settings required to establish a connection to the mail server.
awa 1.1 18
MKO 23.2 19 ; Use mail server
20 : When the global mail server is disabled, no emails can be sent, event when a [[client-specific mail server>>doc:Formcycle.UserInterface.Client.Settings]] exists.
21 ; Authentication {{version major="7" minor="3"/}}
22 : Specifies the type of authentication against the email server.
23 ; Mail server
24 : The address to the mail server.
25 ; Port
26 : The port on which the mail server listens. The default port for {{smallcaps}}Smtp{{/smallcaps}} is 25.
27 ; Sender address
28 : The address of the sender. This address is used for emails sent by the system, such as sending a user their login details. This address can be seen in the sent emails.
29 ; Sender name
30 : The name of the sender. This name is used for emails sent by the system, such as sending a user their login details. This name can be seen in the sent emails.
31 ; Server supports UTF-8 message headers (RFC6532)  {{version major="7" minor="1"/}}
32 : When the email server supports UTF-8 message headers according to RFC6532, this option should be enabled. You can then send email to internationalized email addresses such as //山田太郎@株式.会社//.
awa 1.1 33
MKO 23.2 34 If you would like to check whether you entered the email server settings correctly, you can use the button //send mail// to send a test email to any given email address.
awa 1.1 35
MKO 23.2 36 == Security ==
awa 1.1 37
MKO 23.2 38 Here you can find settings required to secure the connection to the mail server.
awa 1.1 39
MKO 23.2 40 === Username and password ===
Release Notes 9.1 41
MKO 23.2 42 {{figure image="username_password_en.png" width="600"}}{{/figure}}
Release Notes 10.1 43
MKO 23.2 44 ; Sign in required (until 7.3.0)
45 : Check this option if the email server requires authentication.
Release Notes 9.1 46
MKO 23.2 47 ; Encryption
48 : The type of encryption the mail server expects.
49 ; Username
50 : The username to access the mail server.
51 ; Password
52 : The password for the given username.
awa 1.1 53
Release Notes 9.1 54 === Microsoft Office 365 (Graph API) {{version major="7" minor="3"/}} ===
55
MKO 23.2 56 {{figure image="mail_office365_en.png" width="600"}}{{/figure}}
Release Notes 10.1 57
MKO 23.2 58 ; Directory (tenant) ID
59 : Unique ID of the directory (tenant), which is used for sending the emails. You can find this in the overview of your Azure tenant.
60 ; Application (client) ID
61 : Unique ID of the application (client). After creating a new app registration, you can take it from the list of registrations.
62 ; Client secret
63 : Secret key which is used to authenticate your client. After creating a new client key within Azure, it is displayed temporarily. It is not possible to view it later, so it must be created again if it is lost.
Release Notes 9.1 64
Release Notes 17.1 65 {{info}}
MKO 23.2 66 Please note that in the Azure Active Directory Admin Center, the API application permissions **Mail.Send** as well as **User.Read.All** must be granted. Furthermore, only a user within the Azure AD can be used as sender.
Release Notes 17.1 67 {{/info}}
68
awa 1.1 69 == Support ==
70
MKO 23.2 71 Here you can find some settings related to [[support requests>>doc:Formcycle.UserInterface.Support]].
awa 1.1 72
MKO 23.2 73 ; Mail address for support requests
74 : The email address to which support requests are sent.
75 ; Allow client-specific support address
76 : When activated, a client is allowed to change the email address for support requests.
77 ; Attach system information to support requests
78 : When activated, certain system details are attached to support requests. This includes information such as license data, the software version and more. It may help the support team to process support requests in a timely manner.