在 Spotfire Web 客户端中启用 Microsoft SharePoint Online 连接器

要在 Spotfire Web 客户端中访问 SharePoint Online 数据，您必须配置 Web Player 服务，以通过 Microsoft Azure 中自己的注册应用程序访问 SharePoint。

关于此任务

之所以需要这样做，是因为在内部部署 Spotfire 环境中，Spotfire Web 客户端无法利用 Microsoft Azure 中的 Spotfire 应用程序访问 SharePoint Online 中的数据。

开始之前

您需要在 Microsoft Azure 中注册一个应用程序。

注：在 TIBCO Cloud™ Spotfire 环境中，无法在 Web 客户端中使用 SharePoint Online 连接。

配置 Microsoft Azure 中的应用程序

关于此任务

在 Microsoft Azure 中，按如下方式为 Spotfire 配置注册应用程序。

重定向 URI

将您的 Spotfire Server 添加为“Web 重定向 URI”：

https://<spotfire_server>/spotfire/wp/oauth2/code

应用程序（客户端）ID、客户端密钥和租户 ID

从 Microsoft Azure 中的注册应用程序收集以下信息：

应用程序（客户端）ID
客户端密钥（您可能需要创建一个新的密钥，并将其记下来）
“租户 ID”（如果要使用单租户身份验证）

单租户和多租户身份验证

在获取已注册应用程序的令牌时，您可以选择是使用单租户身份验证还是多租户身份验证。在“支持的帐户类型”下，确保将您的应用程序配置为单租户或多租户（可供任何 Azure AD 目录中的帐户访问），具体取决于要使用的身份验证。

有关租赁的详细信息，请参见 Microsoft 文档中的 Azure Active Directory 中的租赁。

注：如果您已将应用程序配置为单租户，则还必须在 Web 客户端服务配置或管理器的偏好设置中添加租户 ID。

配置 Spotfire Web 客户端

关于此任务

将“应用程序（客户端）ID”和“客户端密钥”添加到您的 Web 客户端的 Web Player 服务配置。如果要使用单租户身份验证，还必须添加“租户 ID”。在配置文件 Spotfire.Dxp.Worker.Host.exe.config 中添加这些设置。

过程

在运行 Spotfire Server 的计算机上，导出要编辑的服务配置。请参见您的 Spotfire 版本的《Spotfire Server 和环境 - 安装和管理手册》的手动编辑服务配置文件主题中的说明。

在 Spotfire.Dxp.Worker.Host.exe.config 文件中，找到或添加设置 Spotfire.Dxp.Data.Adapters.MicrosoftCommon.Properties.Settings：

示例:

<Spotfire.Dxp.Data.Adapters.MicrosoftCommon.Properties.Settings>
  <setting name="ClientSecret" serializeAs="String">
     <value>Your client secret</value>
  </setting>
  <setting name="ClientId" serializeAs="String">
     <value>Your application (client) ID</value>
  </setting>
</Spotfire.Dxp.Data.Adapters.MicrosoftCommon.Properties.Settings>

分别在 ClientId 和 ClientSecret 设置中添加您的“应用程序（客户端）ID”和“客户端密钥”。
1. （可选）对于单租户身份验证，还要添加“租户 ID”。将其添加到 Spotfire.Dxp.Data.Adapters.MicrosoftCommon.Properties.Settings 中的 TenantId 设置。
  示例:
```
<setting name=”TenantId” serializeAs=”String”>
    <value>Your tenant ID</value>
</setting>
```
  注：您的租户 ID 可以是租户的 GUID 或域名。
  此设置的默认值为 common，这意味着您使用多租户身份验证。
保存更改。然后按照《Spotfire Server 和环境 - 安装和管理手册》中的说明导入服务配置。

注：如果您使用多个服务配置来配置不同的 Web Player 服务，请确保在所有相关的服务配置中添加这些设置。记住，无法编辑默认服务配置。

管理器中的偏好设置

关于此任务

输入“应用程序（客户端）ID”、“客户端密钥”和“租户 ID”（如果适用）的另一种方法是使用 Spotfire 管理器中的 Azure AD 偏好设置。通过偏好设置，您可以根据每个 Spotfire 用户组，配置 Spotfire 在连接到 SharePoint Online 时使用哪个 Microsoft Azure 注册应用程序。

偏好设置可从“连接器”>“Azure AD 身份验证”下访问：

ClientID
ClientSecret
TenantID（如果要使用单租户身份验证）

如果您使用安装了 Spotfire 的客户端，则这些偏好设置也是有效的。

注：如果您为登录用户同时配置了服务配置和用户组偏好设置，则偏好设置优先。

注：如果您在服务配置中以及管理器的偏好设置中都没有设置租户 ID，则系统将自动使用多租户身份验证。

使用偏好设置时 Microsoft Azure 中的设置

如果您使用偏好设置，则必须在 Microsoft Azure 的注册应用程序中更改其他设置，才可以使用安装了 Spotfire 的客户端。

在 Microsoft Azure 的注册应用程序中添加“移动和桌面应用程序”作为平台。在该平台中添加以下额外重定向 URI：
```
http://localhost
```
确保在 Microsoft Azure 中的应用程序未注册为公共客户端。