DefaultAzureCredential Classe

Definição

Namespace:

Azure.Identity

Assembly:

Azure.Identity.dll

Pacote:

Azure.Identity v1.11.1

Origem:

DefaultAzureCredential.cs

Fornece um fluxo de autenticação padrão TokenCredential para aplicativos que serão implantados no Azure. Os seguintes tipos de credencial, se habilitados, serão testados, na ordem:

• EnvironmentCredential
• WorkloadIdentityCredential
• ManagedIdentityCredential
• SharedTokenCacheCredential
• VisualStudioCredential
• VisualStudioCodeCredential
• AzureCliCredential
• AzurePowerShellCredential
• AzureDeveloperCliCredential
• InteractiveBrowserCredential

Consulte a documentação desses tipos de credencial para obter mais informações sobre como eles tentam autenticação.

public class DefaultAzureCredential : Azure.Core.TokenCredential

type DefaultAzureCredential = class
    inherit TokenCredential

Public Class DefaultAzureCredential
Inherits TokenCredential

Herança

Object

TokenCredential

DefaultAzureCredential

Exemplos

Este exemplo demonstra como autenticar o BlobClient da biblioteca de clientes Azure.Storage.Blobs usando o DefaultAzureCredential, implantado em um recurso do Azure com uma identidade gerenciada atribuída pelo usuário configurada.

// 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);

Comentários

Observe que as credenciais que exigem interação do usuário, como a InteractiveBrowserCredential, não são incluídas por padrão. Os chamadores devem habilitar isso explicitamente ao construir o DefaultAzureCredential definindo o parâmetro includeInteractiveCredentials como true ou definindo a ExcludeInteractiveBrowserCredential propriedade como false ao passar DefaultAzureCredentialOptions.

Construtores

DefaultAzureCredential(Boolean)	Cria uma instância da classe DefaultAzureCredential.
DefaultAzureCredential(DefaultAzureCredentialOptions)	Cria uma instância de DefaultAzureCredential classe.

Métodos

GetToken(TokenRequestContext, CancellationToken)

Chama sequencialmente GetToken(TokenRequestContext, CancellationToken) todas as credenciais incluídas na ordem EnvironmentCredential, ManagedIdentityCredential, SharedTokenCacheCredentiale InteractiveBrowserCredential retorna o primeiro obtido com AccessTokenêxito. Os tokens adquiridos são armazenados em cache pela instância de credencial. O tempo de vida e a atualização do token são tratados automaticamente. Sempre que possível, reutilize instâncias de credencial para otimizar a eficácia do cache.

GetTokenAsync(TokenRequestContext, CancellationToken)

Chama sequencialmente GetToken(TokenRequestContext, CancellationToken) todas as credenciais incluídas na ordem EnvironmentCredential, ManagedIdentityCredential, SharedTokenCacheCredentiale InteractiveBrowserCredential retorna o primeiro obtido com AccessTokenêxito. Os tokens adquiridos são armazenados em cache pela instância de credencial. O tempo de vida e a atualização do token são tratados automaticamente. Sempre que possível, reutilize instâncias de credencial para otimizar a eficácia do cache.