~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/administration/authentication.rst

  • Committer: Mark Atwood
  • Date: 2011-11-15 04:19:11 UTC
  • mfrom: (2457.1.1 drizzle-docs71-2)
  • Revision ID: me@mark.atwood.name-20111115041911-mwcqz8tvfze0sgbo
lp:~hingo/drizzle/7.1-docs-reviewfixes

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
==============
3
3
 
4
4
Authentication is any process by which you verify that someone is who they
5
 
claim they are. [1]_  Drizzle authentication is handled by plugins; there
6
 
are no grant or privilege tables.
7
 
 
8
 
One or more authentication plugin must be loaded, else no connections can
 
5
claim they are. [1]_  
 
6
 
 
7
Drizzle authentication is handled by plugins; by default there is no single
 
8
source where users are defined, such as a system user table, but each
 
9
authentication plugin will use different sources to verify the usernames
 
10
and passwords. (The plugin auth_schema does however keep users in a table inside
 
11
Drizzle, much like the familiar MySQL way of authenticating users works.). 
 
12
*Choosing an authentication plugin, configuring it, and disabling all other 
 
13
authentication plugins should be one of your first administrative tasks.*
 
14
 
 
15
One or more authentication plugins must be loaded, else no connections can
9
16
be made to Drizzle.  On most systems, the :doc:`/plugins/auth_all/index`
10
17
plugin is loaded by default which, as its name suggests, allows all
11
18
connections regardless of username or password.  (Some distributions enable
12
19
the :doc:`/plugins/auth_file/index` plugin by default instead).
13
20
 
14
 
`Choosing an authentication plugin, configuring it, and disabling all other
15
 
authentication plugins should be one of your first administrative tasks.`
 
21
The :doc:`/plugins/auth_schema/index` plugin first shipped with ``Drizzle 7.1 
 
22
Beta 2011.10.28``. This plugin provides an authentication method that is
 
23
both secure and easy to use, and it is similar to how MySQL authentication
 
24
works so will be familiar to many users. If you don't know which authentication
 
25
plugin to use, you should start with configuring 
 
26
:doc:`/plugins/auth_schema/index`. Likewise we warmly recommend distributors to
 
27
consider enabling this plugin by default.
16
28
 
17
29
The following authentication plugins are included with Drizzle:
18
30
 
19
 
* :doc:`/plugins/auth_all/index`
20
 
* :doc:`/plugins/auth_file/index`
21
 
* :doc:`/plugins/auth_http/index`
22
 
* :doc:`/plugins/auth_ldap/index`
23
 
* :doc:`/plugins/auth_pam/index`
24
 
* :doc:`/plugins/auth_schema/index`
 
31
* :doc:`/plugins/auth_all/index` - Allow all connections without checking username or password.
 
32
* :doc:`/plugins/auth_file/index` - Define users and passwords in a text file that is read on startup.
 
33
* :doc:`/plugins/auth_http/index` - Authenticate the username and password against a http server.
 
34
* :doc:`/plugins/auth_ldap/index` - Define users and passwords in a LDAP directory.
 
35
* :doc:`/plugins/auth_pam/index` - Authenticate the username and password against system user accounts via PAM.
 
36
* :doc:`/plugins/auth_schema/index` - Define users and passwords in a system table.
25
37
 
26
38
Protocols
27
39
---------
48
60
:ref:`auth_all_plugin`     Any
49
61
:ref:`auth_file_plugin`    mysql
50
62
:ref:`auth_http_plugin`    mysql-plugin-auth
51
 
:ref:`auth_ldap_plugin`    mysql-plugin-auth
 
63
:ref:`auth_ldap_plugin`    Any
52
64
:ref:`auth_pam_plugin`     mysql-plugin-auth
53
65
:ref:`auth_schema_plugin`  mysql
54
66
=========================  ==================