ルートで常に HTTPS を強制させる方法

サイトの作成時に、ルートのいくつかをセキュアにし、常に HTTPS プロトコルを介するようにしたいというときもあると思います。ルーティングコンポーネントは、_scheme の必須条件を介して HTTPS スキームを強制させることができます。

• YAML

  secure:
      pattern:  /secure
      defaults: { _controller: AcmeDemoBundle:Main:secure }
      requirements:
          _scheme:  https
  

• XML

  <?xml version="1.0" encoding="UTF-8" ?>
  
  <routes xmlns="http://symfony.com/schema/routing"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
  
      <route id="secure" pattern="/secure">
          <default key="_controller">AcmeDemoBundle:Main:secure</default>
          <requirement key="_scheme">https</requirement>
      </route>
  </routes>
  

• PHP

  use Symfony\Component\Routing\RouteCollection;
  use Symfony\Component\Routing\Route;
  
  $collection = new RouteCollection();
  $collection->add('secure', new Route('/secure', array(
      '_controller' => 'AcmeDemoBundle:Main:secure',
  ), array(
      '_scheme' => 'https',
  )));
  
  return $collection;
  

上記のコンフィギュレーションでは secure ルートに必ず HTTPS を使うようにしています。

secure URLを生成する際に、現在の通信プロトコルが HTTP であれば Symfony は自動的に HTTPS プロトコルを使用した絶対 URL を生成します。

# If the current scheme is HTTPS
{{ path('secure') }}
# generates /secure

# If the current scheme is HTTP
{{ path('secure') }}
# generates https://example.com/secure

この条件は、受け取ったリクエストにも強制化されます。もし HTTP で /secure パスにアクセスを試みると、 HTTPS プロトコルの同じ URL に自動的にリダイレクトされます。

上記の例では、_scheme に https を指定していますが、http と指定して、URLに HTTP プロトコルを強制させることもできます。

Note

セキュリティコンポーネントは、requires_channel 設定をすることでも HTTPS プロトコルを強制化することができます。この代替手段は /admin 以下の URL など、サイトの “一部分” をセキュアするのにより適しています。また、サードパーティのバンドルで定義された URL をセキュアにしたいときにも適しています。

< このページの翻訳はまだ行われていません。 デバッグするための開発環境に最適化する方法 >

• → 公式英語ドキュメント
• → 原文コミット履歴
• → 翻訳コミット履歴

翻訳の不備などは、お気軽にコメント欄にてご指摘ください。