IConfidentialClientApplication Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar konfidentiella klientprogram – webbappar, webb-API:er, daemonprogram.
public interface IConfidentialClientApplication : Microsoft.Identity.Client.IByUserFederatedIdentityCredential, Microsoft.Identity.Client.IClientApplicationBasetype IConfidentialClientApplication = interface
interface IClientApplicationBase
interface IApplicationBase
interface IByUserFederatedIdentityCredentialPublic Interface IConfidentialClientApplication
Implements IByUserFederatedIdentityCredential, IClientApplicationBase- Härledda
- Implementeringar
Kommentarer
Konfidentiella klientprogram är vanligtvis program som körs på servrar (webbappar, webb-API eller till och med tjänst-/daemonprogram). De anses vara svåra att komma åt och kan därför hålla en programhemlighet (lagra konfigurationstidshemligheter eftersom dessa värden skulle vara svåra för slutanvändarna att extrahera). En webbapp är den vanligaste konfidentiella klienten. Klient-ID:t exponeras via webbläsaren, men hemligheten skickas endast i den bakre kanalen och exponeras aldrig direkt. Mer information finns i Klientprogram.
Egenskaper
| Name | Description |
|---|---|
| AppConfig |
Information om konfigurationen av ClientApplication i felsökningssyfte. (Ärvd från IClientApplicationBase) |
| AppTokenCache |
Cacheminne för programtoken som innehåller åtkomsttoken för det här programmet. Den underhålls och uppdateras tyst när den anropas AcquireTokenForClient(IEnumerable<String>) |
| Authority |
Hämtar utfärdarens URL eller säkerhetstokentjänsten (STS) från vilken MSAL.NET hämtar säkerhetstoken.
Returvärdet för den här egenskapen är antingen det värde som tillhandahålls av utvecklaren i konstruktorn för programmet eller på annat sätt värdet för den Microsoft.Identity.Client.ApplicationBase.DefaultAuthority statiska medlemmen (dvs |
| UserTokenCache |
Cacheminne för användartoken som innehåller ID-token, åtkomsttoken och uppdateringstoken för konton. Den används och uppdateras tyst om det behövs när den anropas AcquireTokenSilent(IEnumerable<String>, IAccount) . Den uppdateras av varje metod för att hämta token, med undantag för AcquireTokenForClient(IEnumerable<String>) vilken endast programcachen används (se AppTokenCache). (Ärvd från IClientApplicationBase) |
Metoder
| Name | Description |
|---|---|
| AcquireTokenByAuthorizationCode(IEnumerable<String>, String) |
Hämtar en token från den utfärdare som konfigurerats i appen med hjälp av auktoriseringskoden som tidigare tagits emot från identitetsprovidern med hjälp av OAuth 2.0-auktoriseringskodflödet. Se Auktoriseringskodflöde. Det här flödet används vanligtvis i webbappar (till exempel ASP.NET och ASP.NET Core webbappar) som loggar in användare och kan begära en auktoriseringskod. Den här metoden ser inte ut i tokencachen, men lagrar resultatet i den. Innan du anropar den här metoden använder du andra metoder, till exempel AcquireTokenSilent(IEnumerable<String>, IAccount) för att kontrollera tokencachen. |
| AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String) |
Hämtar en token åt en användare med hjälp av en federerad identitetsautentiseringsuppgift.
Detta använder |
| AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String) |
Hämtar en token åt en användare med hjälp av en federerad identitetsautentiseringsuppgift.
Detta använder |
| AcquireTokenForClient(IEnumerable<String>) |
Hämtar en token från den utfärdare som konfigurerats i appen för själva den konfidentiella klienten (inte för en användare) med hjälp av autentiseringsuppgifterna för klienten. Se Flöde för klientautentiseringsuppgifter. Under den här åtgärden söker MSAL först i cacheminnet efter en oexpirerad token innan en ny hämtas från Microsoft Entra ID. |
| AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion) |
Hämtar en åtkomsttoken för det här programmet (vanligtvis ett webb-API) från den utfärdare som konfigurerats i programmet för att få åtkomst till ett annat underordnat skyddat webb-API åt en användare som använder OAuth 2.0 On-Behalf-Of-flödet. Under den här åtgärden söker MSAL först i cacheminnet efter en oexpirerad token innan en ny hämtas från Microsoft Entra ID. Se On-Behalf-Of Flow. |
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
Försöker hämta en åtkomsttoken för från cacheminnet för |
| AcquireTokenSilent(IEnumerable<String>, String) |
Föråldrad.
I konfidentiella klientappar används AcquireTokenSilent(IEnumerable<String>, IAccount) i stället. |
| GetAccountAsync(String) |
IAccount Hämta efter dess identifierare bland de konton som är tillgängliga i tokencacheminnet och i samma miljö (utfärdarvärd) som Authority. (Ärvd från IClientApplicationBase) |
| GetAccountsAsync() |
Föråldrad.
Använd GetAccountAsync(String) i webbappar och webb-API:er och använd en tokencache-serialiserare för bättre säkerhet och prestanda. Se även https://aka.ms/msal-net-cca-token-cache-serialization. |
| GetAccountsAsync(String) |
Endast för Azure AD B2C-scenarier hämtar IAccount du samlingen efter dess identifierare bland de konton som är tillgängliga i tokencachen baserat på användarflödet. (Ärvd från IClientApplicationBase) |
| GetAuthorizationRequestUrl(IEnumerable<String>) |
Beräknar URL:en för auktoriseringsbegäran som låter användaren logga in och samtycka till att programmet får åtkomst till specifika omfång i användarens namn. URL:en riktar sig till slutpunkten /authorize för den utfärdare som konfigurerats i programmet. |
| RemoveAsync(IAccount) |
Tar bort alla token i cacheminnet för det angivna kontot. (Ärvd från IClientApplicationBase) |
Tilläggsmetoder
| Name | Description |
|---|---|
| GetCertificate(IConfidentialClientApplication) |
Returnerar certifikatet som används för att skapa detta ConfidentialClientApplication, om det finns något. |