Partilhar via


ChainedTokenCredential class

Permite que várias implementações de TokenCredential sejam tentadas em ordem até que um dos métodos getToken retorne um token de acesso. Para obter mais informações, consulte visão geral de ChainedTokenCredential.

Construtores

ChainedTokenCredential(TokenCredential[])

Cria uma instância de ChainedTokenCredential usando as credenciais fornecidas.

Métodos

getToken(string | string[], GetTokenOptions)

Retorna o primeiro token de acesso retornado por uma das implementações de TokenCredential encadeadas. Lança um AggregateAuthenticationError quando uma ou mais credenciais lançam um AuthenticationError e nenhuma credencial retornou um token de acesso.

Esse método é chamado automaticamente pelas bibliotecas de cliente do SDK do Azure. Você pode chamar esse método diretamente, mas também deve manipular o cache de token e a atualização de token.

Detalhes do Construtor

ChainedTokenCredential(TokenCredential[])

Cria uma instância de ChainedTokenCredential usando as credenciais fornecidas.

new ChainedTokenCredential(sources: TokenCredential[])

Parâmetros

sources

TokenCredential[]

TokenCredential implementações a serem testadas em ordem.

Exemplo de uso:

import { ClientSecretCredential, ChainedTokenCredential } from "@azure/identity";

const tenantId = "<tenant-id>";
const clientId = "<client-id>";
const clientSecret = "<client-secret>";
const anotherClientId = "<another-client-id>";
const anotherSecret = "<another-client-secret>";

const firstCredential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const secondCredential = new ClientSecretCredential(tenantId, anotherClientId, anotherSecret);

const credentialChain = new ChainedTokenCredential(firstCredential, secondCredential);

Detalhes de Método

getToken(string | string[], GetTokenOptions)

Retorna o primeiro token de acesso retornado por uma das implementações de TokenCredential encadeadas. Lança um AggregateAuthenticationError quando uma ou mais credenciais lançam um AuthenticationError e nenhuma credencial retornou um token de acesso.

Esse método é chamado automaticamente pelas bibliotecas de cliente do SDK do Azure. Você pode chamar esse método diretamente, mas também deve manipular o cache de token e a atualização de token.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

Parâmetros

scopes

string | string[]

A lista de escopos para os quais o token terá acesso.

options
GetTokenOptions

As opções usadas para configurar quaisquer solicitações que essa implementação TokenCredential possa fazer.

Devoluções

Promise<AccessToken>