Lingua

IConfidentialClientApplication Interfaccia

Definizione

Spazio dei nomi:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Pacchetto:
Microsoft.Identity.Client v4.84.2

Rappresenta le applicazioni client riservate: app Web, API Web, applicazioni daemon.

public interface IConfidentialClientApplication : Microsoft.Identity.Client.IByUserFederatedIdentityCredential, Microsoft.Identity.Client.IClientApplicationBase
type IConfidentialClientApplication = interface
    interface IClientApplicationBase
    interface IApplicationBase
    interface IByUserFederatedIdentityCredential
Public Interface IConfidentialClientApplication
Implements IByUserFederatedIdentityCredential, IClientApplicationBase
Derivato
Implementazioni
IApplicationBase IByUserFederatedIdentityCredential IClientApplicationBase

Commenti

Le applicazioni client riservate sono in genere applicazioni che vengono eseguite su server (app Web, API Web o persino applicazioni di servizio/daemon). Sono considerati difficili da accedere e pertanto sono in grado di mantenere un segreto dell'applicazione (conservare i segreti del tempo di configurazione perché questi valori sarebbero difficili per gli utenti finali da estrarre). Un'app Web è il client riservato più comune. L'ID client viene esposto tramite il Web browser, ma il segreto viene passato solo nel canale back e non viene mai esposto direttamente. Per informazioni dettagliate, vedere Applicazioni client.

Proprietà

Nome Descrizione
AppConfig

Informazioni dettagliate sulla configurazione di ClientApplication a scopo di debug.

(Ereditato da IClientApplicationBase)
AppTokenCache

Cache dei token dell'applicazione che contiene i token di accesso per questa applicazione. Viene mantenuto e aggiornato automaticamente quando si chiama AcquireTokenForClient(IEnumerable<String>)
Authority

Ottiene l'URL dell'autorità o il servizio token di sicurezza da cui MSAL.NET acquisirà i token di sicurezza. Il valore restituito di questa proprietà è il valore fornito dallo sviluppatore nel costruttore dell'applicazione oppure il valore del Microsoft.Identity.Client.ApplicationBase.DefaultAuthority membro statico (ovvero https://login.microsoftonline.com/common/)

(Ereditato da IClientApplicationBase)
UserTokenCache

Cache dei token utente che contiene token ID, token di accesso e token di aggiornamento per gli account. Viene usato e aggiornato automaticamente se necessario quando si chiama AcquireTokenSilent(IEnumerable<String>, IAccount) Viene aggiornato da ogni metodo di acquisizione del token, ad eccezione del quale usa solo la cache dell'applicazione AcquireTokenForClient(IEnumerable<String>) (vedere AppTokenCache).

(Ereditato da IClientApplicationBase)

Metodi

Nome Descrizione
AcquireTokenByAuthorizationCode(IEnumerable<String>, String)

Acquisisce un token dall'autorità configurata nell'app usando il codice di autorizzazione ricevuto in precedenza dal provider di identità usando il flusso del codice di autorizzazione OAuth 2.0. Vedere Flusso del codice di autorizzazione. Questo flusso viene in genere usato nelle app Web (ad esempio, ASP.NET e ASP.NET Core app Web) che accedono agli utenti e possono richiedere un codice di autorizzazione. Questo metodo non cerca nella cache dei token, ma archivia il risultato. Prima di chiamare questo metodo, usare altri metodi, AcquireTokenSilent(IEnumerable<String>, IAccount) ad esempio per controllare la cache dei token.
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String)

Acquisisce un token per conto di un utente usando un'asserzione di credenziali di identità federata. In questo modo viene utilizzato il user_fic tipo di concessione. L'utente è identificato dall'ID oggetto (OID).

(Ereditato da IByUserFederatedIdentityCredential)
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String)

Acquisisce un token per conto di un utente usando un'asserzione di credenziali di identità federata. In questo modo viene utilizzato il user_fic tipo di concessione. L'utente è identificato dall'UPN.

(Ereditato da IByUserFederatedIdentityCredential)
AcquireTokenForClient(IEnumerable<String>)

Acquisisce un token dall'autorità configurata nell'app per il client riservato stesso (non per un utente) usando il flusso delle credenziali client. Vedere Flusso di credenziali client. Durante questa operazione MSAL cercherà prima nella cache un token non scaduto prima di acquisirne uno nuovo da Microsoft Entra ID.
AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion)

Acquisisce un token di accesso per questa applicazione (in genere un'API Web) dall'autorità configurata nell'applicazione, per accedere a un'altra API Web protetta downstream per conto di un utente che usa il flusso on-Behalf-Of OAuth 2.0. Durante questa operazione MSAL cercherà prima nella cache un token non scaduto prima di acquisirne uno nuovo da Microsoft Entra ID. Vedere Flusso on-Behalf-Of.
AcquireTokenSilent(IEnumerable<String>, IAccount)

Tenta di acquisire un token di accesso per account dalla cache dei token utente, con parametri avanzati che controllano la chiamata di rete. Vedere Acquisire i token in modo invisibile all'utente.

(Ereditato da IClientApplicationBase)
AcquireTokenSilent(IEnumerable<String>, String)
Obsoleti.

Nelle app client riservate viene invece usato AcquireTokenSilent(IEnumerable<String>, IAccount) .
GetAccountAsync(String)

Ottenere in base al IAccount relativo identificatore tra gli account disponibili nella cache dei token e dello stesso ambiente (host dell'autorità) di Authority.

(Ereditato da IClientApplicationBase)
GetAccountsAsync()
Obsoleti.

Usare GetAccountAsync(String) nelle app Web e nelle API Web e usare un serializzatore della cache dei token per migliorare la sicurezza e le prestazioni. Vedete https://aka.ms/msal-net-cca-token-cache-serialization.
GetAccountsAsync(String)

Solo per gli scenari di Azure AD B2C, ottenere la raccolta in base al IAccount relativo identificatore tra gli account disponibili nella cache dei token in base al flusso utente.

(Ereditato da IClientApplicationBase)
GetAuthorizationRequestUrl(IEnumerable<String>)

Calcola l'URL della richiesta di autorizzazione che consente all'utente di accedere e fornire il consenso all'applicazione che accede a ambiti specifici nel nome dell'utente. L'URL è destinato all'endpoint /authorize dell'autorità configurata nell'applicazione.
RemoveAsync(IAccount)

Rimuove tutti i token nella cache per l'account specificato.

(Ereditato da IClientApplicationBase)

Metodi di estensione

Nome Descrizione
GetCertificate(IConfidentialClientApplication)

Restituisce il certificato utilizzato per creare questo ConfidentialClientApplicationoggetto , se presente.

Si applica a