Apps

Module Exchange 9.0

Description

Ce module fournit 3 portlets affichant les informations issues de Microsoft Exchange: contacts, e-mail et tâches.

Ce module est compatible avec Microsoft Exchange 2010, 2013, 2016 et Exchange Online sur Office 365 (à la date de livraison du module).

Pour Exchange 2010 et plus, le module utilise EWS (Exchange Web Services) pour afficher les portlets contacts, e-mail, agenda et tâches. Les webservices EWS doivent donc être disponibles sur le serveur Exchange.


Captures d'écran

1. Portlet Tâches
2. Portlet Agenda
3. Portlet Contact - Liste de contacts
4. Portlet Contact - Affichage détaillé
5. Portlet Mail
6. La portlet OWA

Installation

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 :

IIS EWS Auth basic

IIS EWS Auth basic2

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

Informations

Version
  • 9.0
Stabilité
  • Stable
Compatibilité
  • JPlatform 10
Certifié Jalios
  • Oui
Prix
  • Module payant
Support
  • Jalios Support
Auteur
  • Jalios SA
Licence
  • Jalios
Taille
  • 7,05 Mo
Mis-à-jour
  • 14/12/17
Téléchargements
  • 38
Domaines
Modules nécessaires
Calendrier
v 5.0.1