Documentation Mailcow : Autodiscover et Autoconfig

Introduction

L'Autodiscover et l'Autoconfig sont des fonctionnalités qui permettent aux clients de messagerie de configurer automatiquement les paramètres de connexion. Cette documentation explique comment personnaliser ces fonctionnalités dans Mailcow.

Configuration par défaut

Personnalisation

Pour personnaliser le processus d'Autodiscover ou d'Autoconfig, suivez ces étapes :

1. Ouvrez ou créez le fichier data/web/inc/vars.local.inc.php.
2. Ajoutez vos modifications au tableau de configuration.

Les changements seront fusionnés avec $autodiscover_config dans data/web/inc/vars.inc.php.

Exemple de configuration

<?php
$autodiscover_config = array(
  // Type de service Autodiscover général : "activesync" ou "imap"
  'autodiscoverType' => 'activesync',
  // Utiliser ActiveSync (EAS) pour les clients Outlook de bureau
  'useEASforOutlook' => 'yes',
  'imap' => array(
    'server' => $mailcow_hostname,
    'port' => array_pop(explode(':', getenv('IMAPS_PORT'))),
    'tlsport' => array_pop(explode(':', getenv('IMAP_PORT'))),
  ),
  'pop3' => array(
    'server' => $mailcow_hostname,
    'port' => array_pop(explode(':', getenv('POPS_PORT'))),
    'tlsport' => array_pop(explode(':', getenv('POP_PORT'))),
  ),
  'smtp' => array(
    'server' => $mailcow_hostname,
    'port' => array_pop(explode(':', getenv('SMTPS_PORT'))),
    'tlsport' => array_pop(explode(':', getenv('SUBMISSION_PORT'))),
  ),
  'activesync' => array(
    'url' => 'https://'.$mailcow_hostname.($https_port == 443 ? '' : ':'.$https_port).'/Microsoft-Server-ActiveSync',
  ),
  'caldav' => array(
    'server' => $mailcow_hostname,
    'port' => $https_port,
  ),
  'carddav' => array(
    'server' => $mailcow_hostname,
    'port' => $https_port,
  ),
);
    

Points importants

1. Ne pas utiliser les ports de service STARTTLS dans la variable "port".
2. Le service Autodiscover pointera toujours vers SMTPS et IMAPS (services encapsulés TLS).
3. Le service Autoconfig annoncera également les ports STARTTLS, spécifiés dans la variable "tlsport".

Cas particuliers

• Clients Outlook récents : Les clients Outlook plus récents (en particulier ceux livrés avec O365) ne découvriront pas automatiquement les profils de messagerie.
• ActiveSync : Il est fortement déconseillé d'utiliser ActiveSync avec un client de bureau.
• emClient : Ce client utilise Autodiscover mais ne prend pas en charge ActiveSync. Mailcow exclut emClient d'ActiveSync.
• Outlook pour Mac : Ne prend pas en charge ActiveSync.

Modifications courantes

1. Pour toujours utiliser IMAP et SMTP au lieu d'EAS, définissez :

   'autodiscoverType' => 'imap'

2. Pour désactiver ActiveSync pour les clients Outlook de bureau, définissez :

   'useEASforOutlook' => 'no'

Conclusion

La personnalisation de l'Autodiscover et de l'Autoconfig dans Mailcow permet d'adapter le comportement de la découverte automatique des paramètres de messagerie selon vos besoins spécifiques.