User Tools

Site Tools


add_mail_recipients

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
add_mail_recipients [2017/03/04 18:20] lucyadd_mail_recipients [2019/03/20 13:22] – [Import Recipients] lucy
Line 1: Line 1:
-===== How to Enter Your Recipients =====+===== Introduction=====
  
-In every campaign you need to configure the target email addressesUSB devices or phone numbers (users) under Admin/Recipients. +Every campaign needs a recipient group to work. The recipient group are the users who receive the attack simulation or awareness content. You can create multiple groups for a single campaign. Groups can be used within LUCY to target users with specific phishing or training campaigns. Many organizations start by grouping users by department, location (if you have multiple office locations), or even domains (if there are multiple domains). The recipients can be in any number of groups and you can set up an unlimited number of groups. 
 + 
 + 
 +===== How to Enter Your Recipients? ===== 
 + 
 +Recipients and groups can be configured under Admin/Recipients. 
  
 {{ 45.jpg?direct&600 }} {{ 45.jpg?direct&600 }}
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. This feature is still in beta release.+**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 =====
Line 17: Line 23:
 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). 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.+**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.
  
 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:  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: 
Line 42: Line 48:
 sarah@example:Sarah::boston sarah@example:Sarah::boston
  
-{{ 48.jpg?direct&600 }}+{{add_mail_recep.png?600}} 
 + 
 + 
 +===== Adding multiple groups in a campaign  and associating them with a scenario ===== 
 + 
 +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?600 }} 
 + 
 +The default mapping is "campaign and awareness". This means the user group will recieve the phishing simulation and if configured, also the elarning content. If you wish, you can limit the mapping to "awarness only" or "campaign only". If you for example configure "campaign only", the according group would only get the attack simulation, but no elearning. 
 + 
 +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 "Distribute users over selected scenarios". Lucy will then randomly split the users over the selected scenarios. Every user will get a unique single attack and no user will be attacked with the same scenario twice. If you want to control the distribution of receivers even more deeply, you would have to create a [[scheduler|scheduler rule]]. This allows the distribution to be even more complex. 
  
  
Line 48: Line 68:
  
 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.
 +
 +
 +=====  Recipient group associations =====
 +
 +If you have multiple recipient groups with the same name (this can happen if you for example copy a campaign with recipients), use this procedure to find the correct group/campaign association:
 +
 +Step 1: Go to your campaign under "recipients"
 +Step 2: Click on the recipient link to get to the associated group 
 +Step 3: Rename your group in order to identify it better
 +
 +As an alternative you can also hover over the link and look at the group ID. When you hover over the groups within the generic recipient settings, you will see also the corresponding ID's.
 +
 +{{ recipient_association.png?600 }}
 +
 +
  
 ===== Language considerations ===== ===== Language considerations =====
Line 67: Line 102:
 {{ addrec3.png?600 }} {{ addrec3.png?600 }}
  
 +
 +===== 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?600 }}
 +
 +
 +===== Recipient actions within a running campaign =====
 +
 +Under the statistics/recipient tab you will have a table view of all recipients used in a campaign. In the last column you can (1) re-send an attack to a specific user, (2) edit the users detail or (3) remove the user stats from the specific campaign:
 +
 +{{ recipien_man.png?600 }}
  
  
Line 100: Line 148:
 {{ recipient_csutom3.png?600 }} {{ recipient_csutom3.png?600 }}
  
 +====== 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?600 }}
 +
 +We use different sources like Bing or Google.
 +
 +
 +====== Analysis of the campaign based on recipient attributes ======
 +
 +All attributes defined within the Recipient group can be analyzed within the campagin statistics or data exports:
 +
 +{{ custom_attr_stats.png?600 }}
  
add_mail_recipients.txt · Last modified: 2021/10/26 13:18 by lucysecurity