Wiki source code of Configure email device

Last modified by Aurelie Bertrand on 2021/05/19 17:35
Show last authors
1 {{toc/}}
2 ----
3
4 = Prerequisite =
5
6 * You will have to disable HTTPS scanning from the server anti-virus, please see how to with Avast (if Avast is your anti-virus). Avast > Menu >parameters > Protection > Principal agents > Web agent >
7 Then uncheck “Grant HTTPS scan”
8 [[image:https://lh6.googleusercontent.com/_ZE0Aa4jLBaPEzzDwPhvd4sHA5ftlODsmljB71JrTGsnyaY_lW9dAs_Xs69E20oJZBplJT9jpPKxNvUV_V-mm1-ePNsYoiu36egaEVCgrm1kbV-svqTYncedTf4tlzafjiaLBXgPw0c||height="303" width="452"]][[image:https://lh3.googleusercontent.com/aJKrn9iT9WfTE97Gq4kPDZ2N15ChgufQoILH4-Yx9De2bnbAHNpinYVvmL1ncoPyOZVe18Q0QR9qnu7kpwXQsPZLFQib_J_i1kvpMO5qxd77Yub40QV2Js8xEvKojWUI2_a_ty8RM2E||height="300" width="497"]]
9
10 = Setup email server =
11
12
13 You have two ways to set up email parameters:
14
15 * By updating server parameters:
16 ** Before 2020R1
17 [[image:https://lh5.googleusercontent.com/IJz4Hz-lHrGevzugHqeG-eN2K9DmZfHoK3BLc--6tQxqJFAeRQHpVWcgAbmFiLX6PSKSWXwcucm8DBDfRh_5gckfqeVo3kL7OXwmPiWuJ0VVz3AEkXncO580_Eq493Aqn35yS67Yn5A||height="151px;" width="299px;"]]
18 ** After 2020 R1
19 [[image:https://lh3.googleusercontent.com/a_DeRir820jhyBh01nHD9clmqxz0UaMlxpUq6um_sbm40L_GbkxcaezGT5zUMJV_j9x5hb4sKVZYHnc8gsBxcycsNeWCSE4ZGmlOrHoWMDIGJHVQGTSW4MU-dMJrCEwN-1QeOgDAbzA||height="173px;" width="218px;"]]
20
21 * By adding a device in the studio:
22 [[image:https://lh5.googleusercontent.com/HTDzY97-jiJWUc78QLNdFJl3ZtV4yazlV_aF1PB02iyob3lD18wE7MOHMcDdi7Hgjet2UYdZW-1J7xEEQ-P_tHZ2ZaWYnncNheCDXnFKEe2qc8-jmPHfnmGRoJGMXtUeGk1HYhuq9LI||height="295px;" width="336px;"]]
23
24 = Parameters field =
25
26 **Email protocol**: SMTP or SMTPS (SMTP + SSL)
27 **Email Server**: <You email server>
28 **Port**: 587 (TLS/STARTTLS), 465 (SSL)
29
30 |(% style="width:118px" %) [[image:https://lh5.googleusercontent.com/-XJwDgJbk9R5yCcA5FOnReeubb7714bDLA6Zbu9i7VRrty7QLTxVyswvVub1rasR6BVv2G0M5sdka1nPIjxzjQ_y5_yPdw1Kmz5anVWYGagWv30r9PhyIhFVoMdhr0btjcJULwLS8zU||height="97" width="88"]]|(% style="width:1372px" %)
31 Port 587 is supported by almost every SMTP servers and is useful to “TLS connections” and “not encrypted”. Port 465 is a good choice if you need to connect by SSL (but is deprecated).
32
33 **Use TLS/SSL protocol**: Check this option to secure communication.
34
35 |(% style="width:118px" %) [[image:https://lh5.googleusercontent.com/-XJwDgJbk9R5yCcA5FOnReeubb7714bDLA6Zbu9i7VRrty7QLTxVyswvVub1rasR6BVv2G0M5sdka1nPIjxzjQ_y5_yPdw1Kmz5anVWYGagWv30r9PhyIhFVoMdhr0btjcJULwLS8zU||height="97" width="88"]]|(% style="width:1372px" %)
36 SSL and TLS provide two ways to encrypt a communication pipe between two computers (for example, between your laptop and a web server). TLS is the next generation of SSL. SSL and TLS means now the same unless you reference a specific version of the protocol.
37
38 **Expeditor address**: <The email address of the expeditor>
39 **Required authentication (STARTTLS)** : Check this option to force authentication while sending emails.
40
41 |(% style="width:118px" %) [[image:https://lh5.googleusercontent.com/-XJwDgJbk9R5yCcA5FOnReeubb7714bDLA6Zbu9i7VRrty7QLTxVyswvVub1rasR6BVv2G0M5sdka1nPIjxzjQ_y5_yPdw1Kmz5anVWYGagWv30r9PhyIhFVoMdhr0btjcJULwLS8zU||height="97" width="88"]]|(% style="width:1372px" %)
42 STARTTLS is a way of upgrading an unsecured existing connection to the security level of a secured one using SSL/TLS. Please note that despite TLS appearing in the name, STARTTLS does not imply that you must use TLS, you can still use SSL.
43
44 **User login**: <Email address to use for authentication>
45 **Mail account password**: <Password to use for authentication>
46
47 |(% style="width:118px" %)
48 [[image:https://lh6.googleusercontent.com/z_rgMaUJuKJxD_2wOx7uMoewAsdz1SswavVUpoLMA1vsaMBsg_dHGVcPHCbMiw6TFzGGckzIsI8A-VF9lBcaXoqKntBJ967cukX1iU-c65EoyGSbkHIVO62pJuNGqLWzpzF1BAW2aL0||height="97" width="88"]]|(% style="width:1372px" %)
49 Sending success depends on the SMTP server configuration. In fact, sending may fail if authentication try is made by an application recognized as risky (Digdash in that case). A way to solve this issue is to authorize the application in the mail server parameters.
50
51 **To mail address**:
52 Fill this filed with the recipient of the mail.
53 The default recipient is ${user.digdashMail}. When sending, this variable is replaced by the value of the user email connected or users of the role in which exist the information flow.
54 It is possible to update this address by using the desired email.
55
56 = Add flux to email device =
57
58 Finally, add a graph to your email device in the studio.
59 An email will be sent each time the flux is refreshed.