Mercurial > prosody-modules

comparison mod_http_upload_external/README.markdown @ 4509:16995e7624f0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_http_upload_external: add access control option
author Nicolas Cedilnik <nicoco@nicoco.fr>
date Sun, 14 Mar 2021 17:19:38 +0100
parents 5741e6511f3d
children c149edb37349
comparison
equal deleted inserted replaced
4508:0329cf8cdecb 4509:16995e7624f0
8 8
9 This module implements [XEP-0363], which lets clients upload files 9 This module implements [XEP-0363], which lets clients upload files
10 over HTTP to an external web server. 10 over HTTP to an external web server.
11 11
12 This module generates URLs that are signed using a HMAC. Any web service that can authenticate 12 This module generates URLs that are signed using a HMAC. Any web service that can authenticate
13 these URLs can be used. 13 these URLs can be used.
14 14
15 Implementations 15 Implementations
16 --------------- 16 ---------------
17 17
18 * [PHP implementation](https://hg.prosody.im/prosody-modules/raw-file/tip/mod_http_upload_external/share.php) 18 * [PHP implementation](https://hg.prosody.im/prosody-modules/raw-file/tip/mod_http_upload_external/share.php)
19 * [Python3+Flask implementation](https://github.com/horazont/xmpp-http-upload) 19 * [Python3+Flask implementation](https://github.com/horazont/xmpp-http-upload)
20 * [Go implementation, Prosody Filer](https://github.com/ThomasLeister/prosody-filer) 20 * [Go implementation, Prosody Filer](https://github.com/ThomasLeister/prosody-filer)
21 * [Perl implementation for nginx](https://github.com/weiss/ngx_http_upload) 21 * [Perl implementation for nginx](https://github.com/weiss/ngx_http_upload)
22 22
23 To implement your own service compatible with this module, check out the implementation notes below 23 To implement your own service compatible with this module, check out the implementation notes below
24 (and if you publish your implementation - let us know!). 24 (and if you publish your implementation - let us know!).
25 25
26 Configuration 26 Configuration
27 ============= 27 =============
28 28
68 ``` {.lua} 68 ``` {.lua}
69 http_upload_external_file_size_limit = 123 -- bytes 69 http_upload_external_file_size_limit = 123 -- bytes
70 ``` 70 ```
71 71
72 Default is 100MB (100\*1024\*1024). 72 Default is 100MB (100\*1024\*1024).
73
74 Access
75 ------
76
77 You may want to give upload access to additional entities such as components
78 by using the `http_upload_access` config option.
79
80 ``` {.lua}
81 http_upload_access = {"gateway.example.com"};
82 ```
73 83
74 Compatibility 84 Compatibility
75 ============= 85 =============
76 86
77 Works with Prosody 0.9.x and later. 87 Works with Prosody 0.9.x and later.