ClientApplication class

Classe abstrata base para todas as ClientApplications – pública e confidencial

Métodos

acquireTokenByCode(AuthorizationCodeRequest, AuthorizationCodePayload)

Adquire um token trocando o código de autorização recebido da primeira etapa do fluxo de código de autorização OAuth2.0.

getAuthCodeUrl(AuthorizationCodeUrlRequest) pode ser usado para criar a URL para a primeira etapa do fluxo de código de autorização OAuth2.0. Verifique se os valores de redirectUri e escopos em AuthorizationCodeUrlRequest e AuthorizationCodeRequest são os mesmos.

acquireTokenByRefreshToken(RefreshTokenRequest)

Adquire um token trocando o token de atualização fornecido para um novo conjunto de tokens.

Essa API é fornecida apenas para cenários em que você deseja migrar da ADAL para a MSAL. Caso contrário, é recomendável que você use acquireTokenSilent() para cenários silenciosos. Ao usar acquireTokenSilent(), a MSAL manipulará o cache e a atualização de tokens automaticamente.

acquireTokenByUsernamePassword(UsernamePasswordRequest)

Adquire tokens com concessão de senha trocando nome de usuário e senha de aplicativos cliente por credenciais

A prática atual mais recente do OAuth 2.0 Security não permite totalmente a concessão de senha. Mais detalhes sobre essa recomendação na https://tools.ietf.org/html/draft-ietf-oauth-security-topics-13#section-3.4 documentação e nas recomendações da Microsoft estão em:https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-authentication-flows#usernamepassword

acquireTokenSilent(SilentFlowRequest)

Adquire um token silenciosamente quando um usuário especifica a conta para a qual o token é solicitado.

Essa API espera que o usuário forneça um objeto de conta e procure o cache para recuperar o token, se estiver presente. Há também um booliano "forceRefresh" opcional que o usuário pode enviar para ignorar o cache para access_token e id_token. Caso o refresh_token esteja expirado ou não seja encontrado, um erro é gerado e a orientação é que o usuário chame qualquer API interativa de aquisição de token (por exemplo: acquireTokenByCode()).

clearCache()

Limpar o cache

getAuthCodeUrl(AuthorizationUrlRequest)

Cria a URL da solicitação de autorização, permitindo que o usuário insira credenciais e consentimento para o aplicativo. A URL tem como destino o ponto de extremidade /authorize da autoridade configurada no objeto do aplicativo.

Depois que o usuário inserir suas credenciais e consentimentos, a autoridade enviará uma resposta ao URI de redirecionamento enviado na solicitação e deverá conter um código de autorização, que pode ser usado para adquirir tokens por meio acquireTokenByCode(AuthorizationCodeRequest)de .

getLogger()

Retorna a instância do agente

getTokenCache()

Obtém o cache de token para o aplicativo.

setLogger(Logger)

Substitui o conjunto de agentes padrão nas configurações pelo novo Agente por novas configurações

Detalhes do método

acquireTokenByCode(AuthorizationCodeRequest, AuthorizationCodePayload)

Adquire um token trocando o código de autorização recebido da primeira etapa do fluxo de código de autorização OAuth2.0.

getAuthCodeUrl(AuthorizationCodeUrlRequest) pode ser usado para criar a URL para a primeira etapa do fluxo de código de autorização OAuth2.0. Verifique se os valores de redirectUri e escopos em AuthorizationCodeUrlRequest e AuthorizationCodeRequest são os mesmos.

function acquireTokenByCode(request: AuthorizationCodeRequest, authCodePayLoad?: AuthorizationCodePayload): Promise<AuthenticationResult>

Parâmetros

authCodePayLoad
AuthorizationCodePayload

Retornos

acquireTokenByRefreshToken(RefreshTokenRequest)

Adquire um token trocando o token de atualização fornecido para um novo conjunto de tokens.

Essa API é fornecida apenas para cenários em que você deseja migrar da ADAL para a MSAL. Caso contrário, é recomendável que você use acquireTokenSilent() para cenários silenciosos. Ao usar acquireTokenSilent(), a MSAL manipulará o cache e a atualização de tokens automaticamente.

function acquireTokenByRefreshToken(request: RefreshTokenRequest): Promise<null | AuthenticationResult>

Parâmetros

Retornos

Promise<null | AuthenticationResult>

acquireTokenByUsernamePassword(UsernamePasswordRequest)

Aviso

Essa API foi preterida.

  • Use a more secure flow instead

Adquire tokens com concessão de senha trocando nome de usuário e senha de aplicativos cliente por credenciais

A prática atual mais recente do OAuth 2.0 Security não permite totalmente a concessão de senha. Mais detalhes sobre essa recomendação na https://tools.ietf.org/html/draft-ietf-oauth-security-topics-13#section-3.4 documentação e nas recomendações da Microsoft estão em:https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-authentication-flows#usernamepassword

function acquireTokenByUsernamePassword(request: UsernamePasswordRequest): Promise<null | AuthenticationResult>

Parâmetros

request
UsernamePasswordRequest

UsenamePasswordRequest

Retornos

Promise<null | AuthenticationResult>

acquireTokenSilent(SilentFlowRequest)

Adquire um token silenciosamente quando um usuário especifica a conta para a qual o token é solicitado.

Essa API espera que o usuário forneça um objeto de conta e procure o cache para recuperar o token, se estiver presente. Há também um booliano "forceRefresh" opcional que o usuário pode enviar para ignorar o cache para access_token e id_token. Caso o refresh_token esteja expirado ou não seja encontrado, um erro é gerado e a orientação é que o usuário chame qualquer API interativa de aquisição de token (por exemplo: acquireTokenByCode()).

function acquireTokenSilent(request: SilentFlowRequest): Promise<AuthenticationResult>

Parâmetros

Retornos

clearCache()

Limpar o cache

function clearCache()

getAuthCodeUrl(AuthorizationUrlRequest)

Cria a URL da solicitação de autorização, permitindo que o usuário insira credenciais e consentimento para o aplicativo. A URL tem como destino o ponto de extremidade /authorize da autoridade configurada no objeto do aplicativo.

Depois que o usuário inserir suas credenciais e consentimentos, a autoridade enviará uma resposta ao URI de redirecionamento enviado na solicitação e deverá conter um código de autorização, que pode ser usado para adquirir tokens por meio acquireTokenByCode(AuthorizationCodeRequest)de .

function getAuthCodeUrl(request: AuthorizationUrlRequest): Promise<string>

Parâmetros

Retornos

Promise<string>

getLogger()

Retorna a instância do agente

function getLogger(): Logger

Retornos

getTokenCache()

Obtém o cache de token para o aplicativo.

function getTokenCache(): TokenCache

Retornos

setLogger(Logger)

Substitui o conjunto de agentes padrão nas configurações pelo novo Agente por novas configurações

function setLogger(logger: Logger)

Parâmetros

logger
Logger

Instância do agente