add_mail_recipients
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
add_mail_recipients [2016/11/14 19:08] – lucy | add_mail_recipients [2018/05/31 16:41] – lucy | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ===== How to Enter Your Recipients | + | ===== Introduction===== |
- | In every campaign | + | Every campaign |
+ | |||
+ | |||
+ | ===== How to Enter Your Recipients? ===== | ||
+ | |||
+ | Recipients and groups can be configured | ||
{{ 45.jpg? | {{ 45.jpg? | ||
Line 11: | Line 16: | ||
We recommend importing them because it will enable you to create a custom text file with additional information about each target user (e.g. defining the division or location where they work). This information can later be used for automatic analysis and statistics. The more information you provide, the better. | We recommend importing them because it will enable you to create a custom text file with additional information about each target user (e.g. defining the division or location where they work). This information can later be used for automatic analysis and statistics. The more information you provide, the better. | ||
- | **Note**: Searching the internet without a Bing or Google API won't get you the same results as if you searched directly with a search engine. | + | **Note**: Searching the internet without a Bing or Google API won't get you the same results as if you searched directly with a search engine. |
===== Import Recipients ===== | ===== Import Recipients ===== | ||
- | You can import the recipients via file or via [[ldap_integration|LDAP]]. | + | You can import the recipients via file or via [[ldap_integration|LDAP]]. There is no restriction on the number of recipients you can add to a group (even though your license might restrict the sending of all mails). |
+ | |||
+ | **SYNTAX**: LUCY requires a [[recipient_import_and_syntax_issues|special syntax]]. Otherwise it will throw an error. In LUCY version > 3.1 it will continue the import with the correct recipients. In an awareness or phishing campaign which is send via email, it will need at least the mail address as a mandatory field. All other fields are voluntary. | ||
- | **SYNTAX**: | + | The import file should contain one recipient per line. Each record should consist of 1 to 7 columns separated by the colon symbol (:). All columns, except for the first one, are optional. If you want to skip the column value, just don't type anything between columns separators (:). You can skip the columns at the end of the record - for example, if you have only Email and Name, you can just specify these 2 columns. The email address is mandatory for the Recipient list. All other fields (like Name) are compulsory. If you want to send a personalized email (using the %name% variable within the email or landing page) you need to define the Name field too. The possible columns are: |
* 1.Email - Recipient' | * 1.Email - Recipient' | ||
Line 31: | Line 39: | ||
Note about language: if you upload a recipient group file (txt or CSV) and want to specify the language you need to use the English description (example " | Note about language: if you upload a recipient group file (txt or CSV) and want to specify the language you need to use the English description (example " | ||
- | **FILE FORMAT**: You can import a plain text file (.txt) or -csv format and name it whatever | + | **FILE FORMAT**: You can import a plain text file (.txt) or -csv format and name it as you want. |
**EXAMPLE**: | **EXAMPLE**: | ||
Line 41: | Line 49: | ||
{{ 48.jpg? | {{ 48.jpg? | ||
+ | |||
+ | ===== Adding multiple groups in a campaign | ||
+ | |||
+ | LUCY allows you to add multiple groups in one campaign. After you added a group, you will be asked to define: | ||
+ | |||
+ | - mapping (1) | ||
+ | - scenario (2) | ||
+ | |||
+ | {{ mapping_rec.png? | ||
+ | |||
+ | The default mapping is " | ||
+ | |||
+ | The scenario association can be used to control, which group gets which attack scenario. In the screenshot you see (2) that all the available scenarios added to the campaign will be displayed. Example: If you select 2 scenarios with a specific group, each user from this group will get two emails (one from scenario 1 and one from scenario 2). If you don't want the users to get multiple emails, you can enable the checkbox " | ||
Line 46: | Line 67: | ||
In LUCY you can add recipients to a running campaign. Please [[i_want_to_add_a_few_extra_mails_into_a_running_campaign|click here]] to read more. | In LUCY you can add recipients to a running campaign. Please [[i_want_to_add_a_few_extra_mails_into_a_running_campaign|click here]] to read more. | ||
+ | |||
===== Language considerations ===== | ===== Language considerations ===== | ||
Line 65: | Line 87: | ||
{{ addrec3.png? | {{ addrec3.png? | ||
+ | |||
+ | ===== Disable recipients from a group within a campaign ===== | ||
+ | |||
+ | You can load a group into LUCY and then uncheck users, you don't want to test or train in this specific campaign. Just click on the according checkbox: | ||
+ | |||
+ | {{ recipient_filtering.png? | ||
+ | |||
+ | |||
+ | ===== Recipient actions within a running campaign ===== | ||
+ | |||
+ | Under the statistics/ | ||
+ | |||
+ | {{ recipien_man.png? | ||
Line 77: | Line 112: | ||
===== Import Error-Log ===== | ===== Import Error-Log ===== | ||
- | LUCY > 3.1 will create an import error log which will help you to quickly identify import errors with mail addresses that had a syntax error. | + | LUCY > 3.1 will create an import error log which will help you to quickly identify import errors with mail addresses that had a syntax error. For LUCY < 3.1 please [[recipient_import_and_syntax_issues|click here]]. Please not that LUCY cannot handle wrong syntax. Also don't use header lines. Duplicate or wrong entries will not be imported. |
{{ import_error.png? | {{ import_error.png? | ||
+ | |||
+ | |||
+ | ===== Custom Recipient Fields ===== | ||
+ | |||
+ | In LUCY > 3.3 you have the ability to create custom recipient fields. You can add any new recipient attribute you want (e.g. city, gender, education etc.). Those attributes can be used for using customized statistics in LUCY (dashboard filters or raw exports). | ||
+ | |||
+ | |||
+ | |||
+ | In order to create a new custom field go to recipients. Under the recipient link you will find the " | ||
+ | |||
+ | {{ recip_custom.png? | ||
+ | |||
+ | The new recipient attribute (can be freely chosen) is then added as a new attribute in the recipient list: | ||
+ | |||
+ | {{ recipient_custom2.png? | ||
+ | |||
+ | {{ recipient_csutom3.png? | ||
+ | |||
+ | ====== E-Mail Scanning Feature (E-Mail Spider) ====== | ||
+ | |||
+ | Under the recipient tab you find an option to scan for mail addresses in the internet. | ||
+ | |||
+ | {{ scanmails.png? | ||
+ | |||
+ | We use different sources like Bing or Google. | ||
add_mail_recipients.txt · Last modified: 2021/10/26 13:18 by lucysecurity