DefaultAzureCredential Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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:
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
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. |
Aplica-se a
Azure SDK for .NET