Add documentation and CHANGELOG entry to Application#verifier

2 files changed, 21 insertions, 0 deletions

diff --git a/railties/CHANGELOG.md b/railties/CHANGELOG.md
index 0eda858cca..a42e942f9b 100644
--- a/railties/CHANGELOG.md
+++ b/railties/CHANGELOG.md
@@ -1,3 +1,15 @@
+*   Add `Application#verifier` method to return a application's message verifier.
+
+    This verifier can be used to generate and verify signed messages in the application.
+
+        message = Rails.application.verifier.generate('my sensible data')
+        Rails.application.verifier.verify(message)
+        # => 'my sensible data'
+
+    See the `ActiveSupport::MessageVerifier` documentation to more information.
+
+    *Rafael Mendonça França*
+
 *   The [Spring application
     preloader](https://github.com/jonleighton/spring) is now installed
     by default for new applications. It uses the development group of
diff --git a/railties/lib/rails/application.rb b/railties/lib/rails/application.rb
index ccd97af655..320da8f100 100644
--- a/railties/lib/rails/application.rb
+++ b/railties/lib/rails/application.rb
@@ -158,6 +158,15 @@ module Rails
       end
     end
 
+    # Return the application's message verifier.
+    #
+    # This verify can be used to generate and verify signed messages in the application.
+    #
+    #     message = Rails.application.verifier.generate('my sensible data')
+    #     Rails.application.verifier.verify(message)
+    #     # => 'my sensible data'
+    #
+    # See the +ActiveSupport::MessageVerifier+ documentation to more information.
     def verifier
       @verifier ||= begin
         if config.respond_to?(:message_verifier_salt)