返回

无需凭据即可使用 DocumentAnalysisClient:打造灵活且安全的文档分析

python

如何在不使用凭据的情况下使用 Azure DocumentAnalysisClient

简介

Azure DocumentAnalysisClient 是一种强大的工具,可用于从各种文档中提取数据。然而,该类通常需要凭据参数,这给使用开放 HTTP 端点的服务造成了困难。本文将指导你如何在不使用凭据的情况下使用 DocumentAnalysisClient,使你能够利用其功能而无需身份验证。

步骤

1. 创建无凭据的 ClientOptions 对象

azure.ai.formrecognizer 模块导入 DocumentAnalysisClientClientOptions。使用 ClientOptions 构造函数创建一个无凭据的 ClientOptions 对象,将 retry_policy 参数设置为一个空字典。

from azure.ai.formrecognizer import DocumentAnalysisClient, ClientOptions

client_options = ClientOptions(retry_policy={})

2. 使用 ClientOptions 对象创建 Client

使用提供的 endpoint 参数和无凭据的 client_options 对象实例化 DocumentAnalysisClient

client = DocumentAnalysisClient(endpoint=my_endpoint, client_options=client_options)

3. 使用 Client 调用 DocumentAnalysisClient 方法

现在,你可以使用创建的 client 对象调用 DocumentAnalysisClient 方法,例如 analyze_document,而无需提供凭据。

results = client.analyze_document(...)

示例代码

import requests
from azure.ai.formrecognizer import DocumentAnalysisClient, ClientOptions

# 你的端点 URL
my_endpoint = "http://form_recognizer...?api-version=2022-08-31"

client_options = ClientOptions(retry_policy={})
client = DocumentAnalysisClient(endpoint=my_endpoint, client_options=client_options)

data = "some data"
params = "some params"
results = client.analyze_document(data=data, parameters=params)

注意事项

使用此方法时,需要注意以下几点:

  • 你的请求将不受 Azure 身份验证和授权系统的保护。
  • 确保你的端点是安全的,并且仅对授权用户开放。
  • 此方法仅适用于具有开放 HTTP 端点的服务。

结论

通过使用无凭据的 ClientOptions 对象,你可以使用 DocumentAnalysisClient 来分析文档,而无需提供凭据。这为使用开放 HTTP 端点的服务提供了灵活性,让你可以利用该服务的强大功能,同时保持安全。

常见问题解答

1. 使用此方法是否安全?

不,只有在你的端点受到保护且仅对授权用户开放时才安全。

2. 此方法是否适用于所有服务?

不,此方法仅适用于具有开放 HTTP 端点的服务。

3. 如何确保端点的安全性?

通过使用安全协议(如 HTTPS)和实施访问控制措施(如密码保护或 IP 限制)来确保端点的安全性。

4. 有没有其他方法可以使用 DocumentAnalysisClient?

是的,可以使用 Azure Active Directory (AAD) 凭据或 SAS 令牌使用 DocumentAnalysisClient。

5. 哪里可以找到更多信息?

有关 DocumentAnalysisClient 和使用开放 HTTP 端点的详细信息,请参阅 Azure 文档