Sending Emails from Your Own Domain

Setting up emails to come from your email server avoids them being at a high risk of being identified as spam. 

Usually, the email address would be a Support or info type email address. We recommend that it is a monitored address so that if a recipient replies to the email, it will be received. Further, we recommend that it is set up so that the password never expires, as it is commonly not noticed for some time that emails are not being sent out.

Setup for SMTP

The fields required are in the Site Settings screen > Email Settings tab:

1. Email Send Method enables you to choose between SMTP and Gmail. If you select Gmail the system will display this screen.
2. From Email Address is the email address that the site will send all emails from. It will often be a support or info email address. We recommend that you do not use alias accounts, as they seem to be more susceptible to spam filtering. The From Name will be the email account's From Name.
3. SMTP Host. This will be available from your email service provider. If you use Gmail it will be smtp.gmail.com.
4. SMTP Port. This will be available from your email service provider. For Gmail (and commonly for other suppliers) it is 587 (Brilliant Assessments uses TLS security).
5. SMTP SSL Enabled. This will be available from your email service provider. Usually, this will be ticked, as most email services use secure transmissions.
6. SMTP User Name. Usually, it is the same as your email address. It will be available from your email service provider.
7. SMTP Password. This will be available from your email service provider.
   •  It is the password you used to set up the email service for this user, or in the case of Gmail it is the password generated for the application. (See more details on setting up Gmail below.) 
   • Note that it is displayed blank after it is saved. You only need to re-enter it if it has changed. Please be assured that we hold this password encrypted, so it is never accessible by us.
8. Reset Email Address fields. When clicking this button, the From Email Address will go back to being noreply@brilliantassessments.com.
9. Send Test Email. When clicking this button, you will receive an email confirming that the set-up was successful:

Setup for Gmail

1. Set Email Send Method to Gmail.
2. Enter your From Email Address and the Display Name, then click Save.
3. After saving, click on Authorize Gmail.
4. This screen will appear - click Continue.
5. Go back to Site Settings -> Email Settings and click Send Test Email.

Setup for Office 365 / Microsoft 365

Brilliant Assessments uses the MS Graph API to access Office 365 / Microsoft 365. Set up a new App Registration for use with Brilliant Assessments so it can send email from your nominated organization's account.

1. Log on to your Azure Portal.
2. Navigate to Microsoft Entra ID -> Manage -> App Registrations.
3. Select New Registration.
4. Name: Brilliant Assessments Email.
5. Supported Accounts: Accounts in this organizational directory only.
6. Click Register to proceed.

7. On the next page record the following GUID values:

   • Application (client) ID
   • Directory (tenant) ID

   

8. Navigate to Manage -> API Permissions.
9. Choose + Add a permission.
10. Note that Microsoft Graph -> User.Read Delegated permission is there by default. Keep this.
11. Under Add Permission:
    • Select Microsoft Graph at the top of the page.
    • Choose Application Permissions.
    • Filter on mail.send.
    • Select Mail.Send: Send mail as any user.
    • Choose Add Permissions.
12. Back on the API Permissions screen, select "Grant admin consent for Your Organization Name". Choose YES when prompted to confirm.
13. Navigate to Certificates & secrets.
14. Choose New Client Secret.
15. Give it a meaningful name such as Brilliant Assessments Email Client.

16. Under Expires, choose the period that you are happy to grant consent for.

    • Important: Keep in mind you will need to renew this consent and/or issue a new Client Secret key before the end of this period to ensure continuous service.
    • Choose Add.

    

17. Copy the Value field.
18. Optional: you could now choose to secure the Application Service to a specific email address within your organization that you are going to use with Brilliant Assessments. This is outside the scope of this tutorial. You can search and use Windows PowerShell scripts to secure this.
19. Next, log on to your https://mysite.brilliantassessments.com company site.
20. Navigate to Administer -> Site Settings -> Email Settings tab.
    • Select MS Graph as the Send Method.
    • Specify the email address from which you wish to send emails.
    • Copy the Directory (tenant) ID from Step 7.
    • Copy the Application (client) ID from Step 7.
    • Copy the Client Secret Value from Step 17.
    • Save settings.
    • Navigate back to Email Settings and click Send Test Email.

FAQs & Troubleshooting

Use the questions below to troubleshoot common setup issues.