Wiki source code of Mail Listener
Last modified by Outhman Moustaghfir on 2022/06/13 13:18
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = Introduction = | ||
| 6 | |||
| 7 | "MailListener" is a listener based on mail event that triggers the beginning of a process or scenario. | ||
| 8 | |||
| 9 | |||
| 10 | [[image:2022-03-01_11h26_36.png||height="120" width="121"]] | ||
| 11 | |||
| 12 | = Configuration = | ||
| 13 | |||
| 14 | The configuration of a mail listener is divided into 2 parts : | ||
| 15 | |||
| 16 | ===== configuration COM : ===== | ||
| 17 | |||
| 18 | [[image:2022-03-01_11h58_40.png||height="221" width="220"]] | ||
| 19 | |||
| 20 | this is the first one to set, it consists of putting the e-mail address and password. | ||
| 21 | |||
| 22 | [[image:2022-03-01_11h58_04.png||height="251" width="739"]] | ||
| 23 | |||
| 24 | Then, we can set multiple listeners linked to that email, and start using them in "mailListener" Connector. | ||
| 25 | |||
| 26 | |||
| 27 | [[image:2022-03-01_12h01_13.png||height="371" width="719"]] [[image:2022-03-01_12h02_50.png||height="287" width="426"]] | ||
| 28 | |||
| 29 | The parameters mentioned for a listener are : | ||
| 30 | |||
| 31 | * __ConfigName__: the name of the listener's configuration. | ||
| 32 | * __From__: the regex pattern referring to address mail sender. | ||
| 33 | * __Object__: the regex pattern referring to the mail subject. | ||
| 34 | * __Actif / Enabled__: chose whether we want to use the configuration or just keep and not use it (without any delete). | ||
| 35 | |||
| 36 | **__NB__:** the emails configured are unique by the environment, and cannot be reused in another environment. | ||
| 37 | |||
| 38 | ===== Config MailListener Connector ===== | ||
| 39 | |||
| 40 | ((( | ||
| 41 | After finishing the mail configuration, let's make a scenario containing a MailListener connector : | ||
| 42 | ))) | ||
| 43 | |||
| 44 | ((( | ||
| 45 | |||
| 46 | ))) | ||
| 47 | |||
| 48 | ((( | ||
| 49 | [[image:2022-03-01_14h11_52.png]] | ||
| 50 | ))) | ||
| 51 | |||
| 52 | ((( | ||
| 53 | |||
| 54 | ))) | ||
| 55 | |||
| 56 | ((( | ||
| 57 | |||
| 58 | ))) | ||
| 59 | |||
| 60 | ((( | ||
| 61 | The parameters mentioned in the connector are : | ||
| 62 | ))) | ||
| 63 | |||
| 64 | * __Listened emails__: a list of all emails configured previously. | ||
| 65 | * __config__: a list of listeners corresponding to email. | ||
| 66 | * __mask__: a regex pattern for the input file name. it is set by default to '__.*__', meaning all files. | ||
| 67 | |||
| 68 | |||
| 69 | **__NB:__** if an email configuration is set without deploying any scenario, you may expect to receive some warning session on the exploitation page, that indicates the reception of an input file by mail without processing any scenario. | ||
| 70 | |||
| 71 | [[image:2022-03-01_14h34_30.png]] | ||
| 72 | |||
| 73 | |||
| 74 |