UrlAuthorizationModule クラス

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

UrlAuthorizationModule クラス

ユーザーが要求している URL にアクセスするためのアクセス許可を持っているかどうかを検証します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 UrlAuthorizationModule
    Implements IHttpModule

Visual Basic (使用法)

Dim instance As UrlAuthorizationModule

C#

public sealed class UrlAuthorizationModule
 : IHttpModule

C++

public ref class UrlAuthorizationModule sealed
 : IHttpModule

J#

public final class UrlAuthorizationModule implements
 IHttpModule

JScript

public final class UrlAuthorizationModule implements
 IHttpModule

解説

UrlAuthorizationModule は、現在のユーザーの Name またはユーザーが属すロールの一覧に基づいて、そのユーザーが要求している URL にアクセスできるかどうかを決定します。ユーザー名が決定される方法については、「ASP.NET の認証」を参照してください。ユーザーのロールを管理する方法については、「ロールを使用した承認の管理」を参照してください。

ユーザーまたはロールの承認は、authorization 構成要素を使用して管理されます。それぞれ allow または deny の各サブ要素を使用して、ユーザーまたはロールのアクセスが許可または拒否されます。allow と deny の各サブ要素は、構成ファイル内に現れる順番で解釈されます。ある要素がいったんアクセスを許可または拒否されると、そこで UrlAuthorizationModule の承認チェックは完了します。たとえば、次の Web.config ファイルの authorization セクションでは、匿名ユーザーのアクセスを拒否することによってユーザーにログオンを要求し、Administrators ロールのユーザーのみにアクセスを許可しています。Administrators ロール以外のユーザーは拒否されます。

<authorization>
  <deny users="?" />
  <allow roles="Administrators" />
  <deny users="*" />
</authorization>

URL に対するユーザーまたはロールのアクセスを拒否するには、そのユーザーまたはロールを明確に拒否する必要があります。つまり、前の例で <deny users="*" /> 要素と指定していなかった場合、認証されたユーザーは全員そのロールに関係なく、要求する URL にアクセスできることになります。

使用例

Kim と Admins ロールのメンバにはアクセスを許可し、John とすべての匿名ユーザーにはアクセスを拒否するコード例を次に示します。

<authorization>
  <allow users="Kim"/>
  <allow roles="Admins"/>
  <deny users="John"/>
  <deny users="?"/>
</authorization>

継承階層

System.Object
  System.Web.Security.UrlAuthorizationModule

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UrlAuthorizationModule メンバ
System.Web.Security 名前空間
その他の技術情報
ASP.NET の承認