diff --git a/CHANGES.rst b/CHANGES.rst
index e955db2..703e4fe 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,6 +1,23 @@
 repoze.workflow Changelog
 =========================
 
+1.0b2 (unreleased)
+------------------
+
+Features
+~~~~~~~~
+
+- Add ``repoze.workflow.has_permission`` since as of Pyramid 1.5 the
+  "pyramid.security.has_permission" API is now deprecated and it will
+  be removed in Pyramid 1.8
+
+Housekeeping
+~~~~~~~~~~~~
+
+- Update permission checker example in ``docs/configuration.rst``
+
+- Add mock library to test requirements
+
 1.0b1 (2014-12-11)
 ------------------
 
diff --git a/docs/configuration.rst b/docs/configuration.rst
index eed245e..ab3a121 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -64,7 +64,7 @@ workflow.
       state_attr="state"
       initial_state="private"
       content_types=".dummy.IContent"
-      permission_checker="repoze.bfg.security.has_permission"
+      permission_checker="repoze.workflow.has_permission"
       >
 
       <state name="private" 
diff --git a/repoze/workflow/__init__.py b/repoze/workflow/__init__.py
index 221beaa..97f4d99 100644
--- a/repoze/workflow/__init__.py
+++ b/repoze/workflow/__init__.py
@@ -1,3 +1,4 @@
+from repoze.workflow.security import has_permission # API
 from repoze.workflow.workflow import Workflow # API
 from repoze.workflow.workflow import WorkflowError #API
 from repoze.workflow.workflow import get_workflow #API
diff --git a/repoze/workflow/security.py b/repoze/workflow/security.py
new file mode 100644
index 0000000..3fa1752
--- /dev/null
+++ b/repoze/workflow/security.py
@@ -0,0 +1,5 @@
+def has_permission(permission, context, request):
+    """ Default permission checker """
+    return request.has_permission(
+        permission,
+        context=context)
diff --git a/repoze/workflow/tests/test_security.py b/repoze/workflow/tests/test_security.py
new file mode 100644
index 0000000..c3856d3
--- /dev/null
+++ b/repoze/workflow/tests/test_security.py
@@ -0,0 +1,20 @@
+import unittest
+
+
+class HasPermissionTests(unittest.TestCase):
+
+    def _get_has_permission(self):
+        from repoze.workflow import has_permission
+        return has_permission
+
+    def test_has_permission(self):
+        import mock
+        has_permission = self._get_has_permission()
+        permission = 'edit'
+        context = object()
+        request = mock.MagicMock()
+        has_permission(permission, context, request)
+        self.assertEqual(
+            request.has_permission.assert_called_once_with(
+                permission, context=context),
+            None)
diff --git a/setup.py b/setup.py
index cc70f7a..d4ef63e 100644
--- a/setup.py
+++ b/setup.py
@@ -41,6 +41,7 @@ def _read_file(name):
 
 tests_require = [
     'zope.testing',
+    'mock',
     ]
 
 testing_extras = tests_require + ['nose', 'coverage']