Skip to content

Commit 516312b

Browse files
committed
Docs: note auth header must be passed through WSGI for webhooks
(See #69.)
1 parent beec6e8 commit 516312b

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/installation.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,9 +166,16 @@ to :ref:`configure an Anymail backend <backend-configuration>`, and then:
166166
If so, you'll need to deploy your Django project to your live server before you
167167
can complete this step.
168168

169+
Some WSGI servers may need additional settings to pass HTTP authorization headers
170+
through to Django. For example, Apache with `mod_wsgi`_ requires
171+
`WSGIPassAuthorization On`, else Anymail will complain about "missing or invalid
172+
basic auth" when your webhook is called.
173+
169174
See :ref:`event-tracking` for information on creating signal handlers and the
170175
status tracking events you can receive.
171176

177+
.. _mod_wsgi: http://modwsgi.readthedocs.io/en/latest/configuration-directives/WSGIPassAuthorization.html
178+
172179

173180
.. setting:: ANYMAIL
174181

0 commit comments

Comments
 (0)