WWW.XMEDIUS.COM

XMediusFAX Ricoh ESA Connector 11.0.0 Manuel de l'administrateur

XMediusFAX Ricoh ESA Connector Numéro de version 11.0.0.42 – avril 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). • Ksoap2 and Kxml: Copyright © 2006, James Seigel, Calgary, AB., Canada Copyright © 2003,2004, Stefan Haustein, Oberhausen, Rhld., Germany • Log4J: Copyright © 2000-2002 The Apache Software Foundation 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 Ricoh ESA Connector par les fabricants de ces produits et logiciels. Copyright Logiciel et documentation XMediusFAX Ricoh ESA Connector © 2010-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 Ricoh ESA Connector..........................................................................................................1 But de ce document.........................................................................................................................................1

Chapitre 2 : Exigences d'installation.................................................................................3 Exigences d'installation..................................................................................................................................3 PC de l'administrateur..........................................................................................................................................................3 Appareils multifonctions (MF).............................................................................................................................................3 Serveur de fax (XMediusFAX)..............................................................................................................................................4

Chapitre 3 : Installation de l'outil de déploiement............................................................5 Installation de l'outil de déploiement du connecteur : aperçu.....................................................................5 Planification d'installation du connecteur.....................................................................................................5 Installer les fichiers et l'outil de déploiement du XMediusFAX Ricoh ESA Connector.............................6 Mettre à niveau l'outil de déploiement du XMediusFAX Ricoh ESA Connector.........................................7

Chapitre 4 : Configurations et déploiement du connecteur Fax.....................................9 Configurations et déploiement du connecteur Fax – aperçu.......................................................................9 À propos du déploiement du XMediusFAX Ricoh ESA Connector.............................................................9 Authentification des utilisateurs de fax.......................................................................................................10 Configuration d'un utilisateur par défaut (pas d'authentification).................................................................................11 Configuration d'authentification par utilisateur XMediusFAX........................................................................................12 Autres configurations d'authentification..........................................................................................................................13

Configurer et déployer le XMediusFAX Ricoh ESA Connector..................................................................14 Gérer la liste des MF dans l'outil de déploiement (et mettre à niveau le connecteur)............................19

Chapitre 5 : Débogage......................................................................................................21 Déboguer le XMediusFAX Ricoh ESA Connector sur les MF.....................................................................21

Chapitre 6 : Désinstallation..............................................................................................23 Désinstaller le XMediusFAX Ricoh ESA Connector....................................................................................23

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

XMediusFAX Ricoh ESA Connector | Manuel de l'administrateur

i

Table des matières

ii

XMediusFAX Ricoh ESA Connector | Manuel de l'administrateur

Chapitre 1 | Introduction

Chapitre 1

Introduction

Le XMediusFAX Ricoh ESA Connector Le XMediusFAX Ricoh ESA Connector est une solution permettant à des appareils multifonctions (MF) Ricoh compatibles avec la technologie Ricoh ESA (Embedded Software Architecture) de faxer des documents à l'aide de XMediusFAX. Voici un exemple de déploiement comprenant un MF (avec le XMediusFAX Ricoh ESA Connector installé) et XMediusFAX :

Remarque : Plusieurs MF connectés au réseau peuvent bénéficier du XMediusFAX Ricoh ESA 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 : •

Installer le XMediusFAX Ricoh ESA Connector (et tous les autres éléments nécessaires) sur un unique ordinateur (pour déploiement ultérieur vers les MF).

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

1

Chapitre 1 | Introduction

•

Configurer et déployer le XMediusFAX Ricoh ESA Connector vers les MF afin que la fonction de fax y soit activée.

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 Ricoh ESA Connector 11.0.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.

PC de l'administrateur Le “PC de l'administrateur” est l'ordinateur sur lequel le XMediusFAX Ricoh ESA Connector sera installé pour déployer ultérieurement le connecteur vers un ou plusieurs MF. Cet ordinateur doit : • •

Comporter le Java Runtime Environment 7 (JRE 7). Avoir un accès réseau pour communiquer avec vos MF. Remarque : Dans le cas où vous auriez besoin d'accéder à des informations de débogage des MF depuis cet ordinateur, ce dernier doit aussi comporter une application client rsh (Remote Shell) – par exemple, l'utilitaire rsh.exe disponible pour Microsoft Windows.

Appareils multifonctions (MF) Tout MF vers lequel vous vous apprêtez à déployer le XMediusFAX Ricoh ESA Connector doit : • • • •

Utiliser l'architecture logicielle intégrée de Ricoh (Embedded Software Architecture – ESA), version 10.x, 11.x ou 12.x. Comporter un écran de résolution µWVGA, WVGA ou SVGA. Être accessible depuis le PC de l'administrateur. Avoir un accès réseau à XMediusFAX. 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 Ricoh ESA Connector. Cependant, si vous souhaitez utiliser d'autres méthodes d'authentification (y compris des méthodes d'identification unique), vos MF peuvent s'intégrer avec Ricoh CAP ou avec AAA (en utilisant un provider AAA approprié).

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

3

Chapitre 2 | Exigences d'installation

Pour plus d'informations à propos de l'intégration de AAA et des providers AAA, veuillez contacter votre revendeur de MF. Remarque : Certains modèles de MF Ricoh ne supportent pas les fonctions d'auto-détection (originaux présents sur la vitre d'exposition, auto-détection de la taille de l'original) utilisés par défaut par le XMediusFAX Ricoh ESA Connector, ce qui empêche le connecteur de numériser des documents sur ces MF. Ce problème peut cependant être résolu par une procédure de contournement : suivez les instructions dans l'article KB#314106 (voir support.xmediusfax.com).

Serveur de fax (XMediusFAX) Le XMediusFAX Ricoh ESA 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 vos MF. Votre licence XMediusFAX doit comprendre : • •

•

La fonctionnalité de services Web. Le nombre maximum de MF autorisés à utiliser le XMediusFAX Ricoh ESA 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

Web Service (faxservice.war) 6.5.5.310

XMediusFAX 7.0.0

Web Service (faxservice.war) 7.0.0.360

XMediusFAX 7.5.0 et plus

Aucun correctif n'est nécessaire.

Remarque : Tous les correctifs sont disponibles au téléchargement à l'adresse support.xmediusfax.com. 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.

4

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 3 | Installation de l'outil de déploiement

Chapitre 3

Installation de l'outil de déploiement

Installation de l'outil de déploiement du connecteur : aperçu Ce chapitre fournit : • •

La liste de tous les éléments nécessaires à une installation complète du connecteur. Les étapes à suivre pour installer les fichiers et l'outil de déploiement du connecteur sur le PC de l'administrateur (avant de configurer et de déployer le connecteur vers les MF concernés – description dans le prochain chapitre). Important : Le XMediusFAX Ricoh ESA Connector a été conçu pour une installation sur les MF à l'aide de l'outil de déploiement fourni dans la trousse d'installation du XMediusFAX Ricoh ESA Connector. Il n'est pas recommandé d'utiliser d'autres méthodes pour déployer le XMediusFAX Ricoh ESA Connector sur les MF. Si toutefois votre environnement nécessite l'utilisation d'une autre méthode, vous pouvez contacter notre équipe de services professionnels pour vous aider à trouver une solution.

Planification d'installation du connecteur Pour installer le XMediusFAX Ricoh ESA Connector, les éléments suivants sont nécessaires. Programme d'installation des fichiers et de l'outil de déploiement du XMediusFAX Ricoh ESA Connector Le XMediusFAX Ricoh ESA Connector est constitué de plusieurs fichiers qui seront installés – au moyen d'un seul programme d'installation – sur le PC de l'administrateur. Cela comprend : • •

Un outil de déploiement qui sera utilisé pour configurer et déployer le connecteur vers les MF concernés. Tous les fichiers nécessaires au déploiement.

Conteneur de certificat (keystore) pour les services Web de XMediusFAX – Optionnel Le XMediusFAX Ricoh ESA 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. Pour cela, il est nécessaire de disposer d'un conteneur de certificat valide provenant de l'hôte de XMediusFAX (fichier keystore d'extension .jks) parmi les fichiers du connecteur. Remarque : Un keystore par défaut est disponible sur l'hôte de XMediusFAX (généré lors de l'installation de XMediusFAX) : [tomcat_home]\conf\keystore.jks. Il est prêt à l'utilisation et devrait fonctionner correctement dans votre environnement de fax ; il comprend le nom d'hôte de XMediusFAX et son mot de passe est “changeit”.

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

5

Chapitre 3 | Installation de l'outil de déploiement

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), une procédure est donnée dans ce manuel (Générer un nouveau conteneur de certificat (si nécessaire) à la page 25).

Installer les fichiers et l'outil de déploiement du XMediusFAX Ricoh ESA Connector Attention : Cette installation doit être effectuée sur le PC de l'administrateur, à partir duquel le XMediusFAX Ricoh ESA Connector sera déployé vers les MF. Pour installer le XMediusFAX Ricoh ESA Connector(fichiers et outil de déploiement) : 1. Lancez l'installateur de l'outil de déploiement du XMediusFAX Ricoh ESA Connector : Setup.exe.

2. Suivez simplement les instructions du programme d'installation. Tous les fichiers sont installés par défaut dans C:\Program Files\XMediusFAX Ricoh ESA Connector\ (référencé par [Connector_Install_Path] dans ce document). 3. Installez le certificat (optionnel) : a) Récupérez le conteneur de certificat des services Web que vous avez généré sur l'hôte de XMediusFAX (seulement si vous souhaitez permettre une validation de l'identité du serveur) : keystore.jks

Remarque : Pour plus d'informations, voir Planification d'installation du connecteur à la page 5. b) Copiez et collez le fichier dans l'emplacement suivant sur le PC de l'administrateur : [Connector_Install_Path]\keystores

L'installation est à présent terminée et vous pouvez configurer et déployer le connecteur (voir : Configurations et déploiement du connecteur Fax – aperçu à la page 9).

6

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 3 | Installation de l'outil de déploiement

Mettre à niveau l'outil de déploiement du XMediusFAX Ricoh ESA Connector Mises à niveau majeures Pour mettre à niveau l'outil de déploiement du XMediusFAX Ricoh ESA Connector à partir d'une version majeure précédente (par exemple, de la version 10 à la version 11), lancez simplement le programme d'installation de la nouvelle version (Setup.exe) et suivez les instructions à l'écran. Attention : Rappelez-vous que la mise à niveau vers la version actuelle de l'outil de déploiement ne peut être effectuée qu'à partir de la version 10.0 au minimum. Les autres versions de l'outil de déploiement ne sont pas éligibles à une telle mise à niveau. Mises à niveau mineures (versions correctives) Pour mettre à niveau l'outil de déploiement du XMediusFAX Ricoh ESA Connector entre deux versions mineures (par exemple de la version 11.0.0.x à la version 11.0.0.y), vous devez tout d'abord désinstaller la version actuelle (à l'aide de la fonction d'ajout/suppression de programmes), puis installer la nouvelle version (à l'aide de son programme d'installation). Attention : Ne supprimez pas les dossiers persistants, ils contiennent vos configurations actuelles (qui seront utilisées par la nouvelle version). Mise à niveau du connecteur sur les MF Pour pouvoir mettre à niveau le XMediusFAX Ricoh ESA Connector sur vos MF, vous devez avant tout mettre à niveau l'outil de déploiement en suivant les instructions ci-dessus. Par la suite, vous devrez redéployer le connecteur sur tous les MF concernés (voir Gérer la liste des MF dans l'outil de déploiement (et mettre à niveau le connecteur) à la page 19).

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

7

Chapitre 3 | Installation de l'outil de déploiement

8

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 4 | Configurations et déploiement du connecteur Fax

Chapitre 4

Configurations et déploiement du connecteur Fax

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

Informations sur la manière de déployer la fonction de fax vers vos MF. Informations à propos de l'authentification des utilisateurs, avec une description des diverses méthodes qui peuvent être utilisées. Les procédures pour configurer votre environnement de fax selon la méthode d'authentification utilisée. La procédure pour configurer et déployer le XMediusFAX Ricoh ESA Connector vers les MF concernés, à l'aide de l'outil de déploiement fourni. Remarque : Avant de commencer, vous devez avoir préalablement installé les fichiers du XMediusFAX Ricoh ESA Connector et l'outil de déploiement sur le PC de l'administrateur (voir Installer les fichiers et l'outil de déploiement du XMediusFAX Ricoh ESA Connector à la page 6).

À propos du déploiement du XMediusFAX Ricoh ESA Connector Un outil de déploiement est disponible parmi les fichiers du connecteur qui ont été installés sur le PC de l'administrateur. Cet outil de déploiement vous permet de configurer et d'installer simultanément le XMediusFAX Ricoh ESA Connector sur tous les MF concernés.

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

9

Chapitre 4 | Configurations et déploiement du connecteur Fax

Remarque : Vous pouvez décider d'avoir des paramètres de configuration différents selon le MF sur lequel le connecteur sera installé. Cela peut se justifier selon la méthode que vous souhaitez employer pour que les utilisateurs s'authentifient sur chaque MF.

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, il est préférable de considérer ce sujet avant de commencer à déployer le XMediusFAX Ricoh ESA Connector vers vos MF. 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 : • • •

10

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) Autres types d'authentification, tels que Active Directory ou d'autres authentifications par identification unique (impliquant l'utilisation et la configuration du logiciel AAA)

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 4 | Configurations et déploiement du connecteur Fax

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 Ricoh ESA 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 Ricoh ESA 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 Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

11

Chapitre 4 | Configurations et déploiement du connecteur Fax

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 Ricoh ESA 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.

12

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 4 | Configurations et déploiement du connecteur Fax

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. Plus précisément, le XMediusFAX Ricoh ESA Connector peut être configuré pour authentifier les utilisateurs : • •

Au moyen du Card Authentication Package (CAP) de Ricoh – lequel doit être préalablement configuré (selon la documentation de Ricoh), ou À l'aide de toute méthode compatible AAA – laquelle doit être préalablement configurée et déployée (serveur AAA et un provider AAA adéquat pour permettre au MF de transmettre à XMediusFAX les informations restituées par la méthode).

En fonction de la solution utilisée : 1. Assurez-vous de sélectionner la Méthode d'authentification de l'utilisateur appropriée (CAP ou AAA) lorsque vous configurerez le connecteur avant de le déployer. 2. Selon le type d'attribut restitué par la méthode d'authentification (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 numéro d'identification) Considérons l'exemple de scénario suivant :

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

13

Chapitre 4 | Configurations et déploiement du connecteur Fax

• • • •

Le MF est configuré pour permettre l'identification unique. 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 numéro d'identification correspondant à l'utilisateur. Du côté du répertoire d'utilisateurs, ce numéro d'identification est stocké, pour chaque utilisateur, dans un attribut nommé idNumber.

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 numéro d'identification restitué (alors considéré comme un compte NT) trouve une correspondance avec l'attribut idNumber de votre répertoire d'utilisateurs. Dans cette règle, le Filtre de recherche de la Demande peut être par exemple : (&(objectClass=user)(idNumber=$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 numéro d'identification – 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 et déployer le XMediusFAX Ricoh ESA Connector Important : Avant de commencer, veuillez porter attention à toutes les informations que vous devez avoir récoltées : • • •

14

Toutes les adresses IP des MF sur lesquels vous allez déployer le XMediusFAX Ricoh ESA Connector. Les paramètres de connexion du serveur de fax et des services Web (selon l'ordinateur hôte de votre XMediusFAX). Le choix de la méthode d'authentification des utilisateurs (voir Authentification des utilisateurs de fax à la page 10).

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 4 | Configurations et déploiement du connecteur Fax

Pour configurer et déployer le XMediusFAX Ricoh ESA Connector : 1. Lancez l'outil de déploiement en sélectionnant XMediusFAX Ricoh ESA Connector ➤ Fax Connector Deployer parmi vos applications installées.

2. Créez des fichiers de configuration pour le connecteur : Remarque : Ces fichiers seront plus tard appliqués à un ou plusieurs MF. Vous pouvez avoir un unique fichier de configuration pour tous les MF, ou même un fichier de configuration différent pour chaque MF, si nécessaire. a) Sélectionnez Fichier ➤ Nouvelle configuration. Remarque : Si vous aviez précédemment enregistré un fichier de configuration, vous pouvez le modifier au lieu de partir d'une configuration vide (Fichier ➤ Modifier une configuration).

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

15

Chapitre 4 | Configurations et déploiement du connecteur Fax

b) 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 saisie sous la forme : https://:8443

•

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

Utiliser un proxy

Active l'utilisation d'un proxy pour se connecter au serveur XMediusFAX. Paramètres : Hôte du proxy / Port (le nom de l'hôte ou l'adresse IP du proxy et son port).

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 Planification d'installation du connecteur à la page 5). Important : Si vous utilisez cette option, le dans le champ URL du service de fax doit correspondre au Common Name (CN) du certificat.

16

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 4 | Configurations et déploiement du connecteur Fax

Contrôle

Description Paramètres : Chemin du keystore/Mot de passe du keystore (le chemin et le mot de passe du conteneur de certificat).

c) 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). Vous devez saisir des paramètres d'authentification appropriés. 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 présenter 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.

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

Description

Méthode d'authentification de l'utilisateur

Le mode d'authentification des utilisateurs de fax : •

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, 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. CAP – active l'authentification au moyen du Card Authentication Package (CAP) de Ricoh. AAA (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 10.

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).

e) Cliquez Enregistrer.

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

17

Chapitre 4 | Configurations et déploiement du connecteur Fax

f) Donnez au fichier de configuration un nom facilement reconnaissable (dans le cas de multiples configurations) et enregistrez-le. Remarque : Si vous ne pouvez pas enregistrer le fichier de configuration dans le répertoire en cours (par ex. si l'écriture y est refusée), vous pouvez toujours le sauvegarder ailleurs, sans conséquence pour le déploiement. g) Répétez ces sous-étapes si vous devez créer d'autres fichiers de configuration. 3. Ajoutez tous les MF concernés à la liste de déploiement : a) Cliquez sur Ajouter.

b) Entrez l'Adresse IP du MF. c) Associez un Fichier de configuration à ce MF (à l'aide du bouton de navigation). d) Si nécessaire, ajustez les paramètres d'authentification selon ceux de votre MF : Contrôle

Description

Mot de passe Ne remplissez ce champ que si votre MF est configuré avec un mot de passe de installation à distance contrôle des installations à distance. Remarque : Ce mot de passe peut avoir été configuré à l'aide du Web Image Monitor de ce MF : Gestion de périphérique ➤ Configuration ➤ Paramètres Fonctions avancées ➤ Outils administrateur ➤ Paramètres Web Service. Nom d'utilisateur Web Nom d'utilisateur et mot de passe du compte utilisé pour accéder à l'interface Web Image Monitor Image Monitor (page Web) de ce MF. Mot de passe Web Image Monitor

Remarque : Si vous n'avez jamais changé le compte de connexion par défaut du Web Image Monitor pour ce MF (nom d'utilisateur "admin" et mot de passe vide), vous pouvez laisser ces champs vides).

e) Validez et répétez ces sous-étapes pour chaque MF. Remarque : L'écran Configuration du périphérique garde en mémoire le dernier fichier de configuration que vous avez sélectionné ; cela vous aidera si vous souhaitez associer la même configuration à plusieurs MF. Cependant, vous pouvez toujours sélectionner un autre fichier de configuration. 4. Vérifiez et ajustez (au besoin) votre liste de MF avant le déploiement : a) Sélectionnez les MF vers lesquels vous allez déployer le connecteur (cela peut être une sélection partielle, ou même totale à l'aide de Tout sélectionner). b) Cliquez Récupérer l'état pour vérifier l'état d'installation et la version du connecteur sur les MF sélectionnés.

18

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 4 | Configurations et déploiement du connecteur Fax

Astuce : Cela vous permettra de vérifier si les MF sont joignables à l'aide des adresses IP entrées, et si certains d'entre-eux ne comportent pas déjà le connecteur, installé lors d'une précédente installation. c) Vous pouvez ajuster la liste de MF et leur configuration à l'aide des boutons Modifier ou Supprimer (sur des sélections simples ou multiples). 5. Déployez le connecteur : a) Sélectionnez les MF vers lesquels vous allez déployer le connecteur. b) Cliquez Installer le connecteur pour déployer le connecteur configuré vers les MF sélectionnés. Après le déploiement, un résumé affiche le résultat d'installation du connecteur (réussi ou non) pour chaque MF. La fonction de fax est maintenant prête pour l'utilisation sur tous les MF concernés. Remarque : L'outil de déploiement mémorise la liste d'adresses IP et les associations de fichiers de configuration après fermeture, pour le cas où vous devriez effectuer à nouveau le déploiement (par exemple pour des fins de changement de configurations). À retenir : Il est possible que vous deviez ajuster quelques paramètres dans votre XMediusFAX, selon le choix que vous avez fait pour l'authentification des utilisateurs sur chaque MF (selon la section: Authentification des utilisateurs de fax à la page 10).

Gérer la liste des MF dans l'outil de déploiement (et mettre à niveau le connecteur) Lancez l'outil de déploiement en sélectionnant XMediusFAX Ricoh ESA Connector ➤ Fax Connector Deployer parmi vos applications installées.

L'écran principal affiche la liste de tous les MF que vous avez déjà enregistrés dans l'outil de déploiement, chacun avec ses principales propriétés et son état par rapport à l'installation du XMediusFAX Ricoh ESA Connector. Tous les boutons à côté de la liste vous permettent de gérer cette dernière : par exemple, pour modifier les paramètres d'un MF, redéployer une version mise à jour du fichier de configuration du connecteur

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

19

Chapitre 4 | Configurations et déploiement du connecteur Fax

vers un MF, ou pour mettre à niveau la version d'un XMediusFAX Ricoh ESA Connector déjà installé sur un MF. Liste des MF Colonne

Description

Adresse IP

L'Adresse IP du MF.

État

La version et l'état d'installation du XMediusFAX Ricoh ESA Connector sur ce MF. Remarque : Pour connaître l'état actuel, vous pourriez avoir à utiliser le bouton Récupérer l'état.

Fichier de configuration

Le fichier de configuration du XMediusFAX Ricoh ESA Connector associé à ce MF (voir Configurer et déployer le XMediusFAX Ricoh ESA Connector à la page 14 pour plus d'informations sur la création d'un fichier de configuration).

Actions de liste Toutes les actions décrites ci-dessous sont disponibles pour une sélection simple ou multiple de MF (sauf pour ajouter un nouveau MF) : Bouton

Description

Ajouter

Pour ajouter un nouveau MF à la liste (voir Configurer et déployer le XMediusFAX Ricoh ESA Connector à la page 14 pour plus d'informations sur les paramètres de MF).

Édition

Pour modifier les paramètres du MF sélectionné. Remarque : Une sélection multiple permet d'associer rapidement un même fichier de configuration à plusieurs MF.

Supprimer

Pour retirer de a liste le MF sélectionné.

Tout sélectionner

Sélectionne tous les MF de la liste.

Installer le connecteur

Déploie le XMediusFAX Ricoh ESA Connector sur le MF sélectionné avec le fichier de configuration associé à ce MF. Remarque : Si une version précédente du XMediusFAX Ricoh ESA Connector est déjà installée, l'outil de déploiement effectue automatiquement une mise à niveau vers la version actuelle. Rappelez-vous que les versions du XMediusFAX Ricoh ESA Connector plus anciennes que 10.0 ne sont pas éligibles à une telle mise à niveau.

Désinstaller le connecteur

Désinstalle le XMediusFAX Ricoh ESA Connector du MF sélectionné (voir Désinstaller le XMediusFAX Ricoh ESA Connector à la page 23 pour des détails plus généraux à propos de la désinstallation).

Récupérer l'état

Récupère la version et l'état d'installation du XMediusFAX Ricoh ESA Connector (colonne État) pour tous les MF listés.

20

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 5 | Débogage

Chapitre 5

Débogage

Déboguer le XMediusFAX Ricoh ESA Connector sur les MF Si vous rencontrez des problèmes avec le XMediusFAX Ricoh ESA Connector sur un MF, vous pouvez avoir accès à des informations de débogage pour des fins de dépannage avec l'assistance technique de votre revendeur de XMediusFAX. Il n'existe pas de journalisation permanente de ces informations (aucun fichier journal), cependant, vous pouvez les afficher “en direct” à l'aide du protocole Remote Shell (rsh). Yous aurez besoin d'une application permettant d'utiliser le rsh, comme par exemple l'utilitaire rsh.exe disponible pour Microsoft Windows. Depuis le PC de l'administrateur (par exemple), exécutez la ligne de commande suivante : rsh [mfd_ip] mmesg_auto 125

Remarque : Cette commande liste des informations de sortie correspondant à toutes les applications installées sur le MF dont l'adresse IP [mfd_ip] a été entrée. Les lignes d'informations à propos du XMediusFAX Ricoh ESA Connector peuvent être facilement identifiées, car elles commencent toutes par : [stdout] [FaxServerXlet]. Astuce : La visualisation à l'écran ne permet d'accéder qu'à un nombre limité de lignes ; si vous souhaitez journaliser des informations sur une plus longue période, vous pouvez écrire ces dernières dans un fichier au lieu de les visualiser directement à l'écran. Par exemple : rsh [mfd_ip] mmesg_auto 125 >> C:\mfd01-log.txt

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

21

Chapitre 5 | Débogage

22

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Chapitre 6 | Désinstallation

Chapitre 6

Désinstallation

Désinstaller le XMediusFAX Ricoh ESA Connector Pour désinstaller correctement le XMediusFAX Ricoh ESA Connector : 1. Désinstallez le XMediusFAX Ricoh ESA Connector de tous les MF concernés: a) Lancez l'outil de déploiement en sélectionnant XMediusFAX Ricoh ESA Connector ➤ Fax Connector Deployer parmi vos applications installées. b) Sélectionnez dans la liste les MF desquels vous devez supprimer le XMediusFAX Ricoh ESA Connector. c) Cliquez Désinstaller le connecteur. Après la désinstallation, un résumé affiche le résultat de désinstallation du connecteur (réussi ou non) pour chaque MF. 2. Désinstallez les fichiers et l'outil de déploiement du connecteur Fax ESA du PC de l'administrateur : Remarque : Cette étape est optionnelle et doit être appliquée seulement si : • •

Vous avez désinstallé le XMediusFAX Ricoh ESA Connector de tous les MF, et Vous ne prévoyez pas déployer le XMediusFAX Ricoh ESA Connector vers d'autres MF.

a) Sur le PC de l'administrateur, accédez à la fonctionnalité d'ajout et de suppression de programmes. b) Sélectionnez XMediusFAX Ricoh ESA Connector et cliquez Supprimer

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

23

Chapitre 6 | Désinstallation

24

XMediusFAX Ricoh ESA Connector 11.0.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) qui sera utilisé sur le MF par le XMediusFAX Ricoh ESA Connector, au cas où vous auriez besoin d'un keystore (pour une sécurité additionnelle) et où vous n'utiliseriez pas le celui généré par défaut au moment 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 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 connecteur Fax) pour accéder à 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 : Souvenez-vous de ce mot de passe, il sera utilisé plus loin dans cette procédure, et également lors de la configuration du XMediusFAX Ricoh ESA Connector dans le prochain chapitre. 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.

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

25

Chapitre 7 | Annexe

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

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 fichier keystore.jks généré est celui dont vous aurez besoin pour finaliser l'installation du XMediusFAX Ricoh ESA Connector. Cependant, vous devez terminer la présente procédure afin que ce keystore soit reconnu fiable par l'hôte de 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. Vous pouvez maintenant faire une copie du même fichier keystore.jks pour le rendre disponible sur le PC de l'administrateur.

26

XMediusFAX Ricoh ESA Connector 11.0.0 | Manuel de l'administrateur

Manuel de l'administrateur Document non contractuel

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