aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 03a3fb20ca40d462934187658c9685406977258c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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.