prosody-modules
045abdc53ba4
mod_sasl2/README.md

Find changesets by keywords by author, files, the commit message, revision number or hash, or revset expression.

Software / code / prosody-modules

File

mod_sasl2/README.md @ 6149:045abdc53ba4

mod_sasl2: Reset SASL handler after failed authentication mod_saslauth already does this, and we should be too. It allows re-attempting authentication after failure.
author Matthew Wild <mwild1@gmail.com>
date Thu, 16 Jan 2025 15:44:24 +0000
parent 6061:26bfcb442138
line wrap: on
line source

---
labels:
- Stage-Beta
summary: "XEP-0388: Extensible SASL Profile"
---

Implementation of [XEP-0388: Extensible SASL Profile]. 

## Configuration

This module honours the same configuration options as Prosody's existing
[mod_saslauth](https://prosody.im/doc/modules/mod_saslauth).

## Developers

mod_sasl2 provides some events you can hook to affect aspects of the
authentication process:

- `advertise-sasl-features`
- `sasl2/c2s/success`
  - Priority 1000: Session marked as authenticated, success response created (`event.success`)
  - Priority -1000: Success response sent to client
  - Priority -1500: Updated <stream-features/> sent to client
- `sasl2/c2s/failure`
- `sasl2/c2s/error`

# Compatibility

This module requires Prosody **trunk** and is not compatible with 0.12 or older versions.


     Prosody Version           Status
  -----------------------  ----------------
  trunk as of 2024-11-24   Works
  0.12                     Does not work
  -----------------------  ----------------