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 范围之外进行。这些步骤可能会随着微软的不断开发而改变。
登录 Azure 门户。
在左侧导航中选择 "所有服务"，然后选择 "应用程序注册"（或使用顶部栏中的搜索字段）
选择 "新建应用程序注册"，然后创建一个注册，并输入以下值：
名称：我们建议使用 UltraSearch。
重定向 URI：有时也称为回复 URL。请在此处选择 "公共客户端/nativ"。由于 UltraSearch 使用 MSAL 进行身份验证，因此请使用为此目的提供的重定向 URI，或者根据 "我的 URI"://auth 方案定义自己的重定向 URI，例如 treesize://auth
注册完成后，Azure 将为应用程序分配一个唯一的应用程序 ID。从右侧窗格中复制此值，因为接下来的步骤需要用到它。
向 UltraSearch 提供配置信息¶
要使用上述应用程序注册，必须向 UltraSearch 提供信息。有三种方法可供选择：
如果只想为单个用户/电脑配置这些设置（例如评估和测试设置），可以在选项对话框中进行，也可以通过命令行将这些值传递给 UltraSearch。
在 UltraSearch 中配置注册：
在 UltraSearch 中选择 "选项 "标签，然后从 "常规 "下拉菜单中选择 "连接 SharePoint
然后提供上文定义的应用程序 ID 和重定向 URI，点击保存。
现在，您可以将 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 注册¶
上传证书：
导航至您的 Azure 应用程序注册
转到 "证书和机密 "部分
点击 "上传证书
选择并上传在步骤 1 中创建的 .cer 文件
第 3 步：配置 API 权限¶
添加 SharePoint 权限：
进入应用程序注册中的 "应用程序接口权限
点击 "添加权限
从 Microsoft API 中选择 "Microsoft Graph
选择 "应用程序权限
添加 "Sites.Selected "权限
Note
确保 c 和 d 步骤正确配置了所授予的权限，否则以后可能会导致错误的身份验证。
Sites.Selected 权限允许应用程序仅访问已明确配置的特定 SharePoint 网站集，从而提供细粒度的安全控制。
授予管理许可：
单击您所在机构的 "授予管理同意
确认权限已授予（状态显示绿色复选标记）
第 5 步：配置 UltraSearch¶
证书配置：
出现提示时，配置 UltraSearch 使用 .pfx 文件进行身份验证
提供证书文件路径和证书密码