From e83c3a13b2b8533b7259ffe885bf95d711c3c526 Mon Sep 17 00:00:00 2001 From: Quentin Dufour Date: Tue, 31 Aug 2021 10:44:22 +0200 Subject: Add a README file --- README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..03a3fb2 --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +bagage +====== + +**This is a technical preview, use it a your own risk, expect bugs and missing features.** + +Bagage will be a service to access your documents everywhere. + +Currently, it is only a WebDAV to S3 proxy. +Later, it may propose a web interface and support synchronization with the Nextcloud client. + + +how it works +------------ + +bagage exposes a webdav endpoint behind an HTTP basic auth. +Credentials provided through basic auth are used to authenticate on the LDAP server, then 2 keys `garage_s3_access_key` and `garage_s3_secret_key` are fetched from the user's LDAP profile to authenticate against the S3 server. + +For now, these entries must be manually/externally added to the LDAP server prior using the service. + +configuration +------------- + +bagage is configured through environment variables. +You can get all the keys and their default values in the [config.go](https://git.deuxfleurs.fr/Deuxfleurs/bagage/src/branch/main/config.go#L9) file. + + +running it +---------- + +You need a S3 endpoint and a LDAP server running. +Once you correctly set your environment variables, you can simply run it: + +``` +go run . +``` + +docker +------- + +A simple dockerfile is proposed to build a binary if you want. + -- cgit v1.2.3