Difference between revisions of "Email settings for sending emails"

From Charitylog Manual
Jump to: navigation, search
(IP addresses)
 
(91 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
[[File:helpheader_small.png|right]]
 
[[File:helpheader_small.png|right]]
  
''Location in standard build:'' '''''[[Admin]] menu > 3rd Party Software > Email Setup'''''
+
See also [[Receiving_and_processing_emails]]
  
[[File:cl_ESfC_1.png|border]]
+
__TOC__
  
 +
===Email Options===
 +
There are 2/3 choices for sending emails:
  
There are various places in Charitylog where email can be used - for example, on the [[Details Screen]], email addresses can display an "envelope" icon which will create an email to the relevant person. The "Email Settings for Charitylog" page controls various options for the way that this process happens.
+
1) Using an external email client (e.g. Outlook). Clicking an email address simply launches Outlook's Compose window. No record of the email is kept in the system. No setup is required beyond setting "Enable Email" to Yes.
  
[[File:cl_ESfC_2.png|600px|border]]
+
2) Using your own email servers. Emails are sent through your SMTP servers. A record of the email will appear on the recipient's record (recommended). Follow the instructions on this page to configure this.
  
 +
3) (Older systems may still be using the legacy option of using our servers. Due to email providers increasing SPAM protection we recommend upgrading to option 2).
  
==Settings==
+
===General Email Setup===
  
===Use email service with Charitylog===
+
[[File:Menu_email_setup.png]]
  
Simple yes/no option. Setting to "No" will mean that the envelope icon does '''not''' display on [[Details Screen]]s, for example.
+
[[File:Email_setup.png]]
  
 +
1) Note the Sending email address is the one from [[System Details|System Settings]].
  
===Sending email address for organisation===
+
2) Set 'Use external email client' to 'Use Charitylog'.
  
This is not editable here - it is copied over from the "Email Address (Main)" field on the [[System Details]] page.
+
3) Enter your organisation's email footer, disclaimer and legal text in the 'Email footer' box.
  
 +
4) Enter the email settings:
 +
SMTP Server Address (e.g. mail.example.com)
 +
SMTP Server Username (e.g. noreply@example.com)
 +
SMTP Server Password
 +
SMTP Server Port
 +
SMTP Server Protocol (e.g. None, TLS, SSL)
  
===Use external email client (e.g. Outlook)===
+
===Specific Instructions for Office 365===
  
Choose whether to generate the email within Charitylog (either using Charitylog's SMTP server or your own SMTP server), or have the system create '''mailto''' links to open your own email program.
+
[[File:Diagram_Office_365_email_flow.png|200px|alt="Process flow diagram for an Office365 Connector"]]
  
 +
If you use Microsoft Office 365 you will need to add an email connector on your Exchange online admin centre.
  
===Email footer (company information) legal text===
+
Log in to [https://www.office.com/ Microsoft Office 365] and then click on the Admin Icon.
  
This text will appear at the bottom of emails generated by the system. The Companies Act 2006 requires all of your business emails to include the following details if you are a Ltd, plc or LLP:
+
On the menu click on the down arrow next to Admin Centers and Click Exchange.
  
* Company's registered name
+
In the Exchange Admin centre select mail flow and click on connectors across the top of the page. Click on PLUS '+' icon to add a connector.
* Company registration number
 
* Place of registration (e.g. Scotland or England & Wales)
 
* Your registered office address
 
  
 +
[[File:ES_Connectors.PNG|border]]
  
===Use SMTP Servers===
+
Choose the following scenario;
 +
From: Your organization's email server
 +
To: Office 365
  
Choose whether to use Charitylog's SMTP server, or enter details for your own SMTP server. If you choose the latter, the section below will expand to let you enter all the relevant details.
+
Click on Next to Continue.
  
[[File:cl_ESfC_3.png|600px|border]]
+
[[File:ES_scenario.PNG|border]]
  
 +
Give the connector a name (required) and a description (optional), leave the 'Turn it on' and 'Retain internal Exchange email headers (recommended)' options ticked and click next.
 +
 +
[[File:ES_newconector.PNG|border]]
 +
 +
On the following screen you will need to select the option 'By verifying that the IP address of the sending server matches one of these IP addresses that belong to your organization.
 +
 +
Use the PLUS '+' icon to add the [[#IP_addresses|IP addresses]].
 +
 +
[[File:ES_addip.PNG]]
 +
 +
Click next and then Save on the confirmation page.
 +
 +
You will then need to configure the system settings (see above). The SMTP address will be unique to your organisation. If your email address domain is @mycharity.org.uk then you would need to use
 +
mycharity-org-uk.mail.protection.outlook.com
 +
 +
See below for an example;
 +
 +
[[File:ES_example.PNG]]
 +
 +
You can then use any valid Office 365 username and password.
 +
 +
Many organisations require end to end email encryption. Using Charitylog, Microsoft Office 365 Email and Microsoft Office Rights Management this can be achieved. You will require Azure Information Protection for Office 365 (Please consult your IT team or 365 admin panel for details). Following the above instructions will connect your Charitylog system to Office 365. In the Azure Information Protection section you would set up your protection labels (templates and use the Exchange admin centre to set transport rules for emails from the [[#IP_addresses|IP addresses]].
 +
 +
===Specific Instructions for Gmail===
 +
 +
1) You will require a corporate account and Gsuite.
 +
 +
2) Follow [[https://support.google.com/a/answer/2956491?hl=en these instructions]] to setup a new SMTP relay.
 +
 +
3) You will need to specify a [[#IP_addresses|sending IP address]]
 +
 +
4) Ensure that 'require SMTP authentication is '''NOT''' selected
 +
 +
5) Select Require TLS encryption.
 +
 +
6) In our email settings page, set the following:
 +
 +
[[File:Email_GsuiteSettings.png]]
 +
 +
===Instructions for Other Providers===
 +
 +
The setup will probably be broadly similar to the ones above. Please contact your service provider.
 +
 +
===IP addresses===
 +
 +
Your provider may ask you to enter the IP Addresses used by our application. Please enter all of these:
 +
 +
13.42.72.139
 +
 +
3.9.155.126
 +
 +
18.132.80.157
 +
 +
18.135.235.31
  
===Other information on this page===
 
  
The page also has links to some setup advice for Office 365, G Suite and Mimecast.
 
  
  
 
----
 
----
[[User:Rob Kay|Rob Kay - manual author]] ([[User talk:Rob Kay|talk]]) 16:21, 9 November 2017 (GMT)
+
[[File:helpheader_small.png|right]]
[[file:helpheader_small.png|right]]
 
[[Category:Configuration]]
 
e88601c75fe8c5a460cece2035ba0d4d
 

Latest revision as of 13:45, 29 August 2024

Helpheader small.png

See also Receiving_and_processing_emails

Email Options

There are 2/3 choices for sending emails:

1) Using an external email client (e.g. Outlook). Clicking an email address simply launches Outlook's Compose window. No record of the email is kept in the system. No setup is required beyond setting "Enable Email" to Yes.

2) Using your own email servers. Emails are sent through your SMTP servers. A record of the email will appear on the recipient's record (recommended). Follow the instructions on this page to configure this.

3) (Older systems may still be using the legacy option of using our servers. Due to email providers increasing SPAM protection we recommend upgrading to option 2).

General Email Setup

Menu email setup.png

Email setup.png

1) Note the Sending email address is the one from System Settings.

2) Set 'Use external email client' to 'Use Charitylog'.

3) Enter your organisation's email footer, disclaimer and legal text in the 'Email footer' box.

4) Enter the email settings:

SMTP Server Address (e.g. mail.example.com)
SMTP Server Username (e.g. noreply@example.com)
SMTP Server Password
SMTP Server Port
SMTP Server Protocol (e.g. None, TLS, SSL)

Specific Instructions for Office 365

"Process flow diagram for an Office365 Connector"

If you use Microsoft Office 365 you will need to add an email connector on your Exchange online admin centre.

Log in to Microsoft Office 365 and then click on the Admin Icon.

On the menu click on the down arrow next to Admin Centers and Click Exchange.

In the Exchange Admin centre select mail flow and click on connectors across the top of the page. Click on PLUS '+' icon to add a connector.

ES Connectors.PNG

Choose the following scenario;

From: Your organization's email server
To: Office 365

Click on Next to Continue.

ES scenario.PNG

Give the connector a name (required) and a description (optional), leave the 'Turn it on' and 'Retain internal Exchange email headers (recommended)' options ticked and click next.

ES newconector.PNG

On the following screen you will need to select the option 'By verifying that the IP address of the sending server matches one of these IP addresses that belong to your organization.

Use the PLUS '+' icon to add the IP addresses.

ES addip.PNG

Click next and then Save on the confirmation page.

You will then need to configure the system settings (see above). The SMTP address will be unique to your organisation. If your email address domain is @mycharity.org.uk then you would need to use

mycharity-org-uk.mail.protection.outlook.com

See below for an example;

ES example.PNG

You can then use any valid Office 365 username and password.

Many organisations require end to end email encryption. Using Charitylog, Microsoft Office 365 Email and Microsoft Office Rights Management this can be achieved. You will require Azure Information Protection for Office 365 (Please consult your IT team or 365 admin panel for details). Following the above instructions will connect your Charitylog system to Office 365. In the Azure Information Protection section you would set up your protection labels (templates and use the Exchange admin centre to set transport rules for emails from the IP addresses.

Specific Instructions for Gmail

1) You will require a corporate account and Gsuite.

2) Follow [these instructions] to setup a new SMTP relay.

3) You will need to specify a sending IP address

4) Ensure that 'require SMTP authentication is NOT selected

5) Select Require TLS encryption.

6) In our email settings page, set the following:

Email GsuiteSettings.png

Instructions for Other Providers

The setup will probably be broadly similar to the ones above. Please contact your service provider.

IP addresses

Your provider may ask you to enter the IP Addresses used by our application. Please enter all of these:

13.42.72.139

3.9.155.126

18.132.80.157

18.135.235.31




Helpheader small.png