AuthenticationService クラス

リファレンス

定義

名前空間:: System.Web.ApplicationServices

アセンブリ:: System.Web.Extensions.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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	認証クッキーが設定されると発生します。

適用対象

こちらもご覧ください

Windows Communication Foundation Authentication Service の概要

次の方法で共有