次の方法で共有


NegotiateStream.AuthenticateAsClientAsync メソッド

定義

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

オーバーロード

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

戻り値

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

例外

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

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

このオブジェクトは閉じられました。

認証が既に発生しました。

- または -

このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。

注釈

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

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

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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)。

戻り値

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

例外

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

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

このオブジェクトは閉じられました。

認証が既に発生しました。

- または -

このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。

targetNamenullです。

注釈

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

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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)。

戻り値

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

例外

targetNamenull です。

または

credentialnullです。

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

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

認証が既に発生しました。

- または -

このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。

このオブジェクトは閉じられました。

注釈

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

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

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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 つ。

戻り値

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

例外

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

targetName が null です。

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

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

このオブジェクトは閉じられました。

認証が既に発生しました。

- または -

このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。

注釈

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

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

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの 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 つ。

戻り値

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

例外

targetNamenull です。

または

credentialnullです。

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

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

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

認証が既に発生しました。

- または -

このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。

このオブジェクトは閉じられました。

注釈

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

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

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

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

こちらもご覧ください

適用対象