NegotiateStream.AuthenticateAsClientAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Volá klienty k ověření klienta a volitelně serveru v připojení klient-server jako asynchronní operace.
Přetížení
| AuthenticateAsClientAsync() |
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. |
| AuthenticateAsClientAsync(NetworkCredential, String) |
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje klienta. |
| AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String) |
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje klienta a vazbu kanálu. |
| AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel) |
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje a možnosti ověřování. |
| AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel) |
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje, možnosti ověřování a vazbu kanálu. |
AuthenticateAsClientAsync()
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync();public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync ();abstract member AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync () As TaskNávraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Tento objekt byl uzavřen.
Ověřování již proběhlo.
-nebo-
Tento stream se dříve používal k pokusu o ověření jako server. Datový proud nelze použít k opakování ověření jako klient.
Poznámky
Při ověřování se používá klient .DefaultCredentials Pro server není zadán žádný hlavní název služby (SPN). Úroveň zosobnění je Identification, úroveň zabezpečení je EncryptAndSigna vyžaduje se vzájemné ověřování. Třída NegotiateStream vytvoří hlavní název služby (SPN) použitý pro vzájemné ověřování.
Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá NegotiateStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.
Pokud se ověření nezdaří, obdržíte nebo AuthenticationExceptionInvalidCredentialException. V takovém případě můžete zkusit ověření zopakovat pomocí jiných přihlašovacích údajů.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient().
Platí pro
AuthenticateAsClientAsync(NetworkCredential, String)
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje klienta.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As TaskParametry
- credential
- NetworkCredential
Slouží NetworkCredential k vytvoření identity klienta.
- targetName
- String
Hlavní název služby (SPN), který jednoznačně identifikuje server, který se má ověřit.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Tento objekt byl uzavřen.
Ověřování již proběhlo.
-nebo-
Tento stream se dříve používal k pokusu o ověření jako server. Datový proud nelze použít k opakování ověření jako klient.
targetName je null.
Poznámky
Úroveň zosobnění je Identification, úroveň zabezpečení je EncryptAndSigna vyžaduje se vzájemné ověřování. Třída NegotiateStream vytvoří hlavní název služby (SPN) použitý pro vzájemné ověřování.
Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá NegotiateStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(NetworkCredential, String).
Platí pro
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
Volali klienti k ověření klienta a případně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje klienta a vazbu kanálu.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As TaskParametry
- credential
- NetworkCredential
Slouží NetworkCredential k vytvoření identity klienta.
- binding
- ChannelBinding
Používá ChannelBinding se pro rozšířenou ochranu.
- targetName
- String
Hlavní název služby (SPN), který jednoznačně identifikuje server, který se má ověřit.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Ověřování již proběhlo.
-nebo-
Tento stream se dříve používal k pokusu o ověření jako server. Datový proud nelze použít k opakování ověření jako klient.
Tento objekt byl uzavřen.
Poznámky
Úroveň zosobnění je Identification, úroveň zabezpečení je EncryptAndSigna vyžaduje se vzájemné ověřování. Třída NegotiateStream vytvoří hlavní název služby (SPN) použitý pro vzájemné ověřování.
Použitá ChannelBinding pro rozšířenou ochranu, která je předána této metodě v parametru binding , by byla načtena aplikací z TransportContext vlastnosti na přidruženém SslStreamobjektu .
Pokud je ověření úspěšné, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned a určit, které služby zabezpečení používá NegotiateStream. Zkontrolujte vlastnost a IsMutuallyAuthenticated zjistěte, jestli nedošlo k vzájemnému ověřování.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(NetworkCredential, ChannelBinding, String).
Viz také
Platí pro
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
Volá klienty k ověření klienta a volitelně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje a možnosti ověřování.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As TaskParametry
- credential
- NetworkCredential
Slouží NetworkCredential k vytvoření identity klienta.
- targetName
- String
Hlavní název služby (SPN), který jednoznačně identifikuje server, který se má ověřit.
- requiredProtectionLevel
- ProtectionLevel
Jedna z ProtectionLevel hodnot označující služby zabezpečení pro datový proud.
- allowedImpersonationLevel
- TokenImpersonationLevel
Jedna z TokenImpersonationLevel hodnot, která určuje, jak může server používat přihlašovací údaje klienta pro přístup k prostředkům.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
allowedImpersonationLevel není platná hodnota.
targetName je null.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověřování.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověření.
Tento objekt byl uzavřen.
Ověřování již proběhlo.
-nebo-
Tento stream se dříve použil k pokusu o ověření jako server. Datový proud nemůžete použít k opakování ověření jako klient.
Poznámky
Parametr použijte requiredProtectionLevel k vyžádání služeb zabezpečení pro data přenášená pomocí ověřeného datového proudu. Pokud například chcete mít data zašifrovaná a podepsaná, zadejte EncryptAndSign hodnotu . Úspěšné ověření nezaručuje, že bylo požadovanému ProtectionLevel udělení uděleno. Pokud chcete určit, které služby zabezpečení používá NegotiateStream, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned .
Pokud se ověření nezdaří, obdržíte nebo AuthenticationExceptionInvalidCredentialException. V takovém případě můžete zkusit ověření zopakovat pomocí jiných přihlašovacích údajů.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel).
Platí pro
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
- Zdroj:
- NegotiateStream.cs
Volá klienty k ověření klienta a volitelně serveru v připojení klient-server jako asynchronní operace. Proces ověřování používá zadané přihlašovací údaje, možnosti ověřování a vazbu kanálu.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As TaskParametry
- credential
- NetworkCredential
Slouží NetworkCredential k vytvoření identity klienta.
- binding
- ChannelBinding
Hodnota ChannelBinding , která se používá pro rozšířenou ochranu.
- targetName
- String
Hlavní název služby (SPN), který jednoznačně identifikuje server, který se má ověřit.
- requiredProtectionLevel
- ProtectionLevel
Jedna z ProtectionLevel hodnot označující služby zabezpečení pro datový proud.
- allowedImpersonationLevel
- TokenImpersonationLevel
Jedna z TokenImpersonationLevel hodnot, která určuje, jak může server používat přihlašovací údaje klienta pro přístup k prostředkům.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
allowedImpersonationLevel není platná hodnota.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověření.
Ověření se nezdařilo. Tento objekt můžete použít k opakování ověření.
Ověřování již proběhlo.
-nebo-
Tento stream se dříve použil k pokusu o ověření jako server. Datový proud nemůžete použít k opakování ověření jako klient.
Tento objekt byl uzavřen.
Poznámky
Parametr použijte requiredProtectionLevel k vyžádání služeb zabezpečení pro data přenášená pomocí ověřeného datového proudu. Pokud například chcete mít data zašifrovaná a podepsaná, zadejte EncryptAndSign hodnotu . Úspěšné ověření nezaručuje, že bylo požadovanému ProtectionLevel udělení uděleno. Pokud chcete určit, které služby zabezpečení používá NegotiateStream, musíte zkontrolovat IsEncrypted vlastnosti a IsSigned .
Objekt ChannelBinding použitý pro rozšířenou ochranu, která je předána této metodě v parametru binding , by byla načtena aplikací z TransportContext vlastnosti v přidruženém SslStreamobjektu .
Pokud se ověření nezdaří, obdržíte nebo AuthenticationExceptionInvalidCredentialException. V takovém případě můžete zkusit ověření zopakovat pomocí jiných přihlašovacích údajů.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel).
Viz také
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro