你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

DefaultAzureCredential 类

定义

为将部署到 Azure 的应用程序提供默认 TokenCredential 身份验证流。 将按顺序尝试以下凭据类型(如果已启用):

有关这些凭据如何尝试身份验证的详细信息,请参阅这些凭据类型的文档。
public class DefaultAzureCredential : Azure.Core.TokenCredential
type DefaultAzureCredential = class
    inherit TokenCredential
Public Class DefaultAzureCredential
Inherits TokenCredential
继承
DefaultAzureCredential

示例

此示例演示如何使用 DefaultAzureCredential(部署到配置了用户分配的托管标识的 Azure 资源)从 Azure.Storage.Blobs 客户端库对 BlobClient 进行身份验证。

// When deployed to an azure host, the default azure credential will authenticate the specified user assigned managed identity.

string userAssignedClientId = "<your managed identity client Id>";
var credential = new DefaultAzureCredential(new DefaultAzureCredentialOptions { ManagedIdentityClientId = userAssignedClientId });

var blobClient = new BlobClient(new Uri("https://myaccount.blob.core.windows.net/mycontainer/myblob"), credential);

注解

请注意,默认情况下不包括需要用户交互的凭据,例如 InteractiveBrowserCredential。 调用方在构造 DefaultAzureCredential 时必须显式启用此功能,方法是将 includeInteractiveCredentials 参数设置为 true,或者在传递 DefaultAzureCredentialOptions时将 ExcludeInteractiveBrowserCredential 属性设置为 false。

构造函数

DefaultAzureCredential(Boolean)

创建 DefaultAzureCredential 类的实例。

DefaultAzureCredential(DefaultAzureCredentialOptions)

创建 DefaultAzureCredential 类的实例。

方法

GetToken(TokenRequestContext, CancellationToken)

按顺序调用 GetToken(TokenRequestContext, CancellationToken) 包含的所有凭据,顺序 EnvironmentCredential为 、 ManagedIdentityCredentialSharedTokenCacheCredential,并 InteractiveBrowserCredential 返回成功获取 AccessToken的第一个 。 获取的令牌由凭据实例缓存。 令牌生存期和刷新会自动处理。 在可能的情况下,重复使用凭据实例以优化缓存效率。

GetTokenAsync(TokenRequestContext, CancellationToken)

按顺序调用 GetToken(TokenRequestContext, CancellationToken) 包含的所有凭据,顺序 EnvironmentCredential为 、 ManagedIdentityCredentialSharedTokenCacheCredential,并 InteractiveBrowserCredential 返回成功获取 AccessToken的第一个 。 获取的令牌由凭据实例缓存。 令牌生存期和刷新会自动处理。 在可能的情况下,重复使用凭据实例以优化缓存效率。

适用于