Web-UI op :8080, beheer-API met volledige pariteit, bediening vanuit BlueGit, meerdere backup servers per BlueGit
- Eén actielijst stuurt API-routes, UI-formulieren en BlueGit-proxy aan - Instellingen live aanpasbaar (settings.yml boven config.yml) - Login met sessie + CSRF, rate limit op mislukte logins - CLI: config, set, disconnect, delete, rollback, actions, token - Integratietests tegen een echte BlueGit voor UI, API, pariteit en multi-instance
@@ -12,6 +12,7 @@ import (
12
12
"log/slog"
13
13
"net"
14
14
"net/http"
15
"net/url"
15
16
"os"
16
17
"os/signal"
17
18
"strings"
@@ -32,6 +33,13 @@ func usage() {
32
33
bluegit-backup archive [--config …] nu een archief maken
33
34
bluegit-backup sync [--config …] nu synchroniseren
34
35
bluegit-backup prune [--config …] bewaarregels nu toepassen
36
bluegit-backup config [--config …] instellingen tonen
37
bluegit-backup set [--config …] sleutel=waarde … instellingen wijzigen
38
bluegit-backup delete [--config …] ARCHIEF
39
bluegit-backup rollback [--config …] ARCHIEF (vraagt om de naam over te typen)
40
bluegit-backup disconnect [--config …]
41
bluegit-backup actions [--config …] alle API-acties
42
bluegit-backup token [--config …] het beheertoken voor de webinterface
35
43
bluegit-backup example-config
36
44
bluegit-backup version
37
45
@@ -60,6 +68,22 @@ func main() {
60
68
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/sync")
61
69
case "prune":
62
70
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/prune")
71
case "config":
72
err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/config")
73
case "set":
74
err = setConfig(os.Args[2:])
75
case "disconnect":
76
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/disconnect")
77
case "delete":
78
err = withName(os.Args[2:], func(c *client, name string) (int, []byte, error) {
79
return c.do(http.MethodDelete, "/api/v1/admin/archives/"+url.PathEscape(name), nil)
80
})
81
case "rollback":
82
err = rollback(os.Args[2:], os.Stdin, os.Stdout)
83
case "actions":
84
err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/actions")
85
case "token":
86
err = printToken(os.Args[2:])
63
87
case "example-config":
64
88
fmt.Print(config.Example())
65
89
case "version":
@@ -102,6 +126,7 @@ func serve(args []string) error {
102
126
}
103
127
ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
104
128
defer stop()
129
cfg = srv.Cfg // met settings.yml
105
130
ln, err := net.Listen("tcp", cfg.Listen)
106
131
if err != nil {
107
132
return err
@@ -130,6 +155,9 @@ func newClient(cfgPath string) (*client, error) {
130
155
if err != nil {
131
156
return nil, err
132
157
}
158
if set, err := config.LoadSettings(cfg.DataDir); err == nil {
159
_ = cfg.Apply(set)
160
}
133
161
tok, err := server.ReadAdminToken(cfg.DataDir)
134
162
if err != nil {
135
163
return nil, fmt.Errorf("admin.token lezen (draai als de gebruiker van de dienst of root): %w", err)
@@ -162,6 +190,90 @@ func (c *client) do(method, p string, in any) (int, []byte, error) {
162
190
return resp.StatusCode, b, nil
163
191
}
164
192
193
func printResult(code int, b []byte) error {
194
var pretty bytes.Buffer
195
if json.Indent(&pretty, b, "", " ") == nil {
196
b = pretty.Bytes()
197
}
198
fmt.Println(strings.TrimSpace(string(b)))
199
if code >= 300 {
200
return fmt.Errorf("HTTP %d", code)
201
}
202
return nil
203
}
204
205
func setConfig(args []string) error {
206
fs := flag.NewFlagSet("set", flag.ExitOnError)
207
cfgPath := fs.String("config", "", "pad naar config.yml")
208
_ = fs.Parse(args)
209
set := map[string]string{}
210
for _, kv := range fs.Args() {
211
k, v, ok := strings.Cut(kv, "=")
212
if !ok {
213
return fmt.Errorf("verwacht sleutel=waarde, kreeg %q", kv)
214
}
215
set[k] = v
216
}
217
if len(set) == 0 {
218
return fmt.Errorf("geef minstens één sleutel=waarde")
219
}
220
c, err := newClient(*cfgPath)
221
if err != nil {
222
return err
223
}
224
code, b, err := c.do(http.MethodPut, "/api/v1/admin/config", set)
225
if err != nil {
226
return err
227
}
228
return printResult(code, b)
229
}
230
231
func withName(args []string, f func(c *client, name string) (int, []byte, error)) error {
232
fs := flag.NewFlagSet("cmd", flag.ExitOnError)
233
cfgPath := fs.String("config", "", "pad naar config.yml")
234
_ = fs.Parse(args)
235
if fs.NArg() != 1 {
236
return fmt.Errorf("geef precies één archiefnaam")
237
}
238
c, err := newClient(*cfgPath)
239
if err != nil {
240
return err
241
}
242
code, b, err := f(c, fs.Arg(0))
243
if err != nil {
244
return err
245
}
246
return printResult(code, b)
247
}
248
249
func rollback(args []string, stdin io.Reader, stdout io.Writer) error {
250
return withName(args, func(c *client, name string) (int, []byte, error) {
251
fmt.Fprintln(stdout, "LET OP: een rollback vervangt alle gegevens van BlueGit door dit archief en kan niet ongedaan worden gemaakt.")
252
fmt.Fprint(stdout, "Typ de archiefnaam over om door te gaan: ")
253
line, _ := bufio.NewReader(stdin).ReadString('\n')
254
if strings.TrimSpace(line) != name {
255
return 0, nil, fmt.Errorf("afgebroken; er is niets veranderd")
256
}
257
return c.do(http.MethodPost, "/api/v1/admin/rollback", map[string]string{"archive": name, "confirm": name})
258
})
259
}
260
261
func printToken(args []string) error {
262
fs := flag.NewFlagSet("token", flag.ExitOnError)
263
cfgPath := fs.String("config", "", "pad naar config.yml")
264
_ = fs.Parse(args)
265
cfg, err := config.Load(configPath(*cfgPath))
266
if err != nil {
267
return err
268
}
269
tok, err := server.ReadAdminToken(cfg.DataDir)
270
if err != nil {
271
return fmt.Errorf("admin.token niet leesbaar (start de server eerst, en draai als de gebruiker bluegit-backup): %w", err)
272
}
273
fmt.Println(tok)
274
return nil
275
}
276
165
277
func simple(args []string, method, p string) error {
166
278
fs := flag.NewFlagSet("cmd", flag.ExitOnError)
167
279
cfgPath := fs.String("config", "", "pad naar config.yml")
@@ -12,6 +12,7 @@ import (12
"log/slog"12
"log/slog"13
"net"13
"net"14
"net/http"14
"net/http"15
"net/url"15
"os"16
"os"16
"os/signal"17
"os/signal"17
"strings"18
"strings"@@ -32,6 +33,13 @@ func usage() {32
bluegit-backup archive [--config …] nu een archief maken33
bluegit-backup archive [--config …] nu een archief maken33
bluegit-backup sync [--config …] nu synchroniseren34
bluegit-backup sync [--config …] nu synchroniseren34
bluegit-backup prune [--config …] bewaarregels nu toepassen35
bluegit-backup prune [--config …] bewaarregels nu toepassen36
bluegit-backup config [--config …] instellingen tonen37
bluegit-backup set [--config …] sleutel=waarde … instellingen wijzigen38
bluegit-backup delete [--config …] ARCHIEF39
bluegit-backup rollback [--config …] ARCHIEF (vraagt om de naam over te typen)40
bluegit-backup disconnect [--config …]41
bluegit-backup actions [--config …] alle API-acties42
bluegit-backup token [--config …] het beheertoken voor de webinterface35
bluegit-backup example-config43
bluegit-backup example-config36
bluegit-backup version44
bluegit-backup version37
45
@@ -60,6 +68,22 @@ func main() {60
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/sync")68
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/sync")61
case "prune":69
case "prune":62
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/prune")70
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/prune")71
case "config":72
err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/config")73
case "set":74
err = setConfig(os.Args[2:])75
case "disconnect":76
err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/disconnect")77
case "delete":78
err = withName(os.Args[2:], func(c *client, name string) (int, []byte, error) {79
return c.do(http.MethodDelete, "/api/v1/admin/archives/"+url.PathEscape(name), nil)80
})81
case "rollback":82
err = rollback(os.Args[2:], os.Stdin, os.Stdout)83
case "actions":84
err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/actions")85
case "token":86
err = printToken(os.Args[2:])63
case "example-config":87
case "example-config":64
fmt.Print(config.Example())88
fmt.Print(config.Example())65
case "version":89
case "version":@@ -102,6 +126,7 @@ func serve(args []string) error {102
}126
}103
ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)127
ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)104
defer stop()128
defer stop()129
cfg = srv.Cfg // met settings.yml105
ln, err := net.Listen("tcp", cfg.Listen)130
ln, err := net.Listen("tcp", cfg.Listen)106
if err != nil {131
if err != nil {107
return err132
return err@@ -130,6 +155,9 @@ func newClient(cfgPath string) (*client, error) {130
if err != nil {155
if err != nil {131
return nil, err156
return nil, err132
}157
}158
if set, err := config.LoadSettings(cfg.DataDir); err == nil {159
_ = cfg.Apply(set)160
}133
tok, err := server.ReadAdminToken(cfg.DataDir)161
tok, err := server.ReadAdminToken(cfg.DataDir)134
if err != nil {162
if err != nil {135
return nil, fmt.Errorf("admin.token lezen (draai als de gebruiker van de dienst of root): %w", err)163
return nil, fmt.Errorf("admin.token lezen (draai als de gebruiker van de dienst of root): %w", err)@@ -162,6 +190,90 @@ func (c *client) do(method, p string, in any) (int, []byte, error) {162
return resp.StatusCode, b, nil190
return resp.StatusCode, b, nil163
}191
}164
192
193
func printResult(code int, b []byte) error {194
var pretty bytes.Buffer195
if json.Indent(&pretty, b, "", " ") == nil {196
b = pretty.Bytes()197
}198
fmt.Println(strings.TrimSpace(string(b)))199
if code >= 300 {200
return fmt.Errorf("HTTP %d", code)201
}202
return nil203
}204
205
func setConfig(args []string) error {206
fs := flag.NewFlagSet("set", flag.ExitOnError)207
cfgPath := fs.String("config", "", "pad naar config.yml")208
_ = fs.Parse(args)209
set := map[string]string{}210
for _, kv := range fs.Args() {211
k, v, ok := strings.Cut(kv, "=")212
if !ok {213
return fmt.Errorf("verwacht sleutel=waarde, kreeg %q", kv)214
}215
set[k] = v216
}217
if len(set) == 0 {218
return fmt.Errorf("geef minstens één sleutel=waarde")219
}220
c, err := newClient(*cfgPath)221
if err != nil {222
return err223
}224
code, b, err := c.do(http.MethodPut, "/api/v1/admin/config", set)225
if err != nil {226
return err227
}228
return printResult(code, b)229
}230
231
func withName(args []string, f func(c *client, name string) (int, []byte, error)) error {232
fs := flag.NewFlagSet("cmd", flag.ExitOnError)233
cfgPath := fs.String("config", "", "pad naar config.yml")234
_ = fs.Parse(args)235
if fs.NArg() != 1 {236
return fmt.Errorf("geef precies één archiefnaam")237
}238
c, err := newClient(*cfgPath)239
if err != nil {240
return err241
}242
code, b, err := f(c, fs.Arg(0))243
if err != nil {244
return err245
}246
return printResult(code, b)247
}248
249
func rollback(args []string, stdin io.Reader, stdout io.Writer) error {250
return withName(args, func(c *client, name string) (int, []byte, error) {251
fmt.Fprintln(stdout, "LET OP: een rollback vervangt alle gegevens van BlueGit door dit archief en kan niet ongedaan worden gemaakt.")252
fmt.Fprint(stdout, "Typ de archiefnaam over om door te gaan: ")253
line, _ := bufio.NewReader(stdin).ReadString('\n')254
if strings.TrimSpace(line) != name {255
return 0, nil, fmt.Errorf("afgebroken; er is niets veranderd")256
}257
return c.do(http.MethodPost, "/api/v1/admin/rollback", map[string]string{"archive": name, "confirm": name})258
})259
}260
261
func printToken(args []string) error {262
fs := flag.NewFlagSet("token", flag.ExitOnError)263
cfgPath := fs.String("config", "", "pad naar config.yml")264
_ = fs.Parse(args)265
cfg, err := config.Load(configPath(*cfgPath))266
if err != nil {267
return err268
}269
tok, err := server.ReadAdminToken(cfg.DataDir)270
if err != nil {271
return fmt.Errorf("admin.token niet leesbaar (start de server eerst, en draai als de gebruiker bluegit-backup): %w", err)272
}273
fmt.Println(tok)274
return nil275
}276
165
func simple(args []string, method, p string) error {277
func simple(args []string, method, p string) error {166
fs := flag.NewFlagSet("cmd", flag.ExitOnError)278
fs := flag.NewFlagSet("cmd", flag.ExitOnError)167
cfgPath := fs.String("config", "", "pad naar config.yml")279
cfgPath := fs.String("config", "", "pad naar config.yml")@@ -5,18 +5,47 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
5
5
## Opzet
6
6
7
7
- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
8
- **Geen webinterface op de backup server.** Je bedient hem met een configbestand en de CLI. Archieven bekijken en een rollback starten gebeurt in BlueGit, zoals gevraagd.
9
- De CLI praat met de draaiende server via `data_dir/admin.token` (een `bba_…`-token, 0600). Er komt geen tweede inlogsysteem.
10
8
- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
11
9
10
## Webinterface en API
11
12
- De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).
13
- **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.
14
- Sessies staan alleen in het geheugen. Een herstart logt iedereen uit.
15
- Elke handeling staat in één lijst (`Actions`). De API-routes en de formulieren van de webinterface komen allebei uit die lijst, en een formulier roept dezelfde code aan als de API. Daardoor kan de API alles wat de webinterface kan, en andersom. Een unit-test controleert dat elke wijzigende actie een formulier heeft en elk formulier een actie. De integratietests falen als er een actie bij komt die niet getest wordt.
16
- "Alles instellen" betekent: alle velden uit `config.yml` behalve `data_dir`. In die map staan de instellingen zelf, dus die blijft in `config.yml`. Wat via de webinterface, API of BlueGit is ingesteld, gaat naar `data_dir/settings.yml`. Dat bestand gaat boven `config.yml`, zodat `config.yml` van root kan blijven. `listen` geldt pas na een herstart, de rest meteen (ook de downloadsnelheid tijdens een lopende sync).
17
- In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.
18
- De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.
19
20
## Bediening vanuit BlueGit
21
22
- Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:
23
- Een iframe zou een tweede login vragen.
24
- Het werkt niet als de backup server alleen voor BlueGit bereikbaar is en niet voor de browser.
25
- Het opent de deur voor clickjacking.
26
- BlueGit vraagt de lijst met acties op (`GET /api/v1/admin/actions`) en stuurt een gekozen actie ondertekend door. Een nieuwe actie in de backup server werkt daardoor in BlueGit zonder BlueGit aan te passen, zolang hij voor BlueGit is opengezet.
27
- **Niet** vanuit BlueGit:
28
- **koppelen**: dat vraagt de key op de backup server zelf.
29
- **een archief downloaden**: een archief van gigabytes hoort niet door BlueGit heen te lopen.
30
- De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).
31
- Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.
32
33
## Meerdere backup servers
34
35
- Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.
36
- Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.
37
- Een rollback kan vanaf elke gekoppelde backup server. De andere servers zien de teruggezette stand bij hun volgende sync.
38
- Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.
39
- `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.
40
12
41
## Key en authenticatie
13
42
14
- BlueGit maakt de Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
15
- Er is maar één key tegelijk. Een nieuwe key maken maakt de oude ongeldig. Verwijderen ontkoppelt de server.
43
- BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
44
- Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.
16
45
- **Backup server → BlueGit:** `Authorization: Bearer bgbk_…` op `/api/v1/backup/*`. Vijf foute pogingen per minuut per IP-adres geven `429`.
17
- **BlueGit → backup server:** BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen.
46
- **BlueGit → backup server** (meldingen, archieflijst, status, rollback en de beheeracties): BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen. Binnen die 5 minuten kan een afgeluisterd verzoek wel opnieuw worden gestuurd. Gebruik TLS als het netwerk tussen BlueGit en de backup server niet te vertrouwen is.
18
47
- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
19
- Je koppelt met `bluegit-backup connect --url … ` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
48
- Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
20
49
21
50
## Wat wordt geback-upt
22
51
@@ -89,7 +118,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
89
118
- een self-update van een geïnstalleerde server vanuit de pipeline (via een systemd-unit, net als BlueGit)
90
119
- binaries bij een tag
91
120
- Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit uit `timfa/bluegit` en draait alle featuretests. Faalt er één, dan komt er geen release.
92
- **Releases vanaf master staan pas aan zodra `.release-enabled` in de repository staat.** Tim beslist wanneer, en zet ook de geheimen (AUR-sleutel, update-token). Tags zet Tim zelf.
93
- De integratietests bouwen BlueGit van de ref in `.bluegit-ref`. Tot de BlueGit-kant gemerged is, is dat `feature/backup-server`. Daarna wordt het `master`.
121
- Releases vanaf master staan aan zodra `.release-enabled` in de repository staat. Zonder dat bestand doen de release-scripts niets.
122
- De integratietests bouwen BlueGit van de ref in `.bluegit-ref` (`master` zodra de BlueGit-kant gemerged is).
94
123
- De integratietests draaien nooit tegen een echte BlueGit-installatie. Elke test start een eigen BlueGit in een tijdelijke map, met de dev-login en zonder SSH of CI-runner.
95
124
- Het AUR-pakket haalt de broncode van `https://git.timfalken.com/timfa/bluegit-backup/-/archive/<commit>/…`. Daarom is de repository openbaar, net als `timfa/bluegit`.
@@ -5,18 +5,47 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,5
## Opzet5
## Opzet6
6
7
- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.7
- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.8
- **Geen webinterface op de backup server.** Je bedient hem met een configbestand en de CLI. Archieven bekijken en een rollback starten gebeurt in BlueGit, zoals gevraagd.9
- De CLI praat met de draaiende server via `data_dir/admin.token` (een `bba_…`-token, 0600). Er komt geen tweede inlogsysteem.10
- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.8
- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.11
9
10
## Webinterface en API11
12
- De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).13
- **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.14
- Sessies staan alleen in het geheugen. Een herstart logt iedereen uit.15
- Elke handeling staat in één lijst (`Actions`). De API-routes en de formulieren van de webinterface komen allebei uit die lijst, en een formulier roept dezelfde code aan als de API. Daardoor kan de API alles wat de webinterface kan, en andersom. Een unit-test controleert dat elke wijzigende actie een formulier heeft en elk formulier een actie. De integratietests falen als er een actie bij komt die niet getest wordt.16
- "Alles instellen" betekent: alle velden uit `config.yml` behalve `data_dir`. In die map staan de instellingen zelf, dus die blijft in `config.yml`. Wat via de webinterface, API of BlueGit is ingesteld, gaat naar `data_dir/settings.yml`. Dat bestand gaat boven `config.yml`, zodat `config.yml` van root kan blijven. `listen` geldt pas na een herstart, de rest meteen (ook de downloadsnelheid tijdens een lopende sync).17
- In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.18
- De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.19
20
## Bediening vanuit BlueGit21
22
- Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:23
- Een iframe zou een tweede login vragen.24
- Het werkt niet als de backup server alleen voor BlueGit bereikbaar is en niet voor de browser.25
- Het opent de deur voor clickjacking.26
- BlueGit vraagt de lijst met acties op (`GET /api/v1/admin/actions`) en stuurt een gekozen actie ondertekend door. Een nieuwe actie in de backup server werkt daardoor in BlueGit zonder BlueGit aan te passen, zolang hij voor BlueGit is opengezet.27
- **Niet** vanuit BlueGit:28
- **koppelen**: dat vraagt de key op de backup server zelf.29
- **een archief downloaden**: een archief van gigabytes hoort niet door BlueGit heen te lopen.30
- De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).31
- Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.32
33
## Meerdere backup servers34
35
- Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.36
- Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.37
- Een rollback kan vanaf elke gekoppelde backup server. De andere servers zien de teruggezette stand bij hun volgende sync.38
- Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.39
- `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.40
12
## Key en authenticatie41
## Key en authenticatie13
42
14
- BlueGit maakt de Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.43
- BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.15
- Er is maar één key tegelijk. Een nieuwe key maken maakt de oude ongeldig. Verwijderen ontkoppelt de server.44
- Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.16
- **Backup server → BlueGit:** `Authorization: Bearer bgbk_…` op `/api/v1/backup/*`. Vijf foute pogingen per minuut per IP-adres geven `429`.45
- **Backup server → BlueGit:** `Authorization: Bearer bgbk_…` op `/api/v1/backup/*`. Vijf foute pogingen per minuut per IP-adres geven `429`.17
- **BlueGit → backup server:** BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen.46
- **BlueGit → backup server** (meldingen, archieflijst, status, rollback en de beheeracties): BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen. Binnen die 5 minuten kan een afgeluisterd verzoek wel opnieuw worden gestuurd. Gebruik TLS als het netwerk tussen BlueGit en de backup server niet te vertrouwen is.18
- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.47
- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.19
- Je koppelt met `bluegit-backup connect --url … ` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.48
- Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.20
49
21
## Wat wordt geback-upt50
## Wat wordt geback-upt22
51
@@ -89,7 +118,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,89
- een self-update van een geïnstalleerde server vanuit de pipeline (via een systemd-unit, net als BlueGit)118
- een self-update van een geïnstalleerde server vanuit de pipeline (via een systemd-unit, net als BlueGit)90
- binaries bij een tag119
- binaries bij een tag91
- Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit uit `timfa/bluegit` en draait alle featuretests. Faalt er één, dan komt er geen release.120
- Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit uit `timfa/bluegit` en draait alle featuretests. Faalt er één, dan komt er geen release.92
- **Releases vanaf master staan pas aan zodra `.release-enabled` in de repository staat.** Tim beslist wanneer, en zet ook de geheimen (AUR-sleutel, update-token). Tags zet Tim zelf.121
- Releases vanaf master staan aan zodra `.release-enabled` in de repository staat. Zonder dat bestand doen de release-scripts niets.93
- De integratietests bouwen BlueGit van de ref in `.bluegit-ref`. Tot de BlueGit-kant gemerged is, is dat `feature/backup-server`. Daarna wordt het `master`.122
- De integratietests bouwen BlueGit van de ref in `.bluegit-ref` (`master` zodra de BlueGit-kant gemerged is).94
- De integratietests draaien nooit tegen een echte BlueGit-installatie. Elke test start een eigen BlueGit in een tijdelijke map, met de dev-login en zonder SSH of CI-runner.123
- De integratietests draaien nooit tegen een echte BlueGit-installatie. Elke test start een eigen BlueGit in een tijdelijke map, met de dev-login en zonder SSH of CI-runner.95
- Het AUR-pakket haalt de broncode van `https://git.timfalken.com/timfa/bluegit-backup/-/archive/<commit>/…`. Daarom is de repository openbaar, net als `timfa/bluegit`.124
- Het AUR-pakket haalt de broncode van `https://git.timfalken.com/timfa/bluegit-backup/-/archive/<commit>/…`. Daarom is de repository openbaar, net als `timfa/bluegit`.@@ -1,23 +1,35 @@
1
# Backup server (bluegit-backup)
1
# Backup servers (bluegit-backup)
2
2
3
3
Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
4
4
5
Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.
6
5
7
## In BlueGit
6
8
7
**Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders):
9
**Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders) toont de lijst met backup servers: naam, gekoppeld of wachtend op de key, adres en laatste contact. **Backup server toevoegen** maakt een nieuwe server met een eigen key, die één keer wordt getoond.
10
11
Per backup server (`/admin/backup/s/<id>`) staat dezelfde bediening als in de webinterface van de backup server zelf:
8
12
9
- **Backupserver-Key** maken (één keer getoond), vervangen of intrekken. Er is altijd hoogstens één key; een nieuwe key maakt de oude ongeldig en vergeet de gekoppelde server.
10
- **Gekoppelde backup server**: adres, laatste contact, archiefinterval en bewaartermijn.
11
- **Backup-archieven** als lijst, met per archief een rollback. Die staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.
13
- **Status**: laatste sync en het resultaat ervan, aantal syncs en meldingen, grootte van de kopie, archieven, de laatste rollback en de versie. Met de knoppen *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
14
- **Instellingen** van de backup server: archiefinterval, bewaartermijn, minimale vrije ruimte, downloadsnelheid, syncintervallen, publiek adres en luisteradres. BlueGit krijgt de velden van de backup server en toont ze zoals ze daar staan.
15
- **Backup-archieven** met *Verwijderen* en *Rollback*. Een rollback staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.
16
- **Backupserver-Key** vervangen (de oude key werkt meteen niet meer; de server moet opnieuw koppelen), de server hernoemen, of key intrekken en de server verwijderen. Bij verwijderen vraagt BlueGit de backup server eerst om te ontkoppelen. De archieven blijven op de backup server staan.
17
18
BlueGit kent de acties niet vooraf. Het vraagt ze op bij de backup server (`GET /api/v1/admin/actions`) en stuurt ze ondertekend door. Alles wat de backup server voor BlueGit openzet, kan dus ook hier. Koppelen en een archief downloaden kan alleen op de backup server zelf.
12
19
13
20
Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
14
21
15
22
| | |
16
23
|---|---|
17
| `GET /api/v1/admin/backup` | status, gekoppelde server, archieven |
18
| `POST /api/v1/admin/backup/key` | nieuwe key, `{"key": "bgbk_…"}` (eenmalig) |
19
| `DELETE /api/v1/admin/backup/key` | key intrekken |
20
| `POST /api/v1/admin/backup/rollback` | `{"archive": "naam", "confirm": "naam"}` |
24
| `GET /api/v1/admin/backup` | `instance_id` en de lijst met backup servers |
25
| `POST /api/v1/admin/backup/servers` | `{"name"}`: nieuwe backup server; het antwoord bevat eenmalig `key` |
26
| `GET /api/v1/admin/backup/servers/{id}` | server met `remote` (status), `archives` en `config`, zoals de backup server ze meldt |
27
| `PUT /api/v1/admin/backup/servers/{id}` | `{"name"}`: hernoemen |
28
| `POST /api/v1/admin/backup/servers/{id}/key` | nieuwe key (eenmalig in het antwoord) |
29
| `DELETE /api/v1/admin/backup/servers/{id}` | ontkoppelen en vergeten |
30
| `POST /api/v1/admin/backup/servers/{id}/actions/{name}` | actie van de backup server, bijvoorbeeld `config.update` met `{"retention_days": "14"}`, `sync`, `archive`, `prune`, `archive.delete` met `{"name"}`, of `rollback` met `{"archive": "naam", "confirm": "naam"}` |
31
32
Het antwoord van een actie is het antwoord van de backup server, met dezelfde statuscode.
21
33
22
34
## Protocol
23
35
@@ -25,7 +37,7 @@ Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
25
37
26
38
| | |
27
39
|---|---|
28
| `GET /api/v1/backup/info` | `instance_id`, `base_url`, gekoppelde server |
40
| `GET /api/v1/backup/info` | `instance_id`, `base_url`, naam en adres van de server bij deze key |
29
41
| `POST /api/v1/backup/connect` | `{"server_url", "server_id"}`: waar BlueGit meldingen heen stuurt |
30
42
| `GET /api/v1/backup/manifest` | alle bestanden: pad, grootte, mtime, mode; de database ook met sha256 |
31
43
| `GET /api/v1/backup/file?path=…` | één bestand |
@@ -47,8 +59,9 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
47
59
| `GET /api/v1/archives` | `{"archives": [{name, created_at, size}]}` |
48
60
| `GET /api/v1/status` | interval, bewaartermijn, stand van de laatste rollback |
49
61
| `POST /api/v1/rollback` | `{"archive": "naam"}` |
62
| `* /api/v1/admin/…` | de beheeracties van de backup server (lijst: `GET /api/v1/admin/actions`, veld `bluegit: true`) |
50
63
51
**Meldingen.** Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
64
**Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
52
65
53
66
## Wat er in een backup zit
54
67
@@ -62,7 +75,7 @@ data/releases/… release-assets (zonder .incoming)
62
75
data/artifacts/… CI-artifacts
63
76
```
64
77
65
Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppeling staat in `<state>/backup.json` (0600, alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.
78
Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppelingen staan in `<state>/backup.json` (0600, per server alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.
66
79
67
80
## Terugzetten
68
81
@@ -1,23 +1,35 @@1
# Backup server (bluegit-backup)1
# Backup servers (bluegit-backup)2
2
3
Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.3
Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.4
4
5
Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.6
5
## In BlueGit7
## In BlueGit6
8
7
**Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders):9
**Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders) toont de lijst met backup servers: naam, gekoppeld of wachtend op de key, adres en laatste contact. **Backup server toevoegen** maakt een nieuwe server met een eigen key, die één keer wordt getoond.10
11
Per backup server (`/admin/backup/s/<id>`) staat dezelfde bediening als in de webinterface van de backup server zelf:8
12
9
- **Backupserver-Key** maken (één keer getoond), vervangen of intrekken. Er is altijd hoogstens één key; een nieuwe key maakt de oude ongeldig en vergeet de gekoppelde server.13
- **Status**: laatste sync en het resultaat ervan, aantal syncs en meldingen, grootte van de kopie, archieven, de laatste rollback en de versie. Met de knoppen *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.10
- **Gekoppelde backup server**: adres, laatste contact, archiefinterval en bewaartermijn.14
- **Instellingen** van de backup server: archiefinterval, bewaartermijn, minimale vrije ruimte, downloadsnelheid, syncintervallen, publiek adres en luisteradres. BlueGit krijgt de velden van de backup server en toont ze zoals ze daar staan.11
- **Backup-archieven** als lijst, met per archief een rollback. Die staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.15
- **Backup-archieven** met *Verwijderen* en *Rollback*. Een rollback staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.16
- **Backupserver-Key** vervangen (de oude key werkt meteen niet meer; de server moet opnieuw koppelen), de server hernoemen, of key intrekken en de server verwijderen. Bij verwijderen vraagt BlueGit de backup server eerst om te ontkoppelen. De archieven blijven op de backup server staan.17
18
BlueGit kent de acties niet vooraf. Het vraagt ze op bij de backup server (`GET /api/v1/admin/actions`) en stuurt ze ondertekend door. Alles wat de backup server voor BlueGit openzet, kan dus ook hier. Koppelen en een archief downloaden kan alleen op de backup server zelf.12
19
13
Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):20
Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):14
21
15
| | |22
| | |16
|---|---|23
|---|---|17
| `GET /api/v1/admin/backup` | status, gekoppelde server, archieven |24
| `GET /api/v1/admin/backup` | `instance_id` en de lijst met backup servers |18
| `POST /api/v1/admin/backup/key` | nieuwe key, `{"key": "bgbk_…"}` (eenmalig) |25
| `POST /api/v1/admin/backup/servers` | `{"name"}`: nieuwe backup server; het antwoord bevat eenmalig `key` |19
| `DELETE /api/v1/admin/backup/key` | key intrekken |26
| `GET /api/v1/admin/backup/servers/{id}` | server met `remote` (status), `archives` en `config`, zoals de backup server ze meldt |20
| `POST /api/v1/admin/backup/rollback` | `{"archive": "naam", "confirm": "naam"}` |27
| `PUT /api/v1/admin/backup/servers/{id}` | `{"name"}`: hernoemen |28
| `POST /api/v1/admin/backup/servers/{id}/key` | nieuwe key (eenmalig in het antwoord) |29
| `DELETE /api/v1/admin/backup/servers/{id}` | ontkoppelen en vergeten |30
| `POST /api/v1/admin/backup/servers/{id}/actions/{name}` | actie van de backup server, bijvoorbeeld `config.update` met `{"retention_days": "14"}`, `sync`, `archive`, `prune`, `archive.delete` met `{"name"}`, of `rollback` met `{"archive": "naam", "confirm": "naam"}` |31
32
Het antwoord van een actie is het antwoord van de backup server, met dezelfde statuscode.21
33
22
## Protocol34
## Protocol23
35
@@ -25,7 +37,7 @@ Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):25
37
26
| | |38
| | |27
|---|---|39
|---|---|28
| `GET /api/v1/backup/info` | `instance_id`, `base_url`, gekoppelde server |40
| `GET /api/v1/backup/info` | `instance_id`, `base_url`, naam en adres van de server bij deze key |29
| `POST /api/v1/backup/connect` | `{"server_url", "server_id"}`: waar BlueGit meldingen heen stuurt |41
| `POST /api/v1/backup/connect` | `{"server_url", "server_id"}`: waar BlueGit meldingen heen stuurt |30
| `GET /api/v1/backup/manifest` | alle bestanden: pad, grootte, mtime, mode; de database ook met sha256 |42
| `GET /api/v1/backup/manifest` | alle bestanden: pad, grootte, mtime, mode; de database ook met sha256 |31
| `GET /api/v1/backup/file?path=…` | één bestand |43
| `GET /api/v1/backup/file?path=…` | één bestand |@@ -47,8 +59,9 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha25647
| `GET /api/v1/archives` | `{"archives": [{name, created_at, size}]}` |59
| `GET /api/v1/archives` | `{"archives": [{name, created_at, size}]}` |48
| `GET /api/v1/status` | interval, bewaartermijn, stand van de laatste rollback |60
| `GET /api/v1/status` | interval, bewaartermijn, stand van de laatste rollback |49
| `POST /api/v1/rollback` | `{"archive": "naam"}` |61
| `POST /api/v1/rollback` | `{"archive": "naam"}` |62
| `* /api/v1/admin/…` | de beheeracties van de backup server (lijst: `GET /api/v1/admin/actions`, veld `bluegit: true`) |50
63
51
**Meldingen.** Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.64
**Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.52
65
53
## Wat er in een backup zit66
## Wat er in een backup zit54
67
@@ -62,7 +75,7 @@ data/releases/… release-assets (zonder .incoming)62
data/artifacts/… CI-artifacts75
data/artifacts/… CI-artifacts63
```76
```64
77
65
Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppeling staat in `<state>/backup.json` (0600, alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.78
Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppelingen staan in `<state>/backup.json` (0600, per server alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.66
79
67
## Terugzetten80
## Terugzetten68
81
@@ -8,7 +8,9 @@ Een losse backup server voor één [BlueGit](https://git.timfalken.com/timfa/blu
8
8
- Elk `archive_interval` (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (`tar.gz`).
9
9
- Archieven ouder dan `retention_days` gaan weg. Is de schijf vol (minder dan `min_free_mb` vrij), dan gaat het oudste archief weg. Het nieuwste archief blijft altijd staan.
10
10
- In BlueGit ziet de beheerder de archieven en kan hij een **rollback** starten, met een grote waarschuwing dat die niet terug te draaien is. De backup server pakt het archief uit, vervangt zijn kopie en stuurt alles naar BlueGit. BlueGit zet de data terug en herstart.
11
- Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata.
11
- Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata. Eén BlueGit kan wel meerdere backup servers hebben, elk met een eigen key.
12
- Een **webinterface** (standaard op poort 8080) waarin alles in te stellen en te bedienen is, en een **API** die precies hetzelfde kan. Beide lopen via één lijst met acties (`GET /api/v1/admin/actions`).
13
- Vanuit **BlueGit** (*Beheer → Backup → server*) is de backup server ook te bedienen: status, instellingen, sync, archiveren, opruimen, archieven verwijderen en rollback. BlueGit vraagt de acties op bij de backup server en stuurt ze ondertekend door.
12
14
13
15
Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).
14
16
@@ -36,8 +38,8 @@ go build -o bluegit-backup ./cmd/bluegit-backup
36
38
37
39
1. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.
38
40
2. Start de server: `systemctl enable --now bluegit-backup`.
39
3. Maak in BlueGit onder *Beheer → Backup* een Backupserver-Key. Die wordt één keer getoond.
40
4. Koppel:
41
3. Voeg in BlueGit onder *Beheer → Backup* een backup server toe. De Backupserver-Key wordt één keer getoond.
42
4. Koppel in de webinterface (`http://<server>:8080`, sectie *Koppeling*), of met de CLI:
41
43
42
44
```sh
43
45
BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com
@@ -54,27 +56,66 @@ go build -o bluegit-backup ./cmd/bluegit-backup
54
56
55
57
Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.
56
58
57
## Bedienen
59
## Webinterface
60
61
Open `http://<server>:8080` en log in met het beheertoken uit `data_dir/admin.token`:
58
62
59
63
```sh
60
bluegit-backup status # koppeling, laatste sync, laatste archief
61
bluegit-backup list # archieven
62
bluegit-backup sync # nu synchroniseren
63
bluegit-backup archive # nu een archief maken
64
bluegit-backup prune # bewaarregels nu toepassen
64
sudo -u bluegit-backup bluegit-backup token
65
65
```
66
66
67
Deze commando's praten met de draaiende server via `data_dir/admin.token` en moeten dus draaien als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).
67
Daar staan:
68
69
- **Overzicht**: koppeling, laatste sync, kopie, archieven en de laatste rollback, met *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
70
- **Koppeling**: koppelen (met de keuze wissen of herstellen bij een andere BlueGit) en ontkoppelen.
71
- **Instellingen**: elk veld uit de tabel hieronder. Ze gaan naar `data_dir/settings.yml`, dat boven `config.yml` gaat. `listen` geldt pas na een herstart, de rest meteen.
72
- **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
73
- **API**: de lijst met alle acties.
74
75
De sessie is een HttpOnly-cookie (SameSite=Strict, 12 uur), elk formulier heeft een CSRF-token, en vijf foute logins per minuut per IP-adres geven `429`. De interface mag niet in een frame van een andere site. Gebruik een TLS-proxy als de server buiten je eigen netwerk bereikbaar is.
76
77
## API
78
79
Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Bearer <admin.token>`:
80
81
| Methode | Pad | Actie | BlueGit |
82
|---|---|---|---|
83
| GET | `/api/v1/admin/status` | Status | ✓ |
84
| GET | `/api/v1/admin/actions` | Alle acties | ✓ |
85
| GET | `/api/v1/admin/config` | Instellingen met uitleg | ✓ |
86
| PUT | `/api/v1/admin/config` | Instellingen wijzigen, bv. `{"retention_days": 14}` | ✓ |
87
| POST | `/api/v1/admin/connect` | `{"url", "key", "on_conflict": ""\|"wipe"\|"restore"}` | |
88
| POST | `/api/v1/admin/disconnect` | Ontkoppelen (kopie en archieven blijven) | ✓ |
89
| POST | `/api/v1/admin/sync` | Nu synchroniseren (`{"wait": false}`: op de achtergrond) | ✓ |
90
| POST | `/api/v1/admin/archive` | Nu archiveren | ✓ |
91
| POST | `/api/v1/admin/prune` | Bewaarregels nu toepassen | ✓ |
92
| GET | `/api/v1/admin/archives` | Archieven | ✓ |
93
| GET | `/api/v1/admin/archives/{name}/download` | Archief downloaden | |
94
| DELETE | `/api/v1/admin/archives/{name}` | Archief verwijderen | ✓ |
95
| POST | `/api/v1/admin/rollback` | `{"archive", "confirm": archiefnaam}`; niet terug te draaien | ✓ |
68
96
69
Een rollback start je in BlueGit, niet hier.
97
✓ betekent dat de gekoppelde BlueGit dit ook mag, met een ondertekend verzoek. Een sessie van de webinterface mag de API ook gebruiken, met het CSRF-token in `X-CSRF-Token`.
98
99
## CLI
100
101
```sh
102
bluegit-backup status | list | config | actions
103
bluegit-backup sync | archive | prune | disconnect
104
bluegit-backup set retention_days=14 archive_interval=12h
105
bluegit-backup delete bluegit-20261115-030000.tar.gz
106
bluegit-backup rollback bluegit-20261115-030000.tar.gz # vraagt om de naam over te typen
107
bluegit-backup token # beheertoken voor de webinterface
108
```
109
110
Deze commando's praten met de draaiende server via `data_dir/admin.token`. Draai ze dus als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).
70
111
71
112
## Configuratie
72
113
73
114
| Sleutel | Standaard | Betekenis |
74
115
|---|---|---|
75
| `listen` | `0.0.0.0:8790` | Adres van de HTTP-server |
116
| `listen` | `0.0.0.0:8080` | Adres van de webinterface en API (na herstart) |
76
117
| `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt |
77
| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling |
118
| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling (alleen in `config.yml`) |
78
119
| `archive_interval` | `24h` | Hoe vaak een archief |
79
120
| `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |
80
121
| `min_free_mb` | `1024` | Minder vrij: oudste archief weg |
@@ -87,7 +128,8 @@ In `data_dir`:
87
128
- `mirror/` is de lopende kopie.
88
129
- `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).
89
130
- `state.json` (0600) is de koppeling met de key.
90
- `admin.token` (0600) is voor de CLI.
131
- `admin.token` (0600) is voor de webinterface, de API en de CLI.
132
- `settings.yml` (0600) bevat wat via de webinterface, API of BlueGit is ingesteld.
91
133
92
134
## Releases
93
135
@@ -107,6 +149,8 @@ go test ./... # unit-tests
107
149
BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/
108
150
```
109
151
152
Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
153
110
154
De integratietests starten per test een echte BlueGit in een tijdelijke map (dev-login, geen SSH, geen CI-runner). Ze maken een beheerderstoken en daarmee repositories, issues en een Backupserver-Key. Daarna testen ze tegen die BlueGit:
111
155
112
156
| Test | Feature |
@@ -121,8 +165,12 @@ De integratietests starten per test een echte BlueGit in een tijdelijke map (dev
121
165
| `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |
122
166
| `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |
123
167
| `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |
168
| `TestWebUIConfiguresAndOperatesEverything` | Webinterface: inloggen, alle instellingen, koppelen, sync, archief, download, opruimen, rollback, verwijderen, ontkoppelen |
169
| `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
170
| `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
171
| `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
124
172
125
De BlueGit-kant (key, meldingen, beheerpagina, rollback) zit in BlueGit op `feature/backup-server`. Zolang die niet gemerged is, bouwt de pipeline BlueGit van die branch (`.bluegit-ref`). Zet `.bluegit-ref` op `master` zodra hij gemerged is.
173
De pipeline bouwt BlueGit van de ref in `.bluegit-ref`.
126
174
127
175
## Licentie
128
176
@@ -8,7 +8,9 @@ Een losse backup server voor één [BlueGit](https://git.timfalken.com/timfa/blu8
- Elk `archive_interval` (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (`tar.gz`).8
- Elk `archive_interval` (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (`tar.gz`).9
- Archieven ouder dan `retention_days` gaan weg. Is de schijf vol (minder dan `min_free_mb` vrij), dan gaat het oudste archief weg. Het nieuwste archief blijft altijd staan.9
- Archieven ouder dan `retention_days` gaan weg. Is de schijf vol (minder dan `min_free_mb` vrij), dan gaat het oudste archief weg. Het nieuwste archief blijft altijd staan.10
- In BlueGit ziet de beheerder de archieven en kan hij een **rollback** starten, met een grote waarschuwing dat die niet terug te draaien is. De backup server pakt het archief uit, vervangt zijn kopie en stuurt alles naar BlueGit. BlueGit zet de data terug en herstart.10
- In BlueGit ziet de beheerder de archieven en kan hij een **rollback** starten, met een grote waarschuwing dat die niet terug te draaien is. De backup server pakt het archief uit, vervangt zijn kopie en stuurt alles naar BlueGit. BlueGit zet de data terug en herstart.11
- Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata.11
- Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata. Eén BlueGit kan wel meerdere backup servers hebben, elk met een eigen key.12
- Een **webinterface** (standaard op poort 8080) waarin alles in te stellen en te bedienen is, en een **API** die precies hetzelfde kan. Beide lopen via één lijst met acties (`GET /api/v1/admin/actions`).13
- Vanuit **BlueGit** (*Beheer → Backup → server*) is de backup server ook te bedienen: status, instellingen, sync, archiveren, opruimen, archieven verwijderen en rollback. BlueGit vraagt de acties op bij de backup server en stuurt ze ondertekend door.12
14
13
Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).15
Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).14
16
@@ -36,8 +38,8 @@ go build -o bluegit-backup ./cmd/bluegit-backup36
38
37
1. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.39
1. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.38
2. Start de server: `systemctl enable --now bluegit-backup`.40
2. Start de server: `systemctl enable --now bluegit-backup`.39
3. Maak in BlueGit onder *Beheer → Backup* een Backupserver-Key. Die wordt één keer getoond.41
3. Voeg in BlueGit onder *Beheer → Backup* een backup server toe. De Backupserver-Key wordt één keer getoond.40
4. Koppel:42
4. Koppel in de webinterface (`http://<server>:8080`, sectie *Koppeling*), of met de CLI:41
43
42
```sh44
```sh43
BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com45
BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com@@ -54,27 +56,66 @@ go build -o bluegit-backup ./cmd/bluegit-backup54
56
55
Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.57
Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.56
58
57
## Bedienen59
## Webinterface60
61
Open `http://<server>:8080` en log in met het beheertoken uit `data_dir/admin.token`:58
62
59
```sh63
```sh60
bluegit-backup status # koppeling, laatste sync, laatste archief64
sudo -u bluegit-backup bluegit-backup token61
bluegit-backup list # archieven62
bluegit-backup sync # nu synchroniseren63
bluegit-backup archive # nu een archief maken64
bluegit-backup prune # bewaarregels nu toepassen65
```65
```66
66
67
Deze commando's praten met de draaiende server via `data_dir/admin.token` en moeten dus draaien als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).67
Daar staan:68
69
- **Overzicht**: koppeling, laatste sync, kopie, archieven en de laatste rollback, met *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.70
- **Koppeling**: koppelen (met de keuze wissen of herstellen bij een andere BlueGit) en ontkoppelen.71
- **Instellingen**: elk veld uit de tabel hieronder. Ze gaan naar `data_dir/settings.yml`, dat boven `config.yml` gaat. `listen` geldt pas na een herstart, de rest meteen.72
- **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).73
- **API**: de lijst met alle acties.74
75
De sessie is een HttpOnly-cookie (SameSite=Strict, 12 uur), elk formulier heeft een CSRF-token, en vijf foute logins per minuut per IP-adres geven `429`. De interface mag niet in een frame van een andere site. Gebruik een TLS-proxy als de server buiten je eigen netwerk bereikbaar is.76
77
## API78
79
Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Bearer <admin.token>`:80
81
| Methode | Pad | Actie | BlueGit |82
|---|---|---|---|83
| GET | `/api/v1/admin/status` | Status | ✓ |84
| GET | `/api/v1/admin/actions` | Alle acties | ✓ |85
| GET | `/api/v1/admin/config` | Instellingen met uitleg | ✓ |86
| PUT | `/api/v1/admin/config` | Instellingen wijzigen, bv. `{"retention_days": 14}` | ✓ |87
| POST | `/api/v1/admin/connect` | `{"url", "key", "on_conflict": ""\|"wipe"\|"restore"}` | |88
| POST | `/api/v1/admin/disconnect` | Ontkoppelen (kopie en archieven blijven) | ✓ |89
| POST | `/api/v1/admin/sync` | Nu synchroniseren (`{"wait": false}`: op de achtergrond) | ✓ |90
| POST | `/api/v1/admin/archive` | Nu archiveren | ✓ |91
| POST | `/api/v1/admin/prune` | Bewaarregels nu toepassen | ✓ |92
| GET | `/api/v1/admin/archives` | Archieven | ✓ |93
| GET | `/api/v1/admin/archives/{name}/download` | Archief downloaden | |94
| DELETE | `/api/v1/admin/archives/{name}` | Archief verwijderen | ✓ |95
| POST | `/api/v1/admin/rollback` | `{"archive", "confirm": archiefnaam}`; niet terug te draaien | ✓ |68
96
69
Een rollback start je in BlueGit, niet hier.97
✓ betekent dat de gekoppelde BlueGit dit ook mag, met een ondertekend verzoek. Een sessie van de webinterface mag de API ook gebruiken, met het CSRF-token in `X-CSRF-Token`.98
99
## CLI100
101
```sh102
bluegit-backup status | list | config | actions103
bluegit-backup sync | archive | prune | disconnect104
bluegit-backup set retention_days=14 archive_interval=12h105
bluegit-backup delete bluegit-20261115-030000.tar.gz106
bluegit-backup rollback bluegit-20261115-030000.tar.gz # vraagt om de naam over te typen107
bluegit-backup token # beheertoken voor de webinterface108
```109
110
Deze commando's praten met de draaiende server via `data_dir/admin.token`. Draai ze dus als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).70
111
71
## Configuratie112
## Configuratie72
113
73
| Sleutel | Standaard | Betekenis |114
| Sleutel | Standaard | Betekenis |74
|---|---|---|115
|---|---|---|75
| `listen` | `0.0.0.0:8790` | Adres van de HTTP-server |116
| `listen` | `0.0.0.0:8080` | Adres van de webinterface en API (na herstart) |76
| `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt |117
| `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt |77
| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling |118
| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling (alleen in `config.yml`) |78
| `archive_interval` | `24h` | Hoe vaak een archief |119
| `archive_interval` | `24h` | Hoe vaak een archief |79
| `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |120
| `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |80
| `min_free_mb` | `1024` | Minder vrij: oudste archief weg |121
| `min_free_mb` | `1024` | Minder vrij: oudste archief weg |@@ -87,7 +128,8 @@ In `data_dir`:87
- `mirror/` is de lopende kopie.128
- `mirror/` is de lopende kopie.88
- `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).129
- `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).89
- `state.json` (0600) is de koppeling met de key.130
- `state.json` (0600) is de koppeling met de key.90
- `admin.token` (0600) is voor de CLI.131
- `admin.token` (0600) is voor de webinterface, de API en de CLI.132
- `settings.yml` (0600) bevat wat via de webinterface, API of BlueGit is ingesteld.91
133
92
## Releases134
## Releases93
135
@@ -107,6 +149,8 @@ go test ./... # unit-tests107
BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/149
BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/108
```150
```109
151
152
Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.153
110
De integratietests starten per test een echte BlueGit in een tijdelijke map (dev-login, geen SSH, geen CI-runner). Ze maken een beheerderstoken en daarmee repositories, issues en een Backupserver-Key. Daarna testen ze tegen die BlueGit:154
De integratietests starten per test een echte BlueGit in een tijdelijke map (dev-login, geen SSH, geen CI-runner). Ze maken een beheerderstoken en daarmee repositories, issues en een Backupserver-Key. Daarna testen ze tegen die BlueGit:111
155
112
| Test | Feature |156
| Test | Feature |@@ -121,8 +165,12 @@ De integratietests starten per test een echte BlueGit in een tijdelijke map (dev121
| `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |165
| `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |122
| `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |166
| `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |123
| `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |167
| `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |168
| `TestWebUIConfiguresAndOperatesEverything` | Webinterface: inloggen, alle instellingen, koppelen, sync, archief, download, opruimen, rollback, verwijderen, ontkoppelen |169
| `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |170
| `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |171
| `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |124
172
125
De BlueGit-kant (key, meldingen, beheerpagina, rollback) zit in BlueGit op `feature/backup-server`. Zolang die niet gemerged is, bouwt de pipeline BlueGit van die branch (`.bluegit-ref`). Zet `.bluegit-ref` op `master` zodra hij gemerged is.173
De pipeline bouwt BlueGit van de ref in `.bluegit-ref`.126
174
127
## Licentie175
## Licentie128
176
@@ -96,6 +96,15 @@ func (s *Store) Path(name string) (string, error) {
96
96
return p, nil
97
97
}
98
98
99
// Delete verwijdert één archief.
100
func (s *Store) Delete(name string) error {
101
p, err := s.Path(name)
102
if err != nil {
103
return err
104
}
105
return os.Remove(p)
106
}
107
99
108
// DeleteAll verwijdert alle archieven.
100
109
func (s *Store) DeleteAll() error {
101
110
list, err := s.List()
@@ -96,6 +96,15 @@ func (s *Store) Path(name string) (string, error) {96
return p, nil96
return p, nil97
}97
}98
98
99
// Delete verwijdert één archief.100
func (s *Store) Delete(name string) error {101
p, err := s.Path(name)102
if err != nil {103
return err104
}105
return os.Remove(p)106
}107
99
// DeleteAll verwijdert alle archieven.108
// DeleteAll verwijdert alle archieven.100
func (s *Store) DeleteAll() error {109
func (s *Store) DeleteAll() error {101
list, err := s.List()110
list, err := s.List()@@ -70,7 +70,7 @@ func (d Duration) MarshalYAML() (any, error) { return d.String(), nil }
70
70
// Defaults vult lege velden.
71
71
func (c *Config) Defaults() {
72
72
if c.Listen == "" {
73
c.Listen = "0.0.0.0:8790"
73
c.Listen = "0.0.0.0:8080"
74
74
}
75
75
if c.DataDir == "" {
76
76
c.DataDir = "/var/lib/bluegit-backup"
@@ -106,6 +106,9 @@ func (c Config) Validate() error {
106
106
if c.ArchiveInterval.Duration < time.Second {
107
107
return fmt.Errorf("archive_interval moet minstens 1s zijn")
108
108
}
109
if c.FullSyncInterval.Duration < time.Second || c.MinSyncInterval.Duration < 0 {
110
return fmt.Errorf("full_sync_interval moet minstens 1s zijn")
111
}
109
112
if c.PublicURL != "" && !strings.HasPrefix(c.PublicURL, "http://") && !strings.HasPrefix(c.PublicURL, "https://") {
110
113
return fmt.Errorf("public_url moet met http:// of https:// beginnen")
111
114
}
@@ -131,9 +134,9 @@ func Load(path string) (Config, error) {
131
134
// Example is een voorbeeldconfiguratie.
132
135
func Example() string {
133
136
return `# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
134
listen: 0.0.0.0:8790
137
listen: 0.0.0.0:8080
135
138
# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
136
public_url: http://backup.lan:8790
139
public_url: http://backup.lan:8080
137
140
data_dir: /var/lib/bluegit-backup
138
141
# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
139
142
archive_interval: 24h
@@ -70,7 +70,7 @@ func (d Duration) MarshalYAML() (any, error) { return d.String(), nil }70
// Defaults vult lege velden.70
// Defaults vult lege velden.71
func (c *Config) Defaults() {71
func (c *Config) Defaults() {72
if c.Listen == "" {72
if c.Listen == "" {73
c.Listen = "0.0.0.0:8790"73
c.Listen = "0.0.0.0:8080"74
}74
}75
if c.DataDir == "" {75
if c.DataDir == "" {76
c.DataDir = "/var/lib/bluegit-backup"76
c.DataDir = "/var/lib/bluegit-backup"@@ -106,6 +106,9 @@ func (c Config) Validate() error {106
if c.ArchiveInterval.Duration < time.Second {106
if c.ArchiveInterval.Duration < time.Second {107
return fmt.Errorf("archive_interval moet minstens 1s zijn")107
return fmt.Errorf("archive_interval moet minstens 1s zijn")108
}108
}109
if c.FullSyncInterval.Duration < time.Second || c.MinSyncInterval.Duration < 0 {110
return fmt.Errorf("full_sync_interval moet minstens 1s zijn")111
}109
if c.PublicURL != "" && !strings.HasPrefix(c.PublicURL, "http://") && !strings.HasPrefix(c.PublicURL, "https://") {112
if c.PublicURL != "" && !strings.HasPrefix(c.PublicURL, "http://") && !strings.HasPrefix(c.PublicURL, "https://") {110
return fmt.Errorf("public_url moet met http:// of https:// beginnen")113
return fmt.Errorf("public_url moet met http:// of https:// beginnen")111
}114
}@@ -131,9 +134,9 @@ func Load(path string) (Config, error) {131
// Example is een voorbeeldconfiguratie.134
// Example is een voorbeeldconfiguratie.132
func Example() string {135
func Example() string {133
return `# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.136
return `# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.134
listen: 0.0.0.0:8790137
listen: 0.0.0.0:8080135
# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).138
# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).136
public_url: http://backup.lan:8790139
public_url: http://backup.lan:8080137
data_dir: /var/lib/bluegit-backup140
data_dir: /var/lib/bluegit-backup138
# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.141
# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.139
archive_interval: 24h142
archive_interval: 24h@@ -12,7 +12,7 @@ func TestDefaults(t *testing.T) {
12
12
if err != nil {
13
13
t.Fatal(err)
14
14
}
15
if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8790" {
15
if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8080" {
16
16
t.Fatalf("%+v", c)
17
17
}
18
18
}
@@ -42,3 +42,54 @@ func TestLoad(t *testing.T) {
42
42
t.Fatal("geen voorbeeld")
43
43
}
44
44
}
45
46
func TestFieldsRoundTrip(t *testing.T) {
47
var c Config
48
c.Defaults()
49
for _, f := range Fields {
50
v := c.Get(f.Key)
51
if f.Key != "public_url" && v == "" {
52
t.Errorf("%s: leeg", f.Key)
53
}
54
if err := c.Set(f.Key, v); err != nil && f.Key != "public_url" {
55
t.Errorf("%s=%q: %v", f.Key, v, err)
56
}
57
if got := c.Get(f.Key); got != v {
58
t.Errorf("%s: %q != %q", f.Key, got, v)
59
}
60
}
61
if c.Listen != "0.0.0.0:8080" {
62
t.Fatalf("standaardpoort %s", c.Listen)
63
}
64
}
65
66
func TestApplyIsAtomic(t *testing.T) {
67
var c Config
68
c.Defaults()
69
if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "nee"}); err == nil {
70
t.Fatal("fout verwacht")
71
}
72
if c.RetentionDays != 30 {
73
t.Fatal("half toegepast")
74
}
75
if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "7d", "public_url": "http://b:8080/"}); err != nil {
76
t.Fatal(err)
77
}
78
if c.RetentionDays != 7 || c.ArchiveInterval.Duration != 7*24*time.Hour || c.PublicURL != "http://b:8080" {
79
t.Fatalf("%+v", c)
80
}
81
if err := c.Apply(map[string]string{"data_dir": "/tmp"}); err == nil {
82
t.Fatal("data_dir mag niet")
83
}
84
}
85
86
func TestSettingsFile(t *testing.T) {
87
d := t.TempDir()
88
if err := SaveSettings(d, map[string]string{"retention_days": "3"}); err != nil {
89
t.Fatal(err)
90
}
91
m, err := LoadSettings(d)
92
if err != nil || m["retention_days"] != "3" {
93
t.Fatal(m, err)
94
}
95
}
@@ -12,7 +12,7 @@ func TestDefaults(t *testing.T) {12
if err != nil {12
if err != nil {13
t.Fatal(err)13
t.Fatal(err)14
}14
}15
if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8790" {15
if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8080" {16
t.Fatalf("%+v", c)16
t.Fatalf("%+v", c)17
}17
}18
}18
}@@ -42,3 +42,54 @@ func TestLoad(t *testing.T) {42
t.Fatal("geen voorbeeld")42
t.Fatal("geen voorbeeld")43
}43
}44
}44
}45
46
func TestFieldsRoundTrip(t *testing.T) {47
var c Config48
c.Defaults()49
for _, f := range Fields {50
v := c.Get(f.Key)51
if f.Key != "public_url" && v == "" {52
t.Errorf("%s: leeg", f.Key)53
}54
if err := c.Set(f.Key, v); err != nil && f.Key != "public_url" {55
t.Errorf("%s=%q: %v", f.Key, v, err)56
}57
if got := c.Get(f.Key); got != v {58
t.Errorf("%s: %q != %q", f.Key, got, v)59
}60
}61
if c.Listen != "0.0.0.0:8080" {62
t.Fatalf("standaardpoort %s", c.Listen)63
}64
}65
66
func TestApplyIsAtomic(t *testing.T) {67
var c Config68
c.Defaults()69
if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "nee"}); err == nil {70
t.Fatal("fout verwacht")71
}72
if c.RetentionDays != 30 {73
t.Fatal("half toegepast")74
}75
if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "7d", "public_url": "http://b:8080/"}); err != nil {76
t.Fatal(err)77
}78
if c.RetentionDays != 7 || c.ArchiveInterval.Duration != 7*24*time.Hour || c.PublicURL != "http://b:8080" {79
t.Fatalf("%+v", c)80
}81
if err := c.Apply(map[string]string{"data_dir": "/tmp"}); err == nil {82
t.Fatal("data_dir mag niet")83
}84
}85
86
func TestSettingsFile(t *testing.T) {87
d := t.TempDir()88
if err := SaveSettings(d, map[string]string{"retention_days": "3"}); err != nil {89
t.Fatal(err)90
}91
m, err := LoadSettings(d)92
if err != nil || m["retention_days"] != "3" {93
t.Fatal(m, err)94
}95
}@@ -0,0 +1,211 @@
1
package config
2
3
import (
4
"errors"
5
"fmt"
6
"net"
7
"os"
8
"path/filepath"
9
"sort"
10
"strconv"
11
"strings"
12
"time"
13
14
"gopkg.in/yaml.v3"
15
)
16
17
// Field beschrijft één instelling die de webinterface, de API en BlueGit
18
// kunnen lezen en wijzigen. Alles wat in Fields staat, is overal hetzelfde
19
// instelbaar.
20
type Field struct {
21
Key string `json:"key"`
22
Label string `json:"label"`
23
Help string `json:"help"`
24
// Kind is duration, int of text.
25
Kind string `json:"kind"`
26
// Restart: pas na een herstart van kracht.
27
Restart bool `json:"restart,omitempty"`
28
}
29
30
// Fields zijn de instelbare velden, in de volgorde van de webinterface.
31
var Fields = []Field{
32
{Key: "public_url", Label: "Publiek adres", Help: "Waar BlueGit deze server bereikt, bijvoorbeeld http://backup.lan:8080.", Kind: "text"},
33
{Key: "archive_interval", Label: "Archiefinterval", Help: "Zo vaak wordt de hele kopie gecomprimeerd opgeslagen (bijvoorbeeld 24h, 12h, 7d).", Kind: "duration"},
34
{Key: "retention_days", Label: "Bewaartermijn (dagen)", Help: "Archieven ouder dan dit gaan weg. 0 = nooit op leeftijd. Het nieuwste blijft altijd staan.", Kind: "int"},
35
{Key: "min_free_mb", Label: "Minimaal vrij (MB)", Help: "Minder vrije schijfruimte dan dit: het oudste archief gaat weg.", Kind: "int"},
36
{Key: "rate_limit_kib", Label: "Downloadsnelheid (KiB/s)", Help: "Zo snel wordt BlueGit hoogstens gelezen. 0 = onbeperkt.", Kind: "int"},
37
{Key: "full_sync_interval", Label: "Volledige controle", Help: "Ook zonder melding zo vaak alles nalopen.", Kind: "duration"},
38
{Key: "min_sync_interval", Label: "Minimale tijd tussen syncs", Help: "Na een melding wacht de server minstens zo lang sinds de vorige sync.", Kind: "duration"},
39
{Key: "listen", Label: "Luisteradres", Help: "Adres en poort van de webinterface en API. Geldt na een herstart.", Kind: "text", Restart: true},
40
}
41
42
// FieldByKey zoekt een veld.
43
func FieldByKey(key string) (Field, bool) {
44
for _, f := range Fields {
45
if f.Key == key {
46
return f, true
47
}
48
}
49
return Field{}, false
50
}
51
52
// Get geeft de waarde van key als tekst.
53
func (c Config) Get(key string) string {
54
switch key {
55
case "listen":
56
return c.Listen
57
case "public_url":
58
return c.PublicURL
59
case "data_dir":
60
return c.DataDir
61
case "archive_interval":
62
return FormatDuration(c.ArchiveInterval.Duration)
63
case "retention_days":
64
return strconv.Itoa(c.RetentionDays)
65
case "min_free_mb":
66
return strconv.FormatInt(c.MinFreeMB, 10)
67
case "rate_limit_kib":
68
return strconv.FormatInt(c.RateLimitKiB, 10)
69
case "full_sync_interval":
70
return FormatDuration(c.FullSyncInterval.Duration)
71
case "min_sync_interval":
72
return FormatDuration(c.MinSyncInterval.Duration)
73
}
74
return ""
75
}
76
77
// FormatDuration schrijft 24h als "24h" en 30m als "30m".
78
func FormatDuration(d time.Duration) string {
79
if d%(24*time.Hour) == 0 && d >= 48*time.Hour {
80
return fmt.Sprintf("%dd", d/(24*time.Hour))
81
}
82
switch {
83
case d == 0:
84
return "0s"
85
case d%time.Hour == 0:
86
return fmt.Sprintf("%dh", d/time.Hour)
87
case d%time.Minute == 0:
88
return fmt.Sprintf("%dm", d/time.Minute)
89
case d%time.Second == 0:
90
return fmt.Sprintf("%ds", d/time.Second)
91
}
92
return d.String()
93
}
94
95
// ParseDuration leest een Go-duur of een aantal dagen ("7d").
96
func ParseDuration(s string) (time.Duration, error) {
97
s = strings.TrimSpace(s)
98
if strings.HasSuffix(s, "d") {
99
n, err := strconv.Atoi(strings.TrimSuffix(s, "d"))
100
if err == nil && n >= 0 {
101
return time.Duration(n) * 24 * time.Hour, nil
102
}
103
}
104
d, err := time.ParseDuration(s)
105
if err != nil {
106
return 0, fmt.Errorf("ongeldige duur %q", s)
107
}
108
return d, nil
109
}
110
111
// Set zet key op val. Alleen velden uit Fields.
112
func (c *Config) Set(key, val string) error {
113
f, ok := FieldByKey(key)
114
if !ok {
115
return fmt.Errorf("onbekende instelling %q", key)
116
}
117
val = strings.TrimSpace(val)
118
switch f.Kind {
119
case "duration":
120
d, err := ParseDuration(val)
121
if err != nil {
122
return fmt.Errorf("%s: %w", key, err)
123
}
124
switch key {
125
case "archive_interval":
126
c.ArchiveInterval.Duration = d
127
case "full_sync_interval":
128
c.FullSyncInterval.Duration = d
129
case "min_sync_interval":
130
c.MinSyncInterval.Duration = d
131
}
132
case "int":
133
n, err := strconv.ParseInt(val, 10, 64)
134
if err != nil || n < 0 {
135
return fmt.Errorf("%s: geef een geheel getal van 0 of meer", key)
136
}
137
switch key {
138
case "retention_days":
139
c.RetentionDays = int(n)
140
case "min_free_mb":
141
c.MinFreeMB = n
142
case "rate_limit_kib":
143
c.RateLimitKiB = n
144
}
145
default:
146
switch key {
147
case "public_url":
148
c.PublicURL = strings.TrimRight(val, "/")
149
case "listen":
150
if _, _, err := net.SplitHostPort(val); err != nil {
151
return fmt.Errorf("listen: verwacht host:poort, bijvoorbeeld 0.0.0.0:8080")
152
}
153
c.Listen = val
154
}
155
}
156
return nil
157
}
158
159
// Apply zet een reeks instellingen in één keer. Bij een fout verandert er niets.
160
func (c *Config) Apply(set map[string]string) error {
161
next := *c
162
keys := make([]string, 0, len(set))
163
for k := range set {
164
keys = append(keys, k)
165
}
166
sort.Strings(keys)
167
for _, k := range keys {
168
if err := next.Set(k, set[k]); err != nil {
169
return err
170
}
171
}
172
if err := next.Validate(); err != nil {
173
return err
174
}
175
*c = next
176
return nil
177
}
178
179
// SettingsFile bewaart wat via de webinterface, API of BlueGit is ingesteld.
180
// Het gaat boven config.yml, zodat config.yml van root mag blijven.
181
const SettingsFile = "settings.yml"
182
183
// LoadSettings leest data_dir/settings.yml (ontbreekt: leeg).
184
func LoadSettings(dataDir string) (map[string]string, error) {
185
out := map[string]string{}
186
b, err := os.ReadFile(filepath.Join(dataDir, SettingsFile))
187
if errors.Is(err, os.ErrNotExist) {
188
return out, nil
189
}
190
if err != nil {
191
return nil, err
192
}
193
if err := yaml.Unmarshal(b, &out); err != nil {
194
return nil, fmt.Errorf("%s: %w", SettingsFile, err)
195
}
196
return out, nil
197
}
198
199
// SaveSettings schrijft data_dir/settings.yml.
200
func SaveSettings(dataDir string, set map[string]string) error {
201
b, err := yaml.Marshal(set)
202
if err != nil {
203
return err
204
}
205
b = append([]byte("# Door de webinterface, API of BlueGit ingesteld. Gaat boven config.yml.\n"), b...)
206
tmp := filepath.Join(dataDir, SettingsFile+".tmp")
207
if err := os.WriteFile(tmp, b, 0o600); err != nil {
208
return err
209
}
210
return os.Rename(tmp, filepath.Join(dataDir, SettingsFile))
211
}
@@ -0,0 +1,211 @@1
package config2
3
import (4
"errors"5
"fmt"6
"net"7
"os"8
"path/filepath"9
"sort"10
"strconv"11
"strings"12
"time"13
14
"gopkg.in/yaml.v3"15
)16
17
// Field beschrijft één instelling die de webinterface, de API en BlueGit18
// kunnen lezen en wijzigen. Alles wat in Fields staat, is overal hetzelfde19
// instelbaar.20
type Field struct {21
Key string `json:"key"`22
Label string `json:"label"`23
Help string `json:"help"`24
// Kind is duration, int of text.25
Kind string `json:"kind"`26
// Restart: pas na een herstart van kracht.27
Restart bool `json:"restart,omitempty"`28
}29
30
// Fields zijn de instelbare velden, in de volgorde van de webinterface.31
var Fields = []Field{32
{Key: "public_url", Label: "Publiek adres", Help: "Waar BlueGit deze server bereikt, bijvoorbeeld http://backup.lan:8080.", Kind: "text"},33
{Key: "archive_interval", Label: "Archiefinterval", Help: "Zo vaak wordt de hele kopie gecomprimeerd opgeslagen (bijvoorbeeld 24h, 12h, 7d).", Kind: "duration"},34
{Key: "retention_days", Label: "Bewaartermijn (dagen)", Help: "Archieven ouder dan dit gaan weg. 0 = nooit op leeftijd. Het nieuwste blijft altijd staan.", Kind: "int"},35
{Key: "min_free_mb", Label: "Minimaal vrij (MB)", Help: "Minder vrije schijfruimte dan dit: het oudste archief gaat weg.", Kind: "int"},36
{Key: "rate_limit_kib", Label: "Downloadsnelheid (KiB/s)", Help: "Zo snel wordt BlueGit hoogstens gelezen. 0 = onbeperkt.", Kind: "int"},37
{Key: "full_sync_interval", Label: "Volledige controle", Help: "Ook zonder melding zo vaak alles nalopen.", Kind: "duration"},38
{Key: "min_sync_interval", Label: "Minimale tijd tussen syncs", Help: "Na een melding wacht de server minstens zo lang sinds de vorige sync.", Kind: "duration"},39
{Key: "listen", Label: "Luisteradres", Help: "Adres en poort van de webinterface en API. Geldt na een herstart.", Kind: "text", Restart: true},40
}41
42
// FieldByKey zoekt een veld.43
func FieldByKey(key string) (Field, bool) {44
for _, f := range Fields {45
if f.Key == key {46
return f, true47
}48
}49
return Field{}, false50
}51
52
// Get geeft de waarde van key als tekst.53
func (c Config) Get(key string) string {54
switch key {55
case "listen":56
return c.Listen57
case "public_url":58
return c.PublicURL59
case "data_dir":60
return c.DataDir61
case "archive_interval":62
return FormatDuration(c.ArchiveInterval.Duration)63
case "retention_days":64
return strconv.Itoa(c.RetentionDays)65
case "min_free_mb":66
return strconv.FormatInt(c.MinFreeMB, 10)67
case "rate_limit_kib":68
return strconv.FormatInt(c.RateLimitKiB, 10)69
case "full_sync_interval":70
return FormatDuration(c.FullSyncInterval.Duration)71
case "min_sync_interval":72
return FormatDuration(c.MinSyncInterval.Duration)73
}74
return ""75
}76
77
// FormatDuration schrijft 24h als "24h" en 30m als "30m".78
func FormatDuration(d time.Duration) string {79
if d%(24*time.Hour) == 0 && d >= 48*time.Hour {80
return fmt.Sprintf("%dd", d/(24*time.Hour))81
}82
switch {83
case d == 0:84
return "0s"85
case d%time.Hour == 0:86
return fmt.Sprintf("%dh", d/time.Hour)87
case d%time.Minute == 0:88
return fmt.Sprintf("%dm", d/time.Minute)89
case d%time.Second == 0:90
return fmt.Sprintf("%ds", d/time.Second)91
}92
return d.String()93
}94
95
// ParseDuration leest een Go-duur of een aantal dagen ("7d").96
func ParseDuration(s string) (time.Duration, error) {97
s = strings.TrimSpace(s)98
if strings.HasSuffix(s, "d") {99
n, err := strconv.Atoi(strings.TrimSuffix(s, "d"))100
if err == nil && n >= 0 {101
return time.Duration(n) * 24 * time.Hour, nil102
}103
}104
d, err := time.ParseDuration(s)105
if err != nil {106
return 0, fmt.Errorf("ongeldige duur %q", s)107
}108
return d, nil109
}110
111
// Set zet key op val. Alleen velden uit Fields.112
func (c *Config) Set(key, val string) error {113
f, ok := FieldByKey(key)114
if !ok {115
return fmt.Errorf("onbekende instelling %q", key)116
}117
val = strings.TrimSpace(val)118
switch f.Kind {119
case "duration":120
d, err := ParseDuration(val)121
if err != nil {122
return fmt.Errorf("%s: %w", key, err)123
}124
switch key {125
case "archive_interval":126
c.ArchiveInterval.Duration = d127
case "full_sync_interval":128
c.FullSyncInterval.Duration = d129
case "min_sync_interval":130
c.MinSyncInterval.Duration = d131
}132
case "int":133
n, err := strconv.ParseInt(val, 10, 64)134
if err != nil || n < 0 {135
return fmt.Errorf("%s: geef een geheel getal van 0 of meer", key)136
}137
switch key {138
case "retention_days":139
c.RetentionDays = int(n)140
case "min_free_mb":141
c.MinFreeMB = n142
case "rate_limit_kib":143
c.RateLimitKiB = n144
}145
default:146
switch key {147
case "public_url":148
c.PublicURL = strings.TrimRight(val, "/")149
case "listen":150
if _, _, err := net.SplitHostPort(val); err != nil {151
return fmt.Errorf("listen: verwacht host:poort, bijvoorbeeld 0.0.0.0:8080")152
}153
c.Listen = val154
}155
}156
return nil157
}158
159
// Apply zet een reeks instellingen in één keer. Bij een fout verandert er niets.160
func (c *Config) Apply(set map[string]string) error {161
next := *c162
keys := make([]string, 0, len(set))163
for k := range set {164
keys = append(keys, k)165
}166
sort.Strings(keys)167
for _, k := range keys {168
if err := next.Set(k, set[k]); err != nil {169
return err170
}171
}172
if err := next.Validate(); err != nil {173
return err174
}175
*c = next176
return nil177
}178
179
// SettingsFile bewaart wat via de webinterface, API of BlueGit is ingesteld.180
// Het gaat boven config.yml, zodat config.yml van root mag blijven.181
const SettingsFile = "settings.yml"182
183
// LoadSettings leest data_dir/settings.yml (ontbreekt: leeg).184
func LoadSettings(dataDir string) (map[string]string, error) {185
out := map[string]string{}186
b, err := os.ReadFile(filepath.Join(dataDir, SettingsFile))187
if errors.Is(err, os.ErrNotExist) {188
return out, nil189
}190
if err != nil {191
return nil, err192
}193
if err := yaml.Unmarshal(b, &out); err != nil {194
return nil, fmt.Errorf("%s: %w", SettingsFile, err)195
}196
return out, nil197
}198
199
// SaveSettings schrijft data_dir/settings.yml.200
func SaveSettings(dataDir string, set map[string]string) error {201
b, err := yaml.Marshal(set)202
if err != nil {203
return err204
}205
b = append([]byte("# Door de webinterface, API of BlueGit ingesteld. Gaat boven config.yml.\n"), b...)206
tmp := filepath.Join(dataDir, SettingsFile+".tmp")207
if err := os.WriteFile(tmp, b, 0o600); err != nil {208
return err209
}210
return os.Rename(tmp, filepath.Join(dataDir, SettingsFile))211
}@@ -49,7 +49,7 @@ func TestKeyGenerationAndConnect(t *testing.T) {
49
49
t.Fatal("BlueGit bewaart de key leesbaar")
50
50
}
51
51
// Een nieuwe key maakt de oude ongeldig: de backup server kan niet meer syncen.
52
g.NewKey()
52
g.RotateKey()
53
53
code, raw = b.Admin("POST", "/sync", nil)
54
54
if code == 200 {
55
55
t.Fatalf("sync met ingetrokken key gelukt: %s", raw)
@@ -183,7 +183,7 @@ func TestArchiveIntervalAndListInBlueGit(t *testing.T) {
183
183
t.Fatalf("BlueGit toont de archieven niet: %+v vs %v", st.Archives, names)
184
184
}
185
185
// De beheerpagina toont de lijst met de grote waarschuwing.
186
res, err := g.Session().Get(g.URL + "/admin/backup")
186
res, err := g.Session().Get(g.URL + "/admin/backup/s/" + g.Server)
187
187
if err != nil {
188
188
t.Fatal(err)
189
189
}
@@ -269,7 +269,7 @@ func TestRollbackFromBlueGit(t *testing.T) {
269
269
}
270
270
271
271
// Zonder juiste bevestiging gebeurt er niets.
272
code, raw := g.API("POST", "/admin/backup/rollback", map[string]any{"archive": archiveName, "confirm": "ja"})
272
code, raw := g.Action(g.Server, "rollback", map[string]any{"archive": archiveName, "confirm": "ja"})
273
273
if code != 400 {
274
274
t.Fatalf("rollback zonder bevestiging: %d %s", code, raw)
275
275
}
@@ -328,7 +328,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b
328
328
t.Helper()
329
329
hc := g.Session()
330
330
hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
331
res, err := hc.Get(g.URL + "/admin/backup")
331
res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)
332
332
if err != nil {
333
333
t.Fatal(err)
334
334
}
@@ -342,7 +342,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b
342
342
if understood {
343
343
form.Set("understood", "1")
344
344
}
345
res, err = hc.PostForm(g.URL+"/admin/backup/rollback", form)
345
res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/rollback", form)
346
346
if err != nil {
347
347
t.Fatal(err)
348
348
}
@@ -49,7 +49,7 @@ func TestKeyGenerationAndConnect(t *testing.T) {49
t.Fatal("BlueGit bewaart de key leesbaar")49
t.Fatal("BlueGit bewaart de key leesbaar")50
}50
}51
// Een nieuwe key maakt de oude ongeldig: de backup server kan niet meer syncen.51
// Een nieuwe key maakt de oude ongeldig: de backup server kan niet meer syncen.52
g.NewKey()52
g.RotateKey()53
code, raw = b.Admin("POST", "/sync", nil)53
code, raw = b.Admin("POST", "/sync", nil)54
if code == 200 {54
if code == 200 {55
t.Fatalf("sync met ingetrokken key gelukt: %s", raw)55
t.Fatalf("sync met ingetrokken key gelukt: %s", raw)@@ -183,7 +183,7 @@ func TestArchiveIntervalAndListInBlueGit(t *testing.T) {183
t.Fatalf("BlueGit toont de archieven niet: %+v vs %v", st.Archives, names)183
t.Fatalf("BlueGit toont de archieven niet: %+v vs %v", st.Archives, names)184
}184
}185
// De beheerpagina toont de lijst met de grote waarschuwing.185
// De beheerpagina toont de lijst met de grote waarschuwing.186
res, err := g.Session().Get(g.URL + "/admin/backup")186
res, err := g.Session().Get(g.URL + "/admin/backup/s/" + g.Server)187
if err != nil {187
if err != nil {188
t.Fatal(err)188
t.Fatal(err)189
}189
}@@ -269,7 +269,7 @@ func TestRollbackFromBlueGit(t *testing.T) {269
}269
}270
270
271
// Zonder juiste bevestiging gebeurt er niets.271
// Zonder juiste bevestiging gebeurt er niets.272
code, raw := g.API("POST", "/admin/backup/rollback", map[string]any{"archive": archiveName, "confirm": "ja"})272
code, raw := g.Action(g.Server, "rollback", map[string]any{"archive": archiveName, "confirm": "ja"})273
if code != 400 {273
if code != 400 {274
t.Fatalf("rollback zonder bevestiging: %d %s", code, raw)274
t.Fatalf("rollback zonder bevestiging: %d %s", code, raw)275
}275
}@@ -328,7 +328,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b328
t.Helper()328
t.Helper()329
hc := g.Session()329
hc := g.Session()330
hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }330
hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }331
res, err := hc.Get(g.URL + "/admin/backup")331
res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)332
if err != nil {332
if err != nil {333
t.Fatal(err)333
t.Fatal(err)334
}334
}@@ -342,7 +342,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b342
if understood {342
if understood {343
form.Set("understood", "1")343
form.Set("understood", "1")344
}344
}345
res, err = hc.PostForm(g.URL+"/admin/backup/rollback", form)345
res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/rollback", form)346
if err != nil {346
if err != nil {347
t.Fatal(err)347
t.Fatal(err)348
}348
}@@ -65,6 +65,8 @@ type BlueGit struct {
65
65
Token string
66
66
cmd *exec.Cmd
67
67
log *syncBuf
68
// Server is het id van de laatst toegevoegde backup server in BlueGit.
69
Server string
68
70
}
69
71
70
72
type syncBuf struct {
@@ -204,17 +206,39 @@ func (g *BlueGit) MustAPI(method, path string, in any) []byte {
204
206
return b
205
207
}
206
208
207
// NewKey maakt een Backupserver-Key via de beheer-API.
209
// AddServer voegt een backup server toe in BlueGit en geeft id en key.
210
func (g *BlueGit) AddServer(name string) (string, string) {
211
g.t.Helper()
212
var out struct{ ID, Key string }
213
_ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers", map[string]any{"name": name}), &out)
214
if !strings.HasPrefix(out.Key, "bgbk_") || out.ID == "" {
215
g.t.Fatalf("server %+v", out)
216
}
217
return out.ID, out.Key
218
}
219
220
// NewKey voegt een backup server toe en geeft zijn Backupserver-Key.
208
221
func (g *BlueGit) NewKey() string {
222
g.t.Helper()
223
id, key := g.AddServer("test")
224
g.Server = id
225
return key
226
}
227
228
// RotateKey geeft de laatst toegevoegde backup server een nieuwe key.
229
func (g *BlueGit) RotateKey() string {
209
230
g.t.Helper()
210
231
var out struct{ Key string }
211
_ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/key", nil), &out)
212
if !strings.HasPrefix(out.Key, "bgbk_") {
213
g.t.Fatalf("key %q", out.Key)
214
}
232
_ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers/"+g.Server+"/key", nil), &out)
215
233
return out.Key
216
234
}
217
235
236
// Action voert een actie van backup server id uit via BlueGit.
237
func (g *BlueGit) Action(id, name string, in any) (int, []byte) {
238
g.t.Helper()
239
return g.API("POST", "/admin/backup/servers/"+id+"/actions/"+name, in)
240
}
241
218
242
// Project maakt een project met één commit.
219
243
func (g *BlueGit) Project(name, file, content string) {
220
244
g.t.Helper()
@@ -276,23 +300,53 @@ func (g *BlueGit) ProjectCode(repo string) int {
276
300
return code
277
301
}
278
302
279
// BackupStatus is GET /admin/backup in BlueGit.
303
// BackupStatus is wat BlueGit over een backup server weet.
280
304
type BackupStatus struct {
281
305
InstanceID string `json:"instance_id"`
282
HasKey bool `json:"has_key"`
306
HasKey bool `json:"-"`
307
Name string `json:"name"`
283
308
Connected bool `json:"connected"`
284
309
ServerURL string `json:"server_url"`
285
310
Archives []struct {
286
311
Name string `json:"name"`
287
312
Size int64 `json:"size"`
288
313
} `json:"archives"`
314
Config struct {
315
Fields []struct {
316
Key string `json:"key"`
317
Value string `json:"value"`
318
} `json:"fields"`
319
} `json:"config"`
289
320
RemoteError string `json:"remote_error"`
290
321
}
291
322
292
func (g *BlueGit) BackupStatus() BackupStatus {
323
// BackupStatus geeft de stand van de laatst toegevoegde backup server.
324
func (g *BlueGit) BackupStatus() BackupStatus { return g.ServerStatus(g.Server) }
325
326
// ServerStatus geeft de stand van backup server id ("" = de eerste).
327
func (g *BlueGit) ServerStatus(id string) BackupStatus {
293
328
g.t.Helper()
294
var st BackupStatus
295
_ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &st)
329
var list struct {
330
InstanceID string `json:"instance_id"`
331
Servers []struct {
332
ID string `json:"id"`
333
} `json:"servers"`
334
}
335
_ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &list)
336
st := BackupStatus{InstanceID: list.InstanceID}
337
if id == "" && len(list.Servers) > 0 {
338
id = list.Servers[0].ID
339
}
340
found := false
341
for _, s := range list.Servers {
342
found = found || s.ID == id
343
}
344
if !found {
345
return st
346
}
347
_ = json.Unmarshal(g.MustAPI("GET", "/admin/backup/servers/"+id, nil), &st)
348
st.HasKey = true
349
st.InstanceID = list.InstanceID
296
350
return st
297
351
}
298
352
@@ -65,6 +65,8 @@ type BlueGit struct {65
Token string65
Token string66
cmd *exec.Cmd66
cmd *exec.Cmd67
log *syncBuf67
log *syncBuf68
// Server is het id van de laatst toegevoegde backup server in BlueGit.69
Server string68
}70
}69
71
70
type syncBuf struct {72
type syncBuf struct {@@ -204,17 +206,39 @@ func (g *BlueGit) MustAPI(method, path string, in any) []byte {204
return b206
return b205
}207
}206
208
207
// NewKey maakt een Backupserver-Key via de beheer-API.209
// AddServer voegt een backup server toe in BlueGit en geeft id en key.210
func (g *BlueGit) AddServer(name string) (string, string) {211
g.t.Helper()212
var out struct{ ID, Key string }213
_ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers", map[string]any{"name": name}), &out)214
if !strings.HasPrefix(out.Key, "bgbk_") || out.ID == "" {215
g.t.Fatalf("server %+v", out)216
}217
return out.ID, out.Key218
}219
220
// NewKey voegt een backup server toe en geeft zijn Backupserver-Key.208
func (g *BlueGit) NewKey() string {221
func (g *BlueGit) NewKey() string {222
g.t.Helper()223
id, key := g.AddServer("test")224
g.Server = id225
return key226
}227
228
// RotateKey geeft de laatst toegevoegde backup server een nieuwe key.229
func (g *BlueGit) RotateKey() string {209
g.t.Helper()230
g.t.Helper()210
var out struct{ Key string }231
var out struct{ Key string }211
_ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/key", nil), &out)232
_ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers/"+g.Server+"/key", nil), &out)212
if !strings.HasPrefix(out.Key, "bgbk_") {213
g.t.Fatalf("key %q", out.Key)214
}215
return out.Key233
return out.Key216
}234
}217
235
236
// Action voert een actie van backup server id uit via BlueGit.237
func (g *BlueGit) Action(id, name string, in any) (int, []byte) {238
g.t.Helper()239
return g.API("POST", "/admin/backup/servers/"+id+"/actions/"+name, in)240
}241
218
// Project maakt een project met één commit.242
// Project maakt een project met één commit.219
func (g *BlueGit) Project(name, file, content string) {243
func (g *BlueGit) Project(name, file, content string) {220
g.t.Helper()244
g.t.Helper()@@ -276,23 +300,53 @@ func (g *BlueGit) ProjectCode(repo string) int {276
return code300
return code277
}301
}278
302
279
// BackupStatus is GET /admin/backup in BlueGit.303
// BackupStatus is wat BlueGit over een backup server weet.280
type BackupStatus struct {304
type BackupStatus struct {281
InstanceID string `json:"instance_id"`305
InstanceID string `json:"instance_id"`282
HasKey bool `json:"has_key"`306
HasKey bool `json:"-"`307
Name string `json:"name"`283
Connected bool `json:"connected"`308
Connected bool `json:"connected"`284
ServerURL string `json:"server_url"`309
ServerURL string `json:"server_url"`285
Archives []struct {310
Archives []struct {286
Name string `json:"name"`311
Name string `json:"name"`287
Size int64 `json:"size"`312
Size int64 `json:"size"`288
} `json:"archives"`313
} `json:"archives"`314
Config struct {315
Fields []struct {316
Key string `json:"key"`317
Value string `json:"value"`318
} `json:"fields"`319
} `json:"config"`289
RemoteError string `json:"remote_error"`320
RemoteError string `json:"remote_error"`290
}321
}291
322
292
func (g *BlueGit) BackupStatus() BackupStatus {323
// BackupStatus geeft de stand van de laatst toegevoegde backup server.324
func (g *BlueGit) BackupStatus() BackupStatus { return g.ServerStatus(g.Server) }325
326
// ServerStatus geeft de stand van backup server id ("" = de eerste).327
func (g *BlueGit) ServerStatus(id string) BackupStatus {293
g.t.Helper()328
g.t.Helper()294
var st BackupStatus329
var list struct {295
_ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &st)330
InstanceID string `json:"instance_id"`331
Servers []struct {332
ID string `json:"id"`333
} `json:"servers"`334
}335
_ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &list)336
st := BackupStatus{InstanceID: list.InstanceID}337
if id == "" && len(list.Servers) > 0 {338
id = list.Servers[0].ID339
}340
found := false341
for _, s := range list.Servers {342
found = found || s.ID == id343
}344
if !found {345
return st346
}347
_ = json.Unmarshal(g.MustAPI("GET", "/admin/backup/servers/"+id, nil), &st)348
st.HasKey = true349
st.InstanceID = list.InstanceID296
return st350
return st297
}351
}298
352
@@ -0,0 +1,399 @@
1
//go:build integration
2
3
package integration
4
5
import (
6
"encoding/json"
7
"io"
8
"net/http"
9
"net/http/cookiejar"
10
"net/url"
11
"os"
12
"path/filepath"
13
"sort"
14
"strings"
15
"testing"
16
"time"
17
)
18
19
// webUI is een browser op de webinterface van de backup server.
20
type webUI struct {
21
t *testing.T
22
b *Backup
23
hc *http.Client
24
csrf string
25
}
26
27
func openUI(t *testing.T, b *Backup) *webUI {
28
t.Helper()
29
jar, _ := cookiejar.New(nil)
30
u := &webUI{t: t, b: b, hc: &http.Client{Jar: jar, CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}}
31
res, err := u.hc.Get(b.URL + "/")
32
if err != nil {
33
t.Fatal(err)
34
}
35
res.Body.Close()
36
if res.StatusCode != 303 || res.Header.Get("Location") != "/login" {
37
t.Fatalf("zonder login: %d %s", res.StatusCode, res.Header.Get("Location"))
38
}
39
res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {"bba_fout"}})
40
res.Body.Close()
41
if res.Header.Get("Location") != "/login?fout=1" {
42
t.Fatal("fout token geaccepteerd")
43
}
44
res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {b.Srv.AdminToken()}})
45
res.Body.Close()
46
if res.StatusCode != 303 || res.Header.Get("Location") != "/" {
47
t.Fatalf("login: %d", res.StatusCode)
48
}
49
u.Page()
50
return u
51
}
52
53
// Page haalt de hoofdpagina op en onthoudt het CSRF-token.
54
func (u *webUI) Page() string {
55
u.t.Helper()
56
res, err := u.hc.Get(u.b.URL + "/")
57
if err != nil {
58
u.t.Fatal(err)
59
}
60
b, _ := io.ReadAll(res.Body)
61
res.Body.Close()
62
if res.StatusCode != 200 {
63
u.t.Fatalf("pagina: %d", res.StatusCode)
64
}
65
u.csrf = between(string(b), `name="csrf" value="`, `"`)
66
return string(b)
67
}
68
69
// Act verstuurt het formulier van een actie en geeft de melding erna.
70
func (u *webUI) Act(name string, form url.Values) string {
71
u.t.Helper()
72
if form == nil {
73
form = url.Values{}
74
}
75
form.Set("csrf", u.csrf)
76
res, err := u.hc.PostForm(u.b.URL+"/ui/act/"+name, form)
77
if err != nil {
78
u.t.Fatal(err)
79
}
80
res.Body.Close()
81
if res.StatusCode != 303 {
82
u.t.Fatalf("%s: %d", name, res.StatusCode)
83
}
84
return between(u.Page(), `role="status">`, `</div>`)
85
}
86
87
func actionNames(t *testing.T, b *Backup, withGet bool) []string {
88
t.Helper()
89
code, raw := b.Admin("GET", "/actions", nil)
90
if code != 200 {
91
t.Fatalf("actions: %d", code)
92
}
93
var out struct {
94
Actions []struct{ Name, Method string }
95
}
96
_ = json.Unmarshal(raw, &out)
97
var names []string
98
for _, a := range out.Actions {
99
if withGet || a.Method != "GET" {
100
names = append(names, a.Name)
101
}
102
}
103
sort.Strings(names)
104
return names
105
}
106
107
func requireAll(t *testing.T, what string, want []string, done map[string]bool) {
108
t.Helper()
109
for _, n := range want {
110
if !done[n] {
111
t.Errorf("%s: actie %s niet getest", what, n)
112
}
113
}
114
}
115
116
// Feature: alles is in te stellen en te bedienen via de webinterface (poort 8080 standaard).
117
func TestWebUIConfiguresAndOperatesEverything(t *testing.T) {
118
g := startBlueGit(t)
119
g.Project("Alpha", "README.md", "v1")
120
b := startBackup(t, nil)
121
u := openUI(t, b)
122
done := map[string]bool{}
123
124
// Instellingen.
125
msg := u.Act("config.update", url.Values{"archive_interval": {"3h"}, "retention_days": {"5"}, "rate_limit_kib": {"2048"}, "min_free_mb": {"2"}, "full_sync_interval": {"2h"}, "min_sync_interval": {"1s"}, "public_url": {b.URL}, "listen": {b.Cfg.Listen}})
126
if !strings.Contains(msg, "opgeslagen") {
127
t.Fatalf("instellingen: %q", msg)
128
}
129
done["config.update"] = true
130
st := b.Status()
131
if st.Interval != "3h0m0s" || st.RetentionDays != 5 || st.RateLimitKiB != 2048 {
132
t.Fatalf("niet toegepast: %+v", st)
133
}
134
if msg := u.Act("config.update", url.Values{"archive_interval": {"nooit"}}); !strings.Contains(msg, "mislukt") {
135
t.Fatalf("ongeldige waarde: %q", msg)
136
}
137
u.Act("config.update", url.Values{"rate_limit_kib": {"0"}})
138
139
// Koppelen met een key uit BlueGit.
140
if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {"bgbk_fout"}, "on_conflict": {""}}); !strings.Contains(msg, "mislukt") {
141
t.Fatalf("verkeerde key: %q", msg)
142
}
143
if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {g.NewKey()}, "on_conflict": {""}}); !strings.Contains(msg, "gelukt") {
144
t.Fatalf("koppelen: %q", msg)
145
}
146
done["connect"] = true
147
if st := g.BackupStatus(); !st.Connected || st.ServerURL != b.URL {
148
t.Fatalf("BlueGit ziet de koppeling niet: %+v", st)
149
}
150
151
// Sync, archief, opruimen.
152
if msg := u.Act("sync", nil); !strings.Contains(msg, "gestart") {
153
t.Fatalf("sync: %q", msg)
154
}
155
done["sync"] = true
156
Eventually(t, 15*time.Second, "kopie na sync uit de webinterface", func() bool {
157
_, err := os.Stat(b.Mirror("data/repos/tim/alpha.git/HEAD"))
158
return err == nil
159
})
160
b.Sync()
161
if msg := u.Act("archive", nil); !strings.Contains(msg, "Archief gemaakt") {
162
t.Fatalf("archief: %q", msg)
163
}
164
done["archive"] = true
165
name := b.Archives()[0]
166
page := u.Page()
167
if !strings.Contains(page, name) || !strings.Contains(page, "gekoppeld") {
168
t.Fatal("pagina toont het archief of de koppeling niet")
169
}
170
// Download vanuit de pagina.
171
res, err := u.hc.Get(b.URL + "/api/v1/admin/archives/" + name + "/download")
172
if err != nil {
173
t.Fatal(err)
174
}
175
got, _ := io.ReadAll(res.Body)
176
res.Body.Close()
177
want, _ := os.ReadFile(filepath.Join(b.Dir, "archives", name))
178
if res.StatusCode != 200 || len(got) == 0 || string(got) != string(want) {
179
t.Fatalf("download: %d %d bytes", res.StatusCode, len(got))
180
}
181
if msg := u.Act("prune", nil); !strings.Contains(msg, "Opgeruimd") {
182
t.Fatalf("opruimen: %q", msg)
183
}
184
done["prune"] = true
185
186
// Rollback vanuit de webinterface: zonder vinkje niets, daarna echt.
187
g.Commit("alpha", "README.md", "v2", "update")
188
b.Sync()
189
if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}}); !strings.Contains(msg, "Vink aan") {
190
t.Fatalf("zonder vinkje: %q", msg)
191
}
192
if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {"verkeerd"}, "understood": {"1"}}); !strings.Contains(msg, "mislukt") {
193
t.Fatalf("verkeerde bevestiging: %q", msg)
194
}
195
if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}, "understood": {"1"}}); !strings.Contains(msg, "Rollback gestart") {
196
t.Fatalf("rollback: %q", msg)
197
}
198
done["rollback"] = true
199
Eventually(t, 60*time.Second, "rollback klaar", func() bool {
200
st := b.Status().Rollback
201
if st.State == "failed" {
202
t.Fatalf("rollback mislukt: %s", st.Error)
203
}
204
return st.State == "done"
205
})
206
g.WaitUp(30 * time.Second)
207
if _, s := g.File("alpha", "README.md"); s != "v1" {
208
t.Fatalf("README na rollback: %q", s)
209
}
210
211
// Archief verwijderen en ontkoppelen.
212
if msg := u.Act("archive.delete", url.Values{"name": {name}}); !strings.Contains(msg, "gelukt") {
213
t.Fatalf("verwijderen: %q", msg)
214
}
215
done["archive.delete"] = true
216
if len(b.Archives()) != 0 {
217
t.Fatal("archief staat er nog")
218
}
219
if msg := u.Act("disconnect", nil); !strings.Contains(msg, "gelukt") {
220
t.Fatalf("ontkoppelen: %q", msg)
221
}
222
done["disconnect"] = true
223
if b.Status().Connected {
224
t.Fatal("nog gekoppeld")
225
}
226
requireAll(t, "webinterface", actionNames(t, b, false), done)
227
}
228
229
// Feature: de API kan alles wat de webinterface kan, en andersom.
230
func TestAPIDoesEverythingTheUICan(t *testing.T) {
231
g := startBlueGit(t)
232
g.Project("Alpha", "README.md", "v1")
233
b := startBackup(t, nil)
234
done := map[string]bool{}
235
call := func(name, method, path string, in any, want int) []byte {
236
t.Helper()
237
code, raw := b.Admin(method, path, in)
238
if code != want {
239
t.Fatalf("%s %s: %d %s", method, path, code, raw)
240
}
241
done[name] = true
242
return raw
243
}
244
call("status", "GET", "/status", nil, 200)
245
call("actions", "GET", "/actions", nil, 200)
246
raw := call("config", "GET", "/config", nil, 200)
247
if !strings.Contains(string(raw), `"key":"listen"`) {
248
t.Fatalf("config: %s", raw)
249
}
250
call("config.update", "PUT", "/config", map[string]any{"retention_days": 7, "archive_interval": "6h"}, 200)
251
if b.Status().RetentionDays != 7 {
252
t.Fatal("config niet toegepast")
253
}
254
call("connect", "POST", "/connect", map[string]any{"url": g.URL, "key": g.NewKey()}, 200)
255
call("sync", "POST", "/sync", nil, 200)
256
raw = call("archive", "POST", "/archive", nil, 201)
257
var a struct{ Name string }
258
_ = json.Unmarshal(raw, &a)
259
raw = call("archives", "GET", "/archives", nil, 200)
260
if !strings.Contains(string(raw), a.Name) {
261
t.Fatalf("archives: %s", raw)
262
}
263
raw = call("archive.download", "GET", "/archives/"+a.Name+"/download", nil, 200)
264
if len(raw) < 100 || raw[0] != 0x1f || raw[1] != 0x8b {
265
t.Fatal("download is geen gzip")
266
}
267
call("prune", "POST", "/prune", nil, 200)
268
call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name}, 400) // bevestiging ontbreekt
269
call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name, "confirm": a.Name}, 202)
270
Eventually(t, 60*time.Second, "rollback klaar", func() bool { return b.Status().Rollback.State == "done" })
271
g.WaitUp(30 * time.Second)
272
call("archive.delete", "DELETE", "/archives/"+a.Name, nil, 200)
273
call("disconnect", "POST", "/disconnect", nil, 200)
274
requireAll(t, "API", actionNames(t, b, true), done)
275
}
276
277
// Feature: vanuit BlueGit is de backup server te bedienen zoals in zijn eigen webinterface.
278
func TestBlueGitControlsBackupServer(t *testing.T) {
279
g := startBlueGit(t)
280
g.Project("Alpha", "README.md", "v1")
281
b := startBackup(t, nil)
282
b.Connect(g, g.NewKey())
283
b.Sync()
284
285
// Instellingen lezen en wijzigen via de BlueGit-API.
286
st := g.BackupStatus()
287
if len(st.Config.Fields) == 0 {
288
t.Fatalf("BlueGit ziet geen instellingen: %+v", st)
289
}
290
if code, raw := g.Action(g.Server, "config.update", map[string]any{"retention_days": "11", "archive_interval": "5h"}); code != 200 {
291
t.Fatalf("config via BlueGit: %d %s", code, raw)
292
}
293
if s := b.Status(); s.RetentionDays != 11 || s.Interval != "5h0m0s" {
294
t.Fatalf("niet toegepast: %+v", s)
295
}
296
// Archief maken, synchroniseren en verwijderen via BlueGit.
297
if code, raw := g.Action(g.Server, "archive", nil); code != 201 {
298
t.Fatalf("archief via BlueGit: %d %s", code, raw)
299
}
300
name := b.Archives()[0]
301
g.Commit("alpha", "x.txt", "x", "create")
302
before := b.Status().Syncs
303
if code, raw := g.Action(g.Server, "sync", nil); code != 202 {
304
t.Fatalf("sync via BlueGit: %d %s", code, raw)
305
}
306
Eventually(t, 15*time.Second, "sync gestart door BlueGit", func() bool { return b.Status().Syncs > before })
307
if code, raw := g.Action(g.Server, "archive.delete", map[string]any{"name": name}); code != 200 {
308
t.Fatalf("verwijderen via BlueGit: %d %s", code, raw)
309
}
310
if len(b.Archives()) != 0 {
311
t.Fatal("archief niet verwijderd")
312
}
313
// Koppelen kan BlueGit niet namens de backup server (alleen lokaal).
314
if code, _ := g.Action(g.Server, "connect", map[string]any{"url": g.URL, "key": "bgbk_x"}); code != 404 {
315
t.Fatalf("connect via BlueGit: %d", code)
316
}
317
318
// Dezelfde bediening in de BlueGit-webinterface.
319
hc := g.Session()
320
hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
321
res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)
322
if err != nil {
323
t.Fatal(err)
324
}
325
page, _ := io.ReadAll(res.Body)
326
res.Body.Close()
327
for _, want := range []string{`name="retention_days" value="11"`, "/act/sync", "/act/archive", "/act/prune", "/act/config.update"} {
328
if !strings.Contains(string(page), want) {
329
t.Fatalf("BlueGit-pagina mist %q", want)
330
}
331
}
332
csrf := between(string(page), `name="csrf" value="`, `"`)
333
res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"12"}})
334
if err != nil {
335
t.Fatal(err)
336
}
337
res.Body.Close()
338
if b.Status().RetentionDays != 12 {
339
t.Fatalf("formulier in BlueGit: %d", b.Status().RetentionDays)
340
}
341
res, _ = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/archive", url.Values{"csrf": {csrf}})
342
res.Body.Close()
343
if len(b.Archives()) != 1 {
344
t.Fatal("archief via het BlueGit-formulier ontbreekt")
345
}
346
}
347
348
// Feature: één BlueGit kan meerdere backup servers hebben; elke backup server hoort bij één BlueGit.
349
func TestMultipleBackupServers(t *testing.T) {
350
g := startBlueGit(t)
351
g.Project("Alpha", "README.md", "v1")
352
b1, b2 := startBackup(t, nil), startBackup(t, nil)
353
id1, key1 := g.AddServer("nas")
354
id2, key2 := g.AddServer("offsite")
355
b1.Connect(g, key1)
356
b2.Connect(g, key2)
357
for _, id := range []string{id1, id2} {
358
if st := g.ServerStatus(id); !st.Connected || st.RemoteError != "" {
359
t.Fatalf("%s: %+v", id, st)
360
}
361
}
362
if g.ServerStatus(id1).ServerURL != b1.URL || g.ServerStatus(id2).ServerURL != b2.URL {
363
t.Fatal("adressen verwisseld")
364
}
365
// Elke wijziging komt bij beide aan.
366
g.Commit("alpha", "beide.txt", "x", "create")
367
for _, b := range []*Backup{b1, b2} {
368
Eventually(t, 15*time.Second, "melding bij "+b.URL, func() bool {
369
return strings.Contains(gitLog(t, b.Mirror("data/repos/tim/alpha.git")), "zet beide.txt")
370
})
371
}
372
// Een key hoort bij één server: key1 werkt niet voor de tweede server.
373
b3 := startBackup(t, nil)
374
b3.Connect(g, key1) // dezelfde key: BlueGit verplaatst de koppeling van nas naar b3
375
if st := g.ServerStatus(id1); st.ServerURL != b3.URL {
376
t.Fatalf("koppeling niet verplaatst: %+v", st)
377
}
378
// Verwijderen in BlueGit ontkoppelt alleen die server.
379
if code, raw := g.API("DELETE", "/admin/backup/servers/"+id2, nil); code != 204 {
380
t.Fatalf("verwijderen: %d %s", code, raw)
381
}
382
if b2.Status().Connected {
383
t.Fatal("verwijderde backup server is nog gekoppeld")
384
}
385
g.Commit("alpha", "daarna.txt", "x", "create")
386
Eventually(t, 15*time.Second, "overgebleven server krijgt meldingen", func() bool {
387
return strings.Contains(gitLog(t, b3.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt")
388
})
389
time.Sleep(time.Second)
390
if strings.Contains(gitLog(t, b2.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt") {
391
t.Fatal("verwijderde server synchroniseert nog")
392
}
393
// Een backup server hoort bij één BlueGit: koppelen aan een andere vraagt om een keuze.
394
other := startBlueGit(t)
395
code, raw := b3.Admin("POST", "/connect", map[string]any{"url": other.URL, "key": other.NewKey()})
396
if code != 409 || !strings.Contains(string(raw), `"choices":["wipe","restore"]`) {
397
t.Fatalf("tweede BlueGit: %d %s", code, raw)
398
}
399
}
@@ -0,0 +1,399 @@1
//go:build integration2
3
package integration4
5
import (6
"encoding/json"7
"io"8
"net/http"9
"net/http/cookiejar"10
"net/url"11
"os"12
"path/filepath"13
"sort"14
"strings"15
"testing"16
"time"17
)18
19
// webUI is een browser op de webinterface van de backup server.20
type webUI struct {21
t *testing.T22
b *Backup23
hc *http.Client24
csrf string25
}26
27
func openUI(t *testing.T, b *Backup) *webUI {28
t.Helper()29
jar, _ := cookiejar.New(nil)30
u := &webUI{t: t, b: b, hc: &http.Client{Jar: jar, CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}}31
res, err := u.hc.Get(b.URL + "/")32
if err != nil {33
t.Fatal(err)34
}35
res.Body.Close()36
if res.StatusCode != 303 || res.Header.Get("Location") != "/login" {37
t.Fatalf("zonder login: %d %s", res.StatusCode, res.Header.Get("Location"))38
}39
res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {"bba_fout"}})40
res.Body.Close()41
if res.Header.Get("Location") != "/login?fout=1" {42
t.Fatal("fout token geaccepteerd")43
}44
res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {b.Srv.AdminToken()}})45
res.Body.Close()46
if res.StatusCode != 303 || res.Header.Get("Location") != "/" {47
t.Fatalf("login: %d", res.StatusCode)48
}49
u.Page()50
return u51
}52
53
// Page haalt de hoofdpagina op en onthoudt het CSRF-token.54
func (u *webUI) Page() string {55
u.t.Helper()56
res, err := u.hc.Get(u.b.URL + "/")57
if err != nil {58
u.t.Fatal(err)59
}60
b, _ := io.ReadAll(res.Body)61
res.Body.Close()62
if res.StatusCode != 200 {63
u.t.Fatalf("pagina: %d", res.StatusCode)64
}65
u.csrf = between(string(b), `name="csrf" value="`, `"`)66
return string(b)67
}68
69
// Act verstuurt het formulier van een actie en geeft de melding erna.70
func (u *webUI) Act(name string, form url.Values) string {71
u.t.Helper()72
if form == nil {73
form = url.Values{}74
}75
form.Set("csrf", u.csrf)76
res, err := u.hc.PostForm(u.b.URL+"/ui/act/"+name, form)77
if err != nil {78
u.t.Fatal(err)79
}80
res.Body.Close()81
if res.StatusCode != 303 {82
u.t.Fatalf("%s: %d", name, res.StatusCode)83
}84
return between(u.Page(), `role="status">`, `</div>`)85
}86
87
func actionNames(t *testing.T, b *Backup, withGet bool) []string {88
t.Helper()89
code, raw := b.Admin("GET", "/actions", nil)90
if code != 200 {91
t.Fatalf("actions: %d", code)92
}93
var out struct {94
Actions []struct{ Name, Method string }95
}96
_ = json.Unmarshal(raw, &out)97
var names []string98
for _, a := range out.Actions {99
if withGet || a.Method != "GET" {100
names = append(names, a.Name)101
}102
}103
sort.Strings(names)104
return names105
}106
107
func requireAll(t *testing.T, what string, want []string, done map[string]bool) {108
t.Helper()109
for _, n := range want {110
if !done[n] {111
t.Errorf("%s: actie %s niet getest", what, n)112
}113
}114
}115
116
// Feature: alles is in te stellen en te bedienen via de webinterface (poort 8080 standaard).117
func TestWebUIConfiguresAndOperatesEverything(t *testing.T) {118
g := startBlueGit(t)119
g.Project("Alpha", "README.md", "v1")120
b := startBackup(t, nil)121
u := openUI(t, b)122
done := map[string]bool{}123
124
// Instellingen.125
msg := u.Act("config.update", url.Values{"archive_interval": {"3h"}, "retention_days": {"5"}, "rate_limit_kib": {"2048"}, "min_free_mb": {"2"}, "full_sync_interval": {"2h"}, "min_sync_interval": {"1s"}, "public_url": {b.URL}, "listen": {b.Cfg.Listen}})126
if !strings.Contains(msg, "opgeslagen") {127
t.Fatalf("instellingen: %q", msg)128
}129
done["config.update"] = true130
st := b.Status()131
if st.Interval != "3h0m0s" || st.RetentionDays != 5 || st.RateLimitKiB != 2048 {132
t.Fatalf("niet toegepast: %+v", st)133
}134
if msg := u.Act("config.update", url.Values{"archive_interval": {"nooit"}}); !strings.Contains(msg, "mislukt") {135
t.Fatalf("ongeldige waarde: %q", msg)136
}137
u.Act("config.update", url.Values{"rate_limit_kib": {"0"}})138
139
// Koppelen met een key uit BlueGit.140
if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {"bgbk_fout"}, "on_conflict": {""}}); !strings.Contains(msg, "mislukt") {141
t.Fatalf("verkeerde key: %q", msg)142
}143
if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {g.NewKey()}, "on_conflict": {""}}); !strings.Contains(msg, "gelukt") {144
t.Fatalf("koppelen: %q", msg)145
}146
done["connect"] = true147
if st := g.BackupStatus(); !st.Connected || st.ServerURL != b.URL {148
t.Fatalf("BlueGit ziet de koppeling niet: %+v", st)149
}150
151
// Sync, archief, opruimen.152
if msg := u.Act("sync", nil); !strings.Contains(msg, "gestart") {153
t.Fatalf("sync: %q", msg)154
}155
done["sync"] = true156
Eventually(t, 15*time.Second, "kopie na sync uit de webinterface", func() bool {157
_, err := os.Stat(b.Mirror("data/repos/tim/alpha.git/HEAD"))158
return err == nil159
})160
b.Sync()161
if msg := u.Act("archive", nil); !strings.Contains(msg, "Archief gemaakt") {162
t.Fatalf("archief: %q", msg)163
}164
done["archive"] = true165
name := b.Archives()[0]166
page := u.Page()167
if !strings.Contains(page, name) || !strings.Contains(page, "gekoppeld") {168
t.Fatal("pagina toont het archief of de koppeling niet")169
}170
// Download vanuit de pagina.171
res, err := u.hc.Get(b.URL + "/api/v1/admin/archives/" + name + "/download")172
if err != nil {173
t.Fatal(err)174
}175
got, _ := io.ReadAll(res.Body)176
res.Body.Close()177
want, _ := os.ReadFile(filepath.Join(b.Dir, "archives", name))178
if res.StatusCode != 200 || len(got) == 0 || string(got) != string(want) {179
t.Fatalf("download: %d %d bytes", res.StatusCode, len(got))180
}181
if msg := u.Act("prune", nil); !strings.Contains(msg, "Opgeruimd") {182
t.Fatalf("opruimen: %q", msg)183
}184
done["prune"] = true185
186
// Rollback vanuit de webinterface: zonder vinkje niets, daarna echt.187
g.Commit("alpha", "README.md", "v2", "update")188
b.Sync()189
if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}}); !strings.Contains(msg, "Vink aan") {190
t.Fatalf("zonder vinkje: %q", msg)191
}192
if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {"verkeerd"}, "understood": {"1"}}); !strings.Contains(msg, "mislukt") {193
t.Fatalf("verkeerde bevestiging: %q", msg)194
}195
if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}, "understood": {"1"}}); !strings.Contains(msg, "Rollback gestart") {196
t.Fatalf("rollback: %q", msg)197
}198
done["rollback"] = true199
Eventually(t, 60*time.Second, "rollback klaar", func() bool {200
st := b.Status().Rollback201
if st.State == "failed" {202
t.Fatalf("rollback mislukt: %s", st.Error)203
}204
return st.State == "done"205
})206
g.WaitUp(30 * time.Second)207
if _, s := g.File("alpha", "README.md"); s != "v1" {208
t.Fatalf("README na rollback: %q", s)209
}210
211
// Archief verwijderen en ontkoppelen.212
if msg := u.Act("archive.delete", url.Values{"name": {name}}); !strings.Contains(msg, "gelukt") {213
t.Fatalf("verwijderen: %q", msg)214
}215
done["archive.delete"] = true216
if len(b.Archives()) != 0 {217
t.Fatal("archief staat er nog")218
}219
if msg := u.Act("disconnect", nil); !strings.Contains(msg, "gelukt") {220
t.Fatalf("ontkoppelen: %q", msg)221
}222
done["disconnect"] = true223
if b.Status().Connected {224
t.Fatal("nog gekoppeld")225
}226
requireAll(t, "webinterface", actionNames(t, b, false), done)227
}228
229
// Feature: de API kan alles wat de webinterface kan, en andersom.230
func TestAPIDoesEverythingTheUICan(t *testing.T) {231
g := startBlueGit(t)232
g.Project("Alpha", "README.md", "v1")233
b := startBackup(t, nil)234
done := map[string]bool{}235
call := func(name, method, path string, in any, want int) []byte {236
t.Helper()237
code, raw := b.Admin(method, path, in)238
if code != want {239
t.Fatalf("%s %s: %d %s", method, path, code, raw)240
}241
done[name] = true242
return raw243
}244
call("status", "GET", "/status", nil, 200)245
call("actions", "GET", "/actions", nil, 200)246
raw := call("config", "GET", "/config", nil, 200)247
if !strings.Contains(string(raw), `"key":"listen"`) {248
t.Fatalf("config: %s", raw)249
}250
call("config.update", "PUT", "/config", map[string]any{"retention_days": 7, "archive_interval": "6h"}, 200)251
if b.Status().RetentionDays != 7 {252
t.Fatal("config niet toegepast")253
}254
call("connect", "POST", "/connect", map[string]any{"url": g.URL, "key": g.NewKey()}, 200)255
call("sync", "POST", "/sync", nil, 200)256
raw = call("archive", "POST", "/archive", nil, 201)257
var a struct{ Name string }258
_ = json.Unmarshal(raw, &a)259
raw = call("archives", "GET", "/archives", nil, 200)260
if !strings.Contains(string(raw), a.Name) {261
t.Fatalf("archives: %s", raw)262
}263
raw = call("archive.download", "GET", "/archives/"+a.Name+"/download", nil, 200)264
if len(raw) < 100 || raw[0] != 0x1f || raw[1] != 0x8b {265
t.Fatal("download is geen gzip")266
}267
call("prune", "POST", "/prune", nil, 200)268
call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name}, 400) // bevestiging ontbreekt269
call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name, "confirm": a.Name}, 202)270
Eventually(t, 60*time.Second, "rollback klaar", func() bool { return b.Status().Rollback.State == "done" })271
g.WaitUp(30 * time.Second)272
call("archive.delete", "DELETE", "/archives/"+a.Name, nil, 200)273
call("disconnect", "POST", "/disconnect", nil, 200)274
requireAll(t, "API", actionNames(t, b, true), done)275
}276
277
// Feature: vanuit BlueGit is de backup server te bedienen zoals in zijn eigen webinterface.278
func TestBlueGitControlsBackupServer(t *testing.T) {279
g := startBlueGit(t)280
g.Project("Alpha", "README.md", "v1")281
b := startBackup(t, nil)282
b.Connect(g, g.NewKey())283
b.Sync()284
285
// Instellingen lezen en wijzigen via de BlueGit-API.286
st := g.BackupStatus()287
if len(st.Config.Fields) == 0 {288
t.Fatalf("BlueGit ziet geen instellingen: %+v", st)289
}290
if code, raw := g.Action(g.Server, "config.update", map[string]any{"retention_days": "11", "archive_interval": "5h"}); code != 200 {291
t.Fatalf("config via BlueGit: %d %s", code, raw)292
}293
if s := b.Status(); s.RetentionDays != 11 || s.Interval != "5h0m0s" {294
t.Fatalf("niet toegepast: %+v", s)295
}296
// Archief maken, synchroniseren en verwijderen via BlueGit.297
if code, raw := g.Action(g.Server, "archive", nil); code != 201 {298
t.Fatalf("archief via BlueGit: %d %s", code, raw)299
}300
name := b.Archives()[0]301
g.Commit("alpha", "x.txt", "x", "create")302
before := b.Status().Syncs303
if code, raw := g.Action(g.Server, "sync", nil); code != 202 {304
t.Fatalf("sync via BlueGit: %d %s", code, raw)305
}306
Eventually(t, 15*time.Second, "sync gestart door BlueGit", func() bool { return b.Status().Syncs > before })307
if code, raw := g.Action(g.Server, "archive.delete", map[string]any{"name": name}); code != 200 {308
t.Fatalf("verwijderen via BlueGit: %d %s", code, raw)309
}310
if len(b.Archives()) != 0 {311
t.Fatal("archief niet verwijderd")312
}313
// Koppelen kan BlueGit niet namens de backup server (alleen lokaal).314
if code, _ := g.Action(g.Server, "connect", map[string]any{"url": g.URL, "key": "bgbk_x"}); code != 404 {315
t.Fatalf("connect via BlueGit: %d", code)316
}317
318
// Dezelfde bediening in de BlueGit-webinterface.319
hc := g.Session()320
hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }321
res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)322
if err != nil {323
t.Fatal(err)324
}325
page, _ := io.ReadAll(res.Body)326
res.Body.Close()327
for _, want := range []string{`name="retention_days" value="11"`, "/act/sync", "/act/archive", "/act/prune", "/act/config.update"} {328
if !strings.Contains(string(page), want) {329
t.Fatalf("BlueGit-pagina mist %q", want)330
}331
}332
csrf := between(string(page), `name="csrf" value="`, `"`)333
res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"12"}})334
if err != nil {335
t.Fatal(err)336
}337
res.Body.Close()338
if b.Status().RetentionDays != 12 {339
t.Fatalf("formulier in BlueGit: %d", b.Status().RetentionDays)340
}341
res, _ = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/archive", url.Values{"csrf": {csrf}})342
res.Body.Close()343
if len(b.Archives()) != 1 {344
t.Fatal("archief via het BlueGit-formulier ontbreekt")345
}346
}347
348
// Feature: één BlueGit kan meerdere backup servers hebben; elke backup server hoort bij één BlueGit.349
func TestMultipleBackupServers(t *testing.T) {350
g := startBlueGit(t)351
g.Project("Alpha", "README.md", "v1")352
b1, b2 := startBackup(t, nil), startBackup(t, nil)353
id1, key1 := g.AddServer("nas")354
id2, key2 := g.AddServer("offsite")355
b1.Connect(g, key1)356
b2.Connect(g, key2)357
for _, id := range []string{id1, id2} {358
if st := g.ServerStatus(id); !st.Connected || st.RemoteError != "" {359
t.Fatalf("%s: %+v", id, st)360
}361
}362
if g.ServerStatus(id1).ServerURL != b1.URL || g.ServerStatus(id2).ServerURL != b2.URL {363
t.Fatal("adressen verwisseld")364
}365
// Elke wijziging komt bij beide aan.366
g.Commit("alpha", "beide.txt", "x", "create")367
for _, b := range []*Backup{b1, b2} {368
Eventually(t, 15*time.Second, "melding bij "+b.URL, func() bool {369
return strings.Contains(gitLog(t, b.Mirror("data/repos/tim/alpha.git")), "zet beide.txt")370
})371
}372
// Een key hoort bij één server: key1 werkt niet voor de tweede server.373
b3 := startBackup(t, nil)374
b3.Connect(g, key1) // dezelfde key: BlueGit verplaatst de koppeling van nas naar b3375
if st := g.ServerStatus(id1); st.ServerURL != b3.URL {376
t.Fatalf("koppeling niet verplaatst: %+v", st)377
}378
// Verwijderen in BlueGit ontkoppelt alleen die server.379
if code, raw := g.API("DELETE", "/admin/backup/servers/"+id2, nil); code != 204 {380
t.Fatalf("verwijderen: %d %s", code, raw)381
}382
if b2.Status().Connected {383
t.Fatal("verwijderde backup server is nog gekoppeld")384
}385
g.Commit("alpha", "daarna.txt", "x", "create")386
Eventually(t, 15*time.Second, "overgebleven server krijgt meldingen", func() bool {387
return strings.Contains(gitLog(t, b3.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt")388
})389
time.Sleep(time.Second)390
if strings.Contains(gitLog(t, b2.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt") {391
t.Fatal("verwijderde server synchroniseert nog")392
}393
// Een backup server hoort bij één BlueGit: koppelen aan een andere vraagt om een keuze.394
other := startBlueGit(t)395
code, raw := b3.Admin("POST", "/connect", map[string]any{"url": other.URL, "key": other.NewKey()})396
if code != 409 || !strings.Contains(string(raw), `"choices":["wipe","restore"]`) {397
t.Fatalf("tweede BlueGit: %d %s", code, raw)398
}399
}@@ -0,0 +1,452 @@
1
package server
2
3
import (
4
"context"
5
"crypto/subtle"
6
"encoding/json"
7
"errors"
8
"fmt"
9
"io"
10
"net/http"
11
"sort"
12
"strconv"
13
"strings"
14
15
"git.timfalken.com/timfa/bluegit-backup/internal/archive"
16
"git.timfalken.com/timfa/bluegit-backup/internal/config"
17
"git.timfalken.com/timfa/bluegit-backup/internal/mirror"
18
"git.timfalken.com/timfa/bluegit-backup/internal/protocol"
19
)
20
21
// Input is de invoer van een actie: JSON-velden, querystring, formulier of
22
// padwaarden, allemaal als tekst.
23
type Input map[string]string
24
25
// Action is één beheerhandeling. De API, de webinterface en BlueGit lopen
26
// allemaal via deze lijst, zodat ze precies hetzelfde kunnen.
27
type Action struct {
28
// Name is de naam in de webinterface (/ui/act/<name>).
29
Name string `json:"name"`
30
Method string `json:"method"`
31
Path string `json:"path"`
32
// Title is de knoptekst of beschrijving.
33
Title string `json:"title"`
34
// Signed: ook de gekoppelde BlueGit mag dit (ondertekend verzoek).
35
Signed bool `json:"bluegit"`
36
// Params zijn de padwaarden, bijvoorbeeld {name}.
37
Params []string `json:"params,omitempty"`
38
// Fields zijn de invoervelden (documentatie en de lijst in /api/v1/admin/actions).
39
Fields []string `json:"fields,omitempty"`
40
Do func(ctx context.Context, in Input) (int, any) `json:"-"`
41
}
42
43
// fileResult laat de API een bestand sturen in plaats van JSON.
44
type fileResult struct{ path, name string }
45
46
func errBody(err error) map[string]string { return map[string]string{"error": err.Error()} }
47
48
// Actions is de volledige lijst met beheerhandelingen.
49
func (s *Server) Actions() []Action {
50
return []Action{
51
{Name: "status", Method: "GET", Path: "/api/v1/admin/status", Title: "Status", Signed: true,
52
Do: func(ctx context.Context, in Input) (int, any) { return 200, s.Status() }},
53
{Name: "actions", Method: "GET", Path: "/api/v1/admin/actions", Title: "Alle acties", Signed: true,
54
Do: func(ctx context.Context, in Input) (int, any) { return 200, map[string]any{"actions": s.Actions()} }},
55
{Name: "config", Method: "GET", Path: "/api/v1/admin/config", Title: "Instellingen", Signed: true,
56
Do: func(ctx context.Context, in Input) (int, any) { return 200, s.ConfigView() }},
57
{Name: "config.update", Method: "PUT", Path: "/api/v1/admin/config", Title: "Instellingen opslaan", Signed: true,
58
Fields: fieldKeys(), Do: s.actConfigUpdate},
59
{Name: "connect", Method: "POST", Path: "/api/v1/admin/connect", Title: "Koppelen",
60
Fields: []string{"url", "key", "on_conflict"}, Do: s.actConnect},
61
{Name: "disconnect", Method: "POST", Path: "/api/v1/admin/disconnect", Title: "Ontkoppelen", Signed: true,
62
Do: s.actDisconnect},
63
{Name: "sync", Method: "POST", Path: "/api/v1/admin/sync", Title: "Nu synchroniseren", Signed: true,
64
Fields: []string{"wait"}, Do: s.actSync},
65
{Name: "archive", Method: "POST", Path: "/api/v1/admin/archive", Title: "Nu archiveren", Signed: true,
66
Do: func(ctx context.Context, in Input) (int, any) {
67
a, err := s.ArchiveNow()
68
if err != nil {
69
return 409, errBody(err)
70
}
71
return 201, a
72
}},
73
{Name: "prune", Method: "POST", Path: "/api/v1/admin/prune", Title: "Nu opruimen", Signed: true,
74
Do: func(ctx context.Context, in Input) (int, any) {
75
removed, err := s.Prune()
76
if err != nil {
77
return 500, errBody(err)
78
}
79
if removed == nil {
80
removed = []string{}
81
}
82
return 200, map[string]any{"removed": removed}
83
}},
84
{Name: "archives", Method: "GET", Path: "/api/v1/admin/archives", Title: "Archieven", Signed: true,
85
Do: func(ctx context.Context, in Input) (int, any) {
86
list, err := s.archives.List()
87
if err != nil {
88
return 500, errBody(err)
89
}
90
return 200, map[string]any{"archives": list}
91
}},
92
{Name: "archive.download", Method: "GET", Path: "/api/v1/admin/archives/{name}/download", Title: "Downloaden",
93
Params: []string{"name"}, Do: func(ctx context.Context, in Input) (int, any) {
94
p, err := s.archives.Path(in["name"])
95
if err != nil {
96
return 404, errBody(err)
97
}
98
return 200, fileResult{path: p, name: in["name"]}
99
}},
100
{Name: "archive.delete", Method: "DELETE", Path: "/api/v1/admin/archives/{name}", Title: "Verwijderen", Signed: true,
101
Params: []string{"name"}, Do: s.actArchiveDelete},
102
{Name: "rollback", Method: "POST", Path: "/api/v1/admin/rollback", Title: "Rollback", Signed: true,
103
Fields: []string{"archive", "confirm"}, Do: s.actRollback},
104
}
105
}
106
107
func fieldKeys() []string {
108
out := make([]string, 0, len(config.Fields))
109
for _, f := range config.Fields {
110
out = append(out, f.Key)
111
}
112
return out
113
}
114
115
func (s *Server) action(name string) (Action, bool) {
116
for _, a := range s.Actions() {
117
if a.Name == name {
118
return a, true
119
}
120
}
121
return Action{}, false
122
}
123
124
// ConfigView is GET /api/v1/admin/config.
125
type ConfigView struct {
126
Fields []ConfigField `json:"fields"`
127
DataDir string `json:"data_dir"`
128
// Restart: er staat een wijziging klaar die pas na een herstart geldt.
129
Restart bool `json:"restart_pending"`
130
}
131
132
// ConfigField is een veld met zijn waarde.
133
type ConfigField struct {
134
config.Field
135
Value string `json:"value"`
136
}
137
138
// ConfigView geeft alle instellingen met hun huidige waarde.
139
func (s *Server) ConfigView() ConfigView {
140
s.mu.Lock()
141
defer s.mu.Unlock()
142
v := ConfigView{DataDir: s.Cfg.DataDir, Restart: s.restartPending}
143
for _, f := range config.Fields {
144
val := s.Cfg.Get(f.Key)
145
if f.Restart {
146
if p, ok := s.settings[f.Key]; ok {
147
val = p
148
}
149
}
150
v.Fields = append(v.Fields, ConfigField{Field: f, Value: val})
151
}
152
return v
153
}
154
155
// UpdateConfig past instellingen toe en bewaart ze in settings.yml. Velden
156
// met Restart gelden pas na een herstart.
157
func (s *Server) UpdateConfig(set map[string]string) (ConfigView, error) {
158
s.mu.Lock()
159
next := s.Cfg
160
if err := next.Apply(set); err != nil {
161
s.mu.Unlock()
162
return ConfigView{}, err
163
}
164
merged := map[string]string{}
165
for k, v := range s.settings {
166
merged[k] = v
167
}
168
for k := range set {
169
merged[k] = next.Get(k)
170
}
171
if err := config.SaveSettings(next.DataDir, merged); err != nil {
172
s.mu.Unlock()
173
return ConfigView{}, err
174
}
175
for _, f := range config.Fields {
176
if f.Restart {
177
if _, ok := set[f.Key]; ok && next.Get(f.Key) != s.Cfg.Get(f.Key) {
178
s.restartPending = true
179
}
180
// De draaiende waarde blijft tot de herstart.
181
_ = next.Set(f.Key, s.Cfg.Get(f.Key))
182
}
183
}
184
s.settings = merged
185
s.Cfg = next
186
s.mu.Unlock()
187
s.limiter.SetRate(next.RateLimitKiB << 10)
188
keys := make([]string, 0, len(set))
189
for k := range set {
190
keys = append(keys, k)
191
}
192
sort.Strings(keys)
193
s.Log.Info("instellingen gewijzigd", "keys", strings.Join(keys, ","))
194
// Kortere intervallen meteen laten gelden.
195
s.Kick()
196
return s.ConfigView(), nil
197
}
198
199
func (s *Server) actConfigUpdate(ctx context.Context, in Input) (int, any) {
200
set := map[string]string{}
201
for k, v := range in {
202
set[k] = v
203
}
204
if len(set) == 0 {
205
return 400, errBody(errors.New("geen instellingen meegegeven"))
206
}
207
v, err := s.UpdateConfig(set)
208
if err != nil {
209
return 400, errBody(err)
210
}
211
return 200, v
212
}
213
214
func (s *Server) actConnect(ctx context.Context, in Input) (int, any) {
215
res, conflict, err := s.Connect(ctx, ConnectRequest{URL: in["url"], Key: in["key"], OnConflict: in["on_conflict"]})
216
if conflict != nil {
217
return http.StatusConflict, conflict
218
}
219
if err != nil {
220
var he *mirror.HTTPError
221
code := 502
222
if errors.As(err, &he) && he.Status == 401 {
223
code = 401
224
}
225
if errors.Is(err, errBadRequest) {
226
code = 400
227
}
228
return code, errBody(err)
229
}
230
return 200, res
231
}
232
233
// Disconnect vergeet de gekoppelde BlueGit. De kopie en de archieven blijven
234
// staan; een volgende koppeling met een andere BlueGit vraagt dan weer om
235
// wissen of herstellen.
236
func (s *Server) Disconnect() error {
237
s.work.Lock()
238
defer s.work.Unlock()
239
st := s.getState()
240
keep := State{InstanceID: st.InstanceID, BlueGitURL: st.BlueGitURL}
241
if err := saveState(s.Cfg.DataDir, keep); err != nil {
242
return err
243
}
244
s.mu.Lock()
245
s.state = keep
246
s.mu.Unlock()
247
s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)
248
return nil
249
}
250
251
func (s *Server) actDisconnect(ctx context.Context, in Input) (int, any) {
252
if !s.getState().Connected() {
253
return 409, errBody(errors.New("er is geen BlueGit gekoppeld"))
254
}
255
if err := s.Disconnect(); err != nil {
256
return 500, errBody(err)
257
}
258
return 200, map[string]any{"connected": false}
259
}
260
261
func (s *Server) actSync(ctx context.Context, in Input) (int, any) {
262
if !s.getState().Connected() {
263
return 409, errBody(errors.New("geen BlueGit gekoppeld"))
264
}
265
if in["wait"] == "false" || in["wait"] == "0" {
266
s.Kick()
267
return 202, map[string]string{"state": "started"}
268
}
269
stats, err := s.SyncNow(ctx)
270
if err != nil {
271
return 502, errBody(err)
272
}
273
return 200, stats
274
}
275
276
func (s *Server) actArchiveDelete(ctx context.Context, in Input) (int, any) {
277
name := in["name"]
278
if !archive.ValidName(name) {
279
return 400, errBody(errors.New("ongeldige archiefnaam"))
280
}
281
s.work.Lock()
282
err := s.archives.Delete(name)
283
s.work.Unlock()
284
if err != nil {
285
return 404, errBody(err)
286
}
287
s.Log.Info("archief verwijderd met de hand", "archive", name)
288
return 200, map[string]string{"deleted": name}
289
}
290
291
func (s *Server) actRollback(ctx context.Context, in Input) (int, any) {
292
name := in["archive"]
293
if !archive.ValidName(name) {
294
return 400, errBody(errors.New("ongeldige archiefnaam"))
295
}
296
if in["confirm"] != name {
297
return 400, errBody(errors.New("bevestig met de archiefnaam in confirm; een rollback kan niet ongedaan worden gemaakt"))
298
}
299
return s.startRollback(name)
300
}
301
302
// startRollback start een rollback op de achtergrond.
303
func (s *Server) startRollback(name string) (int, any) {
304
if _, err := s.archives.Path(name); err != nil {
305
return 404, errBody(err)
306
}
307
if !s.getState().Connected() {
308
return 409, errBody(errors.New("geen BlueGit gekoppeld"))
309
}
310
s.mu.Lock()
311
busy := s.rollback.State == "running"
312
if !busy {
313
s.rollback = RollbackStatus{State: "running", Archive: name, At: s.now().UTC()}
314
}
315
s.mu.Unlock()
316
if busy {
317
return 409, errBody(errors.New("er loopt al een rollback"))
318
}
319
s.Log.Warn("rollback gestart", "archive", name)
320
go func() {
321
if err := s.Rollback(context.Background(), name); err != nil {
322
s.Log.Error("rollback mislukt", "archive", name, "err", err)
323
}
324
}()
325
return http.StatusAccepted, map[string]string{"state": "running", "archive": name}
326
}
327
328
// ---------- HTTP ----------
329
330
// Handler is de webinterface en de HTTP-API.
331
func (s *Server) Handler() http.Handler {
332
mux := http.NewServeMux()
333
mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })
334
// Van BlueGit, ondertekend (vaste protocolroutes).
335
mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))
336
mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))
337
mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))
338
mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))
339
// Beheer: admin.token, een sessie van de webinterface, of BlueGit.
340
for _, a := range s.Actions() {
341
mux.HandleFunc(a.Method+" "+a.Path, s.apiAction(a))
342
}
343
mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)
344
s.mountUI(mux)
345
return securityHeaders(mux)
346
}
347
348
func securityHeaders(h http.Handler) http.Handler {
349
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
350
w.Header().Set("X-Content-Type-Options", "nosniff")
351
w.Header().Set("Referrer-Policy", "same-origin")
352
h.ServeHTTP(w, r)
353
})
354
}
355
356
// apiAction voert een actie uit voor de API.
357
func (s *Server) apiAction(a Action) http.HandlerFunc {
358
return func(w http.ResponseWriter, r *http.Request) {
359
body, err := io.ReadAll(io.LimitReader(r.Body, 1<<20))
360
if err != nil {
361
writeErr(w, 400, "body")
362
return
363
}
364
if code, msg := s.authorize(r, a, body); code != 0 {
365
writeErr(w, code, msg)
366
return
367
}
368
in, err := parseInput(r, body)
369
if err != nil {
370
writeErr(w, 400, err.Error())
371
return
372
}
373
for _, p := range a.Params {
374
in[p] = r.PathValue(p)
375
}
376
code, out := a.Do(r.Context(), in)
377
if f, ok := out.(fileResult); ok {
378
w.Header().Set("Content-Type", "application/gzip")
379
w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%q", f.name))
380
http.ServeFile(w, r, f.path)
381
return
382
}
383
writeJSON(w, code, out)
384
}
385
}
386
387
// authorize: 0 is toegestaan, anders de foutcode.
388
func (s *Server) authorize(r *http.Request, a Action, body []byte) (int, string) {
389
if tok, ok := strings.CutPrefix(r.Header.Get("Authorization"), "Bearer "); ok {
390
if subtle.ConstantTimeCompare([]byte(strings.TrimSpace(tok)), []byte(s.adminToken)) == 1 {
391
return 0, ""
392
}
393
return 401, "ongeldig token"
394
}
395
if r.Header.Get(protocol.HeaderSignature) != "" {
396
if !a.Signed {
397
return 403, "BlueGit mag dit niet"
398
}
399
st := s.getState()
400
if !st.Connected() {
401
return 401, "niet gekoppeld"
402
}
403
if r.Header.Get(protocol.HeaderInstance) != st.InstanceID {
404
return 401, "andere BlueGit-instantie"
405
}
406
if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {
407
return 401, err.Error()
408
}
409
return 0, ""
410
}
411
if sess, ok := s.session(r); ok {
412
if r.Method != http.MethodGet && r.Method != http.MethodHead {
413
if subtle.ConstantTimeCompare([]byte(r.Header.Get("X-CSRF-Token")), []byte(sess.csrf)) != 1 {
414
return 403, "X-CSRF-Token ontbreekt of klopt niet"
415
}
416
}
417
return 0, ""
418
}
419
return 401, "admin.token, sessie of BlueGit-handtekening nodig"
420
}
421
422
// parseInput leest de querystring en een JSON-object (waarden als tekst).
423
func parseInput(r *http.Request, body []byte) (Input, error) {
424
in := Input{}
425
for k, v := range r.URL.Query() {
426
if len(v) > 0 {
427
in[k] = v[0]
428
}
429
}
430
if len(strings.TrimSpace(string(body))) == 0 {
431
return in, nil
432
}
433
var raw map[string]any
434
if err := json.Unmarshal(body, &raw); err != nil {
435
return nil, errors.New("ongeldige JSON: verwacht een object")
436
}
437
for k, v := range raw {
438
switch t := v.(type) {
439
case string:
440
in[k] = t
441
case float64:
442
in[k] = strconv.FormatFloat(t, 'f', -1, 64)
443
case bool:
444
in[k] = strconv.FormatBool(t)
445
case nil:
446
in[k] = ""
447
default:
448
return nil, fmt.Errorf("veld %s: verwacht tekst, getal of boolean", k)
449
}
450
}
451
return in, nil
452
}
@@ -0,0 +1,452 @@1
package server2
3
import (4
"context"5
"crypto/subtle"6
"encoding/json"7
"errors"8
"fmt"9
"io"10
"net/http"11
"sort"12
"strconv"13
"strings"14
15
"git.timfalken.com/timfa/bluegit-backup/internal/archive"16
"git.timfalken.com/timfa/bluegit-backup/internal/config"17
"git.timfalken.com/timfa/bluegit-backup/internal/mirror"18
"git.timfalken.com/timfa/bluegit-backup/internal/protocol"19
)20
21
// Input is de invoer van een actie: JSON-velden, querystring, formulier of22
// padwaarden, allemaal als tekst.23
type Input map[string]string24
25
// Action is één beheerhandeling. De API, de webinterface en BlueGit lopen26
// allemaal via deze lijst, zodat ze precies hetzelfde kunnen.27
type Action struct {28
// Name is de naam in de webinterface (/ui/act/<name>).29
Name string `json:"name"`30
Method string `json:"method"`31
Path string `json:"path"`32
// Title is de knoptekst of beschrijving.33
Title string `json:"title"`34
// Signed: ook de gekoppelde BlueGit mag dit (ondertekend verzoek).35
Signed bool `json:"bluegit"`36
// Params zijn de padwaarden, bijvoorbeeld {name}.37
Params []string `json:"params,omitempty"`38
// Fields zijn de invoervelden (documentatie en de lijst in /api/v1/admin/actions).39
Fields []string `json:"fields,omitempty"`40
Do func(ctx context.Context, in Input) (int, any) `json:"-"`41
}42
43
// fileResult laat de API een bestand sturen in plaats van JSON.44
type fileResult struct{ path, name string }45
46
func errBody(err error) map[string]string { return map[string]string{"error": err.Error()} }47
48
// Actions is de volledige lijst met beheerhandelingen.49
func (s *Server) Actions() []Action {50
return []Action{51
{Name: "status", Method: "GET", Path: "/api/v1/admin/status", Title: "Status", Signed: true,52
Do: func(ctx context.Context, in Input) (int, any) { return 200, s.Status() }},53
{Name: "actions", Method: "GET", Path: "/api/v1/admin/actions", Title: "Alle acties", Signed: true,54
Do: func(ctx context.Context, in Input) (int, any) { return 200, map[string]any{"actions": s.Actions()} }},55
{Name: "config", Method: "GET", Path: "/api/v1/admin/config", Title: "Instellingen", Signed: true,56
Do: func(ctx context.Context, in Input) (int, any) { return 200, s.ConfigView() }},57
{Name: "config.update", Method: "PUT", Path: "/api/v1/admin/config", Title: "Instellingen opslaan", Signed: true,58
Fields: fieldKeys(), Do: s.actConfigUpdate},59
{Name: "connect", Method: "POST", Path: "/api/v1/admin/connect", Title: "Koppelen",60
Fields: []string{"url", "key", "on_conflict"}, Do: s.actConnect},61
{Name: "disconnect", Method: "POST", Path: "/api/v1/admin/disconnect", Title: "Ontkoppelen", Signed: true,62
Do: s.actDisconnect},63
{Name: "sync", Method: "POST", Path: "/api/v1/admin/sync", Title: "Nu synchroniseren", Signed: true,64
Fields: []string{"wait"}, Do: s.actSync},65
{Name: "archive", Method: "POST", Path: "/api/v1/admin/archive", Title: "Nu archiveren", Signed: true,66
Do: func(ctx context.Context, in Input) (int, any) {67
a, err := s.ArchiveNow()68
if err != nil {69
return 409, errBody(err)70
}71
return 201, a72
}},73
{Name: "prune", Method: "POST", Path: "/api/v1/admin/prune", Title: "Nu opruimen", Signed: true,74
Do: func(ctx context.Context, in Input) (int, any) {75
removed, err := s.Prune()76
if err != nil {77
return 500, errBody(err)78
}79
if removed == nil {80
removed = []string{}81
}82
return 200, map[string]any{"removed": removed}83
}},84
{Name: "archives", Method: "GET", Path: "/api/v1/admin/archives", Title: "Archieven", Signed: true,85
Do: func(ctx context.Context, in Input) (int, any) {86
list, err := s.archives.List()87
if err != nil {88
return 500, errBody(err)89
}90
return 200, map[string]any{"archives": list}91
}},92
{Name: "archive.download", Method: "GET", Path: "/api/v1/admin/archives/{name}/download", Title: "Downloaden",93
Params: []string{"name"}, Do: func(ctx context.Context, in Input) (int, any) {94
p, err := s.archives.Path(in["name"])95
if err != nil {96
return 404, errBody(err)97
}98
return 200, fileResult{path: p, name: in["name"]}99
}},100
{Name: "archive.delete", Method: "DELETE", Path: "/api/v1/admin/archives/{name}", Title: "Verwijderen", Signed: true,101
Params: []string{"name"}, Do: s.actArchiveDelete},102
{Name: "rollback", Method: "POST", Path: "/api/v1/admin/rollback", Title: "Rollback", Signed: true,103
Fields: []string{"archive", "confirm"}, Do: s.actRollback},104
}105
}106
107
func fieldKeys() []string {108
out := make([]string, 0, len(config.Fields))109
for _, f := range config.Fields {110
out = append(out, f.Key)111
}112
return out113
}114
115
func (s *Server) action(name string) (Action, bool) {116
for _, a := range s.Actions() {117
if a.Name == name {118
return a, true119
}120
}121
return Action{}, false122
}123
124
// ConfigView is GET /api/v1/admin/config.125
type ConfigView struct {126
Fields []ConfigField `json:"fields"`127
DataDir string `json:"data_dir"`128
// Restart: er staat een wijziging klaar die pas na een herstart geldt.129
Restart bool `json:"restart_pending"`130
}131
132
// ConfigField is een veld met zijn waarde.133
type ConfigField struct {134
config.Field135
Value string `json:"value"`136
}137
138
// ConfigView geeft alle instellingen met hun huidige waarde.139
func (s *Server) ConfigView() ConfigView {140
s.mu.Lock()141
defer s.mu.Unlock()142
v := ConfigView{DataDir: s.Cfg.DataDir, Restart: s.restartPending}143
for _, f := range config.Fields {144
val := s.Cfg.Get(f.Key)145
if f.Restart {146
if p, ok := s.settings[f.Key]; ok {147
val = p148
}149
}150
v.Fields = append(v.Fields, ConfigField{Field: f, Value: val})151
}152
return v153
}154
155
// UpdateConfig past instellingen toe en bewaart ze in settings.yml. Velden156
// met Restart gelden pas na een herstart.157
func (s *Server) UpdateConfig(set map[string]string) (ConfigView, error) {158
s.mu.Lock()159
next := s.Cfg160
if err := next.Apply(set); err != nil {161
s.mu.Unlock()162
return ConfigView{}, err163
}164
merged := map[string]string{}165
for k, v := range s.settings {166
merged[k] = v167
}168
for k := range set {169
merged[k] = next.Get(k)170
}171
if err := config.SaveSettings(next.DataDir, merged); err != nil {172
s.mu.Unlock()173
return ConfigView{}, err174
}175
for _, f := range config.Fields {176
if f.Restart {177
if _, ok := set[f.Key]; ok && next.Get(f.Key) != s.Cfg.Get(f.Key) {178
s.restartPending = true179
}180
// De draaiende waarde blijft tot de herstart.181
_ = next.Set(f.Key, s.Cfg.Get(f.Key))182
}183
}184
s.settings = merged185
s.Cfg = next186
s.mu.Unlock()187
s.limiter.SetRate(next.RateLimitKiB << 10)188
keys := make([]string, 0, len(set))189
for k := range set {190
keys = append(keys, k)191
}192
sort.Strings(keys)193
s.Log.Info("instellingen gewijzigd", "keys", strings.Join(keys, ","))194
// Kortere intervallen meteen laten gelden.195
s.Kick()196
return s.ConfigView(), nil197
}198
199
func (s *Server) actConfigUpdate(ctx context.Context, in Input) (int, any) {200
set := map[string]string{}201
for k, v := range in {202
set[k] = v203
}204
if len(set) == 0 {205
return 400, errBody(errors.New("geen instellingen meegegeven"))206
}207
v, err := s.UpdateConfig(set)208
if err != nil {209
return 400, errBody(err)210
}211
return 200, v212
}213
214
func (s *Server) actConnect(ctx context.Context, in Input) (int, any) {215
res, conflict, err := s.Connect(ctx, ConnectRequest{URL: in["url"], Key: in["key"], OnConflict: in["on_conflict"]})216
if conflict != nil {217
return http.StatusConflict, conflict218
}219
if err != nil {220
var he *mirror.HTTPError221
code := 502222
if errors.As(err, &he) && he.Status == 401 {223
code = 401224
}225
if errors.Is(err, errBadRequest) {226
code = 400227
}228
return code, errBody(err)229
}230
return 200, res231
}232
233
// Disconnect vergeet de gekoppelde BlueGit. De kopie en de archieven blijven234
// staan; een volgende koppeling met een andere BlueGit vraagt dan weer om235
// wissen of herstellen.236
func (s *Server) Disconnect() error {237
s.work.Lock()238
defer s.work.Unlock()239
st := s.getState()240
keep := State{InstanceID: st.InstanceID, BlueGitURL: st.BlueGitURL}241
if err := saveState(s.Cfg.DataDir, keep); err != nil {242
return err243
}244
s.mu.Lock()245
s.state = keep246
s.mu.Unlock()247
s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)248
return nil249
}250
251
func (s *Server) actDisconnect(ctx context.Context, in Input) (int, any) {252
if !s.getState().Connected() {253
return 409, errBody(errors.New("er is geen BlueGit gekoppeld"))254
}255
if err := s.Disconnect(); err != nil {256
return 500, errBody(err)257
}258
return 200, map[string]any{"connected": false}259
}260
261
func (s *Server) actSync(ctx context.Context, in Input) (int, any) {262
if !s.getState().Connected() {263
return 409, errBody(errors.New("geen BlueGit gekoppeld"))264
}265
if in["wait"] == "false" || in["wait"] == "0" {266
s.Kick()267
return 202, map[string]string{"state": "started"}268
}269
stats, err := s.SyncNow(ctx)270
if err != nil {271
return 502, errBody(err)272
}273
return 200, stats274
}275
276
func (s *Server) actArchiveDelete(ctx context.Context, in Input) (int, any) {277
name := in["name"]278
if !archive.ValidName(name) {279
return 400, errBody(errors.New("ongeldige archiefnaam"))280
}281
s.work.Lock()282
err := s.archives.Delete(name)283
s.work.Unlock()284
if err != nil {285
return 404, errBody(err)286
}287
s.Log.Info("archief verwijderd met de hand", "archive", name)288
return 200, map[string]string{"deleted": name}289
}290
291
func (s *Server) actRollback(ctx context.Context, in Input) (int, any) {292
name := in["archive"]293
if !archive.ValidName(name) {294
return 400, errBody(errors.New("ongeldige archiefnaam"))295
}296
if in["confirm"] != name {297
return 400, errBody(errors.New("bevestig met de archiefnaam in confirm; een rollback kan niet ongedaan worden gemaakt"))298
}299
return s.startRollback(name)300
}301
302
// startRollback start een rollback op de achtergrond.303
func (s *Server) startRollback(name string) (int, any) {304
if _, err := s.archives.Path(name); err != nil {305
return 404, errBody(err)306
}307
if !s.getState().Connected() {308
return 409, errBody(errors.New("geen BlueGit gekoppeld"))309
}310
s.mu.Lock()311
busy := s.rollback.State == "running"312
if !busy {313
s.rollback = RollbackStatus{State: "running", Archive: name, At: s.now().UTC()}314
}315
s.mu.Unlock()316
if busy {317
return 409, errBody(errors.New("er loopt al een rollback"))318
}319
s.Log.Warn("rollback gestart", "archive", name)320
go func() {321
if err := s.Rollback(context.Background(), name); err != nil {322
s.Log.Error("rollback mislukt", "archive", name, "err", err)323
}324
}()325
return http.StatusAccepted, map[string]string{"state": "running", "archive": name}326
}327
328
// ---------- HTTP ----------329
330
// Handler is de webinterface en de HTTP-API.331
func (s *Server) Handler() http.Handler {332
mux := http.NewServeMux()333
mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })334
// Van BlueGit, ondertekend (vaste protocolroutes).335
mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))336
mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))337
mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))338
mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))339
// Beheer: admin.token, een sessie van de webinterface, of BlueGit.340
for _, a := range s.Actions() {341
mux.HandleFunc(a.Method+" "+a.Path, s.apiAction(a))342
}343
mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)344
s.mountUI(mux)345
return securityHeaders(mux)346
}347
348
func securityHeaders(h http.Handler) http.Handler {349
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {350
w.Header().Set("X-Content-Type-Options", "nosniff")351
w.Header().Set("Referrer-Policy", "same-origin")352
h.ServeHTTP(w, r)353
})354
}355
356
// apiAction voert een actie uit voor de API.357
func (s *Server) apiAction(a Action) http.HandlerFunc {358
return func(w http.ResponseWriter, r *http.Request) {359
body, err := io.ReadAll(io.LimitReader(r.Body, 1<<20))360
if err != nil {361
writeErr(w, 400, "body")362
return363
}364
if code, msg := s.authorize(r, a, body); code != 0 {365
writeErr(w, code, msg)366
return367
}368
in, err := parseInput(r, body)369
if err != nil {370
writeErr(w, 400, err.Error())371
return372
}373
for _, p := range a.Params {374
in[p] = r.PathValue(p)375
}376
code, out := a.Do(r.Context(), in)377
if f, ok := out.(fileResult); ok {378
w.Header().Set("Content-Type", "application/gzip")379
w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%q", f.name))380
http.ServeFile(w, r, f.path)381
return382
}383
writeJSON(w, code, out)384
}385
}386
387
// authorize: 0 is toegestaan, anders de foutcode.388
func (s *Server) authorize(r *http.Request, a Action, body []byte) (int, string) {389
if tok, ok := strings.CutPrefix(r.Header.Get("Authorization"), "Bearer "); ok {390
if subtle.ConstantTimeCompare([]byte(strings.TrimSpace(tok)), []byte(s.adminToken)) == 1 {391
return 0, ""392
}393
return 401, "ongeldig token"394
}395
if r.Header.Get(protocol.HeaderSignature) != "" {396
if !a.Signed {397
return 403, "BlueGit mag dit niet"398
}399
st := s.getState()400
if !st.Connected() {401
return 401, "niet gekoppeld"402
}403
if r.Header.Get(protocol.HeaderInstance) != st.InstanceID {404
return 401, "andere BlueGit-instantie"405
}406
if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {407
return 401, err.Error()408
}409
return 0, ""410
}411
if sess, ok := s.session(r); ok {412
if r.Method != http.MethodGet && r.Method != http.MethodHead {413
if subtle.ConstantTimeCompare([]byte(r.Header.Get("X-CSRF-Token")), []byte(sess.csrf)) != 1 {414
return 403, "X-CSRF-Token ontbreekt of klopt niet"415
}416
}417
return 0, ""418
}419
return 401, "admin.token, sessie of BlueGit-handtekening nodig"420
}421
422
// parseInput leest de querystring en een JSON-object (waarden als tekst).423
func parseInput(r *http.Request, body []byte) (Input, error) {424
in := Input{}425
for k, v := range r.URL.Query() {426
if len(v) > 0 {427
in[k] = v[0]428
}429
}430
if len(strings.TrimSpace(string(body))) == 0 {431
return in, nil432
}433
var raw map[string]any434
if err := json.Unmarshal(body, &raw); err != nil {435
return nil, errors.New("ongeldige JSON: verwacht een object")436
}437
for k, v := range raw {438
switch t := v.(type) {439
case string:440
in[k] = t441
case float64:442
in[k] = strconv.FormatFloat(t, 'f', -1, 64)443
case bool:444
in[k] = strconv.FormatBool(t)445
case nil:446
in[k] = ""447
default:448
return nil, fmt.Errorf("veld %s: verwacht tekst, getal of boolean", k)449
}450
}451
return in, nil452
}@@ -58,6 +58,20 @@ type Server struct {
58
58
rollback RollbackStatus
59
59
60
60
kick chan struct{}
61
62
// settings is wat via webinterface, API of BlueGit is ingesteld.
63
settings map[string]string
64
restartPending bool
65
sessions map[string]session
66
loginFails map[string][]time.Time
67
}
68
69
// cfg is de huidige configuratie (instellingen kunnen tijdens het draaien
70
// veranderen).
71
func (s *Server) cfg() config.Config {
72
s.mu.Lock()
73
defer s.mu.Unlock()
74
return s.Cfg
61
75
}
62
76
63
77
// RollbackStatus is de stand van de laatste rollback of restore.
@@ -76,8 +90,14 @@ func New(cfg config.Config, log *slog.Logger) (*Server, error) {
76
90
if err := os.MkdirAll(cfg.DataDir, 0o750); err != nil {
77
91
return nil, err
78
92
}
79
s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1)}
80
var err error
93
set, err := config.LoadSettings(cfg.DataDir)
94
if err != nil {
95
return nil, err
96
}
97
if err := cfg.Apply(set); err != nil {
98
return nil, fmt.Errorf("%s: %w", config.SettingsFile, err)
99
}
100
s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1), settings: set, sessions: map[string]session{}}
81
101
if s.adminToken, err = secretFile(cfg.DataDir, "admin.token", "bba_"); err != nil {
82
102
return nil, err
83
103
}
@@ -131,15 +151,22 @@ func (s *Server) Kick() {
131
151
}
132
152
133
153
func (s *Server) syncLoop(ctx context.Context) {
134
full := time.NewTicker(s.Cfg.FullSyncInterval.Duration)
135
defer full.Stop()
136
154
s.Kick() // meteen na de start
137
155
for {
156
s.mu.Lock()
157
next := s.Cfg.FullSyncInterval.Duration - s.now().Sub(s.lastSync)
158
s.mu.Unlock()
159
if next < 0 {
160
next = 0
161
}
162
full := time.NewTimer(next)
138
163
select {
139
164
case <-ctx.Done():
165
full.Stop()
140
166
return
141
167
case <-full.C:
142
168
case <-s.kick:
169
full.Stop()
143
170
}
144
171
s.mu.Lock()
145
172
wait := s.Cfg.MinSyncInterval.Duration - s.now().Sub(s.lastSync)
@@ -192,13 +219,11 @@ func (s *Server) SyncNow(ctx context.Context) (mirror.Stats, error) {
192
219
}
193
220
194
221
func (s *Server) archiveLoop(ctx context.Context) {
195
t := time.NewTicker(s.tick())
196
defer t.Stop()
197
222
for {
198
223
select {
199
224
case <-ctx.Done():
200
225
return
201
case <-t.C:
226
case <-time.After(s.tick()):
202
227
}
203
228
s.mu.Lock()
204
229
due := s.now().Sub(s.lastArchive) >= s.Cfg.ArchiveInterval.Duration
@@ -217,7 +242,7 @@ func (s *Server) archiveLoop(ctx context.Context) {
217
242
218
243
// tick is hoe vaak de archieflus kijkt: een minuut, of korter bij een kort interval.
219
244
func (s *Server) tick() time.Duration {
220
d := s.Cfg.ArchiveInterval.Duration / 4
245
d := s.cfg().ArchiveInterval.Duration / 4
221
246
if d > time.Minute {
222
247
d = time.Minute
223
248
}
@@ -251,7 +276,7 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {
251
276
return a, err
252
277
}
253
278
s.Log.Info("archief gemaakt", "archive", a.Name, "bytes", a.Size)
254
if pr, err := s.archives.Prune(now, s.Cfg.RetentionDays, s.minFree()); err == nil {
279
if pr, err := s.archives.Prune(now, s.cfg().RetentionDays, s.minFree()); err == nil {
255
280
for _, r := range pr {
256
281
s.Log.Info("archief verwijderd", "archive", r)
257
282
}
@@ -259,41 +284,19 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {
259
284
return a, nil
260
285
}
261
286
262
func (s *Server) minFree() uint64 { return uint64(s.Cfg.MinFreeMB) << 20 }
287
func (s *Server) minFree() uint64 { return uint64(s.cfg().MinFreeMB) << 20 }
263
288
264
289
// Prune past de bewaarregels toe.
265
290
func (s *Server) Prune() ([]string, error) {
266
291
s.work.Lock()
267
292
defer s.work.Unlock()
268
removed, err := s.archives.Prune(s.now(), s.Cfg.RetentionDays, s.minFree())
293
removed, err := s.archives.Prune(s.now(), s.cfg().RetentionDays, s.minFree())
269
294
for _, r := range removed {
270
295
s.Log.Info("archief verwijderd", "archive", r)
271
296
}
272
297
return removed, err
273
298
}
274
299
275
// ---------- HTTP ----------
276
277
// Handler is de HTTP-API.
278
func (s *Server) Handler() http.Handler {
279
mux := http.NewServeMux()
280
mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })
281
// Van BlueGit, ondertekend.
282
mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))
283
mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))
284
mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))
285
mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))
286
// Lokaal beheer, met admin.token.
287
mux.HandleFunc("GET /api/v1/admin/status", s.admin(s.apiStatus))
288
mux.HandleFunc("GET /api/v1/admin/archives", s.admin(s.apiArchives))
289
mux.HandleFunc("POST /api/v1/admin/connect", s.admin(s.apiConnect))
290
mux.HandleFunc("POST /api/v1/admin/sync", s.admin(s.apiSync))
291
mux.HandleFunc("POST /api/v1/admin/archive", s.admin(s.apiArchiveNow))
292
mux.HandleFunc("POST /api/v1/admin/prune", s.admin(s.apiPrune))
293
mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)
294
return mux
295
}
296
297
300
func writeJSON(w http.ResponseWriter, code int, v any) {
298
301
w.Header().Set("Content-Type", "application/json")
299
302
w.Header().Set("Cache-Control", "no-store")
@@ -343,17 +346,6 @@ func bodyOf(r *http.Request) []byte {
343
346
return b
344
347
}
345
348
346
func (s *Server) admin(h http.HandlerFunc) http.HandlerFunc {
347
return func(w http.ResponseWriter, r *http.Request) {
348
tok := strings.TrimSpace(strings.TrimPrefix(r.Header.Get("Authorization"), "Bearer "))
349
if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {
350
writeErr(w, http.StatusUnauthorized, "admin.token nodig")
351
return
352
}
353
h(w, r)
354
}
355
}
356
357
349
func (s *Server) apiNotify(w http.ResponseWriter, r *http.Request) {
358
350
s.mu.Lock()
359
351
s.notifies++
@@ -409,36 +401,6 @@ func (s *Server) Status() Status {
409
401
410
402
func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
411
403
412
func (s *Server) apiSync(w http.ResponseWriter, r *http.Request) {
413
stats, err := s.SyncNow(r.Context())
414
if err != nil {
415
writeErr(w, 502, err.Error())
416
return
417
}
418
writeJSON(w, 200, stats)
419
}
420
421
func (s *Server) apiArchiveNow(w http.ResponseWriter, r *http.Request) {
422
a, err := s.ArchiveNow()
423
if err != nil {
424
writeErr(w, 409, err.Error())
425
return
426
}
427
writeJSON(w, 201, a)
428
}
429
430
func (s *Server) apiPrune(w http.ResponseWriter, r *http.Request) {
431
removed, err := s.Prune()
432
if err != nil {
433
writeErr(w, 500, err.Error())
434
return
435
}
436
if removed == nil {
437
removed = []string{}
438
}
439
writeJSON(w, 200, map[string]any{"removed": removed})
440
}
441
442
404
// ---------- koppelen ----------
443
405
444
406
// ConnectRequest is POST /api/v1/admin/connect.
@@ -461,32 +423,6 @@ type ConflictError struct {
461
423
Choices []string `json:"choices"`
462
424
}
463
425
464
func (s *Server) apiConnect(w http.ResponseWriter, r *http.Request) {
465
var in ConnectRequest
466
if err := json.Unmarshal(bodyOf(r), &in); err != nil {
467
writeErr(w, 400, "ongeldige JSON")
468
return
469
}
470
res, conflict, err := s.Connect(r.Context(), in)
471
if conflict != nil {
472
writeJSON(w, http.StatusConflict, conflict)
473
return
474
}
475
if err != nil {
476
var he *mirror.HTTPError
477
code := 502
478
if errors.As(err, &he) && he.Status == 401 {
479
code = 401
480
}
481
if errors.Is(err, errBadRequest) {
482
code = 400
483
}
484
writeErr(w, code, err.Error())
485
return
486
}
487
writeJSON(w, 200, res)
488
}
489
490
426
var errBadRequest = errors.New("ongeldig verzoek")
491
427
492
428
// Connect koppelt deze server aan een BlueGit. Er is er altijd hoogstens één.
@@ -504,7 +440,8 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
504
440
default:
505
441
return nil, nil, fmt.Errorf("%w: on_conflict moet wipe of restore zijn", errBadRequest)
506
442
}
507
if s.Cfg.PublicURL == "" {
443
pub := s.cfg().PublicURL
444
if pub == "" {
508
445
return nil, nil, fmt.Errorf("%w: zet public_url in de configuratie; BlueGit moet deze server kunnen bereiken", errBadRequest)
509
446
}
510
447
s.work.Lock()
@@ -544,7 +481,7 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
544
481
if mode == "restore" && s.mirror.Empty() {
545
482
return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
546
483
}
547
if err := rem.Connect(ctx, s.Cfg.PublicURL, s.serverID); err != nil {
484
if err := rem.Connect(ctx, pub, s.serverID); err != nil {
548
485
return nil, nil, err
549
486
}
550
487
st := State{BlueGitURL: in.URL, Key: in.Key, InstanceID: info.InstanceID, ConnectedAt: s.now().UTC()}
@@ -601,27 +538,8 @@ func (s *Server) apiRollback(w http.ResponseWriter, r *http.Request) {
601
538
writeErr(w, 400, "ongeldige archiefnaam")
602
539
return
603
540
}
604
if _, err := s.archives.Path(in.Archive); err != nil {
605
writeErr(w, 404, err.Error())
606
return
607
}
608
s.mu.Lock()
609
busy := s.rollback.State == "running"
610
if !busy {
611
s.rollback = RollbackStatus{State: "running", Archive: in.Archive, At: s.now().UTC()}
612
}
613
s.mu.Unlock()
614
if busy {
615
writeErr(w, 409, "er loopt al een rollback")
616
return
617
}
618
s.Log.Warn("rollback gestart", "archive", in.Archive)
619
go func() {
620
if err := s.Rollback(context.Background(), in.Archive); err != nil {
621
s.Log.Error("rollback mislukt", "archive", in.Archive, "err", err)
622
}
623
}()
624
writeJSON(w, http.StatusAccepted, map[string]string{"state": "running", "archive": in.Archive})
541
code, out := s.startRollback(in.Archive)
542
writeJSON(w, code, out)
625
543
}
626
544
627
545
// Rollback pakt een archief uit, vervangt daarmee de draaiende kopie en
@@ -58,6 +58,20 @@ type Server struct {58
rollback RollbackStatus58
rollback RollbackStatus59
59
60
kick chan struct{}60
kick chan struct{}61
62
// settings is wat via webinterface, API of BlueGit is ingesteld.63
settings map[string]string64
restartPending bool65
sessions map[string]session66
loginFails map[string][]time.Time67
}68
69
// cfg is de huidige configuratie (instellingen kunnen tijdens het draaien70
// veranderen).71
func (s *Server) cfg() config.Config {72
s.mu.Lock()73
defer s.mu.Unlock()74
return s.Cfg61
}75
}62
76
63
// RollbackStatus is de stand van de laatste rollback of restore.77
// RollbackStatus is de stand van de laatste rollback of restore.@@ -76,8 +90,14 @@ func New(cfg config.Config, log *slog.Logger) (*Server, error) {76
if err := os.MkdirAll(cfg.DataDir, 0o750); err != nil {90
if err := os.MkdirAll(cfg.DataDir, 0o750); err != nil {77
return nil, err91
return nil, err78
}92
}79
s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1)}93
set, err := config.LoadSettings(cfg.DataDir)80
var err error94
if err != nil {95
return nil, err96
}97
if err := cfg.Apply(set); err != nil {98
return nil, fmt.Errorf("%s: %w", config.SettingsFile, err)99
}100
s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1), settings: set, sessions: map[string]session{}}81
if s.adminToken, err = secretFile(cfg.DataDir, "admin.token", "bba_"); err != nil {101
if s.adminToken, err = secretFile(cfg.DataDir, "admin.token", "bba_"); err != nil {82
return nil, err102
return nil, err83
}103
}@@ -131,15 +151,22 @@ func (s *Server) Kick() {131
}151
}132
152
133
func (s *Server) syncLoop(ctx context.Context) {153
func (s *Server) syncLoop(ctx context.Context) {134
full := time.NewTicker(s.Cfg.FullSyncInterval.Duration)135
defer full.Stop()136
s.Kick() // meteen na de start154
s.Kick() // meteen na de start137
for {155
for {156
s.mu.Lock()157
next := s.Cfg.FullSyncInterval.Duration - s.now().Sub(s.lastSync)158
s.mu.Unlock()159
if next < 0 {160
next = 0161
}162
full := time.NewTimer(next)138
select {163
select {139
case <-ctx.Done():164
case <-ctx.Done():165
full.Stop()140
return166
return141
case <-full.C:167
case <-full.C:142
case <-s.kick:168
case <-s.kick:169
full.Stop()143
}170
}144
s.mu.Lock()171
s.mu.Lock()145
wait := s.Cfg.MinSyncInterval.Duration - s.now().Sub(s.lastSync)172
wait := s.Cfg.MinSyncInterval.Duration - s.now().Sub(s.lastSync)@@ -192,13 +219,11 @@ func (s *Server) SyncNow(ctx context.Context) (mirror.Stats, error) {192
}219
}193
220
194
func (s *Server) archiveLoop(ctx context.Context) {221
func (s *Server) archiveLoop(ctx context.Context) {195
t := time.NewTicker(s.tick())196
defer t.Stop()197
for {222
for {198
select {223
select {199
case <-ctx.Done():224
case <-ctx.Done():200
return225
return201
case <-t.C:226
case <-time.After(s.tick()):202
}227
}203
s.mu.Lock()228
s.mu.Lock()204
due := s.now().Sub(s.lastArchive) >= s.Cfg.ArchiveInterval.Duration229
due := s.now().Sub(s.lastArchive) >= s.Cfg.ArchiveInterval.Duration@@ -217,7 +242,7 @@ func (s *Server) archiveLoop(ctx context.Context) {217
242
218
// tick is hoe vaak de archieflus kijkt: een minuut, of korter bij een kort interval.243
// tick is hoe vaak de archieflus kijkt: een minuut, of korter bij een kort interval.219
func (s *Server) tick() time.Duration {244
func (s *Server) tick() time.Duration {220
d := s.Cfg.ArchiveInterval.Duration / 4245
d := s.cfg().ArchiveInterval.Duration / 4221
if d > time.Minute {246
if d > time.Minute {222
d = time.Minute247
d = time.Minute223
}248
}@@ -251,7 +276,7 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {251
return a, err276
return a, err252
}277
}253
s.Log.Info("archief gemaakt", "archive", a.Name, "bytes", a.Size)278
s.Log.Info("archief gemaakt", "archive", a.Name, "bytes", a.Size)254
if pr, err := s.archives.Prune(now, s.Cfg.RetentionDays, s.minFree()); err == nil {279
if pr, err := s.archives.Prune(now, s.cfg().RetentionDays, s.minFree()); err == nil {255
for _, r := range pr {280
for _, r := range pr {256
s.Log.Info("archief verwijderd", "archive", r)281
s.Log.Info("archief verwijderd", "archive", r)257
}282
}@@ -259,41 +284,19 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {259
return a, nil284
return a, nil260
}285
}261
286
262
func (s *Server) minFree() uint64 { return uint64(s.Cfg.MinFreeMB) << 20 }287
func (s *Server) minFree() uint64 { return uint64(s.cfg().MinFreeMB) << 20 }263
288
264
// Prune past de bewaarregels toe.289
// Prune past de bewaarregels toe.265
func (s *Server) Prune() ([]string, error) {290
func (s *Server) Prune() ([]string, error) {266
s.work.Lock()291
s.work.Lock()267
defer s.work.Unlock()292
defer s.work.Unlock()268
removed, err := s.archives.Prune(s.now(), s.Cfg.RetentionDays, s.minFree())293
removed, err := s.archives.Prune(s.now(), s.cfg().RetentionDays, s.minFree())269
for _, r := range removed {294
for _, r := range removed {270
s.Log.Info("archief verwijderd", "archive", r)295
s.Log.Info("archief verwijderd", "archive", r)271
}296
}272
return removed, err297
return removed, err273
}298
}274
299
275
// ---------- HTTP ----------276
277
// Handler is de HTTP-API.278
func (s *Server) Handler() http.Handler {279
mux := http.NewServeMux()280
mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })281
// Van BlueGit, ondertekend.282
mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))283
mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))284
mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))285
mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))286
// Lokaal beheer, met admin.token.287
mux.HandleFunc("GET /api/v1/admin/status", s.admin(s.apiStatus))288
mux.HandleFunc("GET /api/v1/admin/archives", s.admin(s.apiArchives))289
mux.HandleFunc("POST /api/v1/admin/connect", s.admin(s.apiConnect))290
mux.HandleFunc("POST /api/v1/admin/sync", s.admin(s.apiSync))291
mux.HandleFunc("POST /api/v1/admin/archive", s.admin(s.apiArchiveNow))292
mux.HandleFunc("POST /api/v1/admin/prune", s.admin(s.apiPrune))293
mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)294
return mux295
}296
297
func writeJSON(w http.ResponseWriter, code int, v any) {300
func writeJSON(w http.ResponseWriter, code int, v any) {298
w.Header().Set("Content-Type", "application/json")301
w.Header().Set("Content-Type", "application/json")299
w.Header().Set("Cache-Control", "no-store")302
w.Header().Set("Cache-Control", "no-store")@@ -343,17 +346,6 @@ func bodyOf(r *http.Request) []byte {343
return b346
return b344
}347
}345
348
346
func (s *Server) admin(h http.HandlerFunc) http.HandlerFunc {347
return func(w http.ResponseWriter, r *http.Request) {348
tok := strings.TrimSpace(strings.TrimPrefix(r.Header.Get("Authorization"), "Bearer "))349
if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {350
writeErr(w, http.StatusUnauthorized, "admin.token nodig")351
return352
}353
h(w, r)354
}355
}356
357
func (s *Server) apiNotify(w http.ResponseWriter, r *http.Request) {349
func (s *Server) apiNotify(w http.ResponseWriter, r *http.Request) {358
s.mu.Lock()350
s.mu.Lock()359
s.notifies++351
s.notifies++@@ -409,36 +401,6 @@ func (s *Server) Status() Status {409
401
410
func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }402
func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }411
403
412
func (s *Server) apiSync(w http.ResponseWriter, r *http.Request) {413
stats, err := s.SyncNow(r.Context())414
if err != nil {415
writeErr(w, 502, err.Error())416
return417
}418
writeJSON(w, 200, stats)419
}420
421
func (s *Server) apiArchiveNow(w http.ResponseWriter, r *http.Request) {422
a, err := s.ArchiveNow()423
if err != nil {424
writeErr(w, 409, err.Error())425
return426
}427
writeJSON(w, 201, a)428
}429
430
func (s *Server) apiPrune(w http.ResponseWriter, r *http.Request) {431
removed, err := s.Prune()432
if err != nil {433
writeErr(w, 500, err.Error())434
return435
}436
if removed == nil {437
removed = []string{}438
}439
writeJSON(w, 200, map[string]any{"removed": removed})440
}441
442
// ---------- koppelen ----------404
// ---------- koppelen ----------443
405
444
// ConnectRequest is POST /api/v1/admin/connect.406
// ConnectRequest is POST /api/v1/admin/connect.@@ -461,32 +423,6 @@ type ConflictError struct {461
Choices []string `json:"choices"`423
Choices []string `json:"choices"`462
}424
}463
425
464
func (s *Server) apiConnect(w http.ResponseWriter, r *http.Request) {465
var in ConnectRequest466
if err := json.Unmarshal(bodyOf(r), &in); err != nil {467
writeErr(w, 400, "ongeldige JSON")468
return469
}470
res, conflict, err := s.Connect(r.Context(), in)471
if conflict != nil {472
writeJSON(w, http.StatusConflict, conflict)473
return474
}475
if err != nil {476
var he *mirror.HTTPError477
code := 502478
if errors.As(err, &he) && he.Status == 401 {479
code = 401480
}481
if errors.Is(err, errBadRequest) {482
code = 400483
}484
writeErr(w, code, err.Error())485
return486
}487
writeJSON(w, 200, res)488
}489
490
var errBadRequest = errors.New("ongeldig verzoek")426
var errBadRequest = errors.New("ongeldig verzoek")491
427
492
// Connect koppelt deze server aan een BlueGit. Er is er altijd hoogstens één.428
// Connect koppelt deze server aan een BlueGit. Er is er altijd hoogstens één.@@ -504,7 +440,8 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any504
default:440
default:505
return nil, nil, fmt.Errorf("%w: on_conflict moet wipe of restore zijn", errBadRequest)441
return nil, nil, fmt.Errorf("%w: on_conflict moet wipe of restore zijn", errBadRequest)506
}442
}507
if s.Cfg.PublicURL == "" {443
pub := s.cfg().PublicURL444
if pub == "" {508
return nil, nil, fmt.Errorf("%w: zet public_url in de configuratie; BlueGit moet deze server kunnen bereiken", errBadRequest)445
return nil, nil, fmt.Errorf("%w: zet public_url in de configuratie; BlueGit moet deze server kunnen bereiken", errBadRequest)509
}446
}510
s.work.Lock()447
s.work.Lock()@@ -544,7 +481,7 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any544
if mode == "restore" && s.mirror.Empty() {481
if mode == "restore" && s.mirror.Empty() {545
return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)482
return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)546
}483
}547
if err := rem.Connect(ctx, s.Cfg.PublicURL, s.serverID); err != nil {484
if err := rem.Connect(ctx, pub, s.serverID); err != nil {548
return nil, nil, err485
return nil, nil, err549
}486
}550
st := State{BlueGitURL: in.URL, Key: in.Key, InstanceID: info.InstanceID, ConnectedAt: s.now().UTC()}487
st := State{BlueGitURL: in.URL, Key: in.Key, InstanceID: info.InstanceID, ConnectedAt: s.now().UTC()}@@ -601,27 +538,8 @@ func (s *Server) apiRollback(w http.ResponseWriter, r *http.Request) {601
writeErr(w, 400, "ongeldige archiefnaam")538
writeErr(w, 400, "ongeldige archiefnaam")602
return539
return603
}540
}604
if _, err := s.archives.Path(in.Archive); err != nil {541
code, out := s.startRollback(in.Archive)605
writeErr(w, 404, err.Error())542
writeJSON(w, code, out)606
return607
}608
s.mu.Lock()609
busy := s.rollback.State == "running"610
if !busy {611
s.rollback = RollbackStatus{State: "running", Archive: in.Archive, At: s.now().UTC()}612
}613
s.mu.Unlock()614
if busy {615
writeErr(w, 409, "er loopt al een rollback")616
return617
}618
s.Log.Warn("rollback gestart", "archive", in.Archive)619
go func() {620
if err := s.Rollback(context.Background(), in.Archive); err != nil {621
s.Log.Error("rollback mislukt", "archive", in.Archive, "err", err)622
}623
}()624
writeJSON(w, http.StatusAccepted, map[string]string{"state": "running", "archive": in.Archive})625
}543
}626
544
627
// Rollback pakt een archief uit, vervangt daarmee de draaiende kopie en545
// Rollback pakt een archief uit, vervangt daarmee de draaiende kopie en@@ -0,0 +1,303 @@
1
package server
2
3
import (
4
"crypto/rand"
5
"crypto/subtle"
6
"embed"
7
"encoding/hex"
8
"encoding/json"
9
"fmt"
10
"html/template"
11
"net"
12
"net/http"
13
"net/url"
14
"strings"
15
"time"
16
17
"git.timfalken.com/timfa/bluegit-backup/internal/archive"
18
)
19
20
//go:embed web/*
21
var webFS embed.FS
22
23
var uiTmpl = template.Must(template.New("").Funcs(template.FuncMap{
24
"bytes": humanBytes,
25
"when": func(t time.Time) string {
26
if t.IsZero() {
27
return "nog niet"
28
}
29
return t.Local().Format("2006-01-02 15:04:05")
30
},
31
"json": func(v any) string { b, _ := json.MarshalIndent(v, "", " "); return string(b) },
32
}).ParseFS(webFS, "web/*.html"))
33
34
const (
35
sessionCookie = "bbsession"
36
sessionTTL = 12 * time.Hour
37
)
38
39
type session struct {
40
csrf string
41
expires time.Time
42
flash string
43
isErr bool
44
}
45
46
func randHex(n int) string {
47
b := make([]byte, n)
48
_, _ = rand.Read(b)
49
return hex.EncodeToString(b)
50
}
51
52
func humanBytes(n int64) string {
53
const unit = 1024
54
if n < unit {
55
return fmt.Sprintf("%d B", n)
56
}
57
div, exp := int64(unit), 0
58
for m := n / unit; m >= unit; m /= unit {
59
div *= unit
60
exp++
61
}
62
return fmt.Sprintf("%.1f %ciB", float64(n)/float64(div), "KMGTPE"[exp])
63
}
64
65
func (s *Server) session(r *http.Request) (session, bool) {
66
c, err := r.Cookie(sessionCookie)
67
if err != nil || c.Value == "" {
68
return session{}, false
69
}
70
s.mu.Lock()
71
defer s.mu.Unlock()
72
sess, ok := s.sessions[c.Value]
73
if !ok || s.now().After(sess.expires) {
74
delete(s.sessions, c.Value)
75
return session{}, false
76
}
77
return sess, true
78
}
79
80
func (s *Server) setFlash(r *http.Request, msg string, isErr bool) {
81
c, err := r.Cookie(sessionCookie)
82
if err != nil {
83
return
84
}
85
s.mu.Lock()
86
defer s.mu.Unlock()
87
if sess, ok := s.sessions[c.Value]; ok {
88
sess.flash, sess.isErr = msg, isErr
89
s.sessions[c.Value] = sess
90
}
91
}
92
93
func (s *Server) takeFlash(r *http.Request) (string, bool) {
94
c, err := r.Cookie(sessionCookie)
95
if err != nil {
96
return "", false
97
}
98
s.mu.Lock()
99
defer s.mu.Unlock()
100
sess, ok := s.sessions[c.Value]
101
if !ok {
102
return "", false
103
}
104
msg, isErr := sess.flash, sess.isErr
105
sess.flash, sess.isErr = "", false
106
s.sessions[c.Value] = sess
107
return msg, isErr
108
}
109
110
func clientIP(r *http.Request) string {
111
h, _, err := net.SplitHostPort(r.RemoteAddr)
112
if err != nil {
113
return r.RemoteAddr
114
}
115
return h
116
}
117
118
// loginAllowed: hoogstens 5 foute pogingen per minuut per IP-adres.
119
func (s *Server) loginAllowed(ip string, failed bool) bool {
120
s.mu.Lock()
121
defer s.mu.Unlock()
122
if s.loginFails == nil {
123
s.loginFails = map[string][]time.Time{}
124
}
125
cut := s.now().Add(-time.Minute)
126
keep := s.loginFails[ip][:0]
127
for _, t := range s.loginFails[ip] {
128
if t.After(cut) {
129
keep = append(keep, t)
130
}
131
}
132
if failed {
133
keep = append(keep, s.now())
134
}
135
s.loginFails[ip] = keep
136
return len(keep) < 5
137
}
138
139
func (s *Server) mountUI(mux *http.ServeMux) {
140
mux.HandleFunc("GET /{$}", s.uiIndex)
141
mux.HandleFunc("GET /login", s.uiLoginPage)
142
mux.HandleFunc("POST /login", s.uiLogin)
143
mux.HandleFunc("POST /logout", s.uiLogout)
144
mux.HandleFunc("POST /ui/act/{name}", s.uiAct)
145
}
146
147
func (s *Server) render(w http.ResponseWriter, name string, data any) {
148
w.Header().Set("Content-Type", "text/html; charset=utf-8")
149
w.Header().Set("Cache-Control", "no-store")
150
w.Header().Set("Content-Security-Policy", "default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'none'; frame-ancestors 'none'; form-action 'self'")
151
w.Header().Set("X-Frame-Options", "DENY")
152
if err := uiTmpl.ExecuteTemplate(w, name, data); err != nil {
153
s.Log.Error("template", "name", name, "err", err)
154
}
155
}
156
157
func (s *Server) uiLoginPage(w http.ResponseWriter, r *http.Request) {
158
if _, ok := s.session(r); ok {
159
http.Redirect(w, r, "/", http.StatusSeeOther)
160
return
161
}
162
s.render(w, "login.html", map[string]any{"Error": r.URL.Query().Get("fout") != "", "Version": Version})
163
}
164
165
func (s *Server) uiLogin(w http.ResponseWriter, r *http.Request) {
166
ip := clientIP(r)
167
if !s.loginAllowed(ip, false) {
168
http.Error(w, "te veel pogingen, wacht een minuut", http.StatusTooManyRequests)
169
return
170
}
171
tok := strings.TrimSpace(r.PostFormValue("token"))
172
if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {
173
s.loginAllowed(ip, true)
174
http.Redirect(w, r, "/login?fout=1", http.StatusSeeOther)
175
return
176
}
177
id := randHex(32)
178
s.mu.Lock()
179
for k, v := range s.sessions {
180
if s.now().After(v.expires) {
181
delete(s.sessions, k)
182
}
183
}
184
s.sessions[id] = session{csrf: randHex(16), expires: s.now().Add(sessionTTL)}
185
s.mu.Unlock()
186
http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: id, Path: "/", HttpOnly: true,
187
SameSite: http.SameSiteStrictMode, Secure: r.TLS != nil || r.Header.Get("X-Forwarded-Proto") == "https",
188
MaxAge: int(sessionTTL / time.Second)})
189
http.Redirect(w, r, "/", http.StatusSeeOther)
190
}
191
192
func (s *Server) uiLogout(w http.ResponseWriter, r *http.Request) {
193
if sess, ok := s.session(r); ok && r.PostFormValue("csrf") == sess.csrf {
194
c, _ := r.Cookie(sessionCookie)
195
s.mu.Lock()
196
delete(s.sessions, c.Value)
197
s.mu.Unlock()
198
}
199
http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: "", Path: "/", MaxAge: -1, HttpOnly: true})
200
http.Redirect(w, r, "/login", http.StatusSeeOther)
201
}
202
203
// pageData is wat de webinterface toont: precies de uitkomst van de
204
// GET-acties uit Actions.
205
type pageData struct {
206
CSRF string
207
Flash string
208
FlashErr bool
209
Status Status
210
Config ConfigView
211
Archives []archive.Archive
212
Actions []Action
213
Version string
214
}
215
216
func (s *Server) uiIndex(w http.ResponseWriter, r *http.Request) {
217
sess, ok := s.session(r)
218
if !ok {
219
http.Redirect(w, r, "/login", http.StatusSeeOther)
220
return
221
}
222
d := pageData{CSRF: sess.csrf, Status: s.Status(), Config: s.ConfigView(), Actions: s.Actions(), Version: Version}
223
d.Archives, _ = s.archives.List()
224
d.Flash, d.FlashErr = s.takeFlash(r)
225
s.render(w, "index.html", d)
226
}
227
228
// uiAct voert een actie uit vanuit een formulier, via dezelfde code als de API.
229
func (s *Server) uiAct(w http.ResponseWriter, r *http.Request) {
230
sess, ok := s.session(r)
231
if !ok {
232
http.Redirect(w, r, "/login", http.StatusSeeOther)
233
return
234
}
235
if err := r.ParseForm(); err != nil {
236
http.Error(w, "formulier", 400)
237
return
238
}
239
if subtle.ConstantTimeCompare([]byte(r.PostFormValue("csrf")), []byte(sess.csrf)) != 1 {
240
http.Error(w, "CSRF-token klopt niet; laad de pagina opnieuw", http.StatusForbidden)
241
return
242
}
243
a, ok := s.action(r.PathValue("name"))
244
if !ok || a.Method == http.MethodGet {
245
http.NotFound(w, r)
246
return
247
}
248
in := Input{}
249
for k, v := range r.PostForm {
250
if k == "csrf" || k == "understood" || len(v) == 0 {
251
continue
252
}
253
in[k] = v[0]
254
}
255
anchor := "#" + strings.SplitN(a.Name, ".", 2)[0]
256
if a.Name == "rollback" && r.PostFormValue("understood") == "" {
257
s.setFlash(r, "Vink aan dat je begrijpt dat een rollback niet ongedaan kan worden gemaakt.", true)
258
http.Redirect(w, r, "/#archives", http.StatusSeeOther)
259
return
260
}
261
if a.Name == "sync" {
262
in["wait"] = "false"
263
}
264
code, out := a.Do(r.Context(), in)
265
msg, isErr := describe(a, code, out)
266
s.setFlash(r, msg, isErr)
267
http.Redirect(w, r, "/"+anchor, http.StatusSeeOther)
268
}
269
270
func describe(a Action, code int, out any) (string, bool) {
271
if code >= 400 {
272
switch v := out.(type) {
273
case *ConflictError:
274
return fmt.Sprintf("%s (vorige: %s, %d archieven). Kies hieronder ‘oude backups wissen’ of ‘nieuwe BlueGit herstellen’ en koppel opnieuw.", v.Error, v.PreviousURL, v.Archives), true
275
case map[string]string:
276
return a.Title + " mislukt: " + v["error"], true
277
}
278
return fmt.Sprintf("%s mislukt (HTTP %d)", a.Title, code), true
279
}
280
switch a.Name {
281
case "sync":
282
return "Synchronisatie gestart.", false
283
case "archive":
284
if v, ok := out.(archive.Archive); ok {
285
return "Archief gemaakt: " + v.Name, false
286
}
287
case "prune":
288
if v, ok := out.(map[string]any); ok {
289
return fmt.Sprintf("Opgeruimd: %d archieven.", len(v["removed"].([]string))), false
290
}
291
case "rollback":
292
return "Rollback gestart. BlueGit herstart zodra de data er staat.", false
293
case "config.update":
294
if v, ok := out.(ConfigView); ok && v.Restart {
295
return "Instellingen opgeslagen. Een deel geldt pas na een herstart.", false
296
}
297
return "Instellingen opgeslagen.", false
298
}
299
return a.Title + ": gelukt.", false
300
}
301
302
// UIPath is het formulieradres van een actie in de webinterface.
303
func UIPath(a Action) string { return "/ui/act/" + url.PathEscape(a.Name) }
@@ -0,0 +1,303 @@1
package server2
3
import (4
"crypto/rand"5
"crypto/subtle"6
"embed"7
"encoding/hex"8
"encoding/json"9
"fmt"10
"html/template"11
"net"12
"net/http"13
"net/url"14
"strings"15
"time"16
17
"git.timfalken.com/timfa/bluegit-backup/internal/archive"18
)19
20
//go:embed web/*21
var webFS embed.FS22
23
var uiTmpl = template.Must(template.New("").Funcs(template.FuncMap{24
"bytes": humanBytes,25
"when": func(t time.Time) string {26
if t.IsZero() {27
return "nog niet"28
}29
return t.Local().Format("2006-01-02 15:04:05")30
},31
"json": func(v any) string { b, _ := json.MarshalIndent(v, "", " "); return string(b) },32
}).ParseFS(webFS, "web/*.html"))33
34
const (35
sessionCookie = "bbsession"36
sessionTTL = 12 * time.Hour37
)38
39
type session struct {40
csrf string41
expires time.Time42
flash string43
isErr bool44
}45
46
func randHex(n int) string {47
b := make([]byte, n)48
_, _ = rand.Read(b)49
return hex.EncodeToString(b)50
}51
52
func humanBytes(n int64) string {53
const unit = 102454
if n < unit {55
return fmt.Sprintf("%d B", n)56
}57
div, exp := int64(unit), 058
for m := n / unit; m >= unit; m /= unit {59
div *= unit60
exp++61
}62
return fmt.Sprintf("%.1f %ciB", float64(n)/float64(div), "KMGTPE"[exp])63
}64
65
func (s *Server) session(r *http.Request) (session, bool) {66
c, err := r.Cookie(sessionCookie)67
if err != nil || c.Value == "" {68
return session{}, false69
}70
s.mu.Lock()71
defer s.mu.Unlock()72
sess, ok := s.sessions[c.Value]73
if !ok || s.now().After(sess.expires) {74
delete(s.sessions, c.Value)75
return session{}, false76
}77
return sess, true78
}79
80
func (s *Server) setFlash(r *http.Request, msg string, isErr bool) {81
c, err := r.Cookie(sessionCookie)82
if err != nil {83
return84
}85
s.mu.Lock()86
defer s.mu.Unlock()87
if sess, ok := s.sessions[c.Value]; ok {88
sess.flash, sess.isErr = msg, isErr89
s.sessions[c.Value] = sess90
}91
}92
93
func (s *Server) takeFlash(r *http.Request) (string, bool) {94
c, err := r.Cookie(sessionCookie)95
if err != nil {96
return "", false97
}98
s.mu.Lock()99
defer s.mu.Unlock()100
sess, ok := s.sessions[c.Value]101
if !ok {102
return "", false103
}104
msg, isErr := sess.flash, sess.isErr105
sess.flash, sess.isErr = "", false106
s.sessions[c.Value] = sess107
return msg, isErr108
}109
110
func clientIP(r *http.Request) string {111
h, _, err := net.SplitHostPort(r.RemoteAddr)112
if err != nil {113
return r.RemoteAddr114
}115
return h116
}117
118
// loginAllowed: hoogstens 5 foute pogingen per minuut per IP-adres.119
func (s *Server) loginAllowed(ip string, failed bool) bool {120
s.mu.Lock()121
defer s.mu.Unlock()122
if s.loginFails == nil {123
s.loginFails = map[string][]time.Time{}124
}125
cut := s.now().Add(-time.Minute)126
keep := s.loginFails[ip][:0]127
for _, t := range s.loginFails[ip] {128
if t.After(cut) {129
keep = append(keep, t)130
}131
}132
if failed {133
keep = append(keep, s.now())134
}135
s.loginFails[ip] = keep136
return len(keep) < 5137
}138
139
func (s *Server) mountUI(mux *http.ServeMux) {140
mux.HandleFunc("GET /{$}", s.uiIndex)141
mux.HandleFunc("GET /login", s.uiLoginPage)142
mux.HandleFunc("POST /login", s.uiLogin)143
mux.HandleFunc("POST /logout", s.uiLogout)144
mux.HandleFunc("POST /ui/act/{name}", s.uiAct)145
}146
147
func (s *Server) render(w http.ResponseWriter, name string, data any) {148
w.Header().Set("Content-Type", "text/html; charset=utf-8")149
w.Header().Set("Cache-Control", "no-store")150
w.Header().Set("Content-Security-Policy", "default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'none'; frame-ancestors 'none'; form-action 'self'")151
w.Header().Set("X-Frame-Options", "DENY")152
if err := uiTmpl.ExecuteTemplate(w, name, data); err != nil {153
s.Log.Error("template", "name", name, "err", err)154
}155
}156
157
func (s *Server) uiLoginPage(w http.ResponseWriter, r *http.Request) {158
if _, ok := s.session(r); ok {159
http.Redirect(w, r, "/", http.StatusSeeOther)160
return161
}162
s.render(w, "login.html", map[string]any{"Error": r.URL.Query().Get("fout") != "", "Version": Version})163
}164
165
func (s *Server) uiLogin(w http.ResponseWriter, r *http.Request) {166
ip := clientIP(r)167
if !s.loginAllowed(ip, false) {168
http.Error(w, "te veel pogingen, wacht een minuut", http.StatusTooManyRequests)169
return170
}171
tok := strings.TrimSpace(r.PostFormValue("token"))172
if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {173
s.loginAllowed(ip, true)174
http.Redirect(w, r, "/login?fout=1", http.StatusSeeOther)175
return176
}177
id := randHex(32)178
s.mu.Lock()179
for k, v := range s.sessions {180
if s.now().After(v.expires) {181
delete(s.sessions, k)182
}183
}184
s.sessions[id] = session{csrf: randHex(16), expires: s.now().Add(sessionTTL)}185
s.mu.Unlock()186
http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: id, Path: "/", HttpOnly: true,187
SameSite: http.SameSiteStrictMode, Secure: r.TLS != nil || r.Header.Get("X-Forwarded-Proto") == "https",188
MaxAge: int(sessionTTL / time.Second)})189
http.Redirect(w, r, "/", http.StatusSeeOther)190
}191
192
func (s *Server) uiLogout(w http.ResponseWriter, r *http.Request) {193
if sess, ok := s.session(r); ok && r.PostFormValue("csrf") == sess.csrf {194
c, _ := r.Cookie(sessionCookie)195
s.mu.Lock()196
delete(s.sessions, c.Value)197
s.mu.Unlock()198
}199
http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: "", Path: "/", MaxAge: -1, HttpOnly: true})200
http.Redirect(w, r, "/login", http.StatusSeeOther)201
}202
203
// pageData is wat de webinterface toont: precies de uitkomst van de204
// GET-acties uit Actions.205
type pageData struct {206
CSRF string207
Flash string208
FlashErr bool209
Status Status210
Config ConfigView211
Archives []archive.Archive212
Actions []Action213
Version string214
}215
216
func (s *Server) uiIndex(w http.ResponseWriter, r *http.Request) {217
sess, ok := s.session(r)218
if !ok {219
http.Redirect(w, r, "/login", http.StatusSeeOther)220
return221
}222
d := pageData{CSRF: sess.csrf, Status: s.Status(), Config: s.ConfigView(), Actions: s.Actions(), Version: Version}223
d.Archives, _ = s.archives.List()224
d.Flash, d.FlashErr = s.takeFlash(r)225
s.render(w, "index.html", d)226
}227
228
// uiAct voert een actie uit vanuit een formulier, via dezelfde code als de API.229
func (s *Server) uiAct(w http.ResponseWriter, r *http.Request) {230
sess, ok := s.session(r)231
if !ok {232
http.Redirect(w, r, "/login", http.StatusSeeOther)233
return234
}235
if err := r.ParseForm(); err != nil {236
http.Error(w, "formulier", 400)237
return238
}239
if subtle.ConstantTimeCompare([]byte(r.PostFormValue("csrf")), []byte(sess.csrf)) != 1 {240
http.Error(w, "CSRF-token klopt niet; laad de pagina opnieuw", http.StatusForbidden)241
return242
}243
a, ok := s.action(r.PathValue("name"))244
if !ok || a.Method == http.MethodGet {245
http.NotFound(w, r)246
return247
}248
in := Input{}249
for k, v := range r.PostForm {250
if k == "csrf" || k == "understood" || len(v) == 0 {251
continue252
}253
in[k] = v[0]254
}255
anchor := "#" + strings.SplitN(a.Name, ".", 2)[0]256
if a.Name == "rollback" && r.PostFormValue("understood") == "" {257
s.setFlash(r, "Vink aan dat je begrijpt dat een rollback niet ongedaan kan worden gemaakt.", true)258
http.Redirect(w, r, "/#archives", http.StatusSeeOther)259
return260
}261
if a.Name == "sync" {262
in["wait"] = "false"263
}264
code, out := a.Do(r.Context(), in)265
msg, isErr := describe(a, code, out)266
s.setFlash(r, msg, isErr)267
http.Redirect(w, r, "/"+anchor, http.StatusSeeOther)268
}269
270
func describe(a Action, code int, out any) (string, bool) {271
if code >= 400 {272
switch v := out.(type) {273
case *ConflictError:274
return fmt.Sprintf("%s (vorige: %s, %d archieven). Kies hieronder ‘oude backups wissen’ of ‘nieuwe BlueGit herstellen’ en koppel opnieuw.", v.Error, v.PreviousURL, v.Archives), true275
case map[string]string:276
return a.Title + " mislukt: " + v["error"], true277
}278
return fmt.Sprintf("%s mislukt (HTTP %d)", a.Title, code), true279
}280
switch a.Name {281
case "sync":282
return "Synchronisatie gestart.", false283
case "archive":284
if v, ok := out.(archive.Archive); ok {285
return "Archief gemaakt: " + v.Name, false286
}287
case "prune":288
if v, ok := out.(map[string]any); ok {289
return fmt.Sprintf("Opgeruimd: %d archieven.", len(v["removed"].([]string))), false290
}291
case "rollback":292
return "Rollback gestart. BlueGit herstart zodra de data er staat.", false293
case "config.update":294
if v, ok := out.(ConfigView); ok && v.Restart {295
return "Instellingen opgeslagen. Een deel geldt pas na een herstart.", false296
}297
return "Instellingen opgeslagen.", false298
}299
return a.Title + ": gelukt.", false300
}301
302
// UIPath is het formulieradres van een actie in de webinterface.303
func UIPath(a Action) string { return "/ui/act/" + url.PathEscape(a.Name) }@@ -0,0 +1,285 @@
1
package server
2
3
import (
4
"bytes"
5
"encoding/json"
6
"net/http"
7
"net/http/httptest"
8
"net/url"
9
"os"
10
"path/filepath"
11
"regexp"
12
"strings"
13
"testing"
14
"time"
15
16
"git.timfalken.com/timfa/bluegit-backup/internal/config"
17
"git.timfalken.com/timfa/bluegit-backup/internal/protocol"
18
)
19
20
// uiClient is een browser met een cookie.
21
type uiClient struct {
22
t *testing.T
23
h http.Handler
24
cookie *http.Cookie
25
}
26
27
func (c *uiClient) do(method, p string, form url.Values) *httptest.ResponseRecorder {
28
var body *strings.Reader
29
if form != nil {
30
body = strings.NewReader(form.Encode())
31
} else {
32
body = strings.NewReader("")
33
}
34
r := httptest.NewRequest(method, p, body)
35
if form != nil {
36
r.Header.Set("Content-Type", "application/x-www-form-urlencoded")
37
}
38
if c.cookie != nil {
39
r.AddCookie(c.cookie)
40
}
41
w := httptest.NewRecorder()
42
c.h.ServeHTTP(w, r)
43
for _, ck := range w.Result().Cookies() {
44
if ck.Name == sessionCookie {
45
c.cookie = ck
46
}
47
}
48
return w
49
}
50
51
var csrfRE = regexp.MustCompile(`name="csrf" value="([0-9a-f]+)"`)
52
53
func login(t *testing.T, s *Server) (*uiClient, string) {
54
c := &uiClient{t: t, h: s.Handler()}
55
if w := c.do("GET", "/", nil); w.Code != 303 || w.Header().Get("Location") != "/login" {
56
t.Fatalf("zonder sessie: %d %s", w.Code, w.Header().Get("Location"))
57
}
58
if w := c.do("POST", "/login", url.Values{"token": {"fout"}}); w.Header().Get("Location") != "/login?fout=1" {
59
t.Fatalf("fout token: %s", w.Header().Get("Location"))
60
}
61
if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 303 || c.cookie == nil {
62
t.Fatalf("login %d", w.Code)
63
}
64
if !c.cookie.HttpOnly || c.cookie.SameSite != http.SameSiteStrictMode {
65
t.Fatalf("cookie %+v", c.cookie)
66
}
67
w := c.do("GET", "/", nil)
68
if w.Code != 200 {
69
t.Fatalf("index %d", w.Code)
70
}
71
m := csrfRE.FindStringSubmatch(w.Body.String())
72
if m == nil {
73
t.Fatal("geen csrf")
74
}
75
return c, m[1]
76
}
77
78
// Elke wijzigende actie heeft een formulier in de webinterface, elke
79
// beheerroute zit in Actions, en elk formulier hoort bij een actie.
80
func TestUIAndAPIParity(t *testing.T) {
81
f := newFake(t)
82
s := newTestServer(t)
83
if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {
84
t.Fatal(w.Body)
85
}
86
if _, err := s.SyncNow(t.Context()); err != nil {
87
t.Fatal(err)
88
}
89
if _, err := s.ArchiveNow(); err != nil {
90
t.Fatal(err)
91
}
92
c, _ := login(t, s)
93
page := c.do("GET", "/", nil).Body.String()
94
// Het koppelformulier staat in een uitklapper zodra er gekoppeld is; het
95
// moet er nog steeds zijn.
96
forms := map[string]bool{}
97
for _, m := range regexp.MustCompile(`action="/ui/act/([a-z.]+)"`).FindAllStringSubmatch(page, -1) {
98
forms[m[1]] = true
99
}
100
for _, a := range s.Actions() {
101
switch a.Method {
102
case "GET":
103
// Getoond op de pagina; download als link.
104
if a.Name == "archive.download" && !strings.Contains(page, "/download\">Downloaden") {
105
t.Errorf("geen downloadlink")
106
}
107
default:
108
if !forms[a.Name] {
109
t.Errorf("actie %s (%s %s) heeft geen formulier in de webinterface", a.Name, a.Method, a.Path)
110
}
111
delete(forms, a.Name)
112
}
113
}
114
for f := range forms {
115
t.Errorf("formulier %s hoort bij geen API-actie", f)
116
}
117
// Alle GET-acties geven hun gegevens ook op de pagina.
118
for _, want := range []string{"Overzicht", "cfg-archive_interval", "cfg-listen", "bluegit-", "/api/v1/admin/config"} {
119
if !strings.Contains(page, want) {
120
t.Errorf("pagina mist %q", want)
121
}
122
}
123
// De API geeft dezelfde actielijst.
124
w := adminReq(s, "GET", "/api/v1/admin/actions", "")
125
var al struct {
126
Actions []Action `json:"actions"`
127
}
128
_ = json.Unmarshal(w.Body.Bytes(), &al)
129
if len(al.Actions) != len(s.Actions()) {
130
t.Fatalf("actions %d", len(al.Actions))
131
}
132
}
133
134
func TestUISettingsAndCSRF(t *testing.T) {
135
s := newTestServer(t)
136
c, csrf := login(t, s)
137
form := url.Values{"csrf": {csrf}, "retention_days": {"9"}, "archive_interval": {"12h"}, "rate_limit_kib": {"300"}, "listen": {"127.0.0.1:9999"}}
138
if w := c.do("POST", "/ui/act/config.update", form); w.Code != 303 {
139
t.Fatalf("opslaan %d %s", w.Code, w.Body)
140
}
141
page := c.do("GET", "/", nil).Body.String()
142
if !strings.Contains(page, "Instellingen opgeslagen") || !strings.Contains(page, "herstart") {
143
t.Fatalf("melding ontbreekt")
144
}
145
cv := s.ConfigView()
146
get := func(k string) string {
147
for _, f := range cv.Fields {
148
if f.Key == k {
149
return f.Value
150
}
151
}
152
return ""
153
}
154
if get("retention_days") != "9" || get("archive_interval") != "12h" || get("listen") != "127.0.0.1:9999" || !cv.Restart {
155
t.Fatalf("%+v", cv)
156
}
157
if s.limiter.Rate() != 300<<10 {
158
t.Fatalf("rate %d", s.limiter.Rate())
159
}
160
if s.cfg().Listen == "127.0.0.1:9999" {
161
t.Fatal("listen hoort pas na herstart te gelden")
162
}
163
// Bewaard: een nieuwe server leest het.
164
s2, err := New(s.Cfg, nil)
165
if err != nil {
166
t.Fatal(err)
167
}
168
if s2.cfg().RetentionDays != 9 || s2.cfg().Listen != "127.0.0.1:9999" {
169
t.Fatalf("na herstart %+v", s2.cfg())
170
}
171
// Zonder of met fout CSRF-token: geweigerd.
172
if w := c.do("POST", "/ui/act/config.update", url.Values{"retention_days": {"1"}}); w.Code != 403 {
173
t.Fatalf("zonder csrf %d", w.Code)
174
}
175
// Ongeldige waarde: foutmelding, niets veranderd.
176
c.do("POST", "/ui/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"-1"}})
177
if !strings.Contains(c.do("GET", "/", nil).Body.String(), "mislukt") || s.cfg().RetentionDays != 9 {
178
t.Fatal("ongeldige waarde")
179
}
180
// API met sessiecookie vraagt X-CSRF-Token.
181
r := httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))
182
r.AddCookie(c.cookie)
183
w := httptest.NewRecorder()
184
s.Handler().ServeHTTP(w, r)
185
if w.Code != 403 {
186
t.Fatalf("cookie zonder csrf-header %d", w.Code)
187
}
188
r = httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))
189
r.AddCookie(c.cookie)
190
r.Header.Set("X-CSRF-Token", csrf)
191
w = httptest.NewRecorder()
192
s.Handler().ServeHTTP(w, r)
193
if w.Code != 200 || s.cfg().RetentionDays != 3 {
194
t.Fatalf("cookie met csrf-header %d %s", w.Code, w.Body)
195
}
196
// Uitloggen.
197
c.do("POST", "/logout", url.Values{"csrf": {csrf}})
198
if w := c.do("GET", "/", nil); w.Code != 303 {
199
t.Fatalf("na uitloggen %d", w.Code)
200
}
201
// Webinterface mag niet in een iframe van een ander.
202
if h := c.do("GET", "/login", nil).Header(); h.Get("X-Frame-Options") != "DENY" {
203
t.Fatal("frame")
204
}
205
}
206
207
func TestLoginRateLimit(t *testing.T) {
208
s := newTestServer(t)
209
c := &uiClient{t: t, h: s.Handler()}
210
for i := 0; i < 5; i++ {
211
c.do("POST", "/login", url.Values{"token": {"fout"}})
212
}
213
if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 429 {
214
t.Fatalf("na 5 fouten %d", w.Code)
215
}
216
}
217
218
func TestAPIConfig(t *testing.T) {
219
s := newTestServer(t)
220
w := adminReq(s, "PUT", "/api/v1/admin/config", `{"min_free_mb":2048,"full_sync_interval":"30m"}`)
221
if w.Code != 200 {
222
t.Fatalf("%d %s", w.Code, w.Body)
223
}
224
if s.cfg().MinFreeMB != 2048 || s.cfg().FullSyncInterval.Duration != 30*time.Minute {
225
t.Fatalf("%+v", s.cfg())
226
}
227
if _, err := os.Stat(filepath.Join(s.Cfg.DataDir, config.SettingsFile)); err != nil {
228
t.Fatal(err)
229
}
230
for _, body := range []string{`{"data_dir":"/tmp"}`, `{"onbekend":1}`, `{"archive_interval":"0s"}`, `{}`, `[1]`} {
231
if w := adminReq(s, "PUT", "/api/v1/admin/config", body); w.Code != 400 {
232
t.Errorf("%s: %d", body, w.Code)
233
}
234
}
235
w = adminReq(s, "GET", "/api/v1/admin/config", "")
236
var cv ConfigView
237
_ = json.Unmarshal(w.Body.Bytes(), &cv)
238
if len(cv.Fields) != len(config.Fields) {
239
t.Fatalf("%s", w.Body)
240
}
241
}
242
243
func TestSignedAdminActions(t *testing.T) {
244
f := newFake(t)
245
s := newTestServer(t)
246
if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {
247
t.Fatal(w.Body)
248
}
249
good := protocol.SigningSecret("bgbk_test")
250
call := func(method, p, body string) *httptest.ResponseRecorder {
251
r := httptest.NewRequest(method, p, bytes.NewReader([]byte(body)))
252
protocol.Sign(r, good, "inst-1", []byte(body), time.Now())
253
w := httptest.NewRecorder()
254
s.Handler().ServeHTTP(w, r)
255
return w
256
}
257
if w := call("PUT", "/api/v1/admin/config", `{"retention_days":"4"}`); w.Code != 200 || s.cfg().RetentionDays != 4 {
258
t.Fatalf("config via BlueGit %d %s", w.Code, w.Body)
259
}
260
if w := call("GET", "/api/v1/admin/config", ""); w.Code != 200 {
261
t.Fatalf("config lezen %d", w.Code)
262
}
263
if w := call("POST", "/api/v1/admin/connect", `{}`); w.Code != 403 {
264
t.Fatalf("connect via BlueGit %d", w.Code)
265
}
266
if w := call("POST", "/api/v1/admin/rollback", `{"archive":"bluegit-20261115-120000.tar.gz"}`); w.Code != 400 {
267
t.Fatalf("rollback zonder confirm %d", w.Code)
268
}
269
// Handtekening over een ander pad: geweigerd.
270
r := httptest.NewRequest("POST", "/api/v1/admin/sync", nil)
271
protocol.Sign(r, good, "inst-1", nil, time.Now())
272
r.URL.Path = "/api/v1/admin/disconnect"
273
w := httptest.NewRecorder()
274
s.Handler().ServeHTTP(w, r)
275
if w.Code != 401 {
276
t.Fatalf("ander pad %d", w.Code)
277
}
278
if w := call("POST", "/api/v1/admin/disconnect", ``); w.Code != 200 || s.getState().Connected() {
279
t.Fatalf("disconnect %d", w.Code)
280
}
281
// Ontkoppeld: BlueGit kan niets meer.
282
if w := call("GET", "/api/v1/admin/status", ""); w.Code != 401 {
283
t.Fatalf("na ontkoppelen %d", w.Code)
284
}
285
}
@@ -0,0 +1,285 @@1
package server2
3
import (4
"bytes"5
"encoding/json"6
"net/http"7
"net/http/httptest"8
"net/url"9
"os"10
"path/filepath"11
"regexp"12
"strings"13
"testing"14
"time"15
16
"git.timfalken.com/timfa/bluegit-backup/internal/config"17
"git.timfalken.com/timfa/bluegit-backup/internal/protocol"18
)19
20
// uiClient is een browser met een cookie.21
type uiClient struct {22
t *testing.T23
h http.Handler24
cookie *http.Cookie25
}26
27
func (c *uiClient) do(method, p string, form url.Values) *httptest.ResponseRecorder {28
var body *strings.Reader29
if form != nil {30
body = strings.NewReader(form.Encode())31
} else {32
body = strings.NewReader("")33
}34
r := httptest.NewRequest(method, p, body)35
if form != nil {36
r.Header.Set("Content-Type", "application/x-www-form-urlencoded")37
}38
if c.cookie != nil {39
r.AddCookie(c.cookie)40
}41
w := httptest.NewRecorder()42
c.h.ServeHTTP(w, r)43
for _, ck := range w.Result().Cookies() {44
if ck.Name == sessionCookie {45
c.cookie = ck46
}47
}48
return w49
}50
51
var csrfRE = regexp.MustCompile(`name="csrf" value="([0-9a-f]+)"`)52
53
func login(t *testing.T, s *Server) (*uiClient, string) {54
c := &uiClient{t: t, h: s.Handler()}55
if w := c.do("GET", "/", nil); w.Code != 303 || w.Header().Get("Location") != "/login" {56
t.Fatalf("zonder sessie: %d %s", w.Code, w.Header().Get("Location"))57
}58
if w := c.do("POST", "/login", url.Values{"token": {"fout"}}); w.Header().Get("Location") != "/login?fout=1" {59
t.Fatalf("fout token: %s", w.Header().Get("Location"))60
}61
if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 303 || c.cookie == nil {62
t.Fatalf("login %d", w.Code)63
}64
if !c.cookie.HttpOnly || c.cookie.SameSite != http.SameSiteStrictMode {65
t.Fatalf("cookie %+v", c.cookie)66
}67
w := c.do("GET", "/", nil)68
if w.Code != 200 {69
t.Fatalf("index %d", w.Code)70
}71
m := csrfRE.FindStringSubmatch(w.Body.String())72
if m == nil {73
t.Fatal("geen csrf")74
}75
return c, m[1]76
}77
78
// Elke wijzigende actie heeft een formulier in de webinterface, elke79
// beheerroute zit in Actions, en elk formulier hoort bij een actie.80
func TestUIAndAPIParity(t *testing.T) {81
f := newFake(t)82
s := newTestServer(t)83
if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {84
t.Fatal(w.Body)85
}86
if _, err := s.SyncNow(t.Context()); err != nil {87
t.Fatal(err)88
}89
if _, err := s.ArchiveNow(); err != nil {90
t.Fatal(err)91
}92
c, _ := login(t, s)93
page := c.do("GET", "/", nil).Body.String()94
// Het koppelformulier staat in een uitklapper zodra er gekoppeld is; het95
// moet er nog steeds zijn.96
forms := map[string]bool{}97
for _, m := range regexp.MustCompile(`action="/ui/act/([a-z.]+)"`).FindAllStringSubmatch(page, -1) {98
forms[m[1]] = true99
}100
for _, a := range s.Actions() {101
switch a.Method {102
case "GET":103
// Getoond op de pagina; download als link.104
if a.Name == "archive.download" && !strings.Contains(page, "/download\">Downloaden") {105
t.Errorf("geen downloadlink")106
}107
default:108
if !forms[a.Name] {109
t.Errorf("actie %s (%s %s) heeft geen formulier in de webinterface", a.Name, a.Method, a.Path)110
}111
delete(forms, a.Name)112
}113
}114
for f := range forms {115
t.Errorf("formulier %s hoort bij geen API-actie", f)116
}117
// Alle GET-acties geven hun gegevens ook op de pagina.118
for _, want := range []string{"Overzicht", "cfg-archive_interval", "cfg-listen", "bluegit-", "/api/v1/admin/config"} {119
if !strings.Contains(page, want) {120
t.Errorf("pagina mist %q", want)121
}122
}123
// De API geeft dezelfde actielijst.124
w := adminReq(s, "GET", "/api/v1/admin/actions", "")125
var al struct {126
Actions []Action `json:"actions"`127
}128
_ = json.Unmarshal(w.Body.Bytes(), &al)129
if len(al.Actions) != len(s.Actions()) {130
t.Fatalf("actions %d", len(al.Actions))131
}132
}133
134
func TestUISettingsAndCSRF(t *testing.T) {135
s := newTestServer(t)136
c, csrf := login(t, s)137
form := url.Values{"csrf": {csrf}, "retention_days": {"9"}, "archive_interval": {"12h"}, "rate_limit_kib": {"300"}, "listen": {"127.0.0.1:9999"}}138
if w := c.do("POST", "/ui/act/config.update", form); w.Code != 303 {139
t.Fatalf("opslaan %d %s", w.Code, w.Body)140
}141
page := c.do("GET", "/", nil).Body.String()142
if !strings.Contains(page, "Instellingen opgeslagen") || !strings.Contains(page, "herstart") {143
t.Fatalf("melding ontbreekt")144
}145
cv := s.ConfigView()146
get := func(k string) string {147
for _, f := range cv.Fields {148
if f.Key == k {149
return f.Value150
}151
}152
return ""153
}154
if get("retention_days") != "9" || get("archive_interval") != "12h" || get("listen") != "127.0.0.1:9999" || !cv.Restart {155
t.Fatalf("%+v", cv)156
}157
if s.limiter.Rate() != 300<<10 {158
t.Fatalf("rate %d", s.limiter.Rate())159
}160
if s.cfg().Listen == "127.0.0.1:9999" {161
t.Fatal("listen hoort pas na herstart te gelden")162
}163
// Bewaard: een nieuwe server leest het.164
s2, err := New(s.Cfg, nil)165
if err != nil {166
t.Fatal(err)167
}168
if s2.cfg().RetentionDays != 9 || s2.cfg().Listen != "127.0.0.1:9999" {169
t.Fatalf("na herstart %+v", s2.cfg())170
}171
// Zonder of met fout CSRF-token: geweigerd.172
if w := c.do("POST", "/ui/act/config.update", url.Values{"retention_days": {"1"}}); w.Code != 403 {173
t.Fatalf("zonder csrf %d", w.Code)174
}175
// Ongeldige waarde: foutmelding, niets veranderd.176
c.do("POST", "/ui/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"-1"}})177
if !strings.Contains(c.do("GET", "/", nil).Body.String(), "mislukt") || s.cfg().RetentionDays != 9 {178
t.Fatal("ongeldige waarde")179
}180
// API met sessiecookie vraagt X-CSRF-Token.181
r := httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))182
r.AddCookie(c.cookie)183
w := httptest.NewRecorder()184
s.Handler().ServeHTTP(w, r)185
if w.Code != 403 {186
t.Fatalf("cookie zonder csrf-header %d", w.Code)187
}188
r = httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))189
r.AddCookie(c.cookie)190
r.Header.Set("X-CSRF-Token", csrf)191
w = httptest.NewRecorder()192
s.Handler().ServeHTTP(w, r)193
if w.Code != 200 || s.cfg().RetentionDays != 3 {194
t.Fatalf("cookie met csrf-header %d %s", w.Code, w.Body)195
}196
// Uitloggen.197
c.do("POST", "/logout", url.Values{"csrf": {csrf}})198
if w := c.do("GET", "/", nil); w.Code != 303 {199
t.Fatalf("na uitloggen %d", w.Code)200
}201
// Webinterface mag niet in een iframe van een ander.202
if h := c.do("GET", "/login", nil).Header(); h.Get("X-Frame-Options") != "DENY" {203
t.Fatal("frame")204
}205
}206
207
func TestLoginRateLimit(t *testing.T) {208
s := newTestServer(t)209
c := &uiClient{t: t, h: s.Handler()}210
for i := 0; i < 5; i++ {211
c.do("POST", "/login", url.Values{"token": {"fout"}})212
}213
if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 429 {214
t.Fatalf("na 5 fouten %d", w.Code)215
}216
}217
218
func TestAPIConfig(t *testing.T) {219
s := newTestServer(t)220
w := adminReq(s, "PUT", "/api/v1/admin/config", `{"min_free_mb":2048,"full_sync_interval":"30m"}`)221
if w.Code != 200 {222
t.Fatalf("%d %s", w.Code, w.Body)223
}224
if s.cfg().MinFreeMB != 2048 || s.cfg().FullSyncInterval.Duration != 30*time.Minute {225
t.Fatalf("%+v", s.cfg())226
}227
if _, err := os.Stat(filepath.Join(s.Cfg.DataDir, config.SettingsFile)); err != nil {228
t.Fatal(err)229
}230
for _, body := range []string{`{"data_dir":"/tmp"}`, `{"onbekend":1}`, `{"archive_interval":"0s"}`, `{}`, `[1]`} {231
if w := adminReq(s, "PUT", "/api/v1/admin/config", body); w.Code != 400 {232
t.Errorf("%s: %d", body, w.Code)233
}234
}235
w = adminReq(s, "GET", "/api/v1/admin/config", "")236
var cv ConfigView237
_ = json.Unmarshal(w.Body.Bytes(), &cv)238
if len(cv.Fields) != len(config.Fields) {239
t.Fatalf("%s", w.Body)240
}241
}242
243
func TestSignedAdminActions(t *testing.T) {244
f := newFake(t)245
s := newTestServer(t)246
if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {247
t.Fatal(w.Body)248
}249
good := protocol.SigningSecret("bgbk_test")250
call := func(method, p, body string) *httptest.ResponseRecorder {251
r := httptest.NewRequest(method, p, bytes.NewReader([]byte(body)))252
protocol.Sign(r, good, "inst-1", []byte(body), time.Now())253
w := httptest.NewRecorder()254
s.Handler().ServeHTTP(w, r)255
return w256
}257
if w := call("PUT", "/api/v1/admin/config", `{"retention_days":"4"}`); w.Code != 200 || s.cfg().RetentionDays != 4 {258
t.Fatalf("config via BlueGit %d %s", w.Code, w.Body)259
}260
if w := call("GET", "/api/v1/admin/config", ""); w.Code != 200 {261
t.Fatalf("config lezen %d", w.Code)262
}263
if w := call("POST", "/api/v1/admin/connect", `{}`); w.Code != 403 {264
t.Fatalf("connect via BlueGit %d", w.Code)265
}266
if w := call("POST", "/api/v1/admin/rollback", `{"archive":"bluegit-20261115-120000.tar.gz"}`); w.Code != 400 {267
t.Fatalf("rollback zonder confirm %d", w.Code)268
}269
// Handtekening over een ander pad: geweigerd.270
r := httptest.NewRequest("POST", "/api/v1/admin/sync", nil)271
protocol.Sign(r, good, "inst-1", nil, time.Now())272
r.URL.Path = "/api/v1/admin/disconnect"273
w := httptest.NewRecorder()274
s.Handler().ServeHTTP(w, r)275
if w.Code != 401 {276
t.Fatalf("ander pad %d", w.Code)277
}278
if w := call("POST", "/api/v1/admin/disconnect", ``); w.Code != 200 || s.getState().Connected() {279
t.Fatalf("disconnect %d", w.Code)280
}281
// Ontkoppeld: BlueGit kan niets meer.282
if w := call("GET", "/api/v1/admin/status", ""); w.Code != 401 {283
t.Fatalf("na ontkoppelen %d", w.Code)284
}285
}@@ -0,0 +1,102 @@
1
<!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
2
<title>bluegit-backup</title>{{template "style"}}</head><body>
3
<header><h1>bluegit-backup</h1>
4
<span class="badge{{if not .Status.Connected}} off{{end}}">{{if .Status.Connected}}gekoppeld{{else}}niet gekoppeld{{end}}</span>
5
<form method="post" action="/logout"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Uitloggen</button></form>
6
</header>
7
<main>
8
{{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}
9
10
<section id="status">
11
<h2>Overzicht</h2>
12
<dl>
13
<dt>BlueGit</dt><dd>{{if .Status.BlueGitURL}}{{.Status.BlueGitURL}}{{else}}—{{end}}{{if .Status.InstanceID}} <small>instantie {{.Status.InstanceID}}</small>{{end}}</dd>
14
<dt>Laatste sync</dt><dd>{{when .Status.LastSync}}{{if .Status.SyncError}} <span class="badge off">{{.Status.SyncError}}</span>{{end}}</dd>
15
<dt>Laatste sync-resultaat</dt><dd>{{.Status.LastStats.Files}} bestanden, {{.Status.LastStats.Downloaded}} opgehaald ({{bytes .Status.LastStats.Bytes}}), {{.Status.LastStats.Deleted}} verwijderd</dd>
16
<dt>Syncs / meldingen</dt><dd>{{.Status.Syncs}} / {{.Status.Notifies}}</dd>
17
<dt>Kopie</dt><dd>{{bytes .Status.MirrorBytes}}</dd>
18
<dt>Archieven</dt><dd>{{.Status.Archives}}, laatste {{when .Status.LastArchive}}{{if .Status.ArchiveError}} <span class="badge off">{{.Status.ArchiveError}}</span>{{end}}</dd>
19
<dt>Rollback</dt><dd>{{.Status.Rollback.State}}{{if .Status.Rollback.Archive}} ({{.Status.Rollback.Archive}}){{end}}{{if .Status.Rollback.Error}} <span class="badge off">{{.Status.Rollback.Error}}</span>{{end}}</dd>
20
<dt>Versie</dt><dd>{{.Status.Version}} <small>server-id {{.Status.ServerID}}</small></dd>
21
</dl>
22
<div class="row" style="margin-top:.8rem">
23
<form method="post" action="/ui/act/sync"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu synchroniseren</button></form>
24
<form method="post" action="/ui/act/archive"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu archiveren</button></form>
25
<form method="post" action="/ui/act/prune"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Nu opruimen</button></form>
26
</div>
27
</section>
28
29
<section id="connect">
30
<h2>Koppeling</h2>
31
{{if .Status.Connected}}
32
<p>Gekoppeld met <strong>{{.Status.BlueGitURL}}</strong>. Een backup server hoort bij één BlueGit.</p>
33
<form method="post" action="/ui/act/disconnect"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Ontkoppelen</button> <small>De kopie en de archieven blijven staan.</small></form>
34
<details><summary>Opnieuw koppelen (nieuwe key of andere BlueGit)</summary>{{template "connectform" .}}</details>
35
{{else}}
36
<p>Maak in BlueGit onder <em>Beheer → Backup</em> een Backupserver-Key en vul die hier in.</p>
37
{{template "connectform" .}}
38
{{end}}
39
</section>
40
41
<section id="config">
42
<h2>Instellingen</h2>
43
{{if .Config.Restart}}<div class="flash">Er staat een wijziging klaar die pas na een herstart geldt.</div>{{end}}
44
<form method="post" action="/ui/act/config.update">
45
<input type="hidden" name="csrf" value="{{.CSRF}}">
46
{{range .Config.Fields}}
47
<label for="cfg-{{.Key}}">{{.Label}} <small>{{.Help}}{{if .Restart}} (na herstart){{end}}</small></label>
48
<input id="cfg-{{.Key}}" type="text" name="{{.Key}}" value="{{.Value}}">
49
{{end}}
50
<p><small>Gegevensmap: <code>{{.Config.DataDir}}</code> (alleen in config.yml)</small></p>
51
<p><button type="submit">Opslaan</button></p>
52
</form>
53
</section>
54
55
<section id="archives">
56
<h2>Archieven</h2>
57
{{if .Archives}}
58
<table><thead><tr><th>Archief</th><th>Gemaakt</th><th>Grootte</th><th></th></tr></thead><tbody>
59
{{range .Archives}}<tr>
60
<td><code>{{.Name}}</code></td><td>{{when .CreatedAt}}</td><td>{{bytes .Size}}</td>
61
<td class="row"><a href="/api/v1/admin/archives/{{.Name}}/download">Downloaden</a>
62
<form method="post" action="/ui/act/archive.delete"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="name" value="{{.Name}}"><button class="secondary" type="submit">Verwijderen</button></form></td>
63
</tr>{{end}}
64
</tbody></table>
65
<details>
66
<summary>Rollback naar een archief</summary>
67
<div class="backup-danger"><strong>Dit kan niet ongedaan worden gemaakt.</strong>
68
Alle gegevens van BlueGit worden vervangen door de inhoud van het archief. Alles wat daarna is veranderd, is weg. BlueGit herstart.</div>
69
<form method="post" action="/ui/act/rollback">
70
<input type="hidden" name="csrf" value="{{.CSRF}}">
71
<label for="rb-archive">Archief</label>
72
<select id="rb-archive" name="archive">{{range .Archives}}<option value="{{.Name}}">{{.Name}}</option>{{end}}</select>
73
<label for="rb-confirm">Typ de archiefnaam over</label>
74
<input id="rb-confirm" type="text" name="confirm" autocomplete="off" required>
75
<label><input type="checkbox" name="understood" value="1" required> Ik begrijp dat dit niet ongedaan kan worden gemaakt</label>
76
<p><button class="danger" type="submit">Rollback starten</button></p>
77
</form>
78
</details>
79
{{else}}<p>Nog geen archieven.</p>{{end}}
80
</section>
81
82
<section id="api">
83
<h2>API</h2>
84
<p><small>Alles hierboven kan ook via de API, met <code>Authorization: Bearer <admin.token></code>. Acties met ✓ kan ook de gekoppelde BlueGit uitvoeren.</small></p>
85
<table><thead><tr><th>Methode</th><th>Pad</th><th>Actie</th><th>BlueGit</th></tr></thead><tbody>
86
{{range .Actions}}<tr><td><code>{{.Method}}</code></td><td><code>{{.Path}}</code></td><td>{{.Title}}</td><td>{{if .Signed}}✓{{end}}</td></tr>{{end}}
87
</tbody></table>
88
</section>
89
<p><small>bluegit-backup {{.Version}}</small></p>
90
</main></body></html>
91
{{define "connectform"}}
92
<form method="post" action="/ui/act/connect">
93
<input type="hidden" name="csrf" value="{{.CSRF}}">
94
<label for="c-url">BlueGit-adres</label><input id="c-url" type="url" name="url" placeholder="https://git.example.com" value="{{.Status.BlueGitURL}}" required>
95
<label for="c-key">Backupserver-Key</label><input id="c-key" type="password" name="key" placeholder="bgbk_…" autocomplete="off" required>
96
<label>Hoorde deze server eerder bij een andere BlueGit?</label>
97
<label><input type="radio" name="on_conflict" value="" checked> Nee, of vraag het eerst</label>
98
<label><input type="radio" name="on_conflict" value="wipe"> Oude backups wissen en opnieuw beginnen</label>
99
<label><input type="radio" name="on_conflict" value="restore"> De nieuwe BlueGit herstellen met de backupdata</label>
100
<p><button type="submit">Koppelen</button></p>
101
</form>
102
{{end}}
@@ -0,0 +1,102 @@1
<!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">2
<title>bluegit-backup</title>{{template "style"}}</head><body>3
<header><h1>bluegit-backup</h1>4
<span class="badge{{if not .Status.Connected}} off{{end}}">{{if .Status.Connected}}gekoppeld{{else}}niet gekoppeld{{end}}</span>5
<form method="post" action="/logout"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Uitloggen</button></form>6
</header>7
<main>8
{{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}9
10
<section id="status">11
<h2>Overzicht</h2>12
<dl>13
<dt>BlueGit</dt><dd>{{if .Status.BlueGitURL}}{{.Status.BlueGitURL}}{{else}}—{{end}}{{if .Status.InstanceID}} <small>instantie {{.Status.InstanceID}}</small>{{end}}</dd>14
<dt>Laatste sync</dt><dd>{{when .Status.LastSync}}{{if .Status.SyncError}} <span class="badge off">{{.Status.SyncError}}</span>{{end}}</dd>15
<dt>Laatste sync-resultaat</dt><dd>{{.Status.LastStats.Files}} bestanden, {{.Status.LastStats.Downloaded}} opgehaald ({{bytes .Status.LastStats.Bytes}}), {{.Status.LastStats.Deleted}} verwijderd</dd>16
<dt>Syncs / meldingen</dt><dd>{{.Status.Syncs}} / {{.Status.Notifies}}</dd>17
<dt>Kopie</dt><dd>{{bytes .Status.MirrorBytes}}</dd>18
<dt>Archieven</dt><dd>{{.Status.Archives}}, laatste {{when .Status.LastArchive}}{{if .Status.ArchiveError}} <span class="badge off">{{.Status.ArchiveError}}</span>{{end}}</dd>19
<dt>Rollback</dt><dd>{{.Status.Rollback.State}}{{if .Status.Rollback.Archive}} ({{.Status.Rollback.Archive}}){{end}}{{if .Status.Rollback.Error}} <span class="badge off">{{.Status.Rollback.Error}}</span>{{end}}</dd>20
<dt>Versie</dt><dd>{{.Status.Version}} <small>server-id {{.Status.ServerID}}</small></dd>21
</dl>22
<div class="row" style="margin-top:.8rem">23
<form method="post" action="/ui/act/sync"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu synchroniseren</button></form>24
<form method="post" action="/ui/act/archive"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu archiveren</button></form>25
<form method="post" action="/ui/act/prune"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Nu opruimen</button></form>26
</div>27
</section>28
29
<section id="connect">30
<h2>Koppeling</h2>31
{{if .Status.Connected}}32
<p>Gekoppeld met <strong>{{.Status.BlueGitURL}}</strong>. Een backup server hoort bij één BlueGit.</p>33
<form method="post" action="/ui/act/disconnect"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Ontkoppelen</button> <small>De kopie en de archieven blijven staan.</small></form>34
<details><summary>Opnieuw koppelen (nieuwe key of andere BlueGit)</summary>{{template "connectform" .}}</details>35
{{else}}36
<p>Maak in BlueGit onder <em>Beheer → Backup</em> een Backupserver-Key en vul die hier in.</p>37
{{template "connectform" .}}38
{{end}}39
</section>40
41
<section id="config">42
<h2>Instellingen</h2>43
{{if .Config.Restart}}<div class="flash">Er staat een wijziging klaar die pas na een herstart geldt.</div>{{end}}44
<form method="post" action="/ui/act/config.update">45
<input type="hidden" name="csrf" value="{{.CSRF}}">46
{{range .Config.Fields}}47
<label for="cfg-{{.Key}}">{{.Label}} <small>{{.Help}}{{if .Restart}} (na herstart){{end}}</small></label>48
<input id="cfg-{{.Key}}" type="text" name="{{.Key}}" value="{{.Value}}">49
{{end}}50
<p><small>Gegevensmap: <code>{{.Config.DataDir}}</code> (alleen in config.yml)</small></p>51
<p><button type="submit">Opslaan</button></p>52
</form>53
</section>54
55
<section id="archives">56
<h2>Archieven</h2>57
{{if .Archives}}58
<table><thead><tr><th>Archief</th><th>Gemaakt</th><th>Grootte</th><th></th></tr></thead><tbody>59
{{range .Archives}}<tr>60
<td><code>{{.Name}}</code></td><td>{{when .CreatedAt}}</td><td>{{bytes .Size}}</td>61
<td class="row"><a href="/api/v1/admin/archives/{{.Name}}/download">Downloaden</a>62
<form method="post" action="/ui/act/archive.delete"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="name" value="{{.Name}}"><button class="secondary" type="submit">Verwijderen</button></form></td>63
</tr>{{end}}64
</tbody></table>65
<details>66
<summary>Rollback naar een archief</summary>67
<div class="backup-danger"><strong>Dit kan niet ongedaan worden gemaakt.</strong>68
Alle gegevens van BlueGit worden vervangen door de inhoud van het archief. Alles wat daarna is veranderd, is weg. BlueGit herstart.</div>69
<form method="post" action="/ui/act/rollback">70
<input type="hidden" name="csrf" value="{{.CSRF}}">71
<label for="rb-archive">Archief</label>72
<select id="rb-archive" name="archive">{{range .Archives}}<option value="{{.Name}}">{{.Name}}</option>{{end}}</select>73
<label for="rb-confirm">Typ de archiefnaam over</label>74
<input id="rb-confirm" type="text" name="confirm" autocomplete="off" required>75
<label><input type="checkbox" name="understood" value="1" required> Ik begrijp dat dit niet ongedaan kan worden gemaakt</label>76
<p><button class="danger" type="submit">Rollback starten</button></p>77
</form>78
</details>79
{{else}}<p>Nog geen archieven.</p>{{end}}80
</section>81
82
<section id="api">83
<h2>API</h2>84
<p><small>Alles hierboven kan ook via de API, met <code>Authorization: Bearer <admin.token></code>. Acties met ✓ kan ook de gekoppelde BlueGit uitvoeren.</small></p>85
<table><thead><tr><th>Methode</th><th>Pad</th><th>Actie</th><th>BlueGit</th></tr></thead><tbody>86
{{range .Actions}}<tr><td><code>{{.Method}}</code></td><td><code>{{.Path}}</code></td><td>{{.Title}}</td><td>{{if .Signed}}✓{{end}}</td></tr>{{end}}87
</tbody></table>88
</section>89
<p><small>bluegit-backup {{.Version}}</small></p>90
</main></body></html>91
{{define "connectform"}}92
<form method="post" action="/ui/act/connect">93
<input type="hidden" name="csrf" value="{{.CSRF}}">94
<label for="c-url">BlueGit-adres</label><input id="c-url" type="url" name="url" placeholder="https://git.example.com" value="{{.Status.BlueGitURL}}" required>95
<label for="c-key">Backupserver-Key</label><input id="c-key" type="password" name="key" placeholder="bgbk_…" autocomplete="off" required>96
<label>Hoorde deze server eerder bij een andere BlueGit?</label>97
<label><input type="radio" name="on_conflict" value="" checked> Nee, of vraag het eerst</label>98
<label><input type="radio" name="on_conflict" value="wipe"> Oude backups wissen en opnieuw beginnen</label>99
<label><input type="radio" name="on_conflict" value="restore"> De nieuwe BlueGit herstellen met de backupdata</label>100
<p><button type="submit">Koppelen</button></p>101
</form>102
{{end}}@@ -0,0 +1,12 @@
1
<!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
2
<title>Inloggen · bluegit-backup</title>{{template "style"}}</head><body>
3
<header><h1>bluegit-backup</h1></header>
4
<main class="login"><section>
5
<h2>Inloggen</h2>
6
{{if .Error}}<div class="flash err">Dat token klopt niet.</div>{{end}}
7
<form method="post" action="/login">
8
<label for="token">Beheertoken <small>Staat in <code>data_dir/admin.token</code>. Toon het met <code>sudo -u bluegit-backup bluegit-backup token</code>.</small></label>
9
<input id="token" name="token" type="password" autocomplete="current-password" required autofocus>
10
<p><button type="submit">Inloggen</button></p>
11
</form>
12
</section><p><small>versie {{.Version}}</small></p></main></body></html>
@@ -0,0 +1,12 @@1
<!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">2
<title>Inloggen · bluegit-backup</title>{{template "style"}}</head><body>3
<header><h1>bluegit-backup</h1></header>4
<main class="login"><section>5
<h2>Inloggen</h2>6
{{if .Error}}<div class="flash err">Dat token klopt niet.</div>{{end}}7
<form method="post" action="/login">8
<label for="token">Beheertoken <small>Staat in <code>data_dir/admin.token</code>. Toon het met <code>sudo -u bluegit-backup bluegit-backup token</code>.</small></label>9
<input id="token" name="token" type="password" autocomplete="current-password" required autofocus>10
<p><button type="submit">Inloggen</button></p>11
</form>12
</section><p><small>versie {{.Version}}</small></p></main></body></html>@@ -0,0 +1,24 @@
1
{{define "style"}}<style>
2
:root{--blue:#1f6feb;--bg:#f6f8fa;--fg:#1f2328;--muted:#656d76;--border:#d0d7de;--danger:#cf222e;--ok:#1a7f37}
3
*{box-sizing:border-box}body{margin:0;font:15px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif;background:var(--bg);color:var(--fg)}
4
header{background:#0d1b3e;color:#fff;padding:.8rem 1.5rem;display:flex;align-items:center;gap:1rem}
5
header h1{font-size:1.15rem;margin:0;flex:1}header form{margin:0}
6
main{max-width:1000px;margin:1.5rem auto;padding:0 1rem}
7
section{background:#fff;border:1px solid var(--border);border-radius:8px;padding:1rem 1.25rem;margin-bottom:1.25rem}
8
section h2{margin:.1rem 0 .8rem;font-size:1.1rem}
9
dl{display:grid;grid-template-columns:max-content 1fr;gap:.25rem 1rem;margin:0}dt{color:var(--muted)}dd{margin:0}
10
label{display:block;font-weight:600;margin:.6rem 0 .2rem}small{color:var(--muted);font-weight:400;display:block}
11
input[type=text],input[type=password],input[type=url]{width:100%;padding:.45rem .6rem;border:1px solid var(--border);border-radius:6px;font:inherit}
12
button{background:var(--blue);color:#fff;border:0;border-radius:6px;padding:.45rem .9rem;font:inherit;cursor:pointer}
13
button.secondary{background:#fff;color:var(--fg);border:1px solid var(--border)}button.danger{background:var(--danger)}
14
.row{display:flex;gap:.5rem;flex-wrap:wrap;align-items:center}.row form{margin:0}
15
table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:.4rem .5rem;border-bottom:1px solid var(--border)}
16
.flash{padding:.7rem 1rem;border-radius:6px;margin-bottom:1rem;background:#dafbe1;border:1px solid var(--ok)}
17
.flash.err{background:#ffebe9;border-color:var(--danger)}
18
.badge{display:inline-block;padding:0 .5rem;border-radius:1rem;font-size:.85rem;background:#ddf4ff}
19
.badge.off{background:#ffebe9}
20
.backup-danger{border:2px solid var(--danger);background:#ffebe9;border-radius:8px;padding:.8rem 1rem;margin:.8rem 0}
21
.backup-danger strong{color:var(--danger);font-size:1.1rem;display:block}
22
details{margin-top:.5rem}code{background:var(--bg);padding:0 .3rem;border-radius:4px}
23
.login{max-width:420px;margin:4rem auto}
24
</style>{{end}}
@@ -0,0 +1,24 @@1
{{define "style"}}<style>2
:root{--blue:#1f6feb;--bg:#f6f8fa;--fg:#1f2328;--muted:#656d76;--border:#d0d7de;--danger:#cf222e;--ok:#1a7f37}3
*{box-sizing:border-box}body{margin:0;font:15px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif;background:var(--bg);color:var(--fg)}4
header{background:#0d1b3e;color:#fff;padding:.8rem 1.5rem;display:flex;align-items:center;gap:1rem}5
header h1{font-size:1.15rem;margin:0;flex:1}header form{margin:0}6
main{max-width:1000px;margin:1.5rem auto;padding:0 1rem}7
section{background:#fff;border:1px solid var(--border);border-radius:8px;padding:1rem 1.25rem;margin-bottom:1.25rem}8
section h2{margin:.1rem 0 .8rem;font-size:1.1rem}9
dl{display:grid;grid-template-columns:max-content 1fr;gap:.25rem 1rem;margin:0}dt{color:var(--muted)}dd{margin:0}10
label{display:block;font-weight:600;margin:.6rem 0 .2rem}small{color:var(--muted);font-weight:400;display:block}11
input[type=text],input[type=password],input[type=url]{width:100%;padding:.45rem .6rem;border:1px solid var(--border);border-radius:6px;font:inherit}12
button{background:var(--blue);color:#fff;border:0;border-radius:6px;padding:.45rem .9rem;font:inherit;cursor:pointer}13
button.secondary{background:#fff;color:var(--fg);border:1px solid var(--border)}button.danger{background:var(--danger)}14
.row{display:flex;gap:.5rem;flex-wrap:wrap;align-items:center}.row form{margin:0}15
table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:.4rem .5rem;border-bottom:1px solid var(--border)}16
.flash{padding:.7rem 1rem;border-radius:6px;margin-bottom:1rem;background:#dafbe1;border:1px solid var(--ok)}17
.flash.err{background:#ffebe9;border-color:var(--danger)}18
.badge{display:inline-block;padding:0 .5rem;border-radius:1rem;font-size:.85rem;background:#ddf4ff}19
.badge.off{background:#ffebe9}20
.backup-danger{border:2px solid var(--danger);background:#ffebe9;border-radius:8px;padding:.8rem 1rem;margin:.8rem 0}21
.backup-danger strong{color:var(--danger);font-size:1.1rem;display:block}22
details{margin-top:.5rem}code{background:var(--bg);padding:0 .3rem;border-radius:4px}23
.login{max-width:420px;margin:4rem auto}24
</style>{{end}}@@ -49,15 +49,21 @@ func (l *Limiter) Rate() int64 {
49
49
if l == nil {
50
50
return 0
51
51
}
52
l.mu.Lock()
53
defer l.mu.Unlock()
52
54
return int64(l.rate)
53
55
}
54
56
55
57
// Wait blokkeert tot n bytes gelezen mogen worden.
56
58
func (l *Limiter) Wait(ctx context.Context, n int) error {
57
if l == nil || l.rate <= 0 || n <= 0 {
59
if l == nil || n <= 0 {
58
60
return nil
59
61
}
60
62
l.mu.Lock()
63
if l.rate <= 0 {
64
l.mu.Unlock()
65
return nil
66
}
61
67
now := l.now()
62
68
l.tokens += now.Sub(l.last).Seconds() * l.rate
63
69
if l.tokens > l.burst {
@@ -78,7 +84,7 @@ func (l *Limiter) Wait(ctx context.Context, n int) error {
78
84
79
85
// Reader begrenst r met l.
80
86
func (l *Limiter) Reader(ctx context.Context, r io.Reader) io.Reader {
81
if l == nil || l.rate <= 0 {
87
if l == nil {
82
88
return r
83
89
}
84
90
return &reader{ctx: ctx, r: r, l: l}
@@ -91,7 +97,10 @@ type reader struct {
91
97
}
92
98
93
99
func (t *reader) Read(p []byte) (int, error) {
94
if max := int(t.l.burst); len(p) > max {
100
t.l.mu.Lock()
101
max := int(t.l.burst)
102
t.l.mu.Unlock()
103
if len(p) > max {
95
104
p = p[:max]
96
105
}
97
106
n, err := t.r.Read(p)
@@ -102,3 +111,20 @@ func (t *reader) Read(p []byte) (int, error) {
102
111
}
103
112
return n, err
104
113
}
114
115
// SetRate past de snelheid aan zonder lopende downloads te onderbreken.
116
func (l *Limiter) SetRate(bytesPerSec int64) {
117
if l == nil {
118
return
119
}
120
l.mu.Lock()
121
defer l.mu.Unlock()
122
l.rate = float64(bytesPerSec)
123
l.burst = l.rate / 4
124
if l.burst < 16<<10 {
125
l.burst = 16 << 10
126
}
127
if l.tokens > l.burst {
128
l.tokens = l.burst
129
}
130
}
@@ -49,15 +49,21 @@ func (l *Limiter) Rate() int64 {49
if l == nil {49
if l == nil {50
return 050
return 051
}51
}52
l.mu.Lock()53
defer l.mu.Unlock()52
return int64(l.rate)54
return int64(l.rate)53
}55
}54
56
55
// Wait blokkeert tot n bytes gelezen mogen worden.57
// Wait blokkeert tot n bytes gelezen mogen worden.56
func (l *Limiter) Wait(ctx context.Context, n int) error {58
func (l *Limiter) Wait(ctx context.Context, n int) error {57
if l == nil || l.rate <= 0 || n <= 0 {59
if l == nil || n <= 0 {58
return nil60
return nil59
}61
}60
l.mu.Lock()62
l.mu.Lock()63
if l.rate <= 0 {64
l.mu.Unlock()65
return nil66
}61
now := l.now()67
now := l.now()62
l.tokens += now.Sub(l.last).Seconds() * l.rate68
l.tokens += now.Sub(l.last).Seconds() * l.rate63
if l.tokens > l.burst {69
if l.tokens > l.burst {@@ -78,7 +84,7 @@ func (l *Limiter) Wait(ctx context.Context, n int) error {78
84
79
// Reader begrenst r met l.85
// Reader begrenst r met l.80
func (l *Limiter) Reader(ctx context.Context, r io.Reader) io.Reader {86
func (l *Limiter) Reader(ctx context.Context, r io.Reader) io.Reader {81
if l == nil || l.rate <= 0 {87
if l == nil {82
return r88
return r83
}89
}84
return &reader{ctx: ctx, r: r, l: l}90
return &reader{ctx: ctx, r: r, l: l}@@ -91,7 +97,10 @@ type reader struct {91
}97
}92
98
93
func (t *reader) Read(p []byte) (int, error) {99
func (t *reader) Read(p []byte) (int, error) {94
if max := int(t.l.burst); len(p) > max {100
t.l.mu.Lock()101
max := int(t.l.burst)102
t.l.mu.Unlock()103
if len(p) > max {95
p = p[:max]104
p = p[:max]96
}105
}97
n, err := t.r.Read(p)106
n, err := t.r.Read(p)@@ -102,3 +111,20 @@ func (t *reader) Read(p []byte) (int, error) {102
}111
}103
return n, err112
return n, err104
}113
}114
115
// SetRate past de snelheid aan zonder lopende downloads te onderbreken.116
func (l *Limiter) SetRate(bytesPerSec int64) {117
if l == nil {118
return119
}120
l.mu.Lock()121
defer l.mu.Unlock()122
l.rate = float64(bytesPerSec)123
l.burst = l.rate / 4124
if l.burst < 16<<10 {125
l.burst = 16 << 10126
}127
if l.tokens > l.burst {128
l.tokens = l.burst129
}130
}@@ -33,8 +33,8 @@ func TestLimiterAverage(t *testing.T) {
33
33
func TestUnlimited(t *testing.T) {
34
34
l := New(0)
35
35
r := bytes.NewReader([]byte("abc"))
36
if l.Reader(context.Background(), r) != r {
37
t.Fatal("onbegrensd hoort de reader niet te wikkelen")
36
if b, _ := io.ReadAll(l.Reader(context.Background(), r)); string(b) != "abc" {
37
t.Fatal(string(b))
38
38
}
39
39
if err := l.Wait(context.Background(), 1<<30); err != nil {
40
40
t.Fatal(err)
@@ -50,3 +50,21 @@ func TestCancel(t *testing.T) {
50
50
t.Fatal("geen fout na annuleren")
51
51
}
52
52
}
53
54
func TestSetRate(t *testing.T) {
55
l := New(0)
56
l.SetRate(2048)
57
if l.Rate() != 2048 {
58
t.Fatal(l.Rate())
59
}
60
var slept time.Duration
61
l.sleep = func(_ context.Context, d time.Duration) error { slept += d; return nil }
62
now := time.Unix(0, 0)
63
l.now = func() time.Time { return now }
64
l.last = now
65
l.tokens = 0
66
_ = l.Wait(context.Background(), 4096)
67
if slept != 2*time.Second {
68
t.Fatal(slept)
69
}
70
}
@@ -33,8 +33,8 @@ func TestLimiterAverage(t *testing.T) {33
func TestUnlimited(t *testing.T) {33
func TestUnlimited(t *testing.T) {34
l := New(0)34
l := New(0)35
r := bytes.NewReader([]byte("abc"))35
r := bytes.NewReader([]byte("abc"))36
if l.Reader(context.Background(), r) != r {36
if b, _ := io.ReadAll(l.Reader(context.Background(), r)); string(b) != "abc" {37
t.Fatal("onbegrensd hoort de reader niet te wikkelen")37
t.Fatal(string(b))38
}38
}39
if err := l.Wait(context.Background(), 1<<30); err != nil {39
if err := l.Wait(context.Background(), 1<<30); err != nil {40
t.Fatal(err)40
t.Fatal(err)@@ -50,3 +50,21 @@ func TestCancel(t *testing.T) {50
t.Fatal("geen fout na annuleren")50
t.Fatal("geen fout na annuleren")51
}51
}52
}52
}53
54
func TestSetRate(t *testing.T) {55
l := New(0)56
l.SetRate(2048)57
if l.Rate() != 2048 {58
t.Fatal(l.Rate())59
}60
var slept time.Duration61
l.sleep = func(_ context.Context, d time.Duration) error { slept += d; return nil }62
now := time.Unix(0, 0)63
l.now = func() time.Time { return now }64
l.last = now65
l.tokens = 066
_ = l.Wait(context.Background(), 4096)67
if slept != 2*time.Second {68
t.Fatal(slept)69
}70
}@@ -1,7 +1,7 @@
1
1
# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
2
listen: 0.0.0.0:8790
2
listen: 0.0.0.0:8080
3
3
# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
4
public_url: http://backup.lan:8790
4
public_url: http://backup.lan:8080
5
5
data_dir: /var/lib/bluegit-backup
6
6
# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
7
7
archive_interval: 24h
@@ -1,7 +1,7 @@1
# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.1
# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.2
listen: 0.0.0.0:87902
listen: 0.0.0.0:80803
# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).3
# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).4
public_url: http://backup.lan:87904
public_url: http://backup.lan:80805
data_dir: /var/lib/bluegit-backup5
data_dir: /var/lib/bluegit-backup6
# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.6
# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.7
archive_interval: 24h7
archive_interval: 24h