Module Exchange 8.0

Eléments requis

• Serveur MS Exchange 2010, 2013, 2016 ou Exchange online sur office 365.
• Activer l'authentification Exchange via des formulaires pour OWA (form based authentication coté server)
• Activer l'authentification basique pour EWS
• Le certificat SSL valide pour le serveur Exchange
  Le certificat est requis pour établir une connexion sécurisée avec le serveur Exchange. 

JCMS interopère avec le serveur MS Exchange en utilisant le protocol HTTPS et en utilisant l'authentification basée sur un formulaire (Form based authentication).

Installation

• Installer le module en suivant la procédure standard de déploiement de module.
• Redémarrer le site.

Configuration

Module

Une fois le module déployé, aller dans la page d'administration du module et y saisir les propriétés communes :

• Le connecteur à utiliser : e.g ews. C'est une propriété obligatoire. 
• Domaine du serveur Microsoft Exchange : e.g company.com
• Hôte du serveur Microsoft Exchange : e.g myServer.company.net. C'est une propriété obligatoire. Dans le cas d'office365 c'est toujours https://outlook.office365.com
• Version du serveur Microsoft Exchange: 2010. C'est une propriété obligatoire, positionnée à 2010 par défaut. Dans le cas d'office 365 ou Exchange 2016, il faut saisir 2013.
• Utilser la fonctionnalité d'impersonation: e.g True si l'impersonation est utilisé (voir paragraphe suivant).
• Utilisateur impersonation : e.g L'utilisateur utilisé pour la fonctionnalité d'impersonation.
• Mot de passe impersonation : e.g Le mot de passe utilisé pour la fonctionnalité d'impersonation.
• Garder les informations de connection : True si vous voulez stocker les informations de connexions des utilisateurs dans JCMS (si la fonction d'impersonation n'est pas utilisé).
• Timeout des requêtes de connexion : Timeout (en seconde) de la requête de connexion, par défaut c'est positionné à 0 (illimité ou non utilisé).
• Timeout de requête: Timeout des requêtes Exchange pour obtenir les données, par défaut c'est positionné à 0 (illimité ou non utilisé).

Les utilisateurs JCMS peuvent avoir une configuration Exchange différentes (par exemple, un serveur OWA différent). Ces informations sont à configurer dans leur profil JCMS.

Important : en tant normal l'identifiant d'un utilisateur sur Exchange est son identifiant AD mais dans le cas d'Office365, il s'agit de son email.

Important: Noter que les utilisateurs en base (instances de DBMember) ne peuvent pas utiliser de configuration personnalisée !

Vérifier que votre administrateur MS Exchange accepte l'authentification basic via les web services Exchange. Dans le cas contraire, seul la portlet OWA Frame pourra être utilisée.

Cela peut se vérifier dans la configuration IIS :

Le serveur Exchange requiert un canal sécurisé pour se connecter dessus. Si ce certificat est auto-signé, obtenez le certtificat SSL à partir des propriétés IIS du serveur Exchange (à demander à votre administrateur MS Exchange). Placez ce certificat dans le keystore (jssecacerts) du JRE de votre serveur JCMS (JAVA_HOME\{JRE_DIR}\lib\security\jssecacerts). Vous pouvez aussi faciliter cette opération en utilisant the IIS 6.0 Resource Kit Tools.

Avant de pouvoir utiliser les portlet Exchange avec Internet Explorer, vous devez ajouter le serveur OWA à la liste des Sites de confiance dans les options de sécurité de votre navigateur. Aller dans Outils > Options Internet > Onglet Sécurité, selectionner Sites de confiance, cliquer sur Sites et ajouter l'URL duserveur OWA.

Le connecteur syncex n'est plus supporté.

Test de la connexion avec le serveur Exchange

Le module est livré avec un outil de test de la connexion avec le serveur Exchange (directement sans les couches Jalios). 

Pour l'utiliser, se déplacer dans le répertoire WEB-INF/lib de l'application et exécuter la commande suivante :

Pour windows :
java -cp .;* TestExchange <url du serveur> <login> <password> <email> <domain> <useImpersonation>

Pour Linux :
java -cp .:* TestExchange <url du serveur> <login> <password> <email> <domain> <useImpersonation>

Dans le cas où l'impersonation est utilisée, le login/password est celui du compte technique et l'email indique la boite à requêter.
Dans le cas contraire, l'email n'est pas utilisé.

Résultat attendu : 

+ Authentication --
++ Is authenticated: true
Jcms time zone name: Heure d'Europe centrale
Jcms time zone id: Europe/Paris
+ Mails --
++ Mail total count: 10
++ Unread mail count: 2
++ List count: 10
1/////////////////////////////////////////////////////////////////////////////////////////
Subject: FW: Team Meeting
Type: IPM.Schedule.Meeting.Request
Sender: BobK@contoso.com
Body: <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Exchange Server">
<!-- converted from rtf -->
<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style>
</head>
<body>
<font face="Times New Roman" size="3"><span style="font-size:12pt;"><a name="BM_BEGIN"></a>
<div><br>

</div>
<div><font color="silver"><u>  ________________________________  </u></font></div>
<div><font face="Tahoma" size="2"><span style="font-size:10pt;"><b>From:</b> Bob Kelly<br>

<b>Sent:</b> Thursday, August 19, 2010 2:19 PM<br>

<b>To:</b> Aaron Con; Alan Brewer; Ann Beebe; Frank Miller; Giorgio Veronesi<br>

<b>Cc:</b> Florian Voss<br>

<b>Subject:</b> Team Meeting<br>

<b>When:</b> Occurs every Thursday from 8:00 AM to 9:30 AM effective 8/5/2010.<br>

<b>Where:</b> Conference Room - NW<br>

<br>

</span></font></div>
<div> </div>
<div><font face="Calibri" size="2"><span style="font-size:11pt;"> </span></font></div>
</span></font>
</body>
</html>

ID: AAASAEFhcm9uQ0Bjb250b3NvLmNvbQBGAAAAAAA4QUD6sYqXTZFzib0GS6XkBwDZ8kQcx2YYTJBsERgqYn3vAAAATXVDAADZ8kQcx2YYTJBsERgqYn3vAAGugigMAAA=
/////////////////////////////////////////////////////////////////////////////////////////
2/////////////////////////////////////////////////////////////////////////////////////////
Subject: FW: Company Meeting
Type: IPM.Schedule.Meeting.Request
Sender: ToddM@contoso.com
Body: <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Exchange Server">
<!-- converted from rtf -->
<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style>
</head>
<body>
<font face="Times New Roman" size="3"><span style="font-size:12pt;"><a name="BM_BEGIN"></a>
<div><br>

</div>
...

Fonctionnalité d'impersonation

Cette fonctionnalité permet d'accéder aux données MS Exchange en utilisant un compte d'application (et non celui d'un utilisateur). Néanmoins pour utiliser cette fonctionnalité le compte d'application doit avoir les droits nécessaires pour consulter les données des différents utilisateurs.

Configuration de l'impersonation : La documentation de Microsoft sur cette fonctionnalité est disponible ici.

Support d'Office 365

Le module est compatible avec le produit Office 365 (spécialement Exchange Online) à la date de livraison. Pour le configurer vous devez indiquer les paramètres suivants :

• Domaine echange : maCompagnie.onmicrosoft.com
• Hôte Exchange : https://outlook.office365.com (Voir le paragraphe suivant pour plus de détails)
• Version du serveur Exchange  : 2013
• Les identifiants sont les emails des utilisateurs (et non uniquement leur login comme pour un Exchange On Premise)

L'impersonation peut aussi être utilisé (en utilisant le plan entreprise). Voir cette page pour plus de détail.

Portlets

Ajouter les types Portlet Exchange dans votre espace. Créer les portlets. Si ces portlets doivent être utilisée dans le Bureau Virtuel, sélectionner l'habilité Service pour chaque portlet.

Portlet Calendrier :

Pour visualiser les évènements Exchange dans un calendrier JCMS, Il faut donner l'habilité aux portlet Calendrier de requéter les évènements Exchange.

Paramètres communs aux portlets Exchange:

• Page Size: Taille du pager. Par défaut, elles affichent 10 éléments par page.
• Exchange edition: définit si l'utilisateur peut ou non créer des éléments Exchange à partir de JCMS. La valeur par défaut est False.
• Max data (portlet tâche et portlet Courrier) : définit le nombre maximum de données récupérées ( par défaut 100).

Note concernant la portlet OWA iFrame: Si vous utilisez la portlet OWA iFrame et que votre navigateur vous indique via un message de sécurité que le contenu de la portlet est bloqué, vous devez ajouter le site OWA à la liste des sites de confiance.

Membres

Le module crée un groupe pour les membres exclus par la mécanique du module. Les membres de ce groupe ne sont pas autorisés à se connecter à MS Exchange, ni à voir les portlets Exchange.

L'administrateur par défaut de JCMS fait partie de ce groupe à la création et donc n'a pas accés au données Exchange. Si d'autres membres n'ont pas de compte Exchange, il faut aussi les placer dans ce groupe.

Les configurations spécifiques aux membres sont stockées dans les extradata ou les extradbdata :

Extra data :

• jcmsplugin.exchange.usecustomserver : booléen indiquant si la configuration spécifique doit être utilisé
• jcmsplugin.exchange.connector : type de connecteur (maintenant uniquement EWS est possible). Ce champ va être retiré dans une version ultérieure.
• jcmsplugin.exchange.host : L'URL du serveur à utiliser 
• jcmsplugin.exchange.domain : Le domaine windows 
• jcmsplugin.exchange.server-version :  La version de compatibilité du serveur Exchange (2010)

Extradbdata :

• jcmsplugin.exchange.rememberme : true si le mot de passe doit être stocké
• jcmsplugin.exchange.login : le login à utiliser (si l'impersonation n'est pas activé)
• jcmsplugin.exchange.password : Le mot de passe (si l'impersonation n'est pas activé)
• jcmsplugin.exchange.email : l'email exchange de l'utilisateur (dans le cas de l'impersonation, c'est l'information pivot indispensable)

Limites

Avec OWA iFrame:

• Les cookies ont une durée de vie limitée, il peut être nécessaire de rafraichir le portail et de resaisir ses paramètres d'authentification.
• Cross-domain: Il n'est pas possible d'intercepter les actions internes à la fenêtre Exchange (comme "sauvegarder et fermer")
• ...

Migration

Si votre précédente installation contenait une version 7.x (ou inférieure) , il faut retirer du répertoire WEB-INF/lib les jars suivants :

• jaliosews.jar
• webservices-api.jar
• webservices-extra.jar
• webservices-extra-api.jar
• webservices-rt.jar