Skip to content
Back to top

# SharePoint 搜索

使用 UltraSearch 搜索 SharePoint 简单快捷，UltraSearch 允许你直接访问 SharePoint，而无需创建自己的 Azure 应用程序注册。

首次登录时，UltraSearch 会要求你授予搜索 SharePoint 的权限。

在某些情况下，这需要管理员的批准。这种批准应在整个租户范围内进行，每家公司/租户只需批准一次。

可选：无需安装 UltraSearch 即可获得整个租户的同意。

## 使用自己的 Azure 注册

或者，您也可以使用自己的 Azure 注册，这样可以在配置中获得更多控制权和灵活性。更多信息，请参阅 Azure 配置部分。

请在以下情况下选择此选项

- 您想限制某些用户访问 SharePoint（基于用户的身份验证）

- 您想使用基于证书的身份验证

## Azure 配置

如果 SharePoint Online 网站被配置为需要多因素身份验证，UltraSearch 将执行基于浏览器的身份验证（与其他 Azure 应用程序相同）。

要使 UltraSearch 能够从 Azure 租户获取身份验证令牌，必须先在 Azure 门户中注册，并授予它访问 SharePoint Online 的权限：

### 在租户处注册 UltraSearch

请注意，以下步骤必须在 UltraSearch 范围之外进行。这些步骤可能会随着微软的不断开发而改变。

1. 登录 Azure 门户。

2. 在左侧导航中选择 "所有服务"，然后选择 "应用程序注册"（或使用顶部栏中的搜索字段）

3. 选择 "新建应用程序注册"，然后创建一个注册，并输入以下值：

   名称：我们建议使用 UltraSearch。

   重定向 URI：有时也称为回复 URL。请在此处选择 "公共客户端/nativ"。由于 UltraSearch 使用 MSAL 进行身份验证，因此请使用为此目的提供的重定向 URI，或者根据 "我的 URI"://auth 方案定义自己的重定向 URI，例如 treesize://auth

4. 注册完成后，Azure 将为应用程序分配一个唯一的应用程序 ID。从右侧窗格中复制此值，因为接下来的步骤需要用到它。

### 向 UltraSearch 提供配置信息

要使用上述应用程序注册，必须向 UltraSearch 提供信息。有三种方法可供选择：

- 如果只想为单个用户/电脑配置这些设置（例如评估和测试设置），可以在选项对话框中进行，也可以通过命令行将这些值传递给 UltraSearch。

  在 UltraSearch 中配置注册：

  1. 在 UltraSearch 中选择 "选项 "标签，然后从 "常规 "下拉菜单中选择 "连接 SharePoint

  2. 然后提供上文定义的应用程序 ID 和重定向 URI，点击保存。

  3. 现在，您可以将 SharePoint 路径添加为搜索目标。

  要从命令行配置这些值，请使用以下参数运行 UltraSearch。UltraSearch 会记住这些值，因此只需配置一次。

  - /AADApplicationID 后跟 Azure 门户分配的应用程序 ID，例如 /AADApplicationID xxxxxxxx-yyyyy-yyyy-xxxxxxxxxxxx，以及

  - /AADRedirectURI 后跟指定注册时指定的重定向 URI，如 /AADRedirectURI UltraSearch://auth

- 如果要为公司内的某个组配置这些设置，可以定义一个组策略对象来推出这些设置：1.下载并安装 UltraSearch 的管理模板。2.2. 打开组策略管理控制台，导航到要包含配置的 GPO 或创建一个新的 GPO。3.3. 在 "用户配置">"管理模板">"JAM 软件">"UltraSearch">"默认设置 "中配置条目。

### 基于证书的身份验证

基于证书的身份验证允许 UltraSearch 使用数字证书而不是用户凭证向身份验证服务表明自己的身份。

在开始之前，请确保您已

- 对 Azure 应用程序注册的管理访问权限

- 在系统上创建证书的权限

## 逐步设置指南

### 步骤 1：创建自签名证书

使用 PowerShell 的 New-PnPAzureCertificate 命令创建证书文件。请访问文档以获取参考：https://pnp.github.io/powershell/cmdlets/New-PnPAzureCertificate.html

Note

要使用该命令，您需要使用以下命令导入 PnP.PowerShell 模块：导入模块 PnP.PowerShell

生成证书文件：

- 创建 .cer 文件（公共证书）和 .pfx 文件（带证书的私人密钥）

- 为证书使用描述性名称（如 "Auth-Cert）

Note

我们建议使用文档中的 "例 3 "作为创建带密码证书的参考。

验证证书创建：

- 确认 .cer 和 .pfx 文件都已创建

- 注意证书缩略图，以备将来参考

- 安全存储 .pfx 文件及其密码

### 第 2 步：配置 Azure 注册

上传证书：

1. 导航至您的 Azure 应用程序注册

2. 转到 "证书和机密 "部分

3. 点击 "上传证书

4. 选择并上传在步骤 1 中创建的 .cer 文件

### 第 3 步：配置 API 权限

添加 SharePoint 权限：

1. 进入应用程序注册中的 "应用程序接口权限

2. 点击 "添加权限

3. 从 Microsoft API 中选择 "Microsoft Graph

4. 选择 "应用程序权限

5. 添加 "Sites.Selected "权限

Note

确保 c 和 d 步骤正确配置了所授予的权限，否则以后可能会导致错误的身份验证。

Sites.Selected 权限允许应用程序仅访问已明确配置的特定 SharePoint 网站集，从而提供细粒度的安全控制。

授予管理许可：

1. 单击您所在机构的 "授予管理同意

2. 确认权限已授予（状态显示绿色复选标记）

### 第 4 步：配置 SharePoint 网站集

站点集合配置：

- 请联系您的 SharePoint 管理员，配置 UltraSearch 应访问的特定站点集合

- 向他们提供应用程序注册的应用程序（客户端）ID

- 或者访问常见问题页面，了解如何配置： https://knowledgebase.jam-software.com/7686

### 第 5 步：配置 UltraSearch

证书配置：

- 出现提示时，配置 UltraSearch 使用 .pfx 文件进行身份验证

- 提供证书文件路径和证书密码