Configurer le CatchMail
Le CatchMail doit d'abord être configuré depuis la Console d'administration pour pouvoir être utilisé.
Référence
Pour plus d'informations sur le CatchMail, voir Présentation du CatchMail.
| 1 | Depuis la Console d'administration, allez dans Configuration > Catch Mail et renseignez les informations de configuration : |
| Paramètres | Fonctions |
|---|---|
| Section Configuration Catch Mail | |
| Utiliser le Catch Mail | À cocher pour activer la fonction. |
| Utilisateur Akuiteo |
Renseignez le nom de l’utilisateur CatchMail paramétré dans l'Application Desktop. Ex : CATCH |
| Mot de passe Akuiteo | Renseignez le mot de passe de cet utilisateur. |
| Délai de démarrage (par défaut 20s) |
Renseignez un délai à prendre en compte entre le démarrage du serveur et celui du service Catch mail. En seconde. Ex : 20 |
| Intervalle d'analyse des mails (par défaut 60s) |
Renseignez l’intervalle d’attente entre chaque vérification d’un nouvel email. En seconde. Ex : 60 |
| Utiliser une authentification OAUTH (Exchange 365 seulement) |
Activez ou désactivez l'authentification OAUTH pour la connexion à Exchange. Cette case doit être cochée si Exchange 365 est utilisé par Akuiteo dans votre organisation. Dans les autres cas, cette case doit être décochée. |
| Utiliser la librairie Graph API |
Cochez cette case si vous utilisez l'API Microsoft Graph. Pour plus d'informations sur la configuration avec Microsoft Graph, voir Configuration pour Microsoft Graph. |
| Tenant ID |
Ce champ doit être renseigné si Utiliser une authentification OAUTH (Exchange 365 seulement) ou Utiliser la librairie Graph API est coché. Renseignez l'identifiant de locataire fourni par Microsoft pour l'authentification OAUTH ou la connexion à l'API Microsoft Graph. |
| Client ID |
Ce champ doit être renseigné si Utiliser une authentification OAUTH (Exchange 365 seulement) ou Utiliser la librairie Graph API est coché. Renseignez l'identifiant du client pour l'authentification OAUTH ou la connexion à l'API Microsoft Graph. |
| Client Secret |
Ce champ doit être renseigné si Utiliser une authentification OAUTH (Exchange 365 seulement) ou Utiliser la librairie Graph API est coché. Renseignez le secret du client pour l'authentification OAUTH ou la connexion à l'API Microsoft Graph. |
| Emplacement clé de connexion Gmail pour Catchmail |
Ce champ doit être renseigné si vous utilisez l'authentification Gmail avec une clé de connexion Gmail. Renseignez l'emplacement de la clé de connexion Gmail fournie par Google depuis https://console.cloud.google.com/. Ex : c:/keys/catchmail.json |
| Section Configuration de la messagerie | |
| Nom de la configuration |
Donnez un nom à votre configuration (Optionnel). Ex : ConfigCatchMail |
| Mail du compte |
Renseignez l'adresse mail du compte pour utiliser le Catch Mail. Ex : catchmail@akuiteo.com |
| Type de compte de messagerie |
Sélectionnez votre type de messagerie. Ex : EXCHANGE ou POP3 |
| Adresse du serveur Mail |
Si Exchange : Renseignez l’adresse du Web Service Exchange. Ex : https://serveraddress/EWS/exchange.asmx Si POP3 : Renseignez l’adresse du serveur POP3. Ex : mail.serveraddress.net |
| Port du serveur Mail |
Si Exchange : Renseignez le port du serveur de mail. Ex : 443 (si sécurisé) Si POP3 : Renseignez le port sur serveur POP3. Ex : 110 pour POP, 995 pour POP SSL |
| Est sécurisé | Cochez cette case si le serveur de messagerie utilise le port sécurisé. |
| Utilisateur |
Renseignez l’adresse mail du compte Catch mail. Ex : catchmail@akuiteo.com |
| Mot de passe | Renseignez le mot de passe de ce compte. |
| Inbox | Renseignez le répertoire dans lequel sont sauvegardés les e-mails dans votre messagerie. |
| Tester la connexion à l'interface Catch mail à partir des valeurs enregistrées | Cliquez sur le lien pour vérifier la bonne configuration. |
| 2 | Enregistrez puis relancez le serveur Tomcat. |
Configuration pour Microsoft Graph
Accéder au portail Azure
| 1 | Dans un navigateur web, entrez l'adresse https://portal.azure.com/ et connectez-vous en tant qu'administrateur. |
| 2 | Sur la page d’accueil, cliquez sur Microsoft Entra ID. |
Déclarer Akuiteo comme application de l'annuaire Azure AD
| 1 | Cliquez sur Inscriptions d'applications dans le menu de gauche, puis cliquez sur Nouvelle inscription. |
| 2 | Renseignez le Nom de cette nouvelle inscription (par exemple Akuiteo Microsoft Graph CatchMail) et laissez l'option Comptes dans cet annuaire d'organisation uniquement (XXX uniquement - Locataire unique) cochée. Cliquez ensuite sur S'inscrire. |
La page de l'application est affichée.
| 3 | Copiez les informations suivantes : |
- ID d'application (client)
- ID de l'annuaire (locataire)
Pour cela, passez la souris sur un champ concerné puis cliquez sur l'icône permettant de copier l'information dans le presse-papiers. Conservez ces informations dans un document à part.
Créer un "secret client" pour identifier le serveur Akuiteo
| 1 | Cliquez sur Certificats & secrets dans le menu de gauche, puis cliquez sur Nouveau secret client. |
| 2 | Renseignez une Description (par exemple Client Secret Akuiteo) et sélectionnez la Date d’expiration de la clé en fonction de votre politique de sécurité. Cliquez ensuite sur Ajouter. |
Important
Une fois la date d'expiration passée, vous devrez créer un nouveau "secret client".
| 3 | Passez la souris sur le champ Valeur puis cliquez sur le bouton permettant de copier l'information dans le presse-papiers. Conservez cette information dans un document à part. |
Important
Vous devez copier cette valeur juste après la création du secret client car l'information ne sera plus accessible par la suite et vous devrez régénérer un nouveau "secret client".
Demander les autorisations d'API
| 1 | Depuis le menu API autorisées, cliquez sur Ajouter une autorisation puis sur API Microsoft Graph. |
| 2 | Cliquez sur Autorisations d'application. |
| 3 | Depuis la liste des autorisations, cochez les autorisations Mail.ReadWrite puis cliquez sur le bouton Ajouter des autorisations. |
| 4 | Depuis la page Autorisations configurées, cliquez sur le bouton Accorder un consentement d'administrateur pour XXX, puis cliquez sur Oui pour confirmer. |
Configurer la Console d'administration dans Akuiteo
Dans la Console d'administration, depuis
| Champ | Description |
|---|---|
| Utiliser le Catch Mail | Cochez cette option pour activer le CatchMail. |
| Utilisateur Akuiteo | Renseignez le code de l'utilisateur du CatchMail. |
| Mot de passe Akuiteo | Renseignez le mot de passe de l'utilisateur du CatchMail. |
| Délai de démarrage (par défaut 20s) | Valeur par défaut. |
| Intervalle d'analyse des mails (par défaut 60s) | Valeur par défaut. |
| Utiliser une authentification OAUTH (Exchange 365 seulement) | Décochez cette case. |
| Utiliser la librairie Graph API | Cochez cette case. |
| Tenant ID | Renseignez la valeur ID de l'annuaire (locataire) récupérée sur Azure. |
| Client ID | Renseignez la valeur ID d'application (client) récupérée sur Azure. |
| Client Secret | Renseignez la Valeur du secret client récupérée sur Azure. |
| Emplacement clé de connexion Gmail pour Catchmail | Vide. |
