WWW.XMEDIUS.COM

XMediusFAX Sharp OSA Connector 4.1.0 Manuel de l'administrateur

XMediusFAX Sharp OSA Connector Numéro de version 4.1.0.76 – mars 2016. Brevets • Protégé par les brevets américains 4,994,926; 5,291,302; 5,459,584; 6,643,034; 6,785,021; 7,283,270. • Protégé par les brevets canadiens 1,329,852; 2,101,327; 2,417,202. • Brevets américains, européens et japonais supplémentaires en instance. Remerciements Ce logiciel comprend plusieurs librairies et logiciels détenus par des tiers et distribués sous leur licence respective. Pour plus d'informations, voir le dossier \3rd inclus dans cette distribution (si applicable). • OSA .NET: Copyright © 2005 - 2012 Sharp Corporation. • log4net: Copyright © 2001-2003 Neoworks Limited (under Apache license). All Rights Reserved. Avis de non-responsabilité XMedius se réserve le droit de modifier ses logiciels et sa documentation sans préavis. Les produits ont été décrits et documentés dans un souci d’exactitude maximale. Toutefois, XMedius ne garantit pas que sa documentation est exempte d’erreurs ou d’omissions. Par ailleurs, XMedius ne saurait être tenu pour responsable des pertes de données pouvant survenir en cours d’exploitation de ses logiciels, de même qu’il rejette toute responsabilité quant aux conséquences de telles pertes. Sans un accord écrit préalable de la part de XMedius, aucune partie de la présente publication ne peut être reproduite ou modifiée par quelque moyen que ce soit, par procédé manuel comme électronique. Toutes les marques commerciales ainsi que tous les noms de marques ou de produits sont la propriété et correspondent à des marques commerciales, déposées ou non, de leurs détenteurs légitimes. Les références à d’autres produits ou logiciels n’impliquent aucune garantie du logiciel XMediusFAX Sharp OSA Connector par les fabricants de ces produits et logiciels. Copyright Logiciel et documentation XMediusFAX Sharp OSA Connector © 2016 Solutions XMedius inc. Tous droits réservés. Toute duplication, copie et/ou reproduction sans accord préalable est strictement interdite. Informations de contact • Web: www.xmedius.com • Ventes: [email protected] • Licences: [email protected] Amériques, Asie et Océanie: XMedius 3400, boul. de Maisonneuve Ouest, bureau 1135 Montréal (Québec) H3Z 3B8 – CANADA - Boîte postale 48 • Téléphone: +1 514-787-2100 • Numéro sans frais pour l'Amérique du Nord: 1-888-766-1668 • Fax: +1 514-787-2111

Europe, Moyen-Orient et Afrique (EMEA): XMedius 31-33, rue des Beaux Soleils 95520 Osny – France • Téléphone: +33 (0) 1 57 61 30 54 • Fax: +33 (0) 9 70 26 19 22 Assistance technique Logiciel sur site: • Web: support.xmediusfax.com • Email: [email protected] • Tél. Amériques: +1-866-615-3066 (Amérique du Nord seulement) | +1 514-787-2122 • Tél. EMEA: +33 (0) 1 30 17 90 43 • Tel. APAC: 0011-800-132-00000 (Australie seulement) | +1 514-787-2122 Solution cloud: • Web: support.xmedius.com • Email: [email protected] • Tél. Amérique du Nord: +1 855-867-5065 • Tél. Europe: +33 (0) 1 57 61 30 20

Table des matières

Table des matières Chapitre 1 : Introduction.....................................................................................................1 Le XMediusFAX Sharp OSA Connector.........................................................................................................1 But de ce document.........................................................................................................................................1

Chapitre 2 : Exigences d'installation.................................................................................3 Exigences d'installation..................................................................................................................................3 XMediusFAX Sharp OSA Connector et son hôte...............................................................................................................3 Périphériques multifonctions (MF)......................................................................................................................................4 Serveur de fax (XMediusFAX)..............................................................................................................................................4

Chapitre 3 : Installation du connecteur fax.......................................................................7 Installation du connecteur fax........................................................................................................................7 Installer le XMediusFAX Sharp OSA Connector............................................................................................7 Installer le certificat de XMediusFAX (optionnel)..........................................................................................8

Chapitre 4 : Configurations du connecteur fax et des MF............................................11 Configurations du connecteur fax et des MF – aperçu..............................................................................11 À propos des configurations du XMediusFAX Sharp OSA Connector et des MF....................................11 Authentification des utilisateurs de fax.......................................................................................................12 Configuration d'un utilisateur par défaut (pas d'authentification).................................................................................13 Configuration d'authentification par utilisateur XMediusFAX........................................................................................14 Autres configurations d'authentification..........................................................................................................................15

Configurer le XMediusFAX Sharp OSA Connector.....................................................................................16 Configurer un MF pour utiliser le XMediusFAX Sharp OSA Connector....................................................19

Chapitre 5 : Débogage......................................................................................................21 Dépanner le XMediusFAX Sharp OSA Connector.......................................................................................21

Chapitre 6 : Désinstallation..............................................................................................23 Désinstaller le XMediusFAX Sharp OSA Connector...................................................................................23

Chapitre 7 : Annexe...........................................................................................................25 Générer un nouveau conteneur de certificat (si nécessaire).....................................................................25

XMediusFAX Sharp OSA Connector Manuel de l'administrateur

i

Table des matières

ii

XMediusFAX Sharp OSA Connector Manuel de l'administrateur

Chapitre 1 | Introduction

Chapitre 1

Introduction

Le XMediusFAX Sharp OSA Connector Le XMediusFAX Sharp OSA Connector est une solution permettant à des appareils multifonctions (MF) Sharp compatibles avec la technologie OSA (Open Systems Architecture) de faxer des documents à l'aide de XMediusFAX. Voici un exemple de déploiement comprenant un MF, une machine hébergeant le XMediusFAX Sharp OSA Connector, et le serveur de fax (XMediusFAX)

Remarque : Dans cet exemple, le connecteur OSA et le serveur de fax sont installés sur des machines séparées ; cependant, vous pourriez décider de les installer sur la même machine, au besoin. Égelement, plusieurs MF connectés au réseau peuvent bénéficier du XMediusFAX Sharp OSA Connector. Depuis le MF, les utilisateurs peuvent bénéficier de nombreuses fonctionnalités héritées de XMediusFAX, selon leur profil d'utilisateur de fax. Ils ont également la possibilité de sélectionner des destinataires depuis les carnets d'adresses de XMediusFAX et d'ajouter de nouvelles entrées à leurs contacts personnels. Également, diverses méthodes d'authentification pour les utilisateurs de fax peuvent être configurées afin que cette solution de fax convienne à vos besoins.

But de ce document Ce document s'adresse aux administrateurs de XMediusFAX et des MF, et décrit toutes les étapes pour :

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

1

Chapitre 1 | Introduction

• • •

Installer et configurer le XMediusFAX Sharp OSA Connector. Configurer les MF Sharp pour y activer la nouvelle fonction de fax. Optionnellement, installer un certificat de l'hôte de XMediusFAX pour de la sécurité réseau additionnelle.

Ce document donne également des informations à propos de méthodes et contextes d'authentification divers afin de configurer votre environnement de fax selon vos besoins.

2

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 2 | Exigences d'installation

Chapitre 2

Exigences d'installation

Exigences d'installation Important : Avant de commencer, veuillez lire attentivement cette section pour vérifier si votre déploiement actuel est conforme aux exigences système.

XMediusFAX Sharp OSA Connector et son hôte

Connecteur Le XMediusFAX Sharp OSA Connector peut être installé soit sur la machine hébergeant XMediusFAX, soit sur une machine séparée (tant que les deux machines sont capables de communiquer ensemble sur le réseau). Important : Cette version du XMediusFAX Sharp OSA Connector ne peut être utilisée pour effectuer de mise à niveau à partir d'aucune de ses versions précédentes. Hôte du connecteur La machine hébergeant le XMediusFAX Sharp OSA Connector : •

Doit avoir l'un des systèmes d'exploitation suivants installé : • •

•

Doit avoir un accès réseau pour communiquer avec : • •

•

Windows Server 2008 / 2012 Windows 7 / 8

L'hôte de XMediusFAX. Tous les MF devant utiliser le XMediusFAX Sharp OSA Connector.

Doit avoir les composantes suivantes installées avant l'installation du XMediusFAX Sharp OSA Connector : • •

.NET Framework 2.0 ou supérieur Internet Information Services 7 (IIS7) ou supérieur Important : Vous devez configurer IIS pour activer ASP.NET. Par exemple dans Windows 2008 : 1. Dans Gestionnaire de serveur, sélectionnez le nœud Rôles, développez l'en-tête Services Internet (IIS) et cliquez Ajouter des services de rôle. 2. Dans la page Sélectionner des services de rôle, sous Développement d'applications, sélectionnez ASP.NET.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

3

Chapitre 2 | Exigences d'installation

3. Si vous y êtes invité, cliquez sur Ajouter les services de rôles nécessaires. 4. Cliquez Suivant et suivez les instructions d'installation.

Périphériques multifonctions (MF) Tous les MF devant utiliser le XMediusFAX Sharp OSA Connector doivent : • • • •

Être compatibles avec la technologie Sharp OSA version 3.0 ou supérieure. Être compatible avec la technologie "HTML Browser". Être sur le réseau pour communiquer avec la machine hébergeant le XMediusFAX Sharp OSA Connector. Avoir un écran de résolution WSVGA (1024x600), WVGA (800x480) ou QVGA (480x272). Restriction : Les écrans QVGA ne supporteront que l'interface simplifiée du XMediusFAX Sharp OSA Connector (numéro de fax seul). Remarque : À propos du support de l'authentification des utilisateurs de fax sur les MF : Une méthode pleinement opérationnelle, fondée spécifiquement sur les comptes d'utilisateurs internes de XMediusFAX, est fournie avec le XMediusFAX Sharp OSA Connector. Cependant, la méthode intégrée d'authentification "External Account" est également supportée lorsqu'elle est configurée et activée dans le MF.

Serveur de fax (XMediusFAX) Le XMediusFAX Sharp OSA Connector est compatible avec XMediusFAX 6.5.5 et les versions supérieures, ainsi qu'avec la solution de fax cloud de XMedius. Avec la solution de fax cloud : •

Vous devez posséder un compte actif de service de fax de XMedius.

Avec un déploiement de serveur de fax sur site : • •

XMediusFAX doit être correctement installé et doit fonctionner sur un serveur accessible depuis l'hôte du XMediusFAX Sharp OSA Connector. Il est nécessaire d'installer les correctifs minimums suivants sur votre XMediusFAX, selon votre version : Version de XMediusFAX

Version minimale de la composante (correctif) nécessaire

XMediusFAX 6.5.5

Config Manager (XMConfigManager.exe) 6.5.5.310 Web Service (faxservice.war) 6.5.5.310

XMediusFAX 7.0.0

Config Manager (XMConfigManager.exe) 7.0.0.360 Web Service (faxservice.war) 7.0.0.360

Versions supérieures de XMediusFAX

Aucun correctif n'est nécessaire.

Remarque : Tous les correctifs sont disponibles au téléchargement à l'adresse support.xmediusfax.com.

4

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 2 | Exigences d'installation

•

Votre licence XMediusFAX doit comprendre : • •

La fonctionnalité de services Web. Le nombre maximum de MF autorisés à utiliser le XMediusFAX Sharp OSA Connector. Remarque : Pour plus de détails au sujet de XMediusFAX, veuillez vous référer à son Manuel d'installation et de maintenance et à son Manuel d'administration.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

5

Chapitre 2 | Exigences d'installation

6

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 3 | Installation du connecteur fax

Chapitre 3

Installation du connecteur fax

Installation du connecteur fax Ce chapitre fournit les étapes à suivre pour : • •

Installer le XMediusFAX Sharp OSA Connector sur la machine hébergeant le XMediusFAX ou sur une machine séparée sur le réseau. Optionnellement, installer le certificat de l'hôte de XMediusFAX si vous planifiez activer la validation du certificat pour de la sécurité additionnelle. Important : Cette version du XMediusFAX Sharp OSA Connector ne peut être utilisée pour effectuer de mise à niveau à partir d'aucune de ses versions précédentes. Elle s'applique uniquement aux appareils compatibles avec la technologie Sharp OSA version 3.0 ou supérieure. Toute version antérieure du XMediusFAX Sharp OSA Connector doit être désinstallée avant de continuer.

Installer le XMediusFAX Sharp OSA Connector Remarque : Cette installation peut être effectuée soit sur la machine sur laquelle XMediusFAX est installé, soit sur une machine séparée sur le réseau. Important : Avant de commencer l'installation, lisez attentivement la section : Exigences d'installation à la page 3. Certaines configurations sont nécessaires sur la machine devant héberger le XMediusFAX Sharp OSA Connector. Pour installer le XMediusFAX Sharp OSA Connector : 1. Lancez Setup.exe. 2. Choisissez la langue à utiliser pendant l'installation et cliquez OK.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

7

Chapitre 3 | Installation du connecteur fax

3. Suivez simplement les instructions du programme d'installation. L'installation est à présent terminée et vous pouvez configurer le connecteur et les MF (voir : Configurations du connecteur fax et des MF – aperçu à la page 11).

Installer le certificat de XMediusFAX (optionnel) Le XMediusFAX Sharp OSA Connector utilise par défaut la fonction sécurisée des services Web de XMediusFAX (https). Si vous souhaitez ajouter davantage de sécurité pour la connexion des services Web, vous pouvez activer une validation de l'identité du serveur, au moyen de l'interface de configuration du connecteur (voir Configurer le XMediusFAX Sharp OSA Connector à la page 16). Dans ce cas, vous devez également vous assurer que le certificat de XMediusFAX sera approuvé sur la machine hébergeant le XMediusFAX Sharp OSA Connector. Remarque : Un keystore (conteneur de certificat) par défaut a été automatiquement généré sur l'hôte de XMediusFAX pendant son installation : [tomcat_home]\conf\keystore.jks. Il est prêt à être utilisé sans aucune modification et doit fonctionner correctement dans votre environnement de fax. Il comprend le nom d'hôte de XMediusFAX et son mot de passe est “changeit”. Cependant, si vous souhaitez générer un nouveau keystore pour remplacer celui par défaut (par exemple pour ajuster le nom d'hôte ou pour changer le mot de passe), voir Générer un nouveau conteneur de certificat (si nécessaire) à la page 25 avant de suivre la procédure ci-dessous. Important : Cette procédure n'est pas nécessaire si le certificat est signé par une autorité de certification de confiance. Pour assurer que l'hôte du XMediusFAX Sharp OSA Connector approuvera le certificat de XMediusFAX : 1. Récupérez le fichier de certificat de l'hôte de XMediusFAX : a) Ouvrez un navigateur Web et entrez l'adresse : https:// suivie du nom d'hôte de XMediusFAX. b) Continuez malgré le message d'avertissement (certificat pas encore approuvé). c) Enregistrez localement le fichier de certificat (option Copier vers le fichier ou Exporter, selon votre navigateur) 2. Ajoutez le certificat à la liste des autorités de certification racine de confiance :

8

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 3 | Installation du connecteur fax

a) b) c) d) e) f) g) h) i)

Lancez la console de gestion de Microsoft (recherchez mmc.exe depuis le menu Démarrer). Dans le menu Fichier, cliquez Ajouter/Supprimer un composant logiciel enfichable. Sous Composants logiciels enfichables disponibles, cliquez Certificats, puis Ajouter. Sous Ce composant logiciel enfichable gèrera toujours les certificats pour, cliquez Compte d'ordinateur, puis cliquez Suivant. Cliquez L'ordinateur local, puis Terminer. Cliquez sur OK. Dans l'arborescence de la console, double-cliquez Certificats. Effectuez un clic droit dans la liste des Autorités de certification racine de confiance. Cliquez sur Importer pour importer le certificat (le fichier que vous avez enregistré en première étape) et suivez les étapes de l'Assistant d'importation de certificat.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

9

Chapitre 3 | Installation du connecteur fax

10

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 4 | Configurations du connecteur fax et des MF

Chapitre 4

Configurations du connecteur fax et des MF

Configurations du connecteur fax et des MF – aperçu Avant de pouvoir envoyer des fax à l'aide de MF utilisant le XMediusFAX Sharp OSA Connector, vous devez configurer le connecteur et chacun des MF concernés. Ce chapitre couvre les sujets suivants : • • • • •

Informations sur la manière de rendre la fonction de fax disponible sur vos MF. Informations à propos de l'authentification des utilisateurs, avec une description des diverses méthodes qui peuvent être utilisées. Des instructions pour configurer votre environnement de fax selon la méthode d'authentification utilisée. La procédure de configuration du XMediusFAX Sharp OSA Connector La procédure de configuration des MF pour qu.ils utilisent le XMediusFAX Sharp OSA Connector. Remarque : Avant de commencer, vous devez avant tout avoir installé le XMediusFAX Sharp OSA Connector selon les exigences et la procédure fournie dans ce manuel.

À propos des configurations du XMediusFAX Sharp OSA Connector et des MF Le XMediusFAX Sharp OSA Connector est installé comme une application autonome. Sa configuration est effectuée au moyen d'une page Web locale sur la machine sur laquelle le connecteur est installé. Pour avoir le XMediusFAX Sharp OSA Connector activé, chaque MF doit également être configuré au moyen de ses paramètres intégrés.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

11

Chapitre 4 | Configurations du connecteur fax et des MF

Paramètres du connecteur Les paramètres du XMediusFAX Sharp OSA Connector comprennent : •

Tous les paramètres pour la connexion et l'authentification du connecteur avec le serveur hébergeant XMediusFAX. D'autres paramètres pour des options du connecteur et des utilisateurs, lesquelles seront disponibles sur le MF.

•

Paramètres des MF Chaque MF de votre parc de MF Sharp devra être configuré un par un pour activer le XMediusFAX Sharp OSA Connector, en pointant la machine ébergeant le connecteur. Tous les MF partageront alors les mêmes paramètres du XMediusFAX Sharp OSA Connector.

Authentification des utilisateurs de fax Le moyen par lequel les utilisateurs de fax seront authentifiés pour utiliser la fonctionnalité de fax sont multiples et dépendent largement de l'architecture et des politiques de votre entreprise. Remarque : Pour des raisons techniques, cette section doit être considérée préférablement avant de configurer le XMediusFAX Sharp OSA Connector. Plusieurs cas sont développés dans cette section afin de vous aider à faire un choix ou à configurer les divers dispositifs de votre environnement de fax selon vos besoins : • • •

12

Pas d'authentification (utilisation d'un compte d'utilisateur de fax par défaut) Authentification par utilisateur XMediusFAX (écran d'authentification spécifique activée dans la fonction de fax) D'autres types d'authentification (y compris l'authentification par identification unique), au moyen de la fonction "External Account" du MF Sharp (nécessitant une configuration dans la section concernée des paramètres du MF).

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 4 | Configurations du connecteur fax et des MF

Configuration d'un utilisateur par défaut (pas d'authentification)

Si aucune authentification d'utilisateur n'est nécessaire, tous les utilisateurs pourront faxer en partageant les mêmes propriétés d'un unique émetteur de fax par défaut et le même carnet d'adresses. Pour permettre cela, vous devrez créer sur XMediusFAX un compte utilisateur par défaut qui sera référencé par les paramètres de configuration du XMediusFAX Sharp OSA Connector : 1. Depuis l'interface d'administration de XMediusFAX, configurez XMediusFAX pour y inclure un utilisateur que vous allez dédier au MF. Remarque : Cet utilisateur peut être soit un Utilisateur interne, soit un utilisateur externe récupéré par l'Intégration des répertoires (voir le Manuel d'administration de XMediusFAX pour plus d'informations). Par exemple, un Utilisateur interne identifié à l'aide de l'Adresse SMTP suivante : [email protected]. 2. Lorsque vous configurerez le XMediusFAX Sharp OSA Connector, assurez-vous : a) De sélectionner Utilisateur par défaut comme Méthode d'authentification de l'utilisateur (pas d'authentification). b) D'entrer dans le champ Nom de l'utilisateur l'adresse SMTP du compte utilisateur de fax que vous avez précédemment créé. Dans notre exemple : [email protected].

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

13

Chapitre 4 | Configurations du connecteur fax et des MF

Configuration d'authentification par utilisateur XMediusFAX

Lorsqu'une authentification des utilisateurs est nécessaire au niveau de XMediusFAX, tous les utilisateurs possédant un compte interne de XMediusFAX pourront faxer, chacun utilisant ses propres propriétés d'émetteur de fax et son propre carnet d'adresses. Pour permettre cela : 1. À partir de l'interface d'administration de XMediusFAX, ajoutez à la liste d'Utilisateurs internes tous les comptes utilisateurs de fax dont vous avez besoin, selon la procédure disponible dans le Manuel d'administration de XMediusFAX. Astuce : Vous avez également la possibilité d'importer les utilisateurs internes depuis un répertoire existant. 2. Lorsque vous configurerez le XMediusFAX Sharp OSA Connector, assurez-vous de sélectionner Serveur de fax comme Méthode d'authentification de l'utilisateur. À retenir : Avec cette métode, l'authentification sera nécessairement effectuée en entrant des paramètres personnels de connexion. Pour cette raison, l'administrateur devra fournir aux utilisateurs ces paramètres, qui sont le nom et le mot de passe de leur compte utilisateur de fax.

14

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 4 | Configurations du connecteur fax et des MF

Autres configurations d'authentification

Conceptuellement, toute autre méthode d'authentification peut être supportée pour accéder à la fonction de fax sur un MF, à condition que cette méthode soit compatible avec la fonction "External Account" du MF (pour donner à XMediusFAX les informations retournées par la méthode). Remarque : Pour plus d'informations, voir la documentation du MF. Une fois ces éléments vérifiés : 1. Configurez la fonction External Account sur le MF. 2. Assurez-vous de sélectionner External Account comme Méthode d'authentification de l'utilisateur lorsque vous configurerez le connecteur. Selon le type d'attribut restitué par la méthode d'authentification External Account (adresse SMTP, compte NT ou tout autre attribut), il est possible que vous ayez à effectuer quelques configurations additionnelles sur XMediusFAX (voir ci-dessous). Restitution d'une adresse SMTP ou d'un compte NT Si la méthode d'authentification restitue une adresse SMTP pour l'utilisateur qui s'est authentifié (directement ou au moyen d'une recherche), ou encore un compte NT complet (comprenant le nom de domaine), alors XMediusFAX sera capable de gérer cet attribut sans que cela nécessite de configuration supplémentaire – en plus de celles que vous devez déjà avoir effectuées pour l'intégration des répertoires. Pour plus d'informations, voir le Manuel d'administration de XMediusFAX. Restitution d'un autre attribut Si la méthode d'authentification restitue un attribut qui n'est ni une adresse SMTP ni un compte NT complet, XMediusFAX le considérera par défaut comme un compte NT. Dans ce cas, vous devrez ajuster la manière dont l'intégration des répertoires est gérée par XMediusFAX, afin de relier l'attribut restitué à un utilisateur réel possédant des droits pour faxer (exemple ci-dessous). Exemple : identification unique avec lecteur de carte (restitution d'un code numérique) Considérons l'exemple de scénario suivant :

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

15

Chapitre 4 | Configurations du connecteur fax et des MF

• • • •

Le MF utilise une méthode d'authentification permettant l'identification unique (au moyen de la fonction External Account). Les utilisateurs accèdent aux fonctionnalités du MF à l'aide d'une carte personnelle qu'ils font lire à un lecteur de cartes. La méthode d'authentification restitue un code numérique correspondant à l'utilisateur. Du côté du répertoire d'utilisateurs, ce code numérique est stocké, pour chaque utilisateur, dans un attribut nommé accessCodeNumber.

Dans ce cas précis, vous devrez créer une nouvelle règle de Répertoire LDAP dans l'Intégration des répertoires de XMediusFAX, afin que le code numérique restitué (alors considéré comme un compte NT) trouve une correspondance avec l'attribut accessCodeNumber de votre répertoire d'utilisateurs. Dans cette règle, le Filtre de recherche de la Demande peut être par exemple : (&(objectClass=user)(accessCodeNumber=$NtAccountName$))

Dans l'interface d'administration de XMediusFAX, la définition de la règle ressemblera à ceci :

À retenir : Cette règle – utilisée spécialement pour résoudre le code numérique d'une carte – doit être créée en plus des règles existantes d'intégration des répertoires, qui continueront à remplir leurs fonctions habituelles (veuillez consulter le Manuel d'administration de XMediusFAX pour plus de détails au sujet de l'intégration des répertoires).

Configurer le XMediusFAX Sharp OSA Connector Important : Avant de commencer, veuillez porter attention à toutes les informations que vous devez avoir récoltées : • •

16

Les paramètres de connexion de XMediusFAX (selon le type de solution fax que vous utilisez). Le choix de la méthode d'authentification des utilisateurs (voir Authentification des utilisateurs de fax à la page 12).

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 4 | Configurations du connecteur fax et des MF

Important : Cette configuration doit être effectuée depuis la machine hébergeant le XMediusFAX Sharp OSA Connector. La page de configuration n'est pas disponible à distance. Pour configurer le XMediusFAX Sharp OSA Connector : 1. À l'aide d'un navigateur Web, entrez l'adresse suivante : http://localhost/OSAConnector/ Remarque : Le dernier caractère "/" (barre oblique) est obligatoire. 2. Entrez le Nom d'utilisateur et le Mot de passe. Par défaut, les valeurs sont sharp et password.

3. Entrez les paramètres de configuration du XMediusFAX Sharp OSA Connector : a) Configuration du service de fax Contrôle URL du service de fax

Description •

Pour la configuration dans le cadre d'un déploiement sur site L'URL utilisée pour joindre l'hôte XMediusFAX sur site, laquelle doit être entrée sous la forme : https://:8443

•

Pour la configuration dans le cadre d'une solution Cloud L'URL pour se connecter à la solution Cloud.

Valider le certificat du serveur (optionnel)

Permet une sécurité additionnelle pour la connexion des services Web à XMediusFAX, par validation de l'identité du serveur. Remarque : Nécessite un certificat de l'hôte de XMediusFAX (voir Installer le certificat de XMediusFAX (optionnel) à la page 8).

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

17

Chapitre 4 | Configurations du connecteur fax et des MF

Contrôle

Description Important : Si vous utilisez cette option, le dans le champ URL du service de fax doit correspondre au Common Name (CN) du certificat.

b) Authentification du connecteur (selon le type de solution fax) Remarque : La sélection est automatiquement faite selon la valeur entrée pour URL du service de fax (voir plus haut). Des paramètres d'authentification doivent être entrés adéquatement. Contrôle

Description

Déploiement sur site

Mode d'authentification du connecteur utilisé pour un déploiement sur site seulement. Paramètres : Compte administrateur fax/Mot de passe de l'administrateur fax (le nom et le mot de passe d'un compte administrateur de XMediusFAX).

Solution cloud

Mode d'authentification du connecteur utilisé pour une solution Cloud seulement. Paramètre : Jeton d'accès. Remarque : Le Jeton d'accès doit avoir les types de permissions suivants : • •

Interroger le répertoire des utilisateurs Envoyer et gérer les fax

Pour créer et récupérer un tel jeton, ouvrez Jetons d'accès depuis la barre de navigation de votre portail de service de fax Cloud.

c) Options pour l'utilisateur et l'appareil Contrôle

Description

Méthode d'authentification de l'utilisateur

Le mode d'authentification des utilisateurs : •

Utilisateur par défaut (pas d'authentification) – Force le module à utiliser un compte utilisateur de fax par défaut en tant qu'émetteur de fax (plutôt que l'utilisateur courant connecté, s'il y en a un). Cela nécessite l'entrée d'un Identifiant de l'utilisateur existant, qui sera utilisé par tous les utilisateurs du MF.

•

Serveur de fax – Active une méthode d'authentification directement reliée aux utilisateurs internes de XMediusFAX. External Account (pour d'autres méthodes d'authentification) – Relaie la gestion des méthodes d'authentification au MF (nécessite une configuration dans la section concernée du MF – voir sa documentation).

•

À retenir : Il est possible que vous deviez aussi ajuster quelques paramètres dans votre XMediusFAX selon le choix effectué ici. Pour plus de détails, voir la section : Authentification des utilisateurs de fax à la page 12. Interface utilisateur

Le type d'interface utilisateur qui sera utilisée par défaut sur le MF : Complète (tous les champs de composition) ou Simplifiée (numéro de fax seul).

Utiliser le carnet d'adresses Permet aux utilisateurs de XMediusFAX de bénéficier des fonctionnalités de du serveur de fax carnets d'adresses lors de l'envoi de fax sur le MF (activé par défaut).

d) Paramètres de journalisation

18

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 4 | Configurations du connecteur fax et des MF

Contrôle

Description

Chemin du dossier de journalisation

Chemin du dossier dans lequel les fichiers journaux seront stockés (voir Dépanner le XMediusFAX Sharp OSA Connector à la page 21). Remarque : Si vous laissez ce champ vide, le chemin par défaut C:\Inetpub\wwwroot\OSAConnector\LogFiles sera utilisé.

Niveau de verbosité

La précision des informations qui apparaîtront dans les fichiers journaux.

4. Enregistrez les paramètres. Important : Après cette configuration, vous devez encore activer le XMediusFAX Sharp OSA Connector sur tous les MF que vous avez ciblés pour l'utiliser. Voir Configurer un MF pour utiliser le XMediusFAX Sharp OSA Connector à la page 19.

Configurer un MF pour utiliser le XMediusFAX Sharp OSA Connector Remarque : Les étapes de configuration fournis ci-dessous peuvent varier selon le modèle de MF Sharp que vous utilisez. Pour plus de détails, veuillez vous référer à la documentation du MF. Pour activer le XMediusFAX Sharp OSA Connector sur un MF Sharp : 1. À l'aide d'un navigateur Web, entrez l'adresse IP du MF et connectez-vous à sa page de configuration en utilisant le nom de connexion et le mot de passe du MF. 2. Sélectionnez Réglages d'application ➤ Réglages de l'application externe, puis cliquez Ajouter. 3. Dans Nom de l'application, entrez XMediusFAX. Ce nom identifiera la fonction XMediusFAX sur l'écran du MF. 4. Entrez l'Adresse de l'interface utilisateur de l'application : http:///OSAConnector/

Remarque : est l'adresse IP de la machine hébergeant le XMediusFAX Sharp OSA Connector. Le dernier caractère "/" (barre oblique) est obligatoire. 5. Ajoutez l'icône qui identifiera visuellement la fonction XMediusFAX sur l'écran du MF : Naviguez vers le package d'installation du XMediusFAX Sharp OSA Connector et sélectionn ez le fichier : XMediusFAX.gif. 6. Cliquez Soumettre pour enregistrer les paramètres. Remarque : Dans les scénarios d'intégration les plus courants, il n'est pas nécessaire de configurer les autres paramètres disponibles dans cette page. La nouvelle application XMediusFAX apparaît dans la liste des applications. 7. Répétez toutes ces étapes pour chaque MF que vous voulez configurer. La fonction de fax XMediusFAX est maintenant prête pour l'utilisation sur tous les MF concernés.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

19

Chapitre 4 | Configurations du connecteur fax et des MF

20

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 5 | Débogage

Chapitre 5

Débogage

Dépanner le XMediusFAX Sharp OSA Connector Si vous rencontrez des problèmes avec le XMediusFAX Sharp OSA Connector, vous pouvez accéder à des informations de débogage dans des fichiers journaux, sur la machine hébergeant le XMediusFAX Sharp OSA Connector, pour des fins de dépannage avec l'assistance technique de XMediusFAX. Par défaut, les fichiers journaux se retrouvent dans le dossier C:\Inetpub\wwwroot\OSAConnector\LogFiles. Un nouveau fichier journal est créé chaque jour (nommé selon la date), et son contenu dépend du niveau de verbosité choisi pour le XMediusFAX Sharp OSA Connector (voir Configurer le XMediusFAX Sharp OSA Connector à la page 16).

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

21

Chapitre 5 | Débogage

22

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 6 | Désinstallation

Chapitre 6

Désinstallation

Désinstaller le XMediusFAX Sharp OSA Connector Pour désinstaller correctement le XMediusFAX Sharp OSA Connector : 1. Sur la machine hébergeant le XMediusFAX Sharp OSA Connector, accédez à la fonctionnalité d'ajout et de suppression de programmes. 2. Sélectionnez XMediusFAX Sharp OSA Connector et cliquez Supprimer.

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

23

Chapitre 6 | Désinstallation

24

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Chapitre 7 | Annexe

Chapitre 7

Annexe

Générer un nouveau conteneur de certificat (si nécessaire) Cette procédure va vous permettre de générer un nouveau conteneur de certificat valide (aussi appelé keystore) sur l'hôte de XMediusFAX afin de l'installer et de l'approuver sur la machine hébergeant le XMediusFAX Sharp OSA Connector. Suivez cette procédure seulement au cas où vous auriez besoin d'activer la validation du certificat (pour de la sécurité additionnelle) et où vous n'utiliseriez pas le certificat généré par défaut lors de l'installation de XMediusFAX. Attention : Cette opération doit être effectuée sur l'hôte de XMediusFAX et implique quelques configurations à faire sur l'hôte de XMediusFAX lui-même, afin que ce dernier puisse se fier au certificat nouvellement généré. Veuillez suivre attentivement la procédure ci-dessous. Remarque : Le certificat que vous allez générer ici est un certificat auto-signé ; cependant, vous pourriez décider d'utiliser un certificat signé par une autorité officielle. Dans les deux cas, le paramètre CN du certificat doit correspondre à la chaîne qui sera utilisée du côté client (le XMediusFAX Sharp OSA Connector) pour joindre l'hôte de XMediusFAX. Sur l'hôte de XMediusFAX : 1. Créez un nouveau fichier keystore contenant un seul certificat autosigné : a) Exécutez la ligne de commande suivante : [java_home]/bin/keytool -genkey -alias tomcat -keyalg RSA -validity 9125 -keystore keystore.jks

Remarque : Vous pouvez donner au keystore un autre nom que keystore.jks, tant que vous respectez l'extension .jks et que vous ajustez les étapes suivantes selon le nom que vous avez entré dans la ligne de commande. b) Tel que demandé par l'invite de commande, entrez un mot de passe pour votre fichier keystore. Remarque : Gardez en tête ce mot de passe, vous en aurez besoin plus loin dans cette procédure. c) Pour first and last name, entrez le Common Name (CN) de l'hôte de XMediusFAX. Important : Cette entrée correspond au paramètre CN du certificat; elle doit impérativement correspondre à la chaîne qui sera utilisée du côté client pour accéder à XMediusFAX (la valeur sera vérifiée à chaque tentative de connexion aux services Web). Par exemple, si vous entrez ici myfaxserver, assurez-vous que la même chaîne : • •

est l'un des noms qui vont se résoudre en l'adresse IP de l'hôte de XMediusFAX, et est le nom qui sera utilisé du côté client pour accéder à XMediusFAX.

d) Suivez les messages guides pour entrer les autres informations générales :

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

25

Chapitre 7 | Annexe

• • • • •

Unité organisationnelle Organisation Ville État ou province Code de pays à deux lettres

Après avoir entré ces informations, il vous sera demandé de confirmer les valeurs entrées (CN=common name du serveur de fax, OU=unité d'organisation, O=organisation, L=ville, ST=état ou province, C=code de pays).

e) Entrez un mot de passe pour la clé, c'est à dire le mot de passe spécifique à ce certificat (par opposition avec ceux des certificats stockés dans le même fichier keystore). Important : Vous DEVEZ utiliser ici le même mot de passe que celui utilisé pour le fichier keystore lui-même (l'invite de commande indique d'ailleurs que ce sera fait automatiquement si vous appuyez simplement sur la touche Entrée). Remarque : Le keystore.jks est maintenant généré. Cependant, vous devez terminer la présente procédure afin que ce keystore soit reconnu fiable par XMediusFAX. 2. Placez une copie du fichier keystore.jks créé dans le dossier [tomcat_home]/conf de l'hôte de XMediusFAX. 3. Modifiez le fichier de configuration de Tomcat : a) Ouvrez le fichier server.xml situé dans le dossier [tomcat_home]/conf et recherchez la balise de définition du connecteur HTTPS :

b) Vérifiez que le paramètre keystoreFile contient la valeur conf/keystore.jks. il s'agit du chemin relatif vers le fichier keystore que vous venez de créer. c) Remplacez la valeur du paramètre keystorePass par le mot de passe que vous avez entré lors de la création du fichier keystore. d) Enregistrez le fichier. 4. Redémarrez le service Apache Tomcat pour activer vos modifications. Le conteneur de certificat généré sera à présent considéré fiable par XMediusFAX. À retenir : Pour installer le certificat sur l'hôte du XMediusFAX Sharp OSA Connector, voir : Installer le certificat de XMediusFAX (optionnel) à la page 8.

26

XMediusFAX Sharp OSA Connector 4.1.0 | Manuel de l'administrateur

Manuel de l'administrateur Document non contractuel

*253566482* Solutions XMedius inc. 3400, boul. de Maisonneuve Ouest - Bureau 1135 Montréal, Québec H3Z 3B8 - Canada www.xmedius.com