CredentialCache.DefaultCredentials プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

CredentialCache.DefaultCredentials プロパティ

アプリケーションのシステム資格情報を取得します。

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

Visual Basic (宣言)

Public Shared ReadOnly Property
 DefaultCredentials As ICredentials

Visual Basic (使用法)

Dim value As ICredentials

value = CredentialCache.DefaultCredentials

public static ICredentials DefaultCredentials
 { get; }

C++

public:
static property ICredentials^ DefaultCredentials {
    ICredentials^ get ();
}

/** @property */
public static ICredentials get_DefaultCredentials
 ()

JScript

public static function get
 DefaultCredentials () : ICredentials

プロパティ値
アプリケーションのシステム資格情報を表す ICredentials。

解説

DefaultCredentials プロパティは、NTLM 認証、ネゴシエート認証、および Kerberos ベースの認証だけに適用されます。

DefaultCredentials は、アプリケーションが実行されている現在のセキュリティコンテキストのシステム資格情報を表します。クライアント側アプリケーションでは、通常、アプリケーションを実行しているユーザーの Windows 資格情報 (ユーザー名、パスワード、およびドメイン) です。ASP.NET アプリケーションでは、既定の資格情報は、ログインしているユーザーまたは偽装されているユーザーのユーザー資格情報です。

資格情報を NetworkCredential インスタンスとして取得するには、DefaultNetworkCredentials プロパティを使用します。

authType に使用できる値は、"NTLM"、"Digest"、"Kerberos"、および "Negotiate" です。このメソッドは、HTTP プロトコルおよび FTP プロトコルでは動作しません。

メモ
DefaultCredentials によって返される ICredentials インスタンスは、現在のセキュリティコンテキストのユーザー名、パスワード、またはドメインを表示するためには使用できません。

使用例

DefaultCredentials プロパティを使用して、アプリケーションのシステム資格情報を取得するコード例を次に示します。

Visual Basic

' Assuming "Windows Authentication" has been set as; 
' Directory Security settings for default web site in IIS.
Dim url As String = "http://localhost"
' Create a 'HttpWebRequest' object with the specified url. 
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(url),
 HttpWebRequest)
' Assign the credentials of the logged in user or the user being impersonated.
myHttpWebRequest.Credentials = CredentialCache.DefaultCredentials
' Send the 'HttpWebRequest' and wait for response.            
Dim myHttpWebResponse As HttpWebResponse =
 CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Console.WriteLine("Authentication successful")
Console.WriteLine("Response received successfully")

// Ensure Directory Security settings for default web site in IIS is
 "Windows Authentication".
string url = "http://localhost";
// Create a 'HttpWebRequest' object with the specified url. 
HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.Create(url); 
// Assign the credentials of the logged in user or the user being impersonated.
myHttpWebRequest.Credentials = CredentialCache.DefaultCredentials;
// Send the 'HttpWebRequest' and wait for response.            
HttpWebResponse myHttpWebResponse = (HttpWebResponse)myHttpWebRequest.GetResponse();
 
Console.WriteLine("Authentication successful");
Console.WriteLine("Response received successfully");

C++

// Ensure Directory Security settings for default web site in IIS is
 "Windows Authentication".
String^ url = "http://localhost";

// Create a 'HttpWebRequest' object with the specified url.
HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create(
 url ));

// Assign the credentials of the logged in user or the user being impersonated.
myHttpWebRequest->Credentials = CredentialCache::DefaultCredentials;

// Send the 'HttpWebRequest' and wait for response.
HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());
Console::WriteLine( "Authentication successful" );
Console::WriteLine( "Response received successfully" );

// Ensure Directory Security settings for default web site in IIS 
// is "Windows Authentication".
String url = "http://localhost";

// Create a 'HttpWebRequest' object with the specified url. 
HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.
    Create(url);

// Assign the credentials of the logged in user or the user being 
// impersonated.
myHttpWebRequest.set_Credentials(CredentialCache.
    get_DefaultCredentials());

// Send the 'HttpWebRequest' and wait for response.            
HttpWebResponse myHttpWebResponse 
    = (HttpWebResponse)myHttpWebRequest.GetResponse();

Console.WriteLine("Authentication successful");
Console.WriteLine("Response received successfully");