NegotiateStream.AuthenticateAsClient メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。
オーバーロード
| AuthenticateAsClient() |
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 |
| AuthenticateAsClient(NetworkCredential, String) |
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したクライアントの資格情報を使用します。 |
| AuthenticateAsClient(NetworkCredential, ChannelBinding, String) |
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したクライアントの資格情報およびチャネル バインディングが使用されます。 |
| AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel) |
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定した資格情報と認証オプションを使用します。 |
| AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel) |
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定した資格情報、認証オプション、およびチャネル バインディングが使用されます。 |
AuthenticateAsClient()
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。
public:
virtual void AuthenticateAsClient();public virtual void AuthenticateAsClient ();abstract member AuthenticateAsClient : unit -> unit
override this.AuthenticateAsClient : unit -> unitPublic Overridable Sub AuthenticateAsClient ()例外
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
認証が既に発生しました。
- または -
このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。
注釈
認証では、クライアント DefaultCredentialsの . サーバーにサービス プリンシパル名 (SPN) が指定されていない。 権限借用レベルは Identification、セキュリティ レベルは EncryptAndSign、相互認証が要求されます。 このクラスは NegotiateStream 、相互認証に使用される SPN を構築します。
認証が成功したら、プロパティとIsSignedプロパティをIsEncrypted確認して、.NegotiateStream プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
認証に失敗した場合は、次の値をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
適用対象
AuthenticateAsClient(NetworkCredential, String)
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したクライアントの資格情報を使用します。
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName);public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, string targetName);abstract member AuthenticateAsClient : System.Net.NetworkCredential * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string -> unitPublic Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String)パラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- targetName
- String
認証するサーバーを一意に識別するサービス プリンシパル名 (SPN)。
例外
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
認証が既に発生しました。
- または -
このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。
targetName が nullです。
注釈
権限借用レベルは Identification、セキュリティ レベルは EncryptAndSign、相互認証が要求されます。 このクラスは NegotiateStream 、相互認証に使用される SPN を構築します。
認証が成功したら、プロパティとIsSignedプロパティをIsEncrypted確認して、.NegotiateStream プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
適用対象
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定したクライアントの資格情報およびチャネル バインディングが使用されます。
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unitPublic Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String)パラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- binding
- ChannelBinding
拡張保護に使用する ChannelBinding。
- targetName
- String
認証するサーバーを一意に識別するサービス プリンシパル名 (SPN)。
例外
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証が既に発生しました。
- または -
このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。
このオブジェクトは閉じられました。
注釈
権限借用レベルは Identification、セキュリティ レベルは EncryptAndSign、相互認証が要求されます。 このクラスは NegotiateStream 、相互認証に使用される SPN を構築します。
パラメーターでこのメソッドに渡される拡張保護にbinding使用される保護はChannelBinding、関連付けられているSslStreamプロパティからTransportContextアプリケーションによって取得されます。
認証が成功したら、プロパティとIsSignedプロパティをIsEncrypted確認して、.NegotiateStream プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。
こちらもご覧ください
適用対象
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定した資格情報と認証オプションを使用します。
public:
virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unitPublic Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)パラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- targetName
- String
認証するサーバーを一意に識別するサービス プリンシパル名 (SPN)。
- requiredProtectionLevel
- ProtectionLevel
ストリームのセキュリティ サービスを示す ProtectionLevel 値の 1 つ。
- allowedImpersonationLevel
- TokenImpersonationLevel
サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示す TokenImpersonationLevel 値の 1 つ。
例外
allowedImpersonationLevel は有効な値ではありません。
targetName が null です。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
このオブジェクトは閉じられました。
認証が既に発生しました。
- または -
このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。
注釈
このパラメーターを requiredProtectionLevel 使用して、認証済みストリームを使用して送信されるデータのセキュリティ サービスを要求します。 たとえば、データを暗号化して署名するには、値を指定します EncryptAndSign 。 認証が成功しても、要求された ProtectionLevel 認証が許可されたことは保証されません。 とプロパティをIsEncryptedIsSigned確認して、どのセキュリティ サービスが使用されているかを確認するNegotiateStream必要があります。
認証に失敗した場合は、次の値をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。
適用対象
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)
クライアントによって呼び出され、クライアントとサーバー間の接続でクライアントと (オプションで) サーバーを認証します。 認証プロセスでは、指定した資格情報、認証オプション、およびチャネル バインディングが使用されます。
public:
virtual void AuthenticateAsClient(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 void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unitPublic Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)パラメーター
- credential
- NetworkCredential
クライアントの ID を確立するために使用される NetworkCredential。
- binding
- ChannelBinding
拡張保護に使用する ChannelBinding。
- targetName
- String
認証するサーバーを一意に識別するサービス プリンシパル名 (SPN)。
- requiredProtectionLevel
- ProtectionLevel
ストリームのセキュリティ サービスを示す ProtectionLevel 値の 1 つ。
- allowedImpersonationLevel
- TokenImpersonationLevel
サーバーがクライアントの資格情報を使用してリソースにアクセスする方法を示す TokenImpersonationLevel 値の 1 つ。
例外
allowedImpersonationLevel は有効な値ではありません。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証に失敗しました。 このオブジェクトを使用して、認証を再試行できます。
認証が既に発生しました。
- または -
このストリームは、かつて、サーバーとして認証を行う目的で使用されていました。 ストリームを使用して、クライアントとして認証を再試行することはできません。
このオブジェクトは閉じられました。
注釈
このパラメーターを requiredProtectionLevel 使用して、認証済みストリームを使用して送信されるデータのセキュリティ サービスを要求します。 たとえば、データを暗号化して署名するには、値を指定します EncryptAndSign 。 認証が成功しても、要求された ProtectionLevel 認証が許可されたことは保証されません。 とプロパティをIsEncryptedIsSigned確認して、どのセキュリティ サービスが使用されているかを確認するNegotiateStream必要があります。
パラメーターでこのメソッドに渡される拡張保護にbinding使用される保護はChannelBinding、関連付けられているSslStreamプロパティからTransportContextアプリケーションによって取得されます。
認証に失敗した場合は、次の値をAuthenticationExceptionInvalidCredentialException受け取ります。 この場合は、別の資格情報で認証を再試行できます。