Intégration à Connections

Vous pouvez configurer HCL Verse pour qu'il fonctionne avec HCL Connections 6 ou 5.5 CR2.

Avant de commencer

Exécutez la procédure Installation et configuration de.

Pourquoi et quand exécuter cette tâche

L'intégration à Connections est facultative. Cette intégration optimise les profils Connections pour activer des cartes de visite, des photos et des signatures de courrier électronique dans Verse. Elle permet également aux utilisateurs Verse de joindre et de télécharger des fichiers Connections lorsqu'ils rédigent et lisent des messages.

Configuration requise :
  • HCL Connections 6 (ou 5.5 CR2).
  • L'adresse électronique de l'utilisateur dans la zone Adresse Internet du document Personne de Domino doit correspondre à l'adresse électronique figurant dans le profil Connections. Pour extraire des informations telles qu'une photo, l'adresse de l'utilisateur Domino est codée et un appel est effectué vers Connections. L'adresse Domino codée doit correspondre à l'adresse Connections codée pour extraire les informations.

Cette procédure décrit les étapes pour installer et configurer Connections dans votre environnement, puis pour l'activer afin qu'il fonctionne avec HCL Verse . Si vous disposez de Connections 6 ou 5.5, vous n'avez pas besoin de configurer un nouvel environnement.

Procédure

  1. Installez HCL Connections 6. Consultez la section Installation de la documentation HCL Connections.
    Remarque : Si vous avez effectué la mise à niveau à partir d'une édition de Connections antérieure à la version 5.5, exécutez la procédure Mise à niveau de profils antérieurs.
  2. Configurez le serveur IBM HTTP Server qui est utilisé pour accéder à Connections. Voir Configuration d'IBM HTTP Server dans la documentation HCL Connections.
  3. Activez SSL sur IBM HTTP Server. Voir Configuration d'IBM HTTP Server pour les connexions chiffrées dans la documentation HCL Connections.
  4. Activez la connexion unique pour Domino. Voir Activation de la connexion unique pour Domino dans la documentation HCL Connections.
  5. Editez le fichier IBM HTTP Server httpd.conf comme suit. Ce fichier se trouve généralement dans le répertoire <IHS_ROOT>/conf. Cette étape active le partage de ressources d'origine croisée afin que Verse puisse accéder aux API HCL Connections.
    Remarque : Dans cette étape, certaines parties du texte sont réparties sur plusieurs lignes pour faire tenir le contenu dans la page de documentation ; les lignes supplémentaires sont en retrait. Dans le fichier réel, ce texte tient sur une ligne.
    1. Effectuez une copie de sauvegarde du fichier httpd.conf.
    2. Supprimez tous les symboles de mise en commentaire (#) sur les lignes suivantes :
      LoadModule headers_module modules/mod_headers.so
      LoadModule rewrite_module modules/mod_rewrite.so
    3. Localisez un bloc <VirtualHost> approprié pour votre configuration globale. Il peut s'agir d'un serveur virtuel général pour toutes les demandes accédant à cet hôte, il peut être réservé au trafic SSL uniquement ou être mappé pour les applications particulières que vous voulez autoriser. Il est souvent opportun d'utiliser <VirtualHost *:443> pour cet objectif. Il doit être actif pour le trafic vers les API Connections appelées par Verse.
      Copiez les lignes suivantes et collez-les à la fin du bloc <VirtualHost> :
      RewriteEngine on
      
      # Minor change to adjust for Cloud vs On-Premises API variation of parameter name
      RewriteCond %{REQUEST_METHOD} PUT
      RewriteCond %{QUERY_STRING} ^(.*)uid=(.*)
      RewriteRule ^/profiles/photo.do /profiles/photo.do?%1userid=%2 [L]
      
      # Added necessary CORS headers when Origin header present
      Header unset Access-Control-Allow-Origin
      SetEnvIf Origin "^https://(vop_server_hostname\.)?(domain_name)$" origin_is=$0
      Header always set Access-Control-Allow-Origin %{origin_is}e env=origin_is
      Header always set Access-Control-Allow-Credentials "true" env=origin_is
      Header always set Access-Control-Allow-Headers "X-Requested-With, Content-Type, slug" env=origin_is
      Header always set Access-Control-Allow-Methods "POST, GET, OPTIONS, DELETE, PUT" env=origin_is
      Header always set Access-Control-Max-Age "1000" env=origin_is
      Header always set Access-Control-Allow-Methods "POST, GET, OPTIONS, DELETE, PUT" env=origin_is
      # Header always set Access-Control-Allow-Headers "X-Requested-With, 
         Content-Type, Origin, Authorization, Accept, Client-Security-Token, 
         Accept-Encoding, slug" env=origin_is
      Header always set Access-Control-Allow-Headers "X-Requested-With, 
         Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, 
         Pragma, slug, X-Update-Nonce" env=origin_is
      Header always set Access-Control-Expose-Headers "Content-Disposition, 
         Content-Encoding, Content-Length, Date, Transfer-Encoding, Vary, 
         ETag, Set-Cookie, Location, Connection, X-UA-Compatible, 
         X-LConn-Auth, X-LConn-UserId" env=origin_is
      
      # Added a rewrite to respond with a 200 SUCCESS on every OPTIONS request.
      RewriteCond %{REQUEST_METHOD} OPTIONS
      RewriteRule .* - [R=200,L]
      
      # Remove the Origin header if it exists for other requests 
         (POST, GET, DELETE, PUT). Causes problems with Connections 
         returning 403 response.
      RequestHeader unset Origin env=origin_is
      
    4. Recherchez la ligne suivante dans le texte collé :
      SetEnvIf Origin "^https://(vop_server_hostname\.)?(domain_name)$" origin_is=$0
      Editez cette ligne :
      • Remplacez vop_server_hostname par la partie correspondant au nom d'hôte du nom du serveur de messagerie Verse.
      • Remplacez domain_name par le domaine du serveur de messagerie Verse On Premises.

      Mettez une barre oblique inversée (\) devant tous les points dans les noms.

      Par exemple, supposons que votre serveur Connections soit https://connections.renovations.com et vos serveurs de messagerie soient les suivants :
      https://mail1.uk.renovations.com
      https://mail2.us.renovations.com
      https://mail3.jp.renovations.com

      Dans ce cas, spécifiez les lignes suivantes :

      SetEnvIf Origin "^https://(mail1\.)?(uk\.renovations\.com)$" origin_is=$0
      SetEnvIf Origin "^https://(mail2\.)?(us\.renovations\.com)$" origin_is=$0
      SetEnvIf Origin "^https://(mail3\.)?(jp\.renovations\.com)$" origin_is=$0 
      Ou spécifiez la ligne suivante pour représenter tous les serveurs pour ne pas avoir à ajouter une ligne pour chacun d'entre eux :
      SetEnvIf Origin "^https://(mail.*\.)?(.*\.renovations\.com)$" origin_is=$0
  6. Pour permettre aux utilisateurs Verse de se connecter au serveur Connections, ajoutez la ligne suivante au fichier notes.ini dans le répertoire de données Domino :
    VOP_LLN2_BSSUIServer_URL=https://HCL_http_server_hostname
    Remarque : Si le paramètre correspond à la dernière ligne du fichier notes.ini, appuyez sur ENTREE après la ligne.
  7. Redémarrez le serveur Domino® :
    Restart server