<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFLOGIN</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="説明">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFLOGIN</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">説明</span>
<p>
ユーザーログインと認証コードのためのコンテナです。ユーザーがまだログインしていない場合に、このタグ内のコードが実行されます。このタグ内には、ユーザーを認証し、そのユーザーのロールを識別するためのコードを記述します。cfloginuser タグと共に使用します。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">カテゴリ</span>
<p>
セキュリティタグ
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">シンタックス</span><pre>&lt;cflogin
   idletimeout = &quot;value&quot;
   applicationToken = &quot;token&quot;
   cookieDomain = &quot;domain&quot;
   ...
   &lt;cfloginuser 
      name = &quot;name&quot;
      password = &quot;password-string&quot;
      roles = &quot;roles&quot;&gt;
   ...&gt;
&lt;/cflogin&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">関連項目</span>
<p>
cfloginuser、cflogout、GetAuthUser、IsUserInRole、『ColdFusion MX 開発ガイド』の第16章の「アプリケーションの保護」 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">ヒストリ</span>
<p>
ColdFusion MX&#160;6.1: 動作が変更されました。ColdFusion が NTLM 認証情報またはダイジェスト (CFHTTP Negotiated ヘッダ) 認証情報を含むリクエストを受け取るときは、cflogin 変数が存在します。
</p>

<p>
ColdFusion&#160;MX: このタグが追加されました。
</p>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">使用方法</span>
<p>
このタグの本文は、ログインしているユーザーがいない場合にのみ実行されます。アプリケーションベースのセキュリティを使用する場合は、cflogin タグの本文に、ユーザーが指定した ID とパスワードをログイン ID のデータソース、LDAP ディレクトリ、またはその他のレポジトリと対照して確認するためのコードを挿入します。タグ本文には cfloginuser タグを指定して、認証済みユーザーを ColdFusion に識別させる必要があります。
</p>

<p>
ユーザーはデータソースを制御し、cflogin タグ内の SQL のコーディングを担当します。また、関連付けられたデータベースにユーザー、パスワード、およびロールに関する情報があるようにしなければなりません。
</p>

<p>
cflogin タグは、そのページが次のいずれかに対するレスポンスとして実行されている場合には、cflogin.name と cflogin.password という 2 つの変数から成るビルトインの cflogin 構造体を含んでいます。
</p>
<ul>

<li>j_username および j_password という名前の入力フィールドを含むフォームの送信。</li>

<li>CFHTTP 基本認証を使用し、ユーザー名とパスワードが入っている認証ヘッダを含むリクエスト。</li>

<li>NTLM またはダイジェスト認証を使用するリクエスト。この場合、ユーザー名とパスワードは Authorization ヘッダの一方向アルゴリズムでハッシュされます。ColdFusion は Web サーバーからユーザー名を取得し、cflogin.password 値に空の文字列を設定します。</li>
</ul>

<p>
これらの値は、cflogin タグの本文内でユーザーを認証するために使用され、さらに cfloginuser タグ内でユーザーをログインさせるために使用されます。この構造体は cflogin タグ本文内でのみ使用できます。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">例</span>
<p>
次の例は、簡単な認証を示しています。このコードは、通常は Application.cfc の onRequestStart メソッドまたは application.cfm ページに置かれます。
</p>
<pre>&lt;cflogin&gt;
   &lt;cfif NOT IsDefined(&quot;cflogin&quot;)&gt;
      &lt;cfinclude template=&quot;loginform.cfm&quot;&gt;
      &lt;cfabort&gt;
   &lt;cfelse&gt;
      &lt;cfif cflogin.name eq &quot;admin&quot;&gt;
         &lt;cfset roles = &quot;user,admin&quot;&gt;
      &lt;cfelse&gt;
            &lt;cfset roles = &quot;user&quot;&gt;
      &lt;/cfif&gt;
      &lt;cfloginuser name = &quot;#cflogin.name#&quot; password = &quot;#cflogin.password#&quot;
         roles = &quot;#roles#&quot; /&gt;
   &lt;/cfif&gt;
&lt;/cflogin&gt;
</pre>
<p>
次の参照専用の例では、ユーザー ID とパスワードをデータソースと対照して確認します。
</p>
<pre>&lt;cfquery name=&quot;qSecurity&quot;
   datasource=&quot;UserRolesDb&quot;&gt;
   SecurityRoles からロールを選択
   where username=&lt;cfqueryparam value=&quot;#cflogin.name#&quot;
      CFSQLTYPE=&quot;CF_SQL_VARCHAR&quot;
   and password=&lt;cfqueryparam value=&quot;#cflogin.password#&quot;
      CFSQLTYPE=&quot;CF_SQL_VARCHAR&quot;
&lt;/cfquery&gt;

&lt;cfif qSecurity.recordcount gt 0&gt;
&lt;cfloginuser name = &quot;#cflogin.name#&quot;
password = &quot;#cflogin.password#&quot;
roles = &quot;#trim(qSecurity.Roles)#&quot; &gt;
&lt;/cfif&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="IDLETIMEOUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">IDLETIMEOUT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "1800"


<p>ColdFusion がユーザーをログオフさせることになるまでの待機時間 (秒単位) です。</p>

  </td>
  </tr>
  </table>
</div>
<div id="APPLICATIONTOKEN">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">APPLICATIONTOKEN</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "現在のアプリケーション名"


<p>固有のアプリケーション ID を指定します。cfapplication タグまたは &quot;Application.cfc&quot; ファイルでの指定どおりに、ログインの有効性を 1 つのアプリケーションに制限します。</p>

  </td>
  </tr>
  </table>
</div>
<div id="COOKIEDOMAIN">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">COOKIEDOMAIN</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ユーザーがログインしていることを示すために使われる Cookie のドメインです。この属性を使うことで、ユーザーのログイン Cookie を同じドメイン内の複数のクラスタサーバーで使用できるようにします。</p>

  </td>
  </tr>
  </table>
</div>

  </body>
</html>
