Add example files for autodiscover service.

DOC/README.vhost.autodiscover

@@ -0,0 +1,41 @@
+# -- autodiscover.<DOMAIN.TLD> -- #
+
+<VirtualHost 83.223.86.98:443 [2a01:30:0:13:211:84ff:feb7:7f9c]:443>
+
+   ServerAdmin admin@<DOMAIN.TLD>
+
+   ServerName autodiscover.<DOMAIN.TLD>
+
+   RewriteEngine On
+   RewriteCond %{REQUEST_FILENAME} -s [OR]
+   RewriteCond %{REQUEST_FILENAME} -l [OR]
+   RewriteCond %{REQUEST_FILENAME} -d
+   RewriteRule ^.*$ - [NC,L]
+   RewriteRule ^.*$ /autodiscover.php [NC,L]
+
+   <FilesMatch \.php$>
+      SetHandler "proxy:unix:/tmp/php-7.3-fpm.www.sock|fcgi://127.0.0.1"
+   </FilesMatch>
+
+   <IfModule dir_module>
+      DirectoryIndex index.php index.html
+   </IfModule>
+
+   DocumentRoot "/var/www/autodiscover.<DOMAIN.TLD>/htdocs"
+   <Directory "/var/www/autodiscover.<DOMAIN.TLD>/htdocs">
+      Options +FollowSymLinks -Indexes
+      AllowOverride Options Indexes Limit FileInfo AuthConfig
+   </Directory>
+
+   SSLEngine on
+
+   SSLCertificateFile /var/lib/dehydrated/certs/autodiscover.<DOMAIN.TLD>/fullchain.pem
+   SSLCertificateKeyFile /var/lib/dehydrated/certs/autodiscover.<DOMAIN.TLD>/privkey.pem
+
+   CustomLog /var/log/apache2/ip_requests.log base_requests
+
+   CustomLog /var/www/autodiscover.<DOMAIN.TLD>/logs/autodiscover.<DOMAIN.TLD>.log combined
+   ErrorLog /var/www/autodiscover.<DOMAIN.TLD>/logs/autodiscover.<DOMAIN.TLD>.error
+
+</VirtualHost>
+

DOC/autodiscover.php

@@ -0,0 +1,98 @@
+<?php
+
+/********************************
+ * Autodiscover responder
+ ********************************
+ * This PHP script is intended to respond to any request to http(s)://mydomain.com/autodiscover/autodiscover.xml.
+ * If configured properly, it will send a spec-complient autodiscover XML response, pointing mail clients to the
+ * appropriate mail services.
+ * If you use MAPI or ActiveSync, stick with the Autodiscover service your mail server provides for you. But if 
+ * you use POP/IMAP servers, this will provide autoconfiguration to Outlook, Apple Mail and mobile devices.
+ *
+ * To work properly, you'll need to set the service (sub)domains below in the settings section to the correct 
+ * domain names, adjust ports and SSL.
+ */
+
+//get raw POST data so we can extract the email address
+$request = file_get_contents("php://input");
+
+// optional debug log
+# file_put_contents( 'request.log', $request, FILE_APPEND );
+
+// retrieve email address from client request
+preg_match( "/\<EMailAddress\>(.*?)\<\/EMailAddress\>/", $request, $email );
+
+// check for invalid mail, to prevent XSS
+if (filter_var($email[1], FILTER_VALIDATE_EMAIL) === false) {
+	throw new Exception('Invalid E-Mail provided');
+}
+
+// get domain from email address
+$domain = substr( strrchr( $request, "@" ), 1 );
+
+/**************************************
+ *   Port and server settings below   *
+ **************************************/
+
+// POP settings
+#$popServer = 'pop.' . $domain; // pop.example.com
+$popServer = '<POP-SERVER>'; // pop.oopen.de
+$popPort   = 995;
+$popSSL    = true;
+
+// IMAP settings
+#imapServer = 'imap.' . $domain; // imap.example.com
+$imapServer = '<IMAP-SERVER>'; // imap.oopen.de
+$imapPort   = 993;
+$imapSSL    = true;
+
+// SMTP settings
+#$$smtpServer = 'smtp.' . $domain; // smtp.example.com
+$smtpServer = '<SUBMISSION-SERVER>'; // mail.oopen.de
+$smtpPort   = 587;
+$smtpSSL    = true;
+
+//set Content-Type
+header( 'Content-Type: application/xml' );
+?>
+<?php echo '<?xml version="1.0" encoding="utf-8" ?>'; ?>
+<Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
+	<Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
+		<Account>
+			<AccountType>email</AccountType>
+			<Action>settings</Action>
+			<Protocol>
+				<Type>POP3</Type>
+				<Server><?php echo $popServer; ?></Server>
+				<Port><?php echo $popPort; ?></Port>
+				<LoginName><?php echo $email[1]; ?></LoginName>
+				<DomainRequired>off</DomainRequired>
+				<SPA>off</SPA>
+				<SSL><?php echo $popSSL ? 'on' : 'off'; ?></SSL>
+				<AuthRequired>on</AuthRequired>
+			</Protocol>
+			<Protocol>
+				<Type>IMAP</Type>
+				<Server><?php echo $imapServer; ?></Server>
+				<Port><?php echo $imapPort; ?></Port>
+				<DomainRequired>off</DomainRequired>
+				<LoginName><?php echo $email[1]; ?></LoginName>
+				<SPA>off</SPA>
+				<SSL><?php echo $imapSSL ? 'on' : 'off'; ?></SSL>
+				<AuthRequired>on</AuthRequired>
+			</Protocol>
+			<Protocol>
+				<Type>SMTP</Type>
+				<Server><?php echo $smtpServer; ?></Server>
+				<Port><?php echo $smtpPort; ?></Port>
+				<DomainRequired>off</DomainRequired>
+				<LoginName><?php echo $email[1]; ?></LoginName>
+				<SPA>off</SPA>
+				<SSL><?php echo $smtpSSL ? 'on' : 'off'; ?></SSL>
+				<AuthRequired>on</AuthRequired>
+				<UsePOPAuth>on</UsePOPAuth>
+				<SMTPLast>on</SMTPLast>
+			</Protocol>
+		</Account>
+	</Response>
+</Autodiscover>