在 SharePoint Online 中使用仅应用租户权限进行开发

需要仅应用租户权限的 SharePoint 提供程序承载的外接程序的开发人员体验已经发生了更改。 本文将引导你完成开发和调试这些解决方案的新体验。

适用于:SharePoint Online 的提供程序承载的外接程序

了解此问题

在 Visual Studio 中,转到“调试”并开始调试,看到内容为“租户管理员必须批准此应用”的消息,如下所示。

是否信任“我的租户”加载项对话框?

之所以无法单击“信任它”是因为,Visual Studio 是针对已在项目设置中指定的开发网站集运行,而租户级仅限应用权限只能通过针对租户管理网站信任它进行授予。

演练

步骤 1:创建新的服务主体

导航到租户中的网站集,并生成新的客户端 ID 和密码。 (例如,https://contoso.sharepoint.com/_layouts/15/appregnew.aspx)。 在此页面中,为“客户端 ID”、“客户端密码”字段单击“生成”并提供其余字段。 开发加载项时,请确保使用 localhost(包括端口)作为应用域。 应具有与下面类似的内容。

在 AppRegNew 页中创建新的服务主体

步骤 2:授予租户权限

若要执行此步骤,你必须是 SharePoint Online 管理员。

导航到 SharePoint 管理中心(例如,https://contoso-admin.sharepoint.com/_layouts/15/appinv.aspx)并授予租户权限

使用 XML 指定应用的权限

“应用信任”对话框确认权限更改

步骤 3:更新清单和 web.config

在 Visual Studio 解决方案中;使用步骤 1 中创建的客户端 ID 更新清单和 web.config

在加载项的 Web.config 中设置应用的客户端 ID

步骤 4:打包应用并将 .app 文件添加到应用程序目录

右键单击 SharePoint 加载项项目,再单击“发布”。

提供在第 1 步中创建的客户端 ID客户端密码

在 Visual Studio 中设置加载项标识对话框中的客户端 ID 和密码

由于要调试外接程序,因此,请务必提供包括端口的 https://localhost,如下所示。

将用于调试的位置设置为https://localhost

现在在应用目录站点中部署外接程序。

步骤 5:在开发人员网站集中安装外接程序

转到开发人员网站并添加应用。 单击“应用详细信息”

选择应用上的详细信息链接

如果选择了应用磁贴,必须选择“查找原因”,并请求获取应用

通过完成对话框请求应用

一旦提交请求,状态将处于待定状态,直到 SharePoint 管理员或应用程序目录管理员批准该请求。 要批准该请求,请导航到应用程序目录,选择“应用请求”,并批准该请求。

“批准或拒绝应用请求”对话框

一旦批准此请求,可以立即安装外接程序。

“信任”对话框提示

步骤 6:调试你的外接程序

在 Visual Studio 中右键单击 Web 项目,并选择“调试”启动新实例。 启动后,转到网站并启动加载项。

在 Visual Studio 中调试你的外接程序

注意

  • 如果由于某种原因你的应用包文件发生了更改,将需要将其重新部署到应用程序目录,并将其重新安装到开发网站集
  • 如果外接程序具有 appinstalled 事件接收器,将需要确保在完成步骤 5 前已执行步骤 6

另请参阅