与 Connections 集成

您可以将 HCL Verse™ 配置为与 HCL Connections™ 5.5 CR2、6、6.5 或 7.0 协同工作。

开始之前

完成安装和配置过程。

关于此任务

与 Connections 集成是可选操作。该集成利用 Connections 个人档案，支持 Verse 中的名片、照片和电子邮件签名。它还支持 Verse 用户在编写和阅读邮件时附加和下载 Connections 文件。

需求：

HCL Connections™ 5.5 CR2、6、6.5 或 7.0。
“Domino 个人文档因特网地址”字段中的用户电子邮件地址必须与 Connections 配置文件中的电子邮件地址匹配。为了检索诸如照片之类的信息，对 Domino 用户地址进行了编码，并调用了 Connections。Domino 编码地址必须与 Connections 编码地址匹配，才能检索信息。

以下过程描述在环境中安装和配置 Connections 的步骤，使其能够与 HCL Verse™ 协同工作。如果您已经完成，那么不需要再设置新环境。

过程

安装 HCL Connections™。请参阅 HCL Connections 文档中的安装部分。

注：如果您从 5.5 以前的 Connections 发行版进行升级，请完成升级更早配置文件过程。
配置用于访问 Connections 的 IBM HTTP Server。请参阅 HCL Connections 文档中的配置 IBM HTTP Server。
在 IBM HTTP Server 上启用 SSL。请参阅 HCL Connections 文档中的配置 IBM HTTP Server 以支持加密连接。
为 Domino 启用单点登录。请参阅 HCL Connections 文档中的为 Domino 启用单点登录。

编辑 IBM HTTP Server httpd.conf 文件，如下所示。该文件通常位于 <IHS_ROOT>/conf 目录中。此步骤会启用跨源资源共享 (CORS)，以便 Verse 可以访问 HCL Connections™ API。

注：此步骤中显示的一些文本分到多行中，以便内容匹配文档页面；其他行已缩进。在实际文件中，该文本位于一行中。

生成 httpd.conf 的备份副本。

从以下行中删除所有注释符号 (#)：

LoadModule headers_module modules/mod_headers.so
LoadModule rewrite_module modules/mod_rewrite.so

查找您的全局配置的相应 <VirtualHost> 块。对于访问此主机的所有请求，此主机可能是主要的虚拟服务器，可能仅用于处理 SSL 流量，还可能会为您想要允许的特定应用程序映射此主机。为简便起见，通常将 <VirtualHost *:443> 用于此目的。必须激活此主机来处理 Verse 所调用的 Connections API 的流量。

将以下行复制粘贴到 <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

在粘贴的文本中查找以下行：
```
SetEnvIf Origin "^https://(vop_server_hostname\.)?(domain_name)$" origin_is=$0
```
编辑此行：
- 将 vop_server_hostname 替换为 Verse 邮件服务器名称的主机名部分。
- 将 domain_name 替换为 Verse On Premises 邮件服务器的域。
使用反斜杠 (\) 转义名称中的所有句点。
例如，假定您的 Connections 服务器为 https://connections.renovations.com，并且邮件服务器为：
```
https://mail1.uk.renovations.com
https://mail2.us.renovations.com
https://mail3.jp.renovations.com
```
在此情况下，请指定以下行：
```
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 
```
或者，指定以下行以表示所有服务器，而无需为每台服务器添加一行：
```
SetEnvIf Origin "^https://(mail.*\.)?(.*\.renovations\.com)$" origin_is=$0
```

要支持 Verse 用户连接至 Connections 服务器，请将以下行添加至 Domino 数据目录中的 notes.ini 文件：
```
VOP_LLN2_BSSUIServer_URL=https://HCL_http_server_hostname
```
注：如果设置位于 notes.ini 文件中的最后一行，请在该行之后按 ENTER 键。
重新启动 Domino® 服务器：
```
Restart server
```