Question
How to enable / manage / verify mail autodiscover functionality in Plesk Obsidian?
Answer
-
Enable the mail autodiscover on the server:
2.1- Go to Tools & Settings > Mail Server Settings > Settings tab > General options > Enable the Enable mail autodiscover option:
-
Manage the mail autodiscover at Domain or Service Plan level:
3.1- Go to Domains > example.com > Mail Settings tab > Enable the option Enable mail autodiscover > Click OK to enable the mail autodiscover for the domain:
3.1- Go to Service Plans > Service Plan Name > Permissions tab > Enable the Mail autodiscover management option > Click on Update & Sync to grant permissions to a subscription owner to enable or disable the mail autodiscover:
3.2- Go to Service Plans > Service Plan Name > Mail tab > Enable the option Enable mail autodiscover > Click on Update & Sync to enable the mail autodiscover for all the subscriptions synchronized with the service plan:
-
Optional - Verify if the mail autodiscover is available for the different mail clients:
4.1- Create XML file customizing the EMailAddress parameter:
# cat request.xml
<?xml version="1.0" encoding="utf-8"?>
<Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006">
<Request>
<EMailAddress>jdoe@example.com</EMailAddress>
<AcceptableResponseSchema>
http://schemas.microsoft.com/exchange/autodiscover/mobilesync/responseschema/2006
</AcceptableResponseSchema>
</Request>
</Autodiscover>
4.2- Perform a POST request with the file request.xml to the URL https://<domain-name>/autodiscover/autodiscover.xml and the sever will return the following response:
# curl -k -d @request.xml -u jdoe@example.com https://example.com/autodiscover/autodiscover.xml
<Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
<Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
<User>
<DisplayName>jdoe@example.com</DisplayName>
</User>
<Account>
<AccountType>email</AccountType>
<Action>settings</Action>
<Protocol>
<Type>IMAP</Type>
<Server>example.com</Server>
<Port>993</Port>
<DomainRequired>off</DomainRequired>
<SPA>off</SPA>
<SSL>on</SSL>
<AuthRequired>on</AuthRequired>
<LoginName>jdoe@example.com</LoginName>
</Protocol>
<Protocol>
...
</Protocol>
</Account>
</Response>
</Autodiscover>
4.1 - Perform a GET request customizing the emailaddress parameter to the URL https://<domain-name>/mail/config-v1.1.xml?emailaddress=<email-address> and the sever will return the following response:
# curl -k https://example.com/mail/config-v1.1.xml?emailaddress=jdoe@example.com
<clientConfig version="1.1">
<emailProvider id="example.com">
<domain>example.com</domain>
<displayName>jdoe@example.com</displayName>
<displayShortName>jdoe@example.com</displayShortName>
<incomingServer type="imap">
<hostname>example.com</hostname>
<port>993</port>
<socketType>SSL</socketType>
<authentication>password-cleartext</authentication>
<username>jdoe@example.com</username>
</incomingServer>
<outgoingServer type="smtp">
<hostname>example.com</hostname>
<port>465</port>
<socketType>SSL</socketType>
<authentication>password-cleartext</authentication>
<username>jdoe@example.com</username>
</outgoingServer>
<incomingServer type="pop3">
<hostname>example.com</hostname>
<port>995</port>
<socketType>SSL</socketType>
<authentication>password-cleartext</authentication>
<username>jdoe@example.com</username>
</incomingServer>
</emailProvider>
</clientConfig>
Additional information
Check the following table for details on how the feature works depending on the checkboxes enabled/disabled:
| Permissions > Mail autodiscover management | Mail > Enable mail autodiscover | For new domains | For existing domains |
|---|---|---|---|
| Enabled | Disabled |
|
|
| Disabled | Enabled |
|
|
| Disabled | Disabled |
|
|
Comments
6 comments
Ok that sounds pretty nice, but what i have to change in DNS or so if the plesk server isnt my DNS Server.
Do i have to make subdomains like autodiscover.domain.tld and autoconfig.domain.tld and give them a A-Record to my Plesk Server, or how that all work?
greetz Alex
Hi Alexander, should work right away after you enable it basically, because Outlook and Thunderbird do requests to URLs like https://<domain>/autodiscover/autodiscover.xml and https://<domain>/mail/config-v1.1.xml?emailaddress=<address. Means you don't need record autodiscover.domain.tld, you just need your A record for domain.tld
Obsidian 18.021 #3
Thunderbird works perfect
Outlook 2016 doesn't
Android 5.1.1 doesn't
Will test further in the next few days. Running the tests as above to verify show the correct result. Done some research, but couldn't find a reason. Any pointers?
Hello,
Parahoster / Thibaut Robert
Could you, please, provide more information about what you're trying to achieve so that we could make sure that the answer is precise?
TomBob
Are there any errors displayed in Outlook or Android mail client? Also, it's worth checking /var/log/maillog
Hey Ivan Postnikov,
Yeah no problem.
For exemple.
One of my client use his domaine : www.exemple.com and when he try to configure by his mail software (like outlook). The discover show info like this
Input : exemple.com:993
Output : exemple.com:465
But I need to customize this data for using my correct server certificat as : myserver.com:465 ans myserver.com:993
Where Can I change this parameter of the autodiscover ?
Thanks
Hello Parahoster / Thibaut Robert
As I can see, you've already submitted a ticket to us to check this in detail.
Here's the reply from our agent:
In order to change default parameters, you should edit the file which the mail client requests during the process.
The file is different for thunderbird or Outlook.
https://<domain>/autodiscover/autodiscover.xmlhttps://<domain>/mail/config-v1.1.xml?emailaddress=<address>orhttps://<domain>/.well-known/autoconfig/mail/config-v1.1.xml?emailaddress=<address>On this page you have examples containing the same information: How to manage mail autodiscover in Plesk Obsidian?
In case of additional issues/questions, feel free to reply back to the ticket.
Please sign in to leave a comment.