@azure/identity package
Classes
AggregateAuthenticationError |
Fornece uma |
AuthenticationError |
Fornece detalhes sobre uma falha na autenticação com o Azure Active Directory. O |
AuthenticationRequiredError |
Erro usado para impor a autenticação depois de tentar recuperar um token silenciosamente. |
AuthorizationCodeCredential |
Permite que a autenticação Microsoft Entra ID usando um código de autorização obtido por meio do fluxo de código de autorização, descrito em mais detalhes na documentação do Microsoft Entra ID: https://learn.microsoft.com/entra/identity-platform/v2-oauth2-auth-code-flow |
AzureCliCredential |
Essa credencial usará as informações de logon do usuário conectadas no momento por meio da ferramenta de linha de comando da CLI do Azure ('az'). Para fazer isso, ele lerá o token de acesso do usuário e expirará o tempo com o comando da CLI do Azure "az account get-access-token". |
AzureDeveloperCliCredential |
Azure Developer CLI é uma ferramenta de interface de linha de comando que permite que os desenvolvedores criem, gerenciem e implantem recursos no Azure. Ele é criado com base na CLI do Azure e fornece funcionalidade adicional específica para desenvolvedores do Azure. Ele permite que os usuários se autentiquem como um usuário e/ou uma entidade de serviço em Microsoft Entra ID. O AzureDeveloperCliCredential é autenticado em um ambiente de desenvolvimento e adquire um token em nome do usuário conectado ou da entidade de serviço no Azure Developer CLI. Ele atua como o Azure Developer CLI conectado ao usuário ou entidade de serviço e executa um comando da CLI do Azure abaixo para autenticar o aplicativo em Microsoft Entra ID. Configurar AzureDeveloperCliCredentialPara usar essa credencial, o desenvolvedor precisa se autenticar localmente no Azure Developer CLI usando um dos comandos abaixo:
Talvez seja necessário repetir esse processo após um determinado período, dependendo da validade do token de atualização em sua organização. Em geral, o período de validade do token de atualização é de algumas semanas a alguns meses. AzureDeveloperCliCredential solicitará que você entre novamente. |
AzurePowerShellCredential |
Essa credencial usará as informações do usuário conectado no momento do módulo Azure PowerShell. Para fazer isso, ele lerá o token de acesso do usuário e expirará o tempo com o comando Azure PowerShell |
ChainedTokenCredential |
Permite que várias |
ClientAssertionCredential |
Autentica uma entidade de serviço com uma asserção JWT. |
ClientCertificateCredential |
Permite que a autenticação Microsoft Entra ID usando um certificado codificado em PEM atribuído a um Registro de Aplicativo. Mais informações sobre como configurar a autenticação de certificado podem ser encontradas aqui: |
ClientSecretCredential |
Permite que a autenticação Microsoft Entra ID usando um segredo do cliente que foi gerado para um Registro de Aplicativo. Mais informações sobre como configurar um segredo do cliente podem ser encontradas aqui: |
CredentialUnavailableError |
Isso significa que a credencial que foi testada em uma credencial encadeada não estava disponível para ser usada como a credencial. Em vez de tratar isso como um erro que deve parar a cadeia, ele é capturado e a cadeia continua |
DefaultAzureCredential |
Fornece uma configuração padrão ChainedTokenCredential que deve funcionar para a maioria dos aplicativos que usam o SDK do Azure. |
DeviceCodeCredential |
Habilita a autenticação para Microsoft Entra ID usando um código de dispositivo que o usuário pode inserir no https://microsoft.com/devicelogin. |
EnvironmentCredential |
Permite que a autenticação Microsoft Entra ID usando um segredo ou certificado do cliente ou como um usuário com um nome de usuário e senha. |
InteractiveBrowserCredential |
Permite que a autenticação Microsoft Entra ID dentro do navegador da Web usando o fluxo de logon interativo. |
ManagedIdentityCredential |
Tenta autenticação usando uma identidade gerenciada disponível no ambiente de implantação. Esse tipo de autenticação funciona em VMs do Azure, instâncias Serviço de Aplicativo, aplicativos Azure Functions, Serviços de Kubernetes do Azure, instâncias do Azure Service Fabric e dentro do Cloud Shell do Azure. Mais informações sobre como configurar identidades gerenciadas podem ser encontradas aqui: https://learn.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/overview |
OnBehalfOfCredential |
Habilita a autenticação para Microsoft Entra ID usando o fluxo On Behalf Of. |
UsernamePasswordCredential |
Permite que a autenticação Microsoft Entra ID com o nome de usuário e a senha de um usuário. Essa credencial requer um alto grau de confiança, portanto, você só deve usá-la quando outros tipos de credencial mais seguros não puderem ser usados. |
VisualStudioCodeCredential |
Conecta-se ao Azure usando a credencial fornecida pela extensão do VSCode 'Conta do Azure'. Depois que o usuário tiver feito logon por meio da extensão, essa credencial poderá compartilhar o mesmo token de atualização armazenado em cache pela extensão. É um problema conhecido que essa credencial não funciona com versões de extensão da Conta do Azure mais recentes do que a 0.9.11. Uma correção de longo prazo para esse problema está em andamento. Enquanto isso, considere a autenticação com o AzureCliCredential. |
WorkloadIdentityCredential |
A autenticação de Identidade de Carga de Trabalho é um recurso no Azure que permite que aplicativos em execução em VMs (máquinas virtuais) acessem outros recursos do Azure sem a necessidade de uma entidade de serviço ou identidade gerenciada. Com a autenticação de Identidade de Carga de Trabalho, os aplicativos se autenticam usando sua própria identidade, em vez de usar uma entidade de serviço compartilhada ou uma identidade gerenciada. Nos bastidores, a autenticação de Identidade de Carga de Trabalho usa o conceito de SACs (Credenciais de Conta de Serviço), que são criadas automaticamente pelo Azure e armazenadas com segurança na VM. Usando a autenticação de Identidade de Carga de Trabalho, você pode evitar a necessidade de gerenciar e girar entidades de serviço ou identidades gerenciadas para cada aplicativo em cada VM. Além disso, como os SACs são criados automaticamente e gerenciados pelo Azure, você não precisa se preocupar em armazenar e proteger credenciais confidenciais por conta própria. O WorkloadIdentityCredential dá suporte à autenticação ID de carga de trabalho do Microsoft Entra no Kubernetes do Azure e adquire um token usando os SACs disponíveis no ambiente do Kubernetes do Azure. Consulte ID de carga de trabalho do Microsoft Entra para obter mais informações. |
Interfaces
AccessToken |
Representa um token de acesso com um tempo de expiração. |
AuthenticationRecord |
O registro a ser usado para localizar os tokens armazenados em cache no cache. |
AuthenticationRequiredErrorOptions |
Parâmetros opcionais para AuthenticationRequiredError |
AuthorityValidationOptions |
Fornece opções para configurar como a biblioteca de identidade faz a validação de autoridade durante solicitações de autenticação para Microsoft Entra ID. |
AuthorizationCodeCredentialOptions |
Opções para o AuthorizationCodeCredential |
AzureCliCredentialOptions |
Opções para o AzureCliCredential |
AzureDeveloperCliCredentialOptions |
Opções para o AzureDeveloperCliCredential |
AzurePowerShellCredentialOptions |
Opções para o AzurePowerShellCredential |
BrokerAuthOptions |
Opções de configuração para InteractiveBrowserCredential para dar suporte à Autenticação do Agente do WAM. |
BrokerDisabledOptions |
Parâmetros quando a autenticação do agente WAM está desabilitada. |
BrokerEnabledOptions |
Parâmetros quando a autenticação do agente WAM está habilitada. |
BrowserCustomizationOptions |
Opções de configuração compartilhada para personalização do navegador |
ClientAssertionCredentialOptions |
Opções para o ClientAssertionCredential |
ClientCertificateCredentialOptions |
Parâmetros opcionais para a classe ClientCertificateCredential . |
ClientCertificatePEMCertificate |
Opções de configuração necessárias para o ClientCertificateCredential, com o conteúdo da cadeia de caracteres de um certificado PEM |
ClientCertificatePEMCertificatePath |
Opções de configuração necessárias para o ClientCertificateCredential, com o caminho para um certificado PEM. |
ClientSecretCredentialOptions |
Parâmetros opcionais para a classe ClientSecretCredential . |
CredentialPersistenceOptions |
Opções de configuração compartilhadas para credenciais que dão suporte ao cache de token persistente. |
DefaultAzureCredentialClientIdOptions |
Fornece opções para configurar a classe DefaultAzureCredential .
Essa variação dá |
DefaultAzureCredentialOptions |
Fornece opções para configurar a classe DefaultAzureCredential . |
DefaultAzureCredentialResourceIdOptions |
Fornece opções para configurar a classe DefaultAzureCredential .
Essa variação dá |
DeviceCodeCredentialOptions |
Define opções para a classe InteractiveBrowserCredential para Node.js. |
DeviceCodeInfo |
Fornece o código do usuário e o URI de verificação em que o código deve ser inserido. Também fornece uma mensagem a ser exibida para o usuário que contém uma instrução com esses detalhes. |
EnvironmentCredentialOptions |
Permite que a autenticação Microsoft Entra ID dependendo das variáveis de ambiente disponíveis. Define opções para a classe EnvironmentCredential. |
ErrorResponse |
Consulte a documentação oficial para obter mais detalhes: OBSERVAÇÃO: esta documentação é para o suporte do OAuth v1, mas os mesmos detalhes de resposta de erro ainda se aplicam à v2. |
GetBearerTokenProviderOptions |
As opções para configurar o provedor de token. |
GetTokenOptions |
Define opções para TokenCredential.getToken. |
InteractiveBrowserCredentialInBrowserOptions |
Define as opções comuns para a classe InteractiveBrowserCredential. |
InteractiveBrowserCredentialNodeOptions |
Define as opções comuns para a classe InteractiveBrowserCredential. |
InteractiveCredentialOptions |
Opções comuns de construtor para as credenciais de identidade que exigem interação do usuário. |
ManagedIdentityCredentialClientIdOptions |
Opções para enviar no construtor ManagedIdentityCredential .
Essa variação dá |
ManagedIdentityCredentialResourceIdOptions |
Opções para enviar no construtor ManagedIdentityCredential .
Essa variação dá |
MultiTenantTokenCredentialOptions |
Opções para aplicativos multilocatário que permitem locatários permitidos adicionalmente. |
OnBehalfOfCredentialCertificateOptions |
Define os parâmetros para autenticar o OnBehalfOfCredential com um certificado. |
OnBehalfOfCredentialSecretOptions |
Define os parâmetros para autenticar o OnBehalfOfCredential com um segredo. |
TokenCachePersistenceOptions |
Parâmetros que habilitam a persistência do cache de token nas credenciais de identidade. |
TokenCredential |
Representa uma credencial capaz de fornecer um token de autenticação. |
TokenCredentialOptions |
Fornece opções para configurar como a biblioteca de identidades faz solicitações de autenticação para Microsoft Entra ID. |
UsernamePasswordCredentialOptions |
Define opções para a classe UsernamePasswordCredential . |
VisualStudioCodeCredentialOptions |
Fornece opções para configurar a credencial Visual Studio Code. |
WorkloadIdentityCredentialOptions |
Opções para WorkloadIdentityCredential |
Aliases de tipo
BrokerOptions |
Parâmetros que habilitam a autenticação do agente WAM no InteractiveBrowserCredential. |
BrowserLoginStyle |
(Recurso somente navegador) O "estilo de logon" a ser usado no fluxo de autenticação:
|
ClientCertificateCredentialPEMConfiguration |
Opções de configuração necessárias para o ClientCertificateCredential, com o conteúdo da cadeia de caracteres de um certificado PEM ou o caminho para um certificado PEM. |
DeviceCodePromptCallback |
Define a assinatura de um retorno de chamada que será passado para DeviceCodeCredential com a finalidade de exibir detalhes de autenticação para o usuário. |
IdentityPlugin |
O tipo de um plug-in de Identidade do Azure, uma função que aceita um contexto de plug-in. |
OnBehalfOfCredentialOptions |
Parâmetros opcionais para a classe OnBehalfOfCredential . |
Enumerações
AzureAuthorityHosts |
Uma lista de hosts de autoridade conhecidos do Azure |
Funções
deserialize |
Desserializa um registro de autenticação serializado anteriormente de uma cadeia de caracteres em um objeto . A cadeia de caracteres de entrada deve conter as seguintes propriedades:
Se a versão que recebermos não for suportada, um erro será gerado. No momento, a única versão disponível é: "1.0", que é sempre definida quando o registro de autenticação é serializado. |
get |
Retorna um retorno de chamada que fornece um token de portador. Por exemplo, o token de portador pode ser usado para autenticar uma solicitação da seguinte maneira:
|
get |
Retorna uma nova instância do DefaultAzureCredential. |
serialize |
Serializa um A saída de um registro de autenticação serializado conterá as seguintes propriedades:
Para converter posteriormente essa cadeia de caracteres em um serializado |
use |
Estenda a Identidade do Azure com funcionalidade adicional. Passe um plug-in de um pacote de plug-in, como:
Exemplo:
|
Detalhes da função
deserializeAuthenticationRecord(string)
Desserializa um registro de autenticação serializado anteriormente de uma cadeia de caracteres em um objeto .
A cadeia de caracteres de entrada deve conter as seguintes propriedades:
- "autoridade"
- "homeAccountId"
- "clientId"
- "tenantId"
- "nome de usuário"
- "version"
Se a versão que recebermos não for suportada, um erro será gerado.
No momento, a única versão disponível é: "1.0", que é sempre definida quando o registro de autenticação é serializado.
function deserializeAuthenticationRecord(serializedRecord: string): AuthenticationRecord
Parâmetros
- serializedRecord
-
string
Registro de autenticação serializado anteriormente em cadeia de caracteres.
Retornos
AuthenticationRecord.
getBearerTokenProvider(TokenCredential, string | string[], GetBearerTokenProviderOptions)
Retorna um retorno de chamada que fornece um token de portador. Por exemplo, o token de portador pode ser usado para autenticar uma solicitação da seguinte maneira:
import { DefaultAzureCredential } from "@azure/identity";
const credential = new DefaultAzureCredential();
const scope = "https://cognitiveservices.azure.com/.default";
const getAccessToken = getBearerTokenProvider(credential, scope);
const token = await getAccessToken();
// usage
const request = createPipelineRequest({ url: "https://example.com" });
request.headers.set("Authorization", `Bearer ${token}`);
function getBearerTokenProvider(credential: TokenCredential, scopes: string | string[], options?: GetBearerTokenProviderOptions): () => Promise<string>
Parâmetros
- credential
- TokenCredential
A credencial usada para autenticar a solicitação.
- scopes
-
string | string[]
Os escopos necessários para o token de portador.
- options
- GetBearerTokenProviderOptions
Opções para configurar o provedor de token.
Retornos
() => Promise<string>
um retorno de chamada que fornece um token de portador.
getDefaultAzureCredential()
Retorna uma nova instância do DefaultAzureCredential.
function getDefaultAzureCredential(): TokenCredential
Retornos
serializeAuthenticationRecord(AuthenticationRecord)
Serializa um AuthenticationRecord
em uma cadeia de caracteres.
A saída de um registro de autenticação serializado conterá as seguintes propriedades:
- "autoridade"
- "homeAccountId"
- "clientId"
- "tenantId"
- "nome de usuário"
- "version"
Para converter posteriormente essa cadeia de caracteres em um serializado AuthenticationRecord
, use a função deserializeAuthenticationRecord()
exportada .
function serializeAuthenticationRecord(record: AuthenticationRecord): string
Parâmetros
- record
- AuthenticationRecord
Retornos
string
useIdentityPlugin(IdentityPlugin)
Estenda a Identidade do Azure com funcionalidade adicional. Passe um plug-in de um pacote de plug-in, como:
@azure/identity-cache-persistence
: fornece cache de token persistente@azure/identity-vscode
: fornece as dependências deVisualStudioCodeCredential
e habilita-as
Exemplo:
import { cachePersistencePlugin } from "@azure/identity-cache-persistence";
import { useIdentityPlugin, DefaultAzureCredential } from "@azure/identity";
useIdentityPlugin(cachePersistencePlugin);
// The plugin has the capability to extend `DefaultAzureCredential` and to
// add middleware to the underlying credentials, such as persistence.
const credential = new DefaultAzureCredential({
tokenCachePersistenceOptions: {
enabled: true
}
});
function useIdentityPlugin(plugin: IdentityPlugin)
Parâmetros
- plugin
- IdentityPlugin
o plug-in a ser registrado