documentation:2.0:mongodbsessionbackend
Keywords: documentation,2.0,mongodbsessionbackend

# MongoDB session backend

Apache::Session::MongoDB is a faster shareable session backend.

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

## Setup

Install and launch a MongoDB server. Install Apache::Session::MongoDB Perl module (version ⩾ 0.15 required). You also need a recent version of Perl MongoDB client (version ⩾ 1.00 required).

In the manager: set Apache::Session::MongoDB in `General parameters` » `Sessions` » `Session storage` » `Apache::Session module` and add the following parameters (case sensitive):

Optional parameters
Name | Comment | Example
--- | --- | ---
host | MongoDB server (default: 127.0.0.1:27017) | 127.0.0.1:27017
db_name | Session database (default: sessions) | llconfdb
collection | Collection (default: sessions) | sessions
auth_mechanism | Authentication mechanism | PLAIN
auth_mechanism_properties |  |
connect_timeout | Connection timeout | 10000
ssl | Boolean or hash ref (default: 0) | 1
username | Username to use to connect | lluser
password | Password | llpassword

## Security

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