diff --git a/book/security.rst b/book/security.rst
index e60e581abc5..671e9373dac 100644
--- a/book/security.rst
+++ b/book/security.rst
@@ -1098,7 +1098,7 @@ Thanks to the SensioFrameworkExtraBundle, you can also secure your controller us
         // ...
     }
 
-For more information, see the 
+For more information, see the
 :doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/security>`.
 
 Securing other Services
@@ -2164,6 +2164,7 @@ Learn more from the Cookbook
 * :doc:`Blacklist users by IP address with a custom voter </cookbook/security/voters>`
 * :doc:`Access Control Lists (ACLs) </cookbook/security/acl>`
 * :doc:`/cookbook/security/remember_me`
+* :doc:`How to Restrict Firewalls to a Specific Host </cookbook/security/host_restriction>`
 
 .. _`FOSUserBundle`: https://github.com/FriendsOfSymfony/FOSUserBundle
 .. _`implement the \Serializable interface`: http://php.net/manual/en/class.serializable.php
diff --git a/cookbook/security/host_restriction.rst b/cookbook/security/host_restriction.rst
index 232f1cd5ff6..b5b2e529d95 100644
--- a/cookbook/security/host_restriction.rst
+++ b/cookbook/security/host_restriction.rst
@@ -5,7 +5,7 @@ How to Restrict Firewalls to a Specific Host
 ============================================
 
 .. versionadded:: 2.4
-    Support for restricting security firewalls to a specific host was added in
+    Support for restricting security firewalls to a specific host was introduced in
     Symfony 2.4.
 
 When using the Security component, you can create firewalls that match certain
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index bdaa387acc8..6a1d6c6ed67 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -13,6 +13,10 @@ Full Default Configuration
 The following is the full default configuration for the security system.
 Each part will be explained in the next section.
 
+.. versionadded:: 2.4
+    Support for restricting security firewalls to a specific host was introduced in
+    Symfony 2.4.
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -98,6 +102,8 @@ Each part will be explained in the next section.
                 # Examples:
                 somename:
                     pattern: .*
+                    # restrict the firewall to a specific host
+                    host: admin\.example\.com
                     request_matcher: some.service.id
                     access_denied_url: /foo/error403
                     access_denied_handler: some.service.id