SMTP Settings - Revision history

Ltalaschus at 12:17, 5 September 2025

2025-09-05T12:17:56Z

Ltalaschus at 09:38, 18 July 2025

2025-07-18T09:38:07Z

Ltalaschus: /* Troubleshooting */

2025-07-18T08:27:44Z

Troubleshooting

Ltalaschus at 11:33, 15 July 2025

2025-07-15T11:33:55Z

Ltalaschus: /* Microsoft 365 and Microsoft 365 (21 Vianet) */

2025-07-15T11:19:53Z

Microsoft 365 and Microsoft 365 (21 Vianet)

Ltalaschus at 11:49, 9 July 2025

2025-07-09T11:49:41Z

Cstelzmann at 15:31, 24 June 2025

2025-06-24T15:31:16Z

Cstelzmann at 15:09, 24 June 2025

2025-06-24T15:09:49Z

Ltalaschus at 14:07, 23 June 2025

2025-06-23T14:07:55Z

Dweuthen at 16:22, 7 December 2020

2020-12-07T16:22:22Z

@@ Line 43: / Line 43: @@
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">New-ServicePrincipal -AppId <appID> -ObjectId <enterpriseAppObjectID> -DisplayName "MailStore Service Principal"</source>
 * The service principal must now be granted permission to send emails on behalf of a user. This user's email address must later be specified as the sender in the MailStore SMTP settings:
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Add-MailboxPermission -Identity "emailAddressOf@sending.user" -User <enterpriseAppObjectID> -AccessRights FullAccess</source>
 * Additionally, make sure that SMTP is allowed for this user:

@@ Line 37: / Line 37: @@
 * Then the module can be loaded:
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Import-module ExchangeOnlineManagement</source>
-* Connect with your client:
+* Connect with your client, use a user who has ''Role Management'' permissions:
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Connect-ExchangeOnline -Organization <tenantID></source>
 * Creating the app registration also resulted in the creation of an Enterprise App with its ''own ObjectID'' in your tenant. The next step requires the Enterprise App's ObjectID (not from the original app registration) and ApplicationID. Both can be found in the Entra ID Portal at [https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview this page].

@@ Line 69: / Line 69: @@
 # check whether SMTP is enabled for that user, the output should be "False"
 Get-CASMailbox -Identity "emailAddressOf@sending.user" | Format-List SmtpClientAuthenticationDisabled</source>
+* If you are using Microsoft 365 and excuting the command ''New-ServicePrincipal'' fails with the error ''The term 'New-ServicePrincipal' is not recognized as a name of a cmdlet, function, script file, or executable program.'', then the user used to connect does not have proper permissions in the tenant. ''Role Management'' permissions are required.
 [[de:SMTP-Einstellungen]]
 [[en:SMTP Settings]]

@@ Line 59: / Line 59: @@
 * If an error message appears because of invalid access data (''"Incorrect authentication data"''or ''"Authentication failed"''), verify the data entered. In most cases, the access data match those of the corresponding POP3 server.
 * If further error messages appear or other problems arise, please check your entries for possible mistakes.
 [[de:SMTP-Einstellungen]]
 [[en:SMTP Settings]]

@@ Line 33: / Line 33: @@
 * If the output is empty, the module can be installed with the following command:
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Install-Module -Name ExchangeOnlineManagement</source>
 * Then the module can be loaded:
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Import-module ExchangeOnlineManagement</source>

@@ Line 41: / Line 41: @@
 *; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">New-ServicePrincipal -AppId <appID> -ObjectId <enterpriseAppObjectID> -DisplayName "MailStore Service Principal"</source>
 * The service principal must now be granted permission to send emails on behalf of a user. This user's email address must later be specified as the sender in the MailStore SMTP settings:
-*; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Add-MailboxPermission -Identity "emailAddressof@sending.user" -User <enterpriseAppObjectID> -AccessRights FullAccess</source>
+*; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Add-MailboxPermission -Identity "emailAddressOf@sending.user" -User <enterpriseAppObjectID> -AccessRights FullAccess</source>
 * Additionally, make sure that SMTP is allowed for this user:
-*; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Set-CASMailbox -Identity "emailAddressof@sending.user" -SmtpClientAuthenticationDisabled $false</source>
+*; <source lang="powershell" smart-tabs="true" toolbar="false" gutter="false">Set-CASMailbox -Identity "emailAddressOf@sending.user" -SmtpClientAuthenticationDisabled $false</source>
 * Click the &hellip; in the ''Credentials'' section and select your ''Credentials''.

@@ Line 1: / Line 1: @@
 To be able to send emails, MailStore Server requires SMTP access data. MailStore sends notifications by email if [[Product Updates|product updates]] are available or if the automatic creation of a new [[Storage_Locations|archive store]] failed.  Furthermore, email copies for the [[Accessing_the_Archive_with_MailStore_Web_Access#Restoring_Email|restore from MailStore Web Access]] can be sent via SMTP.
 [[File:tech_smtpsettings_01.png|center|550px]]
-Under ''Administrative Tools > Miscellaneous > SMTP Settings'' you can specify the SMTP settings.
+* Select the type ''Standard''.
 * Under ''Server'', enter the host name of the SMTP server or its IP address.
 * By default, MailStore uses port 587. If you want to use a different port, enter port number in the ''Port'' field.
 * In the field ''Protocol'', select ''SMTP'' for an unencrypted connection to the SMTP server. For an encrypted connection, select ''SMTP-TLS'' or ''SMTP-SSL''. {{Option_Accept_all_certificates}}
 * Especially SMTP servers which are accessible through the internet require a login (SMTP authentication). Check the corresponding checkbox and enter the appropriate access data. In most cases, the POP3 access data of any user on the email server can be used.
 * Under ''Sender'', enter the ''Display Name'' and the ''Email Address'' of the email sender. Many SMTP servers require an existing email address to be entered. The display name can be chosen freely; ideally the name indicates that the email was sent by MailStore Server.
 * Under ''Recipient for Notifications'', enter the email address of the recipient for administrative notifications of MailStore Server. To specify multiple recipients, enter them comma-separated.