document.writeln('');

国产精品最大AV站在线观看,a级黄毛片试看三分钟,AV无码A片高潮AV,国产午夜精品一区二区三区,久久爆乳不卡一区,日本三级欧美三级,日韩精品AV一二三区在线,高H短篇小说抽插

當前位置:首頁 > 云服務器 > Azure文檔智能服務:解決“密鑰認證禁用”錯誤及替代方案

Azure文檔智能服務:解決“密鑰認證禁用”錯誤及替代方案

游戲科技網2026年09月14日 21:28云服務器110

在使用Azure文檔智能服務Python SDK時,遇到AuthenticationTypeDisabled錯誤通常表示Azure資源本身禁用了基于API密鑰的認證方式。這不是代碼邏輯錯誤,而是資源配置或組織安全策略所致。解決此問題需要檢查Azure門戶中的資源認證設置,或考慮采用更安全的Azure Active Directory (AAD) 認證方式,并在必要時聯系Azure管理員獲取相應權限。

azure文檔智能服務(document intelligence,原名form recognizer)是一個強大的云服務,用于從文檔中提取文本、鍵值對、表格和結構化數據。開發者通常通過其python sdk與服務進行交互,其中認證是連接到服務的第一步。

1. 問題描述:密鑰認證失敗

當嘗試使用Azure文檔智能服務的端點(endpoint)和API密鑰(key)進行認證時,可能會遇到以下錯誤信息:

1

2

3

azure.core.exceptions.HttpResponseError: (AuthenticationTypeDisabled) Key based authentication is disabled for this resource.

Code: AuthenticationTypeDisabled

Message: Key based authentication is disabled for this resource.

此錯誤明確指出,當前資源已禁用基于API密鑰的認證類型。這意味著即使提供的API密鑰是正確的,服務也不會接受它,因為它根本沒有啟用這種認證機制。

以下是導致此錯誤的典型Python代碼示例:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

from azure.ai.formrecognizer import DocumentAnalysisClient

from azure.core.credentials import AzureKeyCredential

 

# 請替換為您的實際端點和密鑰

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

key = "YOUR_API_KEY" # 此處應填入您的API密鑰

 

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"

 

    # 初始化文檔分析客戶端

    document_analysis_client = DocumentAnalysisClient(endpoint=endpoint, credential=AzureKeyCredential(key))

 

    # 開始分析文檔

    poller = document_analysis_client.begin_analyze_document_from_url(

            "prebuilt-document", docUrl)

    result = poller.result()

 

    # ... 后續處理結果的代碼 ...

    print("文檔分析完成。")

 

if __name__ == "__main__":

    analyze_general_documents()

2. 錯誤分析:AuthenticationTypeDisabled 的根本原因

AuthenticationTypeDisabled錯誤并非代碼語法或邏輯問題。它直接來源于Azure文檔智能服務資源的配置。在Azure中,資源可以配置多種認證方式,包括基于API密鑰和基于Azure Active Directory (AAD) 的認證。當此錯誤發生時,通常意味著:

  • 資源配置策略: 您的組織或訂閱可能配置了嚴格的安全策略,默認禁用或強制禁用API密鑰認證,以強制使用更安全的AAD認證。
  • 手動禁用: 資源管理員可能在Azure門戶中手動禁用了API密鑰認證。
  • 權限不足: 作為用戶,您可能沒有足夠的權限來修改資源的認證設置,或者無法使用當前環境中配置的密鑰。

值得注意的是,代碼中 DocumentAnalysisClient(endpoint=endpoint, credential=AzureKeyCredential(key)) 的寫法在API密鑰認證啟用時是完全正確的。

3. 解決方案與建議

解決此問題主要有以下幾個方向:

3.1 驗證并修改Azure資源配置(如果允許)

如果您的權限允許,或者您可以聯系到Azure管理員,請按照以下步驟檢查并修改文檔智能服務資源的認證設置:

  1. 登錄Azure門戶: 訪問 portal.azure.com。
  2. 導航到文檔智能服務資源: 在搜索欄中輸入您的文檔智能服務資源名稱,并導航到該資源的概覽頁面。
  3. 檢查認證設置: 在資源菜單中查找與“身份驗證”、“密鑰”或“網絡”相關的設置。不同的Azure服務和版本可能位置略有不同。通常,您會在“資源管理”或“安全”部分找到管理API密鑰的選項,以及可能存在的認證類型開關。
  4. 啟用密鑰認證: 如果發現密鑰認證被禁用,并且您的組織策略允許,請嘗試啟用它。
  5. 重新生成密鑰: 確保您使用的密鑰是最新且有效的。

重要提示: 在企業環境中,強烈建議遵循組織的安全策略。如果策略要求禁用API密鑰認證,請不要隨意啟用。

word-document-organizer

智能整理Word文檔,自動排版、生成目錄、統一樣式,支持學術/商務/極簡模板。

下載

3.2 采用Azure Active Directory (AAD) 認證(推薦)

Azure Active Directory (AAD) 認證是更安全、更靈活的認證方式,特別適用于企業級應用。當API密鑰認證被禁用時,使用AAD認證是最佳實踐。

要使用AAD認證,您需要安裝 azure-identity 庫,并使用 DefaultAzureCredential。DefaultAzureCredential 會嘗試通過多種方式(如環境變量、托管標識、Azure CLI、Visual Studio Code等)獲取憑據。

步驟:

  1. 安裝必要的庫:

    1

    pip install azure-identity

  2. 修改Python代碼:將 AzureKeyCredential 替換為 DefaultAzureCredential。

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    12

    13

    14

    15

    16

    17

    18

    19

    20

    21

    22

    23

    24

    25

    26

    27

    28

    29

    30

    31

    32

    33

    34

    35

    from azure.ai.formrecognizer import DocumentAnalysisClient

    from azure.core.credentials import AzureKeyCredential # 仍然可以保留,但不再用于初始化

    from azure.identity import DefaultAzureCredential # 導入DefaultAzureCredential

     

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

    # key = "YOUR_API_KEY" # 不再直接使用API密鑰

     

    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():

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

     

        # 使用DefaultAzureCredential進行認證

        credential = DefaultAzureCredential()

        document_analysis_client = DocumentAnalysisClient(endpoint=endpoint, credential=credential)

     

        poller = document_analysis_client.begin_analyze_document_from_url(

                "prebuilt-document", docUrl)

        result = poller.result()

     

        # ... 后續處理結果的代碼 ...

        print("文檔分析完成。")

     

    if __name__ == "__main__":

        analyze_general_documents()

  3. 配置本地環境以使用AAD認證:

    • Azure CLI: 在終端運行 az login 進行登錄。DefaultAzureCredential 會自動檢測并使用您的CLI憑據。
    • 環境變量: 設置 AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET (適用于服務主體) 或 AZURE_USERNAME, AZURE_PASSWORD (不推薦用于生產環境)。
    • 托管標識: 如果您的代碼運行在Azure虛擬機、Azure應用服務等支持托管標識的環境中,DefaultAzureCredential 會自動利用這些標識。

3.3 聯系Azure管理員

如果您不確定如何配置Azure資源,或者沒有權限進行更改,最直接有效的方法是聯系您的Azure管理員或IT團隊。他們可以幫助您:

  • 確認資源認證策略。
  • 授予您必要的權限。
  • 指導您如何使用正確的認證方法(例如,提供服務主體的憑據)。

4. 總結與注意事項

  • 錯誤性質: AuthenticationTypeDisabled 是一個資源配置錯誤,而非代碼語法錯誤。您提供的Python代碼在API密鑰認證啟用時是正確的。
  • 安全性考量: 許多組織出于安全考慮會禁用API密鑰認證,并傾向于使用AAD認證。AAD提供了更精細的訪問控制、更好的審計能力和更安全的憑據管理。
  • 調試思路: 當遇到此類認證錯誤時,首先應檢查Azure門戶中的資源配置,其次考慮切換到推薦的AAD認證方式。

通過理解此錯誤的原因并采取相應的解決策略,您可以有效地連接到Azure文檔智能服務并利用其強大的功能。

“Azure文檔智能服務:解決“密鑰認證禁用”錯誤及替代方案” 的相關文章