<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/session.security.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'session.security.ini.php',
    1 => 'セッションに関連する INI 設定をセキュアにする',
    2 => 'セッションに関連する INI 設定をセキュアにする',
  ),
  'up' => 
  array (
    0 => 'session.security.php',
    1 => 'セッション と セキュリティ',
  ),
  'prev' => 
  array (
    0 => 'features.session.security.management.php',
    1 => 'セッション管理の基礎',
  ),
  'next' => 
  array (
    0 => 'ref.session.php',
    1 => 'セッション関数',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'reference/session/security.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="session.security.ini" class="sect1">
  <h2 class="title">セッションに関連する INI 設定をセキュアにする</h2>

  <p class="para">
   セッション関連のINI設定をセキュアにすることで、
   開発者はセッションのセキュリティを改善できます。
   重要な INI 設定であっても、推奨される設定がないものがあります。
   開発者にはセッションの設定を強固にする責任があります。
  </p>

  <ul class="itemizedlist">
    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.cookie-lifetime" class="link">session.cookie_lifetime</a>=0
     </p>
     <p class="para">
      <code class="literal">0</code> には特別な意味があります。
      これは、恒久的なストレージにクッキーを保存しないようブラウザに指示します。
      よって、ブラウザが終了した場合、セッションIDクッキーはすぐに削除されます。
      開発者がこの値を0以外にすると、他のユーザーがセッションIDを使うことを許す可能性があります。
      このため、ほとんどのWebアプリケーションは、&quot;<code class="literal">0</code>&quot; を使うべきです。
     </p>
     <p class="para">
      自動ログイン機能が必須の場合、
      開発者は自前のセキュアな自動ログイン機能を実装しなければなりません。
      この機能のために、有効期間が長いセッションIDを使ってはいけません。
      前のページの関連するセクションで、より多くの情報が見つかるかもしれません。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.use-cookies" class="link">session.use_cookies</a>=On
     </p>
     <p class="para">
      <a href="session.configuration.php#ini.session.use-only-cookies" class="link">session.use_only_cookies</a>=On
     </p>
     <p class="para">
      HTTP クッキーはいくつか問題を抱えていますが、
      クッキーはセッションIDを管理する手段として好ましい方法であり続けています。
      セッションIDの管理に、可能であればクッキーだけを使うようにしましょう。
      ほとんどのアプリケーションはセッションIDの管理にクッキーを使うべきです。
     </p>
     <p class="para">
      <a href="session.configuration.php#ini.session.use-only-cookies" class="link">session.use_only_cookies</a>=Off の場合、
      セッションモジュールは、たとえセッションIDクッキーが未初期化であっても、
      セッションIDが与えられた GET や POST によって設定されたものをセッションIDに使うようになります。 
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.use-strict-mode" class="link">session.use_strict_mode</a>=On
     </p>
     <p class="para">
      セッションをセキュアにするために
      <a href="session.configuration.php#ini.session.use-strict-mode" class="link">session.use_strict_mode</a> を有効にすることは必須ですが、
      デフォルトでは無効になっています。
     </p>
     <p class="para">
      有効にすることで、セッションモジュールが未初期化のセッションIDを使うことを防げます。
      別の言い方をすると、セッションモジュールは、
      セッションモジュールが生成した有効なセッションIDだけを受け入れるようになるということです。
      この設定は、ユーザーによって与えられたあらゆるセッションIDを拒否します。
     </p>
     <p class="para">
      Cookie の仕様によって、
      攻撃者はローカルにクッキーのデータベースを設定したり、
      JavaScriptインジェクションの脆弱性を突くことで、
      削除できないセッションIDクッキーを置くことが可能です。
      <a href="session.configuration.php#ini.session.use-strict-mode" class="link">session.use_strict_mode</a> によって、
      攻撃者が初期化したセッションIDが使われるのを防ぐことができます。
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       攻撃者は自分のデバイスでセッションIDを初期化し、
       ターゲットユーザーのセッションIDを設定するかもしれません。
       攻撃者は悪用するセッションIDをアクティブな状態に保たなければなりません。
       攻撃者はこのシナリオで攻撃を実行するには追加のステップが必要です。
       よって、<a href="session.configuration.php#ini.session.use-strict-mode" class="link">session.use_strict_mode</a> が軽減策として役に立つのです。
      </p>
     </p></blockquote>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.cookie-httponly" class="link">session.cookie_httponly</a>=On
     </p>
     <p class="para">
      セッションクッキーを JavaScript からアクセスさせることを拒否します。
      この設定によって、JavaScriptインジェクションによってクッキーを盗むことを防げます。
     </p>
     <p class="para">
      セッションIDをCSRFトークンとして使うことも可能ですが、
      推奨されません。たとえば、HTMLソースが保存され、他のユーザに送られることがあるからです。
      開発者は、セキュリティを向上させるため、セッションIDをWebサイトに出力すべきではありません。
      ほとんどのアプリケーションは、httponly 属性をセッションIDクッキーに設定しなければなりません。
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       CSRF トークンも、セッションIDと同じように定期的に更新すべきです。
      </p>
     </p></blockquote>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.cookie-secure" class="link">session.cookie_secure</a>=On
     </p>
     <p class="para">
      セッションIDクッキーを、プロトコルがHTTPSの場合にだけアクセスすることを許可します。
      website が HTTPS 経由でのみアクセス可能であるなら、この設定を有効にすべきです。
     </p>
     <p class="para">
      HTTPS 経由でのみアクセス可能なWebサイト向けに、HSTS も検討すべきです。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.cookie-samesite" class="link">session.cookie_samesite</a>=&quot;Lax&quot; または
      <a href="session.configuration.php#ini.session.cookie-samesite" class="link">session.cookie_samesite</a>=&quot;Strict&quot;
     </p>
     <p class="para">
      PHP 7.3 以降では、セッションIDクッキー向けに <code class="literal">&quot;SameSite&quot;</code> 属性が設定できます。
      この属性は、CSRF (Cross Site Request Forgery) 攻撃を軽減する手段です。
     </p>
     <p class="para">
      Lax と Strict の違いは、
      HTTP GETリクエストを使う別の登録可能なドメインへのリクエストに対して、クッキーへのアクセスを許可するかどうかです。
      Lax を使っているクッキーは別の登録可能なドメインへのGETリクエストからアクセス可能ですが、
      Strict を使っているクッキーはそうではありません。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.gc-maxlifetime" class="link">session.gc_maxlifetime</a>=[choose smallest possible]
     </p>
     <p class="para">
      <a href="session.configuration.php#ini.session.gc-maxlifetime" class="link">session.gc_maxlifetime</a>
      は期限切れのセッションIDを削除する設定です。
      この設定に依存することは推奨<em>しません</em>。
      開発者はタイムスタンプを使って、セッションの有効期間を自前で管理すべきです。
     </p>
     <p class="para">
      セッションGC(ガベージコレクション)は、
      <span class="function"><a href="function.session-gc.php" class="function">session_gc()</a></span> を使って行うのが最適です。
      <span class="function"><a href="function.session-gc.php" class="function">session_gc()</a></span> 関数は、タスクマネージャーを使って実行すべきです。
      たとえば、UNIXライクなシステムだと cron が挙げられます。
     </p>
     <p class="para">
      GC処理はデフォルトでは確率的に行われます。
      この設定は期限切れのセッションが削除されることを保証 <em>しません</em>。
      開発者はこの設定に依存することはできませんが、
      可能な限り最小の値を指定することを推奨します。
      <a href="session.configuration.php#ini.session.gc-probability" class="link">session.gc_probability</a>
      と <a href="session.configuration.php#ini.session.gc-divisor" class="link">session.gc_divisor</a> の値を、
      適切な頻度で期限切れのセッションが削除されるように調整してください。
      自動ログイン機能が必須の場合、開発者は自前のセキュアな自動ログイン機能を実装しなければなりません。
      詳細な情報は前のページを参照ください。
      自動ログイン機能のために、有効期限が長いセッションIDを絶対に使わないでください。
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       セッション保存ハンドラモジュールによっては、
       期限切れの処理を確率ベースで行うためにこの設定を使わないものもあります。
       たとえば memcached, memcache が挙げられます。
       詳細については、セッション保存ハンドラのドキュメントを参照ください。
      </p>
     </p></blockquote>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.use-trans-sid" class="link">session.use_trans_sid</a>=Off
     </p>
     <p class="para">
      透過的なセッションID管理を使うことは禁止されていません。
      開発者は必要な場合は採用しても構いません。
      しかし、透過的なセッションID管理を無効にすると、
      セッションIDインジェクションやリークの可能性が排除できるので、
      一般的なセッションIDのセキュリティを改善できます。
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       セッションIDは、ブックマークされたURLや、電子メールに埋め込まれたURLや、
       保存されたHTMLソースなどから漏れる可能性があります。
      </p>
     </p></blockquote>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.trans-sid-tags" class="link">session.trans_sid_tags</a>=[limited tags]
     </p>
     <p class="para">
      (PHP 7.1.0 &gt;=) 開発者は必要ないのにHTMLタグを書き換えるべきではありません。
      デフォルト値でほとんどの場合は十分です。古いPHPバージョンの場合は、
      <a href="outcontrol.configuration.php#ini.url-rewriter.tags" class="link">url_rewriter.tags</a> を代わりに使ってください。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.trans-sid-hosts" class="link">session.trans_sid_hosts</a>=[limited hosts]
     </p>
     <p class="para">
      (PHP 7.1.0 &gt;=) この INI 設定は、
      trans sid の書き換えを許可するホストをホワイトリスト形式で定義します。
      信頼できないホストを絶対に追加しないでください。
      セッションモジュールは、この設定が空の場合、
      <code class="literal">$_SERVER[&#039;HTTP_HOST&#039;]</code> だけを許可します。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.referer-check" class="link">session.referer_check</a>=[originating URL]
     </p>
     <p class="para">
      <a href="session.configuration.php#ini.session.use-trans-sid" class="link">session.use_trans_sid</a> が有効になっている場合、
      この設定はセッションIDインジェクションのリスクを減らします。
      website が <code class="literal">http://example.com/</code> の場合、
      <code class="literal">http://example.com/</code> を設定してください。
      HTTPS ブラウザはリファラヘッダを送信しないことに注意してください。
      ブラウザはリファラヘッダを設定によって送信しない可能性もあります。
      よって、この設定は信頼できるセキュリティ対策ではありませんが、
      この設定を使うことは推奨します。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.cache-limiter" class="link">session.cache_limiter</a>=nocache
     </p>
     <p class="para">
      HTTP コンテンツを認証済みのセッションに関してはキャッシュしないようにします。
      コンテンツがプライベートでない場合だけ、キャッシュを許可します。
      そうしない場合、コンテンツが外部に流出する可能性があります。
       <code class="literal">&quot;private&quot;</code> は、HTTPコンテンツがセキュリティに敏感なデータを含まない場合であれば採用しても構いません。
      <code class="literal">&quot;private&quot;</code> は、
      共有されたクライアントによってキャッシュされた、
      プライベートなデータを送信する可能性があることに注意してください。
      <code class="literal">&quot;public&quot;</code> は、
      HTTPコンテンツがプライベートなデータを一切含んでいない場合にのみ使わなければなりません。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.hash-function" class="link">session.hash_function</a>=&quot;sha256&quot;
     </p>
     <p class="para">
      (PHP 7.1.0 &lt;) より強いハッシュ関数は、より強いセッションIDを生成します。
      ハッシュの衝突が起こる可能性は、MD5 ハッシュアルゴリズムを使っても低いですが、
      開発者は SHA2 またはそれより強い sha384 や sha512 のようなハッシュアルゴリズムを使うべきです。
      開発者は、十分に長い
      <a href="session.configuration.php#ini.session.entropy-length" class="link">entropy</a>
      をハッシュ関数を使うときに必ず与えなければなりません。
     </p>
    </li>

    <li class="listitem">
     <p class="para">
      <a href="session.configuration.php#ini.session.save-path" class="link">session.save_path</a>=[どこからでも読み取り可能なディレクトリにしない]
     </p>
     <p class="para">
      この設定を <var class="filename">/tmp</var> (デフォルト) のようにどこか
      らでも読み込み可能なディレクトリに設定した場合、サーバー上
      の他のユーザーがこのディレクトリのファイルのリストを取得すること
      により、セッションをハイジャックをすることが可能となります。
     </p>
    </li>

  </ul>
 </div><?php manual_footer($setup); ?>