document.writeln('');

azure文檔智能服務(wù)(document intelligence,原名form recognizer)是一個強大的云服務(wù),用于從文檔中提取文本、鍵值對、表格和結(jié)構(gòu)化數(shù)據(jù)。開發(fā)者通常通過其python sdk與服務(wù)進行交互,其中認證是連接到服務(wù)的第一步。
當嘗試使用Azure文檔智能服務(wù)的端點(endpoint)和API密鑰(key)進行認證時,可能會遇到以下錯誤信息:
1 2 3 |
|
此錯誤明確指出,當前資源已禁用基于API密鑰的認證類型。這意味著即使提供的API密鑰是正確的,服務(wù)也不會接受它,因為它根本沒有啟用這種認證機制。
以下是導(dǎo)致此錯誤的典型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 |
|
AuthenticationTypeDisabled錯誤并非代碼語法或邏輯問題。它直接來源于Azure文檔智能服務(wù)資源的配置。在Azure中,資源可以配置多種認證方式,包括基于API密鑰和基于Azure Active Directory (AAD) 的認證。當此錯誤發(fā)生時,通常意味著:
值得注意的是,代碼中 DocumentAnalysisClient(endpoint=endpoint, credential=AzureKeyCredential(key)) 的寫法在API密鑰認證啟用時是完全正確的。
解決此問題主要有以下幾個方向:
如果您的權(quán)限允許,或者您可以聯(lián)系到Azure管理員,請按照以下步驟檢查并修改文檔智能服務(wù)資源的認證設(shè)置:
重要提示: 在企業(yè)環(huán)境中,強烈建議遵循組織的安全策略。如果策略要求禁用API密鑰認證,請不要隨意啟用。
Azure Active Directory (AAD) 認證是更安全、更靈活的認證方式,特別適用于企業(yè)級應(yīng)用。當API密鑰認證被禁用時,使用AAD認證是最佳實踐。
要使用AAD認證,您需要安裝 azure-identity 庫,并使用 DefaultAzureCredential。DefaultAzureCredential 會嘗試通過多種方式(如環(huán)境變量、托管標識、Azure CLI、Visual Studio Code等)獲取憑據(jù)。
步驟:
安裝必要的庫:
1 |
|
修改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 |
|
配置本地環(huán)境以使用AAD認證:
如果您不確定如何配置Azure資源,或者沒有權(quán)限進行更改,最直接有效的方法是聯(lián)系您的Azure管理員或IT團隊。他們可以幫助您:
通過理解此錯誤的原因并采取相應(yīng)的解決策略,您可以有效地連接到Azure文檔智能服務(wù)并利用其強大的功能。