mongodbsessionbackend.rst 3.28 KB
Newer Older
1
2
3
4
5
6
7
MongoDB session backend
=======================

`Apache::Session::MongoDB <https://metacpan.org/pod/Apache::Session::MongoDB>`__
is a faster shareable session backend.


Maxime Besson's avatar
Maxime Besson committed
8
.. attention::
9
10
11
12
13
14
15
16
17
18
19
20
21
22

    Use an up-to-date version of Apache::Session::MongoDB, at least 1.8.1.

Setup
-----

Install and launch a `MongoDB server <https://www.mongodb.org/>`__.
Install
`Apache::Session::MongoDB <http://search.cpan.org/perldoc?Apache::Session::MongoDB>`__
Perl module (version ⩾ 0.15 required). You also need a recent version of
`Perl MongoDB
client <http://search.cpan.org/~mongodb/MongoDB-v1.2.2/>`__ (version ⩾
1.00 required).

23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
For Debian, you can install mongodb module and Apache::Session module with:

::

   apt install libmongodb-perl
   cpan Apache::Session::MongoDB

For CentOS:

::

   yum install perl-MongoDB
   cpan Apache::Session::MongoDB


38
39
40
41
42
43
44
In the manager: set
`Apache::Session::MongoDB <http://search.cpan.org/perldoc?Apache::Session::MongoDB>`__
in ``General parameters`` » ``Sessions`` » ``Session storage`` »
``Apache::Session module`` and add the following parameters (case
sensitive):

============================= ============================================================================================ ===============
Maxime Besson's avatar
Maxime Besson committed
45
46
Optional parameters
------------------------------------------------------------------------------------------------------------------------------------------
47
Name                          Comment                                                                                      Example
Maxime Besson's avatar
Maxime Besson committed
48
============================= ============================================================================================ ===============
49
50
51
52
**host**                      `MongoDB server URI <https://metacpan.org/pod/MongoDB::MongoClient#CONNECTION-STRING-URI>`__ 127.0.0.1:27017
**db_name**                   Session database (default: sessions)                                                         llconfdb
**collection**                Collection (default: sessions)                                                               sessions
**auth_mechanism**            Authentication mechanism                                                                     PLAIN
Maxime Besson's avatar
Maxime Besson committed
53
**auth_mechanism_properties**
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
**connect_timeout**           Connection timeout                                                                           10000
**ssl**                       Boolean or hash ref (default: 0)                                                             1
**username**                  Username to use to connect                                                                   lluser
**password**                  Password                                                                                     llpassword
============================= ============================================================================================ ===============

Advanced connection parameters (Replica Sets, timeouts...) may be
specified in the ``host`` parameter. `Refer to the perl MongoDB
documentation for
details <https://metacpan.org/pod/MongoDB::MongoClient#CONNECTION-STRING-URI>`__

Security
--------

Restrict network access to the MongoDB server. For remote servers, you
can use :doc:`SOAP session backend<soapsessionbackend>` in cunjunction
to increase security for remote server that access through an unsecure
network