IPublicClientApplication Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt öffentliche Clientanwendungen dar – Desktop- und mobile Anwendungen.
public interface IPublicClientApplication : Microsoft.Identity.Client.IClientApplicationBase
type IPublicClientApplication = interface
interface IClientApplicationBase
interface IApplicationBase
Public Interface IPublicClientApplication
Implements IClientApplicationBase
- Abgeleitet
- Implementiert
Hinweise
Öffentliche Clientanwendungen sind nicht vertrauenswürdig, anwendungsgeheimnisse zu schützen, und daher können sie nur im Namen des authentifizierenden Benutzers auf Web-APIs zugreifen. Siehe Clientanwendungen.
Im Gegensatz dazu IConfidentialClientApplicationkönnen öffentliche Clients geheime Schlüssel nicht sicher auf einem Clientgerät speichern und erfordern daher nicht die Verwendung eines geheimen Clientschlüssels.
Der für die interaktive Authentifizierung erforderliche Umleitungs-URI wird automatisch von der Bibliothek bestimmt. Sie muss nicht explizit im Konstruktor übergeben werden. Abhängig von der Authentifizierungsstrategie (z. B. über den Web Account Manager, die Authenticator-App, den Webbrowser usw.) werden verschiedene Umleitungs-URIs von MSAL verwendet. Umleitungs-URIs müssen immer für die Anwendung im Azure-Portal konfiguriert werden.
Eigenschaften
| Name | Beschreibung |
|---|---|
| AppConfig |
Details zur Konfiguration der ClientApplication für Debuggingzwecke. (Geerbt von IClientApplicationBase) |
| Authority |
Ruft die URL der Autorität oder den Sicherheitstokendienst (Security Token Service, STS) ab, von dem MSAL.NET Sicherheitstoken erwerben.
Der Rückgabewert dieser Eigenschaft ist entweder der Vom Entwickler im Konstruktor der Anwendung bereitgestellte Wert oder anderweitig der Wert des Microsoft.Identity.Client.ApplicationBase.DefaultAuthority statischen Elements (d |
| IsSystemWebViewAvailable |
Gibt an, ob die Anwendung den Systemwebbrowser verwenden kann, sodass single-sign-on mit Webanwendungen aktiviert wird. Standardmäßig versucht MSAL, einen Systembrowser auf den mobilen Plattformen zu verwenden, sofern er verfügbar ist. Weitere Informationen finden Sie in unserer Dokumentation . |
| UserTokenCache |
Benutzertokencache, der ID-Token, Zugriffstoken und Aktualisierungstoken für Konten enthält. Sie wird verwendet und automatisch aktualisiert, wenn sie beim Aufrufen AcquireTokenSilent(IEnumerable<String>, IAccount) von It durch jede Abrufentokenmethode aktualisiert wird, mit Ausnahme AcquireTokenForClient(IEnumerable<String>) davon, dass nur der Anwendungscache verwendet wird (siehe AppTokenCache). (Geerbt von IClientApplicationBase) |
Methoden
| Name | Beschreibung |
|---|---|
| AcquireTokenByIntegratedWindowsAuth(IEnumerable<String>) |
Veraltet.
Diese API wird nicht mehr empfohlen. Wenn Ihre Anwendung einmaliges Anmelden (Single Sign-On, SSO) mit dem Standardkonto des Windows Betriebssystems erfordert, wechseln Sie zur Verwendung von WAM, die ähnliche Funktionen über den Windows Broker (WAM) bereitstellt. WAM erfordert keine Einrichtung für Desktop-Apps, um sich mit dem Windows Konto anzumelden. Erwirbt ein Token, das nicht interaktiv für den angemeldeten Benutzer in Windows über integrierte Windows Authentifizierung erfolgt. Das in diesen Außerkraftsetzungen verwendete Konto wird vom Betriebssystem als aktueller Benutzerprinzipalname abgerufen. Diese Methode sieht nicht im Tokencache aus, speichert aber das Ergebnis darin. Verwenden Sie vor dem Aufrufen dieser Methode andere Methoden, z AcquireTokenSilent(IEnumerable<String>, IAccount) . B. zum Überprüfen des Tokencaches. |
| AcquireTokenByUsernamePassword(IEnumerable<String>, String, SecureString) |
Veraltet.
Nicht interaktive Anforderung zum Abrufen eines Tokens über die Benutzernamen- und Kennwortauthentifizierung. |
| AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) |
Veraltet.
Dient zum Abrufen eines Tokens ohne Benutzerinteraktion mithilfe der Benutzernamen- und Kennwortauthentifizierung. Diese Methode sieht nicht im Tokencache aus, speichert aber das Ergebnis darin. Verwenden Sie vor dem Aufrufen dieser Methode andere Methoden, z AcquireTokenSilent(IEnumerable<String>, IAccount) . B. zum Überprüfen des Tokencaches. |
| AcquireTokenInteractive(IEnumerable<String>) |
Erwirbt ein Token interaktiv für die angegebenen Bereiche. Entweder ein Systembrowser, ein eingebetteter Browser oder ein Broker verarbeitet diese Anforderung, abhängig von der version des verwendeten .NET Frameworks und der Konfiguration. Für Microsoft Entra Anwendungen wird ein Broker empfohlen. Siehe Windows Broker. Diese Methode sieht nicht im Tokencache aus, speichert aber das Ergebnis darin. Verwenden Sie vor dem Aufrufen dieser Methode andere Methoden, z AcquireTokenSilent(IEnumerable<String>, IAccount) . B. zum Überprüfen des Tokencaches. Siehe interaktive Authentifizierung. |
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
Versucht, ein Zugriffstoken für den |
| AcquireTokenSilent(IEnumerable<String>, String) |
Versucht, ein Zugriffstoken für den |
| AcquireTokenWithDeviceCode(IEnumerable<String>, Func<DeviceCodeResult,Task>) |
Erwirbt ein Token auf einem Gerät ohne Webbrowser, indem er dem Benutzer die Authentifizierung auf einem anderen Gerät ermöglicht. Diese Methode sieht nicht im Tokencache aus, speichert aber das Ergebnis darin. Verwenden Sie vor dem Aufrufen dieser Methode andere Methoden, z AcquireTokenSilent(IEnumerable<String>, IAccount) . B. zum Überprüfen des Tokencaches. |
| GetAccountAsync(String) |
Rufen Sie den IAccount Bezeichner zwischen den Konten ab, die im Tokencache und in derselben Umgebung (Autoritätshost) verfügbar sind wie Authority. (Geerbt von IClientApplicationBase) |
| GetAccountsAsync() |
Gibt alle verfügbaren Konten im Benutzertokencache für die Anwendung zurück. (Geerbt von IClientApplicationBase) |
| GetAccountsAsync(String) |
Rufen Sie die IAccount Sammlung nur für Azure AD B2C-Szenarien anhand ihres Bezeichners unter den Konten ab, die basierend auf dem Benutzerablauf im Tokencache verfügbar sind. (Geerbt von IClientApplicationBase) |
| RemoveAsync(IAccount) |
Entfernt alle Token im Cache für das angegebene Konto. (Geerbt von IClientApplicationBase) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| IsEmbeddedWebViewAvailable(IPublicClientApplication) |
Gibt true zurück, wenn MSAL eine eingebettete Webview (Browser) verwenden kann. |
| IsProofOfPossessionSupportedByClient(IPublicClientApplication) |
Wird verwendet, um zu ermitteln, ob der derzeit verfügbare Broker in der Lage ist, Proof-of-Possession durchzuführen. |
| IsSystemWebViewAvailable(IPublicClientApplication) |
Gibt true zurück, wenn MSAL einen Systembrowser verwenden kann. |
| IsUserInteractive(IPublicClientApplication) |
Gibt "false" zurück, wenn das Programm im headless-Betriebssystem ausgeführt wird, z. B. wenn SSH auf einem Linux-Computer ausgeführt wird. Browser (Webviews) und Broker können nicht verwendet werden, wenn keine Ui-Unterstützung vorhanden ist. Verwenden AcquireTokenWithDeviceCode(IEnumerable<String>, Func<DeviceCodeResult,Task>) Sie stattdessen oder AcquireTokenByIntegratedWindowsAuth(IEnumerable<String>) |