Mercurial > prosody-modules
annotate mod_storage_s3/README.md @ 6319:04c3273cb81f
mod_auth_cyrus: Add empty 'profile' table to SASL handler objects
This is for compatibility with Prosody's built-in util.sasl objects.
A SASL profile table usually includes methods supported by the backend, which
can be used by SASL mechanism handlers to perform operations (such as testing
the password). It also optionally contains a 'cb' field with channel binding
method handlers.
The Cyrus backend doesn't support channel binding, and doesn't have the same
concept of auth backend methods (it handles all that internally, and Prosody
has no insight or control over it).
Thus, we create an empty profile which informs Prosody that the SASL handler
does not support any of the auth or channel binding methods. Some features
will not work, but they didn't work anyway. This just makes it explicit.
This fixes a traceback in mod_sasl2_fast, which expected SASL handlers to
always contain a 'profile' field.
| author | Matthew Wild <mwild1@gmail.com> |
|---|---|
| date | Thu, 04 Sep 2025 10:14:46 +0100 |
| parents | 476717ab3cd9 |
| children |
| rev | line source |
|---|---|
| 5677 | 1 --- |
| 2 labels: | |
| 3 - 'Stage-Alpha' | |
| 4 summary: Cloud Native Storage | |
| 5 ... | |
| 6 | |
| 7 ::: {.alert .alert-danger} | |
| 8 This storage driver is fully async and requires that all storage access happens in an async-compatible context. As of 2023-10-14 this work in Prosody | |
| 9 is not yet complete. For now, this module is primarily suited for testing and finding areas where async work is incomplete. | |
| 10 ::: | |
| 11 | |
|
6112
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5677
diff
changeset
|
12 ::: {.alert .alert-danger} |
|
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5677
diff
changeset
|
13 The data layout in S3 is not final and may change at any point in incompatible ways. |
|
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5677
diff
changeset
|
14 ::: |
|
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5677
diff
changeset
|
15 |
| 5677 | 16 This module provides storage in Amazon S3 compatible things. It has been tested primarily with MinIO. |
| 17 | |
| 18 ``` lua | |
| 19 s3_bucket = "prosody" | |
| 20 s3_base_uri = "http://localhost:9000" | |
| 21 s3_region = "us-east-1" | |
| 22 s3_access_key = "YOUR-ACCESS-KEY-HERE" | |
| 23 s3_secret_key = "YOUR-SECRET-KEY-HERE" | |
| 24 ``` |
