NegotiateStream.AuthenticateAsServerAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアントとサーバー間の接続のサーバー側の認証を非同期操作として処理します。
オーバーロード
| AuthenticateAsServerAsync() |
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 |
| AuthenticateAsServerAsync(ExtendedProtectionPolicy) |
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定した拡張保護ポリシーが使用されます。 |
| AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel) |
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したサーバーの資格情報と認証オプションを使用します。 |
| AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel) |
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したサーバーの資格情報、認証オプション、および拡張保護ポリシーが使用されます。 |
AuthenticateAsServerAsync()
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync();public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync ();abstract member AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync () As Task戻り値
非同期操作を表すタスク オブジェクト。
例外
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
Windows 95 と Windows 98 はサポートされていません。
注釈
認証では、サーバーの を使用します DefaultCredentials。 サーバーにサービス プリンシパル名 (SPN) が指定されていない。 偽装レベルは で Identification、セキュリティ レベルは です EncryptAndSign。
認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
認証が失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって AuthenticateAsServer()スローされる例外に関するページを参照してください。
適用対象
AuthenticateAsServerAsync(ExtendedProtectionPolicy)
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定した拡張保護ポリシーが使用されます。
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);abstract member AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (policy As ExtendedProtectionPolicy) As Taskパラメーター
- policy
- ExtendedProtectionPolicy
拡張保護に使用する ExtendedProtectionPolicy。
戻り値
非同期操作を表すタスク オブジェクト。
例外
policy パラメーターで渡された拡張保護ポリシーの CustomChannelBinding と CustomServiceNames は、どちらも null です。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
拡張保護をサポートしていないプラットフォームで、policy パラメーターが Always に設定されました。
Windows 95 と Windows 98 はサポートされていません。
注釈
認証では、サーバーの を使用します DefaultCredentials。 サーバーにサービス プリンシパル名 (SPN) が指定されていない。 偽装レベルは で Identification、セキュリティ レベルは です EncryptAndSign。
パラメーターが のpolicy場合はnull、 に設定Neverされた拡張保護ポリシーがPolicyEnforcement使用されます。
認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
認証が失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって AuthenticateAsServer(ExtendedProtectionPolicy)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したサーバーの資格情報と認証オプションを使用します。
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Taskパラメーター
- credential
- NetworkCredential
サーバーの ID を確立するために使用される NetworkCredential。
- requiredProtectionLevel
- ProtectionLevel
ストリームのセキュリティ サービスを示す ProtectionLevel 値の 1 つ。
- requiredImpersonationLevel
- TokenImpersonationLevel
サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示す TokenImpersonationLevel 値の 1 つ。
戻り値
非同期操作を表すタスク オブジェクト。
例外
credential が nullです。
requiredImpersonationLevel は、Identification、Impersonation、または Delegation である必要があります。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
認証が既に発生しました。
- または -
このストリームは、かつて、クライアントとして認証を行う目的で使用されていました。 このストリームを使用して、サーバーとして認証を再試行することはできません。
Windows 95 と Windows 98 はサポートされていません。
注釈
認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
認証が失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)スローされる例外に関するページを参照してください。
適用対象
AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)
サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したサーバーの資格情報、認証オプション、および拡張保護ポリシーが使用されます。
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Taskパラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- policy
- ExtendedProtectionPolicy
拡張保護に使用する ExtendedProtectionPolicy。
- requiredProtectionLevel
- ProtectionLevel
ストリームのセキュリティ サービスを示す ProtectionLevel 値の 1 つ。
- requiredImpersonationLevel
- TokenImpersonationLevel
サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示す TokenImpersonationLevel 値の 1 つ。
戻り値
非同期操作を表すタスク オブジェクト。
例外
policy パラメーターで渡された拡張保護ポリシーの CustomChannelBinding と CustomServiceNames は、どちらも null です。
credential が nullです。
requiredImpersonationLevel は、Identification、Impersonation、または Delegation である必要があります。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証が既に発生しました。
- または -
このストリームは、かつて、クライアントとして認証を行う目的で使用されていました。 このストリームを使用して、サーバーとして認証を再試行することはできません。
このオブジェクトは閉じられました。
拡張保護をサポートしていないプラットフォームで、policy パラメーターが Always に設定されました。
Windows 95 と Windows 98 はサポートされていません。
注釈
パラメーターが policy の場合はnull、 を にNever設定した拡張保護ポリシーがPolicyEnforcement使用されます。
認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
認証に失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報を使用して認証を再試行できます。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
.NET