NegotiateStream.BeginAuthenticateAsServer メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアントとサーバー間の接続のサーバー側の認証を処理する非同期操作を開始します。
オーバーロード
| BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 認証プロセスでは、指定したサーバーの資格情報、認証オプション、および拡張保護ポリシーが使用されます。 このメソッドはブロックしません。 |
| BeginAuthenticateAsServer(AsyncCallback, Object) |
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 このメソッドはブロックしません。 |
| BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object) |
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 認証プロセスでは、指定した拡張保護ポリシーが使用されます。 このメソッドはブロックしません。 |
| BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 認証プロセスでは、指定したサーバーの資格情報と認証オプションを使用します。 このメソッドはブロックしません。 |
注釈
このメソッドのオーバーロードは、認証の進行中はブロックされません。 認証が完了するまで待機している間にブロックするには、 メソッドを使用します AuthenticateAsServer 。
BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 認証プロセスでは、指定したサーバーの資格情報、認証オプション、および拡張保護ポリシーが使用されます。 このメソッドはブロックしません。
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultパラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- policy
- ExtendedProtectionPolicy
拡張保護に使用する ExtendedProtectionPolicy。
- requiredProtectionLevel
- ProtectionLevel
ストリームのセキュリティ サービスを示す ProtectionLevel 値の 1 つ。
- requiredImpersonationLevel
- TokenImpersonationLevel
サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示す TokenImpersonationLevel 値の 1 つ。
- asyncCallback
- AsyncCallback
認証完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。
- asyncState
- Object
書き込み操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に asyncCallback デリゲートに渡されます。
戻り値
非同期操作の状態を示す IAsyncResult オブジェクト。
例外
policy パラメーターで渡された拡張保護ポリシーの CustomChannelBinding と CustomServiceNames は、どちらも null です。
credential が nullです。
requiredImpersonationLevel は、Identification、Impersonation、または Delegation である必要があります。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証が既に発生しました。
- または -
このストリームは、かつて、クライアントとして認証を行う目的で使用されていました。 このストリームを使用して、サーバーとして認証を再試行することはできません。
このオブジェクトは閉じられました。
拡張保護をサポートしていないプラットフォームで、policy パラメーターが Always に設定されました。
Windows 95 と Windows 98 はサポートされていません。
注釈
パラメーターを requiredProtectionLevel 使用して、認証済みストリームを使用して送信されるデータのセキュリティ サービスを要求します。 たとえば、データを暗号化して署名するには、 値を指定します EncryptAndSign 。 認証が成功しても、要求された ProtectionLevel が許可されたことは保証されません。 および IsSigned プロパティをIsEncrypted確認して、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要があります。
パラメーターが policy の場合はnull、 を にNever設定した拡張保護ポリシーがPolicyEnforcement使用されます。
このメソッドは非同期であり、操作の完了中はブロックされません。 操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを AuthenticateAsServer 使用します。
非同期認証操作は、 メソッドを呼び出して完了する EndAuthenticateAsServer 必要があります。 通常、 メソッドはデリゲートによって asyncCallback 呼び出されます。 非同期プログラミング モデルの使用の詳細については、「同期メソッドの非同期呼び出し」を参照してください。
認証に失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報を使用して認証を再試行できます。
こちらもご覧ください
適用対象
BeginAuthenticateAsServer(AsyncCallback, Object)
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 このメソッドはブロックしません。
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultパラメーター
- asyncCallback
- AsyncCallback
認証完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。
- asyncState
- Object
操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に asyncCallback デリゲートに渡されます。
戻り値
非同期操作の状態を示す IAsyncResult オブジェクト。
例外
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
Windows 95 と Windows 98 はサポートされていません。
注釈
認証では、サーバーの を使用します DefaultCredentials。 サーバーにサービス プリンシパル名 (SPN) が指定されていない。 偽装レベルは で Identification、セキュリティ レベルは です EncryptAndSign。
認証が成功したら、 プロパティと プロパティをIsEncrypted確認して、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要IsSignedがあります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを AuthenticateAsServer 使用します。
認証に失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報を使用して認証を再試行できます。
適用対象
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 認証プロセスでは、指定した拡張保護ポリシーが使用されます。 このメソッドはブロックしません。
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (policy As ExtendedProtectionPolicy, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultパラメーター
- policy
- ExtendedProtectionPolicy
拡張保護に使用する ExtendedProtectionPolicy。
- asyncCallback
- AsyncCallback
認証完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。
- asyncState
- Object
書き込み操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に asyncCallback デリゲートに渡されます。
戻り値
非同期操作の状態を示す IAsyncResult オブジェクト。
例外
policy パラメーターで渡された拡張保護ポリシーの CustomChannelBinding と CustomServiceNames は、どちらも null です。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
拡張保護をサポートしていないプラットフォームで、policy パラメーターが Always に設定されました。
Windows 95 と Windows 98 はサポートされていません。
注釈
認証では、サーバーの を使用します DefaultCredentials。 サーバーにサービス プリンシパル名 (SPN) が指定されていない。 偽装レベルは で Identification、セキュリティ レベルは です EncryptAndSign。
パラメーターが policy の場合はnull、 を にNever設定した拡張保護ポリシーがPolicyEnforcement使用されます。
認証が成功したら、 プロパティと プロパティをIsEncrypted確認して、 によって使用されるセキュリティ サービスを決定するNegotiateStream必要IsSignedがあります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを AuthenticateAsServer 使用します。
認証が失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
こちらもご覧ください
適用対象
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
サーバーによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証する非同期操作を開始します。 認証プロセスでは、指定したサーバーの資格情報と認証オプションを使用します。 このメソッドはブロックしません。
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultパラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- requiredProtectionLevel
- ProtectionLevel
ストリームのセキュリティ サービスを示す ProtectionLevel 値の 1 つ。
- requiredImpersonationLevel
- TokenImpersonationLevel
サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示す TokenImpersonationLevel 値の 1 つ。
- asyncCallback
- AsyncCallback
認証完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。
- asyncState
- Object
操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に asyncCallback デリゲートに渡されます。
戻り値
非同期操作の状態を示す IAsyncResult オブジェクト。
例外
credential が nullです。
requiredImpersonationLevel は、Identification、Impersonation、または Delegation である必要があります。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
認証が既に発生しました。
- または -
このストリームは、かつて、クライアントとして認証を行う目的で使用されていました。 このストリームを使用して、サーバーとして認証を再試行することはできません。
Windows 95 と Windows 98 はサポートされていません。
注釈
パラメーターを requiredProtectionLevel 使用して、認証済みストリームを使用して送信されるデータのセキュリティ サービスを要求します。 たとえば、データを暗号化して署名するには、 値を指定します EncryptAndSign 。 認証が成功しても、要求された ProtectionLevel が許可されたことは保証されません。 および IsSigned プロパティをIsEncrypted確認して、 によって使用されるセキュリティ サービスを確認するNegotiateStream必要があります。
このメソッドは非同期であり、操作の完了中はブロックされません。 操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを AuthenticateAsServer 使用します。
非同期認証操作は、 メソッドを呼び出して完了する EndAuthenticateAsServer 必要があります。 通常、 メソッドはデリゲートによって asyncCallback 呼び出されます。 非同期プログラミング モデルの使用の詳細については、「非同期的に同期メソッドを呼び出す」を参照してください。
認証が失敗した場合は、 または をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
適用対象
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示