SharePoint程序化访问：解决AADSTS65001错误与证书认证实践-Python教程-PHP中文网

SharePoint程序化访问：解决AADSTS65001错误与证书认证实践

本文旨在解决在使用`office365-rest-python-client`库程序化访问sharepoint online时，即使已授予api权限并进行管理员同意，仍可能遇到的`aadsts65001 delegationdoesnotexist`认证错误。核心解决方案是放弃客户端密钥（client secret）认证方式，转而采用更适合后端服务间通信的azure ad应用程序证书认证流程，从而实现稳定、安全的sharepoint无用户交互访问。

理解AADSTS65001错误及其背景

在使用Python脚本等后端服务程序化访问Office 365 SharePoint Online时，常见的认证方式是通过Azure Active Directory (Azure AD) 应用程序注册。通常，我们会创建一个应用程序注册，添加客户端密钥（Client Secret），并授予必要的API权限（例如SharePoint Sites.FullControl.All或更细粒度的权限），然后进行管理员同意。然而，即便完成了这些步骤，有时仍会遇到AADSTS65001: DelegationDoesNotExist错误，伴随着“The user or administrator has not consented to use the application with ID X”的提示，以及HTTP 401 Unauthorized响应。

这个错误通常发生在Azure AD尝试验证一个委托（Delegation）权限流，但找不到相应的用户同意记录时。对于一个纯粹的后端服务，没有前端用户进行交互式登录和同意，委托权限流并不适用。尽管我们可能已经授予了“应用程序权限”并进行了管理员同意，但某些情况下，使用客户端密钥的方式可能仍会被Azure AD误解为尝试执行需要用户同意的委托流，或者在特定的API调用或配置下，客户端密钥的身份验证上下文未能完全满足无用户交互的应用级访问要求。

为了解决这个问题，并实现真正的应用程序级（App-Only）访问，Azure AD推荐使用证书认证。证书认证提供了一种更强大、更安全的应用程序身份验证机制，尤其适用于服务器到服务器或守护进程（daemon）应用程序，因为它明确地标识了应用程序本身，而不是模拟任何用户。

解决方案：Azure AD应用程序证书认证

证书认证是实现Azure AD应用程序无用户交互访问（App-Only Access）SharePoint Online的推荐方法。它通过使用X.509证书来证明应用程序的身份，而不是依赖于客户端密钥。

1. 配置Azure AD应用程序注册以使用证书

要使用证书认证，您需要在Azure AD中为您的应用程序注册配置一个有效的X.509证书。

生成或获取证书： 您可以自签名一个证书用于开发和测试，或者从证书颁发机构（CA）获取一个正式的证书用于生产环境。 自签名证书示例（Linux/macOS）：

# 生成私钥
openssl genrsa -out privatekey.pem 2048

# 从私钥生成CSR (Certificate Signing Request)
openssl req -new -key privatekey.pem -out cert.csr -subj "/CN=MySharePointApp"

# 自签名证书 (有效期1年)
openssl x509 -req -days 365 -in cert.csr -signkey privatekey.pem -out certificate.crt

# 将私钥转换为PKCS#12格式（如果需要，但通常.pem和.crt足够）
# openssl pkcs12 -export -out certificate.pfx -inkey privatekey.pem -in certificate.crt

登录后复制

您将需要privatekey.pem（私钥）和certificate.crt（公钥证书）。

上传证书到Azure AD应用程序注册：

神卷标书
神卷标书，专注于AI智能标书制作、管理与咨询服务，提供高效、专业的招投标解决方案。支持一站式标书生成、模板下载，助力企业轻松投标，提升中标率。

39

查看详情
- 登录到 Microsoft Entra 管理中心。
- 导航到 应用程序 > 应用注册。
- 选择您的应用程序注册。
- 在左侧导航栏中，点击 证书和密码。
- 在证书选项卡下，点击 上传证书。
- 选择您生成的.crt或.pem格式的公钥证书文件并上传。
配置API权限：
- 在您的应用程序注册中，导航到 API 权限。
- 点击 添加权限。
- 选择 Microsoft Graph 或 SharePoint。对于SharePoint访问，通常选择 SharePoint。
- 选择 应用程序权限（而非委托的权限）。
- 选择所需的权限，例如 Sites.FullControl.All 或更具体的权限（如 Sites.Read.All, Sites.ReadWrite.All）。
- 点击 添加权限。
- 重要： 点击 为 [您的租户名称] 授予管理员同意。这是确保应用程序权限生效的关键一步。

2. 使用office365-rest-python-client进行证书认证

一旦Azure AD应用程序配置了证书，您就可以在Python代码中使用office365-rest-python-client库通过证书进行认证。

示例代码：

from office365.sharepoint.client_context import ClientContext
from office365.runtime.auth.client_certificate import ClientCertificate

# 配置您的Azure AD应用程序和SharePoint信息
tenant_url = "https://yourtenant.sharepoint.com" # 您的SharePoint租户URL
site_url = f"{tenant_url}/sites/security" # 您要访问的SharePoint站点URL
client_id = "YOUR_AZURE_AD_APP_CLIENT_ID" # 您的Azure AD应用程序的客户端ID (Application ID)

# 证书文件路径
# 请确保私钥文件安全存储，不要直接暴露在代码中
certificate_path = "path/to/your/certificate.crt" # 公钥证书文件路径
private_key_path = "path/to/your/privatekey.pem" # 私钥文件路径

# 如果私钥有密码，请在此处提供
private_key_password = None # 如果没有密码，设置为None

try:
    # 创建ClientCertificate对象
    # ClientCertificate需要私钥和公钥证书内容
    # 推荐直接读取文件内容
    with open(private_key_path, 'rb') as f:
        private_key_content = f.read()
    with open(certificate_path, 'rb') as f:
        certificate_content = f.read()

    # 使用ClientCertificate进行认证
    cert_auth = ClientCertificate(
        tenant=tenant_url.split('//')[1].split('.')[0] + ".onmicrosoft.com", # 您的租户ID或域名
        client_id=client_id,
        private_key=private_key_content,
        certificate=certificate_content,
        private_key_password=private_key_password
    )

    # 创建ClientContext对象，使用证书认证
    ctx = ClientContext(site_url, cert_auth)

    # 示例操作：获取当前Web的标题
    web = ctx.web.get().execute_query()
    print(f"成功连接到SharePoint站点: {web.url}")
    print(f"站点标题: {web.properties['Title']}")

    # 示例操作：添加一个页面 (需要Sites.ReadWrite.All或更高权限)
    # from office365.sharepoint.pages.page import Page
    # page_name = "MyNewPageFromPython"
    # content = "<h1>Hello from Python!</h1><p>This is a new page created programmatically.</p>"
    #
    # page = Page.create_wiki_page(ctx, web.properties["SitePages"], page_name, content)
    # ctx.execute_query()
    # print(f"成功创建页面: {page.url}")

except Exception as e:
    print(f"连接或操作SharePoint失败: {e}")
    # 详细错误信息可能在e.response.text中，如果请求失败

登录后复制

代码说明：

tenant_url：您的SharePoint租户的根URL，例如https://yourtenant.sharepoint.com。
site_url：您希望访问的具体SharePoint站点或子站点的URL。
client_id：这是您在Azure AD应用程序注册中获取的“应用程序(客户端) ID”。
certificate_path 和 private_key_path：指向您之前生成或获取的公钥证书文件（.crt或.pem）和私钥文件（.pem）的路径。
ClientCertificate 类的 tenant 参数需要您的Azure AD租户域名，通常是yourtenant.onmicrosoft.com。
ctx.web.get().execute_query()：这是一个简单的示例，用于获取当前Web对象的属性并执行查询。如果连接成功，它将返回Web对象的标题。
注释掉的页面创建代码展示了如何执行更复杂的写操作，但需要相应的写入权限。

注意事项与最佳实践

证书安全： 私钥文件是您应用程序身份的关键。务必将其安全存储，避免泄露。在生产环境中，可以考虑使用Azure Key Vault等服务来管理和保护证书。
权限最小化： 始终遵循最小权限原则。只授予您的应用程序完成其任务所需的最小API权限。例如，如果只需要读取站点内容，则授予Sites.Read.All而不是Sites.FullControl.All。
证书有效期： 证书有有效期。请确保定期更新证书，并在Azure AD中上传新证书，以避免服务中断。
错误处理： 在实际应用中，应包含健壮的错误处理机制，捕获可能的网络问题、认证失败或SharePoint API返回的错误。
office365-rest-python-client文档： 查阅官方PyPI页面和GitHub Wiki以获取最新和最详细的用法示例和文档。

总结

AADSTS65001 DelegationDoesNotExist错误在使用客户端密钥进行SharePoint程序化访问时，通常是由于认证流与预期不符导致的。通过切换到Azure AD应用程序证书认证，我们可以建立一个明确的、无用户交互的应用程序级身份验证机制，从而稳定、安全地访问SharePoint Online。这种方法不仅解决了特定的认证错误，也提升了后端服务访问Office 365资源的整体安全性。

以上就是SharePoint程序化访问：解决AADSTS65001错误与证书认证实践的详细内容，更多请关注php中文网其它相关文章！