WebRequest.AuthenticationLevel プロパティ

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

WebRequest.AuthenticationLevel プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

この要求で使用する認証レベルおよび偽装レベルを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property AuthenticationLevel As
 AuthenticationLevel

Visual Basic (使用法)

Dim instance As WebRequest
Dim value As AuthenticationLevel

value = instance.AuthenticationLevel

instance.AuthenticationLevel = value

C#

public AuthenticationLevel AuthenticationLevel { get;
 set; }

C++

public:
property AuthenticationLevel AuthenticationLevel {
    AuthenticationLevel get ();
    void set (AuthenticationLevel value);
}

J#

/** @property */
public AuthenticationLevel get_AuthenticationLevel ()

/** @property */
public void set_AuthenticationLevel (AuthenticationLevel
 value)

JScript

public function get AuthenticationLevel
 () : AuthenticationLevel

public function set AuthenticationLevel
 (value : AuthenticationLevel)

プロパティ値
AuthenticationLevel 値のビットごとの組み合わせ。既定値は MutualAuthRequested です。 相互認証では、クライアントとサーバーの両方が、それらの身元を証明する資格情報を提供します。MutualAuthRequired と MutualAuthRequested は、Kerberos 認証に関連する値です。Kerberos 認証は、直接サポートすることも、Negotiate セキュリティ プロトコルを使用して実際のセキュリティ プロトコルを選択する場合に使用することもできます。認証プロトコルの詳細については、「インターネット認証」を参照してください。 相互認証が行われたかどうかを確認するには、WebResponse.IsMutuallyAuthenticated プロパティをチェックします。 MutualAuthRequired 認証フラグの値を指定していて相互認証が行われない場合、アプリケーションは、相互認証が失敗したことを示す ProtocolViolationException 内部例外を持つ IOException を受け取ります。

使用例

このプロパティの値を設定するコード例を次に示します。

C#

// The following example uses the System, System.Net, 
// and System.IO namespaces.

public static void RequestMutualAuth(Uri
 resource)
{
    // Create a new HttpWebRequest object for the specified resource.
    WebRequest request=(WebRequest) WebRequest.Create(resource);
    // Request mutual authentication.
   request.AuthenticationLevel = AuthenticationLevel.MutualAuthRequested;
    // Supply client credentials.
    request.Credentials = CredentialCache.DefaultCredentials;
    HttpWebResponse response = (HttpWebResponse) request.GetResponse();
    // Determine whether mutual authentication was used.
    Console.WriteLine("Is mutually authenticated? {0}", response.IsMutuallyAuthenticated);
    // Read and display the response.
    Stream streamResponse = response.GetResponseStream();
    StreamReader streamRead = new StreamReader(streamResponse);
    string responseString = streamRead.ReadToEnd();
   Console.WriteLine(responseString);
    // Close the stream objects.
    streamResponse.Close();
    streamRead.Close();
    // Release the HttpWebResponse.
    response.Close();
}

C++

// The following example uses the System, System.Net, 
// and System.IO namespaces.
static void RequestMutualAuth( Uri^ resource
 )
{
   // Create a new HttpWebRequest object for the specified resource.
   WebRequest^ request = dynamic_cast<WebRequest^>(WebRequest::Create( resource
 ));

   // Request mutual authentication.
   request->AuthenticationLevel = AuthenticationLevel::MutualAuthRequested;

   // Supply client credentials.
   request->Credentials = CredentialCache::DefaultCredentials;
   HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());

   // Determine whether mutual authentication was used.
   Console::WriteLine( L"Is mutually authenticated? {0}", response->IsMutuallyAuthenticated
 );

   // Read and display the response.
   Stream^ streamResponse = response->GetResponseStream();
   StreamReader^ streamRead = gcnew StreamReader( streamResponse );
   String^ responseString = streamRead->ReadToEnd();
   Console::WriteLine( responseString );

   // Close the stream objects.
   streamResponse->Close();
   streamRead->Close();

   // Release the HttpWebResponse.
   response->Close();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
WebRequest クラス
WebRequest メンバ
System.Net 名前空間