X-Git-Url: https://git.p6c8.net/jirafeau_project.git/blobdiff_plain/65aed7759f729985b7c802ccdbbb0c398a13427b..6d2f72029699314db90926f57861154ae76d3852:/README.md?ds=inline diff --git a/README.md b/README.md index 968f6a1..405185c 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ See [jirafeau.net](https://jirafeau.net/) for a demo. - Shows progression: speed, percentage and remaining upload time - Preview content in browser (if possible) - Optional password protection (for uploading or downloading) +- LDAP authentication for uploaders - Set expiration time for downloads - Option to self-destruct after first download - Shortened URLs using base 64 encoding @@ -210,6 +211,8 @@ Hint: To create a custom theme just copy the »courgette« folder and name your ### I found a bug, what should I do? Feel free to open a bug in the [GitLab's issues](https://gitlab.com/mojo42/Jirafeau/issues). +If you can, please copy-paste informations related to bug opening provided in admin interface. +Admin interface can be reached by accessing `/admin.php`. ### How to set maximum file size? @@ -271,7 +274,7 @@ Check [issues](https://gitlab.com/mojo42/Jirafeau/issues) to check open bugs and ### What about this file deduplication thing? -Jirafeau uses a very simple file level deduplication for storage optimization. +Jirafeau can use a very simple file level deduplication for storage optimization. This mean that if some people upload several times the same file, this will only store one time the file and increment a counter. @@ -281,17 +284,32 @@ When the counter falls to zero, the file is destroyed. In order to know if a newly uploaded file already exist, Jirafeau will hash the file using md5 by default but other methods are available (see `file_hash` documentation in `lib/config.original.php`). +This feature is disabled by default and can be enabled through the `file_hash` option. + ### What is the difference between "delete link" and "delete file and links" in admin interface? -As explained in the previous question, files with the same hash are not duplicated and a reference counter stores the number of links pointing to a single file. +When file deduplication feature is enabled, files with the same hash are not duplicated and a reference counter stores the number of links pointing to a single file. So: - The button "delete link" will delete the reference to the file but might not destroy the file. - The button "delete file and links" will delete all references pointing to the file and will destroy the file. +### How can I setup LDAP authentication? + +LDAP authentication is disabled by default. To use it, you will need to install [PHP LDAP extension](https://www.php.net/manual/en/book.ldap.php) and edit your `lib/config.local.php` to set those options: +- `upload_ldap_auth`: set it to `true` +- `upload_ldap_host`: set it to your ldap host +- `upload_ldap_base_dn`: set it to your base DN + +More details in [config.original.php](lib/config.original.php)'s documentation. + +Note that you can test around LDAP with [docker-compose example](./docker/docker-compose-examples/ldap/). + ### How to contact someone from Jirafeau? Feel free to create an issue if you found a bug. +Also, you can come have a chat on [libera.chat](https://web.libera.chat/) in `#jirafeau` channel. + ### Can I buy you a coffee? You can [drop few bucks](https://www.paypal.com/paypalme/jeromejutteau) to help the [demo web site](https://jirafeau.net) to stay alive.