IConfidentialClientApplication Interface

Definitie

Naamruimte:: Microsoft.Identity.Client

Assembly:: Microsoft.Identity.Client.dll

Pakket:: Microsoft.Identity.Client v4.91.0

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt vertrouwelijke clienttoepassingen - web-apps, web-API's, daemon-toepassingen.

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

Afgeleid: Microsoft.Identity.Client.ConfidentialClientApplication

Implementeringen: IApplicationBase IByUserFederatedIdentityCredential IClientApplicationBase

Opmerkingen

Vertrouwelijke clienttoepassingen zijn doorgaans toepassingen die worden uitgevoerd op servers (web-apps, web-API of zelfs service-/daemon-toepassingen). Ze worden beschouwd als moeilijk toegankelijk en kunnen daarom een toepassingsgeheim bewaren (bewaar configuratietijdgeheimen omdat deze waarden moeilijk zijn voor eindgebruikers om te extraheren). Een web-app is de meest voorkomende vertrouwelijke client. De client-id wordt weergegeven via de webbrowser, maar het geheim wordt alleen doorgegeven in het back-kanaal en wordt nooit rechtstreeks weergegeven. Zie Clienttoepassingen voor meer informatie.

Eigenschappen

Naam	Description
AppConfig	Details over de configuratie van de ClientApplication voor foutopsporingsdoeleinden. (Overgenomen van IClientApplicationBase)
AppTokenCache	Toepassingstokencache met toegangstokens voor deze toepassing. Het wordt op de achtergrond onderhouden en bijgewerkt wanneer u belt AcquireTokenForClient(IEnumerable<String>)
Authority	Hiermee haalt u de URL van de instantie of de beveiligingstokenservice (STS) op waaruit MSAL.NET beveiligingstokens krijgt. De geretourneerde waarde van deze eigenschap is ofwel de waarde die door de ontwikkelaar in de constructor van de toepassing wordt geleverd, of anders de waarde van het Microsoft.Identity.Client.ApplicationBase.DefaultAuthority statische lid (dat wil `https://login.microsoftonline.com/common/`gezegd) (Overgenomen van IClientApplicationBase)
UserTokenCache	Gebruikerstokencache met id-tokens, toegangstokens en vernieuwingstokens voor accounts. Deze wordt indien nodig op de achtergrond gebruikt en bijgewerkt wanneer het aanroepen AcquireTokenSilent(IEnumerable<String>, IAccount) wordt bijgewerkt door elke acquire-tokenmethode, met uitzondering waarvan AcquireTokenForClient(IEnumerable<String>) alleen de toepassingscache wordt gebruikt (zie AppTokenCache). (Overgenomen van IClientApplicationBase)

Methoden

Naam	Description
AcquireTokenByAuthorizationCode(IEnumerable<String>, String)	Hiermee verkrijgt u een token van de instantie die in de app is geconfigureerd met behulp van de autorisatiecode die eerder is ontvangen van de id-provider met behulp van de OAuth 2.0-autorisatiecodestroom. Zie autorisatiecodestroom. Deze stroom wordt meestal gebruikt in web-apps (bijvoorbeeld ASP.NET en ASP.NET Core web-apps) die gebruikers aanmelden en een autorisatiecode kunnen aanvragen. Deze methode kijkt niet in de tokencache, maar slaat het resultaat erin op. Voordat u deze methode aanroept, gebruikt u andere methoden, zoals AcquireTokenSilent(IEnumerable<String>, IAccount) het controleren van de tokencache.
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String)	Verwerft een token namens een gebruiker met behulp van een federatieve identiteitsreferentie-assertie. Hierbij wordt het `user_fic` toekenningstype gebruikt. De gebruiker wordt geïdentificeerd door object-id (OID). (Overgenomen van IByUserFederatedIdentityCredential)
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String)	Verwerft een token namens een gebruiker met behulp van een federatieve identiteitsreferentie-assertie. Hierbij wordt het `user_fic` toekenningstype gebruikt. De gebruiker wordt geïdentificeerd door UPN. (Overgenomen van IByUserFederatedIdentityCredential)
AcquireTokenForClient(IEnumerable<String>)	Hiermee verkrijgt u een token van de instantie die is geconfigureerd in de app voor de vertrouwelijke client zelf (niet voor een gebruiker) met behulp van de clientreferentiestroom. Zie de stroom voor clientreferenties. Tijdens deze bewerking zoekt MSAL eerst in de cache naar een niet-verlopen token voordat een nieuw token uit Microsoft Entra ID wordt opgehaald.
AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion)	Hiermee verkrijgt u een toegangstoken voor deze toepassing (meestal een web-API) van de instantie die in de toepassing is geconfigureerd, om namens een gebruiker toegang te krijgen tot een andere downstream beveiligde web-API met behulp van de OAuth 2.0 On-Behalf-Of stroom. Tijdens deze bewerking zoekt MSAL eerst in de cache naar een niet-verlopen token voordat een nieuw token uit Microsoft Entra ID wordt opgehaald. Zie On-Behalf-Of Flow.
AcquireTokenSilent(IEnumerable<String>, IAccount)	Hiermee probeert u een toegangstoken voor de `account` tokencache van de gebruiker te verkrijgen, met geavanceerde parameters voor het beheren van de netwerkaanroep. Zie Tokens op de achtergrond verkrijgen. (Overgenomen van IClientApplicationBase)
AcquireTokenSilent(IEnumerable<String>, String)	Verouderd. In plaats daarvan worden vertrouwelijke client-apps gebruikt AcquireTokenSilent(IEnumerable<String>, IAccount) .
GetAccountAsync(String)	Haal de IAccount id op van de accounts die beschikbaar zijn in de tokencache en van dezelfde omgeving (instantiehost) als Authority. (Overgenomen van IClientApplicationBase)
GetAccountsAsync()	Verouderd. Gebruik GetAccountAsync(String) in web-apps en web-API's en gebruik een serializer voor tokencache voor betere beveiliging en prestaties. Zie https://aka.ms/msal-net-cca-token-cache-serialization.
GetAccountsAsync(String)	Alleen voor Azure AD B2C-scenario's haalt u de IAccount verzameling op met de id van de accounts die beschikbaar zijn in de tokencache op basis van de gebruikersstroom. (Overgenomen van IClientApplicationBase)
GetAuthorizationRequestUrl(IEnumerable<String>)	Berekent de URL van de autorisatieaanvraag zodat de gebruiker zich kan aanmelden en toestemming geeft voor de toepassing die toegang heeft tot specifieke bereiken in de naam van de gebruiker. De URL is gericht op het eindpunt /authorize van de instantie die in de toepassing is geconfigureerd.
RemoveAsync(IAccount)	Hiermee verwijdert u alle tokens in de cache voor het opgegeven account. (Overgenomen van IClientApplicationBase)

Extensiemethoden

Naam	Description
GetCertificate(IConfidentialClientApplication)	Retourneert het certificaat dat is gebruikt om dit ConfidentialClientApplicationte maken, indien van toepassing.

Van toepassing op

Feedback

Is deze pagina nuttig?