~drizzle-trunk/drizzle/development

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
.. _auth_http_plugin:

HTTP Authentication
===================

:program:`auth_http` is an authentication plugin that authenticates connections
using web-based HTTP authentication through a URL.  A web server is required
to provide authentication.  For example, see Apache's documentation
for `Authentication, Authorization and Access Control <http://httpd.apache.org/docs/2.0/howto/auth.html>`_.
Currently, SSL connections are not supported.

.. note::

   Unload the :doc:`/plugins/auth_all/index` plugin before using this plugin.

.. seealso:: :doc:`/administration/authentication` 

.. _auth_http_loading:

Loading
-------

To load this plugin, start :program:`drizzled` with::

   --plugin-add=auth_http

Loading the plugin may not enable or configure it.  See the plugin's
:ref:`auth_http_configuration` and :ref:`auth_http_variables`.

.. seealso:: :ref:`drizzled_plugin_options` for more information about adding and removing plugins.

.. _auth_http_configuration:

Configuration
-------------

These command line options configure the plugin when :program:`drizzled`
is started.  See :ref:`command_line_options` for more information about specifying
command line options.

.. program:: drizzled

.. option:: --auth-http.url ARG

   :Default: 
   :Variable: :ref:`auth_http_url <auth_http_url>`
   :Required: **This option must be specified**

   URL for http authentication (required).  If this plugin is loaded, then
   this option must be specified, else :program:`drizzled` will not start.

.. _auth_http_variables:

Variables
---------

These variables show the running configuration of the plugin.
See `variables` for more information about querying and setting variables.

.. _auth_http_url:

* ``auth_http_url``

   :Scope: Global
   :Dynamic: No
   :Option: :option:`--auth-http.url`

   URL for HTTP authentication.

.. _auth_http_examples:

Examples
--------

Sorry, there are no examples for this plugin.

.. _auth_http_authors:

Authors
-------

Mark Atwood

.. _auth_http_version:

Version
-------

This documentation applies to **auth_http 0.1**.

To see which version of the plugin a Drizzle server is running, execute:

.. code-block:: mysql

   SELECT MODULE_VERSION FROM DATA_DICTIONARY.MODULES WHERE MODULE_NAME='auth_http'

Chanagelog
----------

v0.1
^^^^
* First release.