你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
DefaultAzureCredential 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为将部署到 Azure 的应用程序提供默认 TokenCredential 身份验证流。 将按顺序尝试以下凭据类型(如果已启用):
有关这些凭据如何尝试身份验证的详细信息,请参阅这些凭据类型的文档。public class DefaultAzureCredential : Azure.Core.TokenCredential
type DefaultAzureCredential = class
inherit TokenCredential
Public Class DefaultAzureCredential
Inherits TokenCredential
- 继承
示例
此示例演示如何使用 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为 、 ManagedIdentityCredential、 SharedTokenCacheCredential,并 InteractiveBrowserCredential 返回成功获取 AccessToken的第一个 。 获取的令牌由凭据实例缓存。 令牌生存期和刷新会自动处理。 在可能的情况下,重复使用凭据实例以优化缓存效率。 |
GetTokenAsync(TokenRequestContext, CancellationToken) |
按顺序调用 GetToken(TokenRequestContext, CancellationToken) 包含的所有凭据,顺序 EnvironmentCredential为 、 ManagedIdentityCredential、 SharedTokenCacheCredential,并 InteractiveBrowserCredential 返回成功获取 AccessToken的第一个 。 获取的令牌由凭据实例缓存。 令牌生存期和刷新会自动处理。 在可能的情况下,重复使用凭据实例以优化缓存效率。 |