AuthenticationService クラス

定義

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

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

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

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

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

こちらもご覧ください

• Windows Communication Foundation 認証サービスの概要