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 が設定されるときに発生します。認証 Cookie をカスタマイズするイベントの CreatingCookie イベントハンドラーを作成します。

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

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

コンストラクター

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 の概要