DeviceCodeCredential class
Abilita l'autenticazione Microsoft Entra ID utilizzando un codice dispositivo che l'utente può inserire in https://microsoft.com/devicelogin.
Costruttori
| Device |
Crea un'istanza di DeviceCodeCredential con i dettagli necessari per avviare il flusso di autorizzazione del codice del dispositivo con Microsoft Entra ID. Verrà registrato un messaggio, fornendo agli utenti un codice che può usare per eseguire l'autenticazione quando passano a https://microsoft.com/devicelogin Gli sviluppatori possono configurare la modalità di visualizzazione di questo messaggio passando un
|
Metodi
| authenticate(string | string[], Get |
Si autentica con Microsoft Entra ID e restituisce un token di accesso se ha successo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore. Se il token non può essere recuperato automaticamente, questo metodo genererà sempre una richiesta per l'utente. |
| get |
Si autentica con Microsoft Entra ID e restituisce un token di accesso se ha successo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore. Se l'utente ha fornito l'opzione |
Dettagli costruttore
DeviceCodeCredential(DeviceCodeCredentialOptions)
Crea un'istanza di DeviceCodeCredential con i dettagli necessari per avviare il flusso di autorizzazione del codice del dispositivo con Microsoft Entra ID.
Verrà registrato un messaggio, fornendo agli utenti un codice che può usare per eseguire l'autenticazione quando passano a https://microsoft.com/devicelogin
Gli sviluppatori possono configurare la modalità di visualizzazione di questo messaggio passando un userPromptCallbackpersonalizzato:
import { DeviceCodeCredential } from "@azure/identity";
const credential = new DeviceCodeCredential({
tenantId: process.env.AZURE_TENANT_ID,
clientId: process.env.AZURE_CLIENT_ID,
userPromptCallback: (info) => {
console.log("CUSTOMIZED PROMPT CALLBACK", info.message);
},
});
new DeviceCodeCredential(options?: DeviceCodeCredentialOptions)
Parametri
- options
- DeviceCodeCredentialOptions
Opzioni per la configurazione del client che effettua le richieste di autenticazione.
Dettagli metodo
authenticate(string | string[], GetTokenOptions)
Si autentica con Microsoft Entra ID e restituisce un token di accesso se ha successo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore.
Se il token non può essere recuperato automaticamente, questo metodo genererà sempre una richiesta per l'utente.
function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>
Parametri
- scopes
-
string | string[]
Elenco di ambiti per i quali il token avrà accesso.
- options
- GetTokenOptions
Le opzioni usate per configurare le richieste che potrebbero essere eseguite da questa implementazione di TokenCredential.
Valori restituiti
Promise<undefined | AuthenticationRecord>
getToken(string | string[], GetTokenOptions)
Si autentica con Microsoft Entra ID e restituisce un token di accesso se ha successo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore.
Se l'utente ha fornito l'opzione disableAutomaticAuthentication, una volta che il token non può essere recuperato automaticamente, questo metodo non tenterà di richiedere l'interazione dell'utente per recuperare il token.
function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>
Parametri
- scopes
-
string | string[]
Elenco di ambiti per i quali il token avrà accesso.
- options
- GetTokenOptions
Le opzioni usate per configurare le richieste che potrebbero essere eseguite da questa implementazione di TokenCredential.
Valori restituiti
Promise<AccessToken>