使用sp-rest-proxy Addin only权限访问SharePoint出现403错误

配置相关疑问解答 #

• strategy 取值：OnlineAddinOnly 是 SharePoint Online 应用仅权限模式的正确取值，配置无误
• 启动后 clientSecret 变化：属于正常现象，sp-rest-proxy 内置敏感字段加密机制，会自动将明文密钥替换为加密后的字符串，不会影响正常使用

403错误核心排查方向 #

• 站点URL配置检查

  你当前配置的siteUrl为租户根站点地址，如果你要操作的json文件存储在子站点/特定站点集下，必须将siteUrl修改为对应站点的完整路径，例如https://ORGANIZTION.sharepoint.com/sites/你的团队站点名，仅配根站点会因应用权限未覆盖目标站点触发403。

• 应用注册权限生效检查
  即使已经将权限调整为FullControl，仍需确认两个操作是否完成：
  1. 配置完AppPermissionRequests后，是否点击了页面上的「信任」按钮完成应用权限授权，未授权的权限配置不会生效
  2. 若配置的是租户级权限，是否由租户管理员完成同意操作，普通管理员无法审批租户级权限申请
• 配置参数正确性校验
  1. realm字段取值为你的租户ID，需确认和实际租户ID完全一致，不要留占位符
  2. clientId需和应用注册时生成的客户端ID完全匹配，无多余字符或遗漏
  3. 检查clientSecret是否过期：默认 SharePoint 注册的应用密钥有效期为1年，过期后会直接触发权限拒绝
• 资源权限匹配检查
  如果你操作的文档库/列表开启了独立的项级权限，需确认应用权限的Scope覆盖了对应资源：如果仅针对单站点授权，Scope要配置为http://sharepoint/content/sitecollection/web；如果要操作整个站点集下的资源，Scope要配置为http://sharepoint/content/sitecollection

内容的提问来源于stack exchange，提问作者C.J. Morrison