summaryrefslogtreecommitdiff
path: root/docs/configuration-directives/WSGIAccessScript.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/configuration-directives/WSGIAccessScript.rst')
-rw-r--r--docs/configuration-directives/WSGIAccessScript.rst31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/configuration-directives/WSGIAccessScript.rst b/docs/configuration-directives/WSGIAccessScript.rst
new file mode 100644
index 0000000..a361a1a
--- /dev/null
+++ b/docs/configuration-directives/WSGIAccessScript.rst
@@ -0,0 +1,31 @@
+================
+WSGIAccessScript
+================
+
+:Description: Specify script implementing host access controls.
+:Syntax: ``WSGIAccessScript`` *path* [ *options* ]
+:Context: directory, .htaccess
+:Override: AuthConfig
+
+The ``WSGIAccessScript`` directive provides a mechanism for implementing
+host access controls.
+
+More detailed information on using the ``WSGIAccessScript`` directive
+can be found in :doc:`../user-guides/access-control-mechanisms`.
+
+The options which can be supplied to the ``WSGIAccessScript`` directive are:
+
+**application-group=name**
+
+ Specifies the name of the application group within the specified
+ process for which the script file will be loaded.
+
+ If the ``application-group`` option is not supplied, the special value
+ ``%{GLOBAL}`` which denotes that the script file be loaded within the
+ context of the first interpreter created by Python when it is
+ initialised will be used. Otherwise, will be loaded into the
+ interpreter for the specified application group.
+
+Note that the script always runs in processes associated with embedded
+mode. It is not possible to delegate the script such that it is run within
+context of a daemon process.