Mercurial > prosody-modules
view mod_client_management/README.md @ 5305:9b9f35aaeb91
mod_client_management: Add support for revocation of clients (when possible)
We decided to keep the unified listing of "clients", which includes both SASL2
clients and OAuth grants, etc. To a user, or someone wanting to manage what
can access their account, they are largely equivalent.
To accomplish this technically, we add a prefix to the id to state what type
it really is.
author | Matthew Wild <mwild1@gmail.com> |
---|---|
date | Wed, 05 Apr 2023 19:42:16 +0100 |
parents | 385346b6c81d |
children | 7c123d3285de |
line wrap: on
line source
--- labels: - Stage-Beta summary: "Manage clients with access to your account" rockspec: dependencies: - mod_sasl2_fast --- This module allows a user to identify what currently has access to their account. This module depends on [mod_sasl2_fast] and mod_tokenauth (bundled with Prosody). Both will be automatically loaded if this module is loaded. ## Configuration | Name | Description | Default | |---------------------------|--------------------------------------------------------|-----------------| | enforce_client_ids | Only allow SASL2-compatible clients | `false` | When `enforce_client_ids` is not enabled, the client listing may be less accurate due to legacy clients, which can only be tracked by their resource, which is public information, not necessarily unique to a client instance, and is also exposed to other XMPP entities the user communicates with. When `enforce_client_ids` is enabled, clients that don't support SASL2 and provide a client id will be denied access. ## Compatibility Requires Prosody trunk (as of 2023-03-29). Not compatible with Prosody 0.12 and earlier.