... |
... |
@@ -6,6 +6,8 @@ |
6 |
6 |
|
7 |
7 |
{{info}} |
8 |
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. |
9 |
9 |
{{/info}} |
10 |
10 |
|
11 |
11 |
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. |
... |
... |
@@ -16,6 +16,8 @@ |
16 |
16 |
|
17 |
17 |
; Use mail server |
18 |
18 |
: 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. |
19 |
19 |
; Mail server |
20 |
20 |
: The address to the mail server. |
21 |
21 |
; Port |
... |
... |
@@ -24,6 +24,8 @@ |
24 |
24 |
: 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. |
25 |
25 |
; Sender name |
26 |
26 |
: 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 //山田太郎@株式.会社//. |
27 |
27 |
|
28 |
28 |
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. |
29 |
29 |
|
... |
... |
@@ -31,15 +31,35 @@ |
31 |
31 |
|
32 |
32 |
Here you can find settings required to secure the connection to the mail server. |
33 |
33 |
|
34 |
|
-; Sign in required |
|
40 |
+=== Username and password === |
|
41 |
+ |
|
42 |
+{{figure image="username_password_en.png" width="600"}}{{/figure}} |
|
43 |
+ |
|
44 |
+; Sign in required (until 7.3.0) |
35 |
35 |
: Check this option if the email server requires authentication. |
|
46 |
+ |
|
47 |
+; Encryption |
|
48 |
+: The type of encryption the mail server expects. |
36 |
36 |
; Username |
37 |
37 |
: The username to access the mail server. |
38 |
38 |
; Password |
39 |
39 |
: The password for the given username. |
40 |
|
-; Encryption |
41 |
|
-: The type of encryption the mail server expects. |
42 |
42 |
|
|
54 |
+=== Microsoft Office 365 (Graph API) {{version major="7" minor="3"/}} === |
|
55 |
+ |
|
56 |
+{{figure image="mail_office365_en.png" width="600"}}{{/figure}} |
|
57 |
+ |
|
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. |
|
64 |
+ |
|
65 |
+{{info}} |
|
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. |
|
67 |
+{{/info}} |
|
68 |
+ |
43 |
43 |
== Support == |
44 |
44 |
|
45 |
45 |
Here you can find some settings related to [[support requests>>doc:Formcycle.UserInterface.Support]]. |