Sprache

IPublicClientApplication Schnittstelle

Definition

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 https://login.microsoftonline.com/common/.

(Geerbt von IClientApplicationBase)
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 account Benutzertokencache abzurufen, wobei erweiterte Parameter den Netzwerkaufruf steuern. Siehe automatisches Abrufen von Token.

(Geerbt von IClientApplicationBase)
AcquireTokenSilent(IEnumerable<String>, String)

Versucht, ein Zugriffstoken für den loginHint Benutzertokencache abzurufen, wobei erweiterte Parameter den Netzwerkaufruf steuern. Siehe automatisches Abrufen von Token.

(Geerbt von IClientApplicationBase)
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>)

Gilt für: