NegotiateStream.AuthenticateAsClientAsync メソッド

リファレンス

定義

名前空間:: System.Net.Security

アセンブリ:: 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

クライアントによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。

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 を構築します。

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

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

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

適用対象

AuthenticateAsClientAsync(NetworkCredential, String)

ソース:: 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

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

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このメソッドに渡される拡張保護に使用されるは、関連付けられた SslStreamのプロパティからTransportContextアプリケーションによって取得されます。

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

こちらもご覧ください

適用対象

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

ソース:: 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

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

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)スローされる例外に関するページを参照してください。

こちらもご覧ください

適用対象

次の方法で共有

NegotiateStream.AuthenticateAsClientAsync メソッド

定義

オーバーロード

AuthenticateAsClientAsync()

戻り値

例外

注釈

適用対象

AuthenticateAsClientAsync(NetworkCredential, String)

パラメーター

戻り値

例外

注釈

適用対象

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

パラメーター

戻り値

例外

注釈

適用対象

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

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

その他のリソース