解决Azure文档智能服务“密钥认证被禁用”错误：综合指南-Python教程-PHP中文网

解决Azure文档智能服务“密钥认证被禁用”错误：综合指南

DDD

发布： 2025-09-18 12:08:51

原创

290人浏览过

解决azure文档智能服务“密钥认证被禁用”错误：综合指南

当使用Azure文档智能服务时，遇到“密钥认证被禁用”（AuthenticationTypeDisabled）错误，通常并非代码逻辑问题，而是Azure资源层面的安全配置所致。这意味着您的特定文档智能服务实例已禁用基于密钥的身份验证，需要检查并调整资源配置或联系管理员以获取适当的访问权限。

Azure文档智能服务认证错误解析

在使用Azure文档智能服务（Document Intelligence）进行文档内容提取时，开发者通常会通过服务终结点（endpoint）和访问密钥（key）进行身份验证。然而，有时即使代码逻辑正确，也可能遇到 HttpResponseError: (AuthenticationTypeDisabled) Key based authentication is disabled for this resource. 这样的错误。这个错误明确指出，当前Azure资源已禁用基于密钥的身份验证方式。

错误现象与代码示例

以下是一个典型的Python代码片段，用于连接Azure文档智能服务并分析文档。当遇到上述认证错误时，代码在尝试创建 DocumentAnalysisClient 并发起分析请求时会失败。

from azure.ai.formrecognizer import DocumentAnalysisClient
from azure.core.credentials import AzureKeyCredential

# 请替换为您的实际终结点和密钥
endpoint = "https://your-resource-name.cognitiveservices.azure.com/"
key = "YOUR_AZURE_DOCUMENT_INTELLIGENCE_KEY" # 确保此密钥是有效的

def format_bounding_region(bounding_regions):
    if not bounding_regions:
        return "N/A"
    return ", ".join("Page #{}: {}".format(region.page_number, format_polygon(region.polygon)) for region in bounding_regions)

def format_polygon(polygon):
    if not polygon:
        return "N/A"
    return ", ".join(["[{}, {}]".format(p.x, p.y) for p in polygon])

def analyze_general_documents():
    # 示例文档URL
    docUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"

    # 初始化文档分析客户端
    # 错误通常在此处或紧随其后的API调用中抛出
    document_analysis_client = DocumentAnalysisClient(endpoint=endpoint, credential=AzureKeyCredential(key))

    print("尝试连接Azure文档智能服务并分析文档...")
    try:
        poller = document_analysis_client.begin_analyze_document_from_url(
                "prebuilt-document", docUrl)
        result = poller.result()

        # 打印分析结果（此处省略大部分结果打印代码，与原始问题代码一致）
        print("文档分析成功！")
        for style in result.styles:
            if style.is_handwritten:
                print("文档包含手写内容。")
        print("----键值对----")
        for kv_pair in result.key_value_pairs:
            if kv_pair.key:
                print(f"键: '{kv_pair.key.content}'")
            if kv_pair.value:
                print(f"值: '{kv_pair.value.content}'\n")
        # ... 其他结果打印 ...

    except Exception as e:
        print(f"文档分析失败: {e}")
        if "AuthenticationTypeDisabled" in str(e):
            print("错误提示：密钥认证已被禁用。请检查Azure资源配置或联系管理员。")

if __name__ == "__main__":
    analyze_general_documents()

登录后复制

当上述代码执行时，如果Azure资源禁用了密钥认证，将会在 document_analysis_client.begin_analyze_document_from_url 调用时抛出 HttpResponseError。

根本原因：Azure资源配置

此错误的根本原因在于Azure文档智能服务实例的身份验证设置。Azure提供了多种身份验证方式，包括：

基于密钥的身份验证 (Key-based authentication)：这是最常见的，通过终结点和API密钥进行认证。
Azure Active Directory (AAD) 身份验证：通过Azure AD进行身份验证，提供更细粒度的访问控制和企业级安全功能。

为了增强安全性或遵循组织策略，Azure管理员可能会选择禁用基于密钥的身份验证，强制所有访问都通过Azure AD进行。一旦禁用，即使提供了正确的API密钥，服务也会拒绝连接。

解决方案与注意事项

解决此问题需要从Azure资源配置层面入手，而不是修改代码逻辑。

检查Azure资源身份验证设置：
- 登录Azure门户。
- 导航到您的文档智能服务（Document Intelligence）资源。
- 在资源菜单中，查找与“身份验证”、“访问控制”或“密钥和终结点”相关的设置。
- 确认“密钥认证”是否被禁用。如果被禁用，您需要联系Azure管理员以启用它，或者切换到Azure AD身份验证。
联系Azure管理员：

Kimi智能助手
超强AI写作助手，一键总结20w字长文，支持批量文档上传，多端同步内容不怕丢失。论文综述、文档速读、脚本小说创作，统统交给Kimi！实时联网搜索，给你最智能清晰的解答。

1671

查看详情
- 如果您的组织有严格的安全策略，可能会默认禁用密钥认证。在这种情况下，您需要联系负责管理Azure资源的管理员。
- 管理员可以：
  - 为您的资源重新启用密钥认证（如果允许）。
  - 为您提供使用Azure AD进行身份验证所需的权限和指导。
  - 提供一个已启用密钥认证的新资源，或者一个您有权访问的现有资源。

考虑使用Azure AD身份验证（推荐）：

如果密钥认证被禁用是出于安全考虑，那么切换到Azure AD身份验证是更专业的做法。
使用Azure AD，您可以利用服务主体（Service Principal）或托管标识（Managed Identity）进行身份验证，这通常比直接使用API密钥更安全、更易于管理。

示例 (使用Azure AD默认凭据，适用于Azure环境或配置了Azure CLI/环境变量的情况):

from azure.ai.formrecognizer import DocumentAnalysisClient
from azure.identity import DefaultAzureCredential # 导入DefaultAzureCredential

endpoint = "https://your-resource-name.cognitiveservices.azure.com/"

def analyze_with_aad():
    docUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"

    # 使用DefaultAzureCredential进行身份验证
    # 它会尝试通过多种方式（环境变量、Managed Identity、Azure CLI等）获取凭据
    credential = DefaultAzureCredential()
    document_analysis_client = DocumentAnalysisClient(endpoint=endpoint, credential=credential)

    print("尝试使用Azure AD凭据连接Azure文档智能服务并分析文档...")
    try:
        poller = document_analysis_client.begin_analyze_document_from_url("prebuilt-document", docUrl)
        result = poller.result()
        print("文档分析成功（使用AAD认证）！")
        # ... 打印结果 ...
    except Exception as e:
        print(f"文档分析失败（使用AAD认证）: {e}")

if __name__ == "__main__":
    analyze_with_aad()

登录后复制

要使 DefaultAzureCredential 工作，您需要确保运行代码的环境已正确配置了Azure AD凭据，例如通过 az login 登录Azure CLI，或者配置了相应的环境变量。

总结

当您遇到Azure文档智能服务 AuthenticationTypeDisabled 错误时，请记住问题不在于您的Python代码逻辑，而在于Azure资源的身份验证配置。务必检查您的Azure资源设置，并在必要时与您的Azure管理员协作，以启用密钥认证或切换到更安全的Azure AD身份验证方式。理解并正确配置Azure资源的身份验证机制是成功集成云服务的关键一步。

以上就是解决Azure文档智能服务“密钥认证被禁用”错误：综合指南的详细内容，更多请关注php中文网其它相关文章！