NegotiateStream.AuthenticateAsClientAsync メソッド

定義

名前空間:: System.Net.Security

アセンブリ:: netstandard.dll, System.Net.Security.dll

アセンブリ:: System.Net.Security.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。

オーバーロード

名前	説明
AuthenticateAsClientAsync()	非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。
AuthenticateAsClientAsync(NetworkCredential, String)	非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定されたクライアント資格情報が使用されます。
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)	非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定されたクライアント資格情報とチャネルバインドが使用されます。
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定された資格情報と認証オプションが使用されます。
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定された資格情報、認証オプション、およびチャネルバインドが使用されます。

AuthenticateAsClientAsync()

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

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.Task

Public Overridable Function AuthenticateAsClientAsync () As Task

返品

Task

非同期操作を表すタスクオブジェクト。

例外

AuthenticationException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidCredentialException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

ObjectDisposedException

このオブジェクトは閉じられています。

InvalidOperationException

認証は既に行われました。

-又は-

このストリームは、サーバーとして認証を試みるために以前使用されていました。ストリームを使用してクライアントとして認証を再試行することはできません。

注釈

認証では、クライアントの DefaultCredentialsが使用されます。サーバーにサービスプリンシパル名 (SPN) が指定されていない。偽装レベルが Identificationされ、セキュリティレベルが EncryptAndSignされ、相互認証が要求されます。 NegotiateStream クラスは、相互認証に使用される SPN を構築します。

認証が成功したら、 IsEncrypted プロパティと IsSigned プロパティを確認して、 NegotiateStreamで使用されるセキュリティサービスを決定する必要があります。 IsMutuallyAuthenticatedプロパティを調べて、相互認証が行われたかどうかを確認します。

認証に失敗した場合は、 AuthenticationException または InvalidCredentialExceptionを受け取ります。この場合は、別の資格情報で認証を再試行できます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient()によってスローされる例外を参照してください。

適用対象

AuthenticateAsClientAsync(NetworkCredential, String)

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定されたクライアント資格情報が使用されます。

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.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As Task

パラメーター

credential: NetworkCredential

クライアントの ID を確立するために使用される NetworkCredential 。

targetName: String

認証するサーバーを一意に識別するサービスプリンシパル名 (SPN)。

返品

Task

非同期操作を表すタスクオブジェクト。

例外

AuthenticationException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidCredentialException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

ObjectDisposedException

このオブジェクトは閉じられています。

InvalidOperationException

認証は既に行われました。

-又は-

ArgumentNullException

targetName は nullです。

注釈

偽装レベルが Identificationされ、セキュリティレベルが EncryptAndSignされ、相互認証が要求されます。 NegotiateStream クラスは、相互認証に使用される SPN を構築します。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(NetworkCredential, String)によってスローされる例外を参照してください。

適用対象

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定されたクライアント資格情報とチャネルバインドが使用されます。

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.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As Task

パラメーター

credential: NetworkCredential

クライアントの ID を確立するために使用される NetworkCredential 。

binding: ChannelBinding

拡張保護に使用される ChannelBinding 。

targetName: String

認証するサーバーを一意に識別するサービスプリンシパル名 (SPN)。

返品

Task

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

targetName は nullです。

-又は-

credential は nullです。

AuthenticationException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidCredentialException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidOperationException

認証は既に行われました。

-又は-

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

ChannelBinding パラメーターでこのメソッドに渡される拡張保護に使用されるbindingは、関連付けられたTransportContextのプロパティからアプリケーションSslStream取得されます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(NetworkCredential, ChannelBinding, String)によってスローされる例外を参照してください。

こちらもご覧ください

適用対象

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定された資格情報と認証オプションが使用されます。

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.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

パラメーター

credential: NetworkCredential

クライアントの ID を確立するために使用される NetworkCredential 。

targetName: String

認証するサーバーを一意に識別するサービスプリンシパル名 (SPN)。

requiredProtectionLevel: ProtectionLevel

ストリームのセキュリティサービスを示す ProtectionLevel 値の 1 つ。

allowedImpersonationLevel: TokenImpersonationLevel

TokenImpersonationLevel値の 1 つ。サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示します。

返品

Task

非同期操作を表すタスクオブジェクト。

例外

ArgumentOutOfRangeException

allowedImpersonationLevel は有効な値ではありません。

ArgumentNullException

targetName が null です。

AuthenticationException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidCredentialException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

ObjectDisposedException

このオブジェクトは閉じられています。

InvalidOperationException

認証は既に行われました。

-又は-

注釈

requiredProtectionLevel パラメーターを使用して、認証済みストリームを使用して送信されるデータのセキュリティサービスを要求します。たとえば、データを暗号化して署名するには、 EncryptAndSign 値を指定します。認証が成功しても、要求された ProtectionLevel が許可されたことは保証されません。 IsEncryptedで使用されるセキュリティサービスを決定するには、IsSignedプロパティとNegotiateStreamプロパティを確認する必要があります。

認証に失敗した場合は、 AuthenticationException または InvalidCredentialExceptionを受け取ります。この場合は、別の資格情報で認証を再試行できます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)によってスローされる例外を参照してください。

適用対象

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

ソース:: NegotiateStream.cs

非同期操作としてクライアントとサーバーの接続で、クライアントと必要に応じてサーバーを認証するためにクライアントによって呼び出されます。認証プロセスでは、指定された資格情報、認証オプション、およびチャネルバインドが使用されます。

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.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

パラメーター

credential: NetworkCredential

クライアントの ID を確立するために使用される NetworkCredential 。

binding: ChannelBinding

拡張保護に使用される ChannelBinding 。

targetName: String

認証するサーバーを一意に識別するサービスプリンシパル名 (SPN)。

requiredProtectionLevel: ProtectionLevel

ストリームのセキュリティサービスを示す ProtectionLevel 値の 1 つ。

allowedImpersonationLevel: TokenImpersonationLevel

TokenImpersonationLevel値の 1 つ。サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示します。

返品

Task

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

targetName は nullです。

-又は-

credential は nullです。

ArgumentOutOfRangeException

allowedImpersonationLevel は有効な値ではありません。

AuthenticationException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidCredentialException

認証に失敗しました。このオブジェクトを使用して、認証を再試行できます。

InvalidOperationException

認証は既に行われました。

-又は-

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

認証に失敗した場合は、 AuthenticationException または InvalidCredentialExceptionを受け取ります。この場合は、別の資格情報で認証を再試行できます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)によってスローされる例外を参照してください。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?