IntranetZoneCredentialPolicy.ShouldSendCredential メソッド

.NET Framework クラス ライブラリ リファレンス

IntranetZoneCredentialPolicy.ShouldSendCredential メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

クライアントの資格情報が、WebRequest を使用して行われたリソース要求と共に送信されたかどうかを示す Boolean を返します。

名前空間: Microsoft.Win32
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ShouldSendCredential ( _
    challengeUri As Uri, _
    request As WebRequest, _
    credential As NetworkCredential, _
    authModule As IAuthenticationModule _
) As Boolean

Visual Basic (使用法)

Dim instance As IntranetZoneCredentialPolicy
Dim challengeUri As Uri
Dim request As WebRequest
Dim credential As NetworkCredential
Dim authModule As IAuthenticationModule
Dim returnValue As Boolean

returnValue = instance.ShouldSendCredential(challengeUri, request, credential, authModule)

C#

public virtual bool ShouldSendCredential (
    Uri challengeUri,
    WebRequest request,
    NetworkCredential credential,
    IAuthenticationModule authModule
)

C++

public:
virtual bool ShouldSendCredential (
    Uri^ challengeUri, 
    WebRequest^ request, 
    NetworkCredential^ credential, 
    IAuthenticationModule^ authModule
)

J#

public boolean ShouldSendCredential (
    Uri challengeUri, 
    WebRequest request, 
    NetworkCredential credential, 
    IAuthenticationModule authModule
)

JScript

public function ShouldSendCredential (
    challengeUri : Uri, 
    request : WebRequest, 
    credential : NetworkCredential, 
    authModule : IAuthenticationModule
) : boolean

パラメータ

challengeUri

要求を受け取る Uri。

request

要求中のリソースを表す WebRequest。

credential

このメソッドが true を返す場合、要求と共に送信される NetworkCredential。

authModule

認証が必要な場合、認証を行う IAuthenticationModule。

戻り値
要求されたリソースが、要求を行っているクライアントと同じドメインに存在する場合は true。それ以外の場合は false。

解説

アプリケーションはこのメソッドを直接呼び出しません。このメソッドは、サーバーとの認証を行う IAuthenticationModule によって呼び出されます。このメソッドが false を返した場合、IAuthenticationModule はサーバーに対してクライアントを認証しません。

このメソッドは、資格情報が指定されている要求、または資格情報を指定する WebProxy オブジェクトを使用する要求でのみ呼び出されます。

使用例

IntranetZoneCredentialPolicy から派生し、基本認証で HTTPS (Secure Hypertext Transfer Protocol) を使用する要求のために資格情報が送信されるようにするコード例を次に示します。HTTPS と基本認証を使用する場合、ユーザー パスワードは暗号化されてからネットワーク上で送信されます。

C#

// The following class allows credentials to be sent if they are for
 requests for resources
// in the same domain, or if the request uses the HTTPSscheme and basic
 authentication is 
// required.

       public class HttpsBasicCredentialPolicy:
 IntranetZoneCredentialPolicy
    {
        public HttpsBasicCredentialPolicy()
        {
        }
        
        public override bool ShouldSendCredential(Uri
 challengeUri, 
            WebRequest request, 
            NetworkCredential credential, 
            IAuthenticationModule authModule)
        {
            Console.WriteLine("Checking custom credential policy for
 HTTPS and basic.");
            bool answer = base.ShouldSendCredential(challengeUri,
 request, credential, authModule);

            if (answer == true)
            {
                Console.WriteLine("Sending credential for
 intranet resource.");
                return answer;
            }
            // Determine whether the base implementation returned false
 for basic and HTTPS.
            if (request.RequestUri.Scheme == Uri.UriSchemeHttps
 &&
                authModule.AuthenticationType == "Basic")
            {
                Console.WriteLine("Sending credential for
 HTTPS and basic.");
                return true;
            }
            return false;
        }
    }

C++

// The following class allows credentials to be sent if they are for
 requests for resources
// in the same domain, or if the request uses the HTTPSscheme and basic
 authentication is 
// required.
public ref class HttpsBasicCredentialPolicy:
 public IntranetZoneCredentialPolicy
{
public:
   HttpsBasicCredentialPolicy(){}

   virtual bool ShouldSendCredential( Uri^ challengeUri, WebRequest^
 request, NetworkCredential^ credential, IAuthenticationModule^ authModule ) override
   {
      Console::WriteLine( L"Checking custom credential policy for
 HTTPS and basic." );
      bool answer = IntranetZoneCredentialPolicy::ShouldSendCredential(
 challengeUri, request, credential, authModule );
      if ( answer == true )
      {
         Console::WriteLine( L"Sending credential for intranet
 resource." );
         return answer;
      }

      // Determine whether the base implementation returned false for
 basic and HTTPS.
      if ( request->RequestUri->Scheme == Uri::UriSchemeHttps
 && authModule->AuthenticationType->Equals( L"Basic" ) )
      {
         Console::WriteLine( L"Sending credential for HTTPS
 and basic." );
         return true;
      }

      return false;
   }
};

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IntranetZoneCredentialPolicy クラス
IntranetZoneCredentialPolicy メンバ
Microsoft.Win32 名前空間