mod_auth_phpbb3/README.markdown
author Matthew Wild <mwild1@gmail.com>
Thu, 07 Dec 2023 15:46:50 +0000
changeset 5791 e79f9dec35c0
parent 2172 28d99ffa3c06
permissions -rw-r--r--
mod_c2s_conn_throttle: Reduce log level from error->info Our general policy is that "error" should never be triggerable by remote entities, and that it is always about something that requires admin intervention. This satisfies neither condition. The "warn" level can be used for unexpected events/behaviour triggered by remote entities, and this could qualify. However I don't think failed auth attempts are unexpected enough. I selected "info" because it is what is also used for other notable session lifecycle events.

---
labels:
- 'Stage-Alpha'
- 'Type-Auth'
summary: PHPBB3 authentication module
...

Introduction
============

This module allows you to authenticate against an PHPBB3 database.

To support the `bcrypt` password hashing algorithm, install
[bcrypt](https://luarocks.org/modules/mikejsavage/bcrypt) from luarocks:

    luarocks install bcrypt

Configuration
=============

SQL connection paramaters are identical to those of [SQL
storage](https://prosody.im/doc/modules/mod_storage_sql).

    authentication = "phpbb3"
    sql = { -- See documentation for SQL storage
        driver = "MySQL";
        database = "phpbb3";
        host = "localhost";
        username = "prosody";
        password = "secretpassword";
    }

Compatibility
=============

Prosody 0.8+