AuthenticationService クラス

  • リファレンス

定義

名前空間:
System.Web.ApplicationServices
アセンブリ:
System.Web.Extensions.dll

Web サービスを通じて ASP.NET フォーム認証にアクセスできるようにします。

public ref class AuthenticationService
[System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)]
[System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")]
[System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")]
public class AuthenticationService
[<System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)>]
[<System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")>]
[<System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")>]
type AuthenticationService = class
Public Class AuthenticationService
継承
Object
AuthenticationService
属性
AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

注釈

AuthenticationServiceオブジェクトを使用すると、Windows Communication Foundation (WCF) サービスを使用してユーザーを認証できます。 WCF 認証サービスは、ユーザー資格情報を格納する Web アプリケーションの外部にあるアプリケーションから ASP.NET メンバーシップを使用してユーザーを認証する必要がある場合に使用します。 アプリケーションは、SOAP 形式でメッセージを送信および使用できる必要があります。 クラスを使用すると、ユーザーの AuthenticationService ログイン、ユーザーのログアウト、資格情報の検証、認証状態の確認、認証のカスタマイズ、認証 Cookie の設定を行うことができます。

AuthenticationServiceクラスには、WCF サービスIsLoggedInを介してのみアクセスする必要がある 4 つのメソッド (、Login、Logout、 ValidateUser メソッド) が含まれています。 これらのメソッドを呼び出すには、Web サーバーで認証サービスを有効にしてから、WCF 互換クライアント アプリケーションを Web サービスに接続します。 認証サービスを構成する方法については、「 方法: WCF 認証サービスを有効にする」を参照してください。

ユーザーをログオンするには、ユーザー資格情報を メソッドに Login 渡します。 資格情報が有効な場合、クラスは AuthenticationService 認証 Cookie を作成します。 認証 Cookie の有効期限が切れていない場合は、ユーザーの資格情報が認証されており、資格情報をもう一度検証する必要はありません。 (Cookie レス認証は、 クラスでは AuthenticationService 使用できません。

ではAuthenticationService、 と CreatingCookieの 2 つのイベントAuthenticatingを発生させることができます。 このイベントは Authenticating 、ユーザーの資格情報が検証されるときに発生します。 イベントのイベント ハンドラーを作成して、 Authenticating ユーザー資格情報の検証方法をカスタマイズします。 このイベントは CreatingCookie 、ユーザーの資格情報の検証後に認証 Cookie が設定されているときに発生します。 イベントのイベント ハンドラーを CreatingCookie 作成して、認証 Cookie をカスタマイズします。

メソッドは ValidateUser ユーザーの資格情報の認証を確認しますが、認証チケットは返しません。 ユーザーが以前にログインしていて、新しいアプリケーション セッションの開始時に資格情報がまだ有効であることを確認する必要がある場合に使用 ValidateUser します。

コンソール アプリケーションから WCF 認証サービスを使用する例については、「 Walkthrough: Using ASP.NET Application Services」を参照してください。

コンストラクター

AuthenticationService()

AuthenticationService クラスの新しいインスタンスを初期化します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
IsLoggedIn()

現在のユーザーが認証されているかどうかを判断します。
Login(String, String, String, Boolean)

ユーザーの資格情報をチェックし、資格情報が有効な場合に認証チケット (クッキー) を作成します。
Logout()

ブラウザーで認証チケット (クッキー) を削除します。
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
ValidateUser(String, String, String)

ユーザーの資格情報を認証しますが、認証チケットは作成しません。

イベント

Authenticating

ユーザーの資格情報の妥当性が確認されると発生します。
CreatingCookie

認証クッキーが設定されると発生します。

適用対象

こちらもご覧ください